IceBox.*

IceBox.InheritProperties

Synopsis

IceBox.InheritProperties=num

Description

If num is set to a value larger than zero, each service inherits the configuration properties of the IceBox server's communicator. If not defined, the default value is zero.

IceBox.LoadOrder

Synopsis

IceBox.LoadOrder=names

Description

Determines the order 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. Any services not mentioned in names are loaded afterward, in an undefined order.

IceBox.PrintServicesReady

Synopsis

IceBox.PrintServicesReady=token

Description

If this property is set to a value greater than zero, 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

Synopsis

IceBox.Service.name=entry_point [args]

Description

Defines a service to be loaded during IceBox initialization. Any arguments that follow the entry point are examined; those matching the --name=value pattern are interpreted as property definitions and appear in the property set of the communicator that is passed to the service start method, and all remaining arguments are passed to the start method in the args parameter. Whitespace separates the arguments, and any arguments that contain whitespace must be enclosed in quotes.

In C#, entry_point has the form assembly:class.

The assembly can be a partially or fully qualified assembly name, such as myplugin,Version=0.0.0.0,Culture=neutral, or an assembly DLL name such as myplugin.dll, and may optionally include a leading relative or absolute path name.

You must use a fully-qualified assembly name to load a service from an assembly in the Global Assembly Cache.

The specified class must implement the IceBox.Service interface and provide at least one of the constructors shown in the example below:

C#

public class MyService : IceBox.Service
{
    public MyService(Ice.Communicator serverCommunicator) { ... }
    public MyService() { ... }

    // ...
}

The constructor taking an Ice.Communicator argument is invoked if present, otherwise the parameterless constructor is invoked.

If you specify a relative path name in the entry point, the assembly is located relative to the program's current working directory:

CODE

IceBox.Service.MyService=..\MyService.dll:MyService

Enclose the assembly's path name in quotes if it contains spaces:

CODE

IceBox.Service.MyService="C:\Program Files\MyService\MyService.dll:MyServiceClass"

Finally, if the assembly uses a leading path name, be sure to include the .dll extension.

IceBox.UseSharedCommunicator.name

Synopsis

IceBox.UseSharedCommunicator.name=num

Description

If num is set to a value larger than zero, the service manager supplies the service name with a communicator that might be shared by other services. If the IceBox.InheritProperties property is also defined, the shared communicator inherits the properties of the IceBox server. If not defined, the default value is zero.