---
title: "IceBox.*"
url: https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties
language: java
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# IceBox.\*

Programming language: Java. Other languages: [C++](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/csharp.md), [JavaScript](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/php.md), [Python](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/ruby.md), [Swift](https://docs.zeroc.com/ice/3.8/property-reference/icebox-properties/swift.md).

## IceBox.InheritProperties

`IceBox.InheritProperties=num`

If `num` is set to a value larger than `0`, each service [inherits the configuration properties](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/java.md) of the IceBox server's communicator, except the properties whose names start with `IceBox.` or `Ice.Admin.`. Properties set by the service arguments in [IceBox.Service.name](#icebox.service.name) override inherited properties. If not defined, the default value is `0`.

## IceBox.LoadOrder

`IceBox.LoadOrder=names`

Determines the [order](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/java.md) in which services are loaded. The service manager loads the services in the order they appear in `names`, where each service name is separated by a comma or white space. Each name must have a matching `IceBox.Service.name` property. Any services not mentioned in `names` are loaded afterward, in an undefined order.

## IceBox.PrintServicesReady

`IceBox.PrintServicesReady=token`

If this property is set, the service manager prints "`token` ready" on standard output once initialization of all the services is complete. This is useful for scripts that need to wait until all services are ready to be used.

## IceBox.Service.*name*

`IceBox.Service.name=entry_point [args]`

Defines a [service](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/java.md) to be loaded during IceBox initialization. The service manager examines the arguments that follow the entry point. An argument of the form `--prefix.key=value`, where `prefix` is one of the [reserved prefixes](https://docs.zeroc.com/ice/3.8/runtime/properties-and-configuration/properties-overview/java.md) such as `Ice`, or the service `name`, sets a property in the communicator that the service manager passes to the service `start` method; `--Ice.Config=file` loads a configuration file into that communicator. The service manager passes all remaining arguments to the `start` method in the `args` parameter. Whitespace separates the arguments, and any arguments that contain whitespace must be enclosed in quotes.

In Java, `entry_point` has the form `[path:]class`.

The `class` component must be the name of a class that implements the `com.zeroc.IceBox.Service` interface and provides at least one of the constructors shown in the example below:

```java
public class MyService implements com.zeroc.IceBox.Service {
    public MyService(com.zeroc.Ice.Communicator serverCommunicator);
    public MyService();

    // ...
}
```

The constructor taking a `Communicator` argument is invoked if present, otherwise the default constructor is invoked.

If `path` is specified, it may be the path name of a JAR file or class directory, as shown below:

```config
IceBox.Service.MyService=MyService.jar:MyService
IceBox.Service.MyOtherService=/classes:MyOtherService
```

If `path` contains spaces, it must be enclosed in quotes:

```config
IceBox.Service.MyService="factory classes.jar":MyService
```

IceBox uses a single class loader to load all services having the same value for `path`.

If `class` is specified without a path, IceBox attempts to load the class with the current thread's context class loader, then with `Class.forName`, and finally with the system class loader.

## IceBox.Trace.ServiceObserver

`IceBox.Trace.ServiceObserver=num`

If `num` is set to a value larger than `0`, the service manager traces the registration and removal of service observers. If not defined, the default value is `0`.

## IceBox.UseSharedCommunicator.*name*

`IceBox.UseSharedCommunicator.name=num`

If `num` is set to a value larger than `0`, the service manager supplies the service `name` with a communicator that might be [shared by other services](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/java.md). If the [IceBox.InheritProperties](#icebox.inheritproperties) property is also defined, the shared communicator inherits the properties of the IceBox server. If not defined, the default value is `0`.
