Table of Contents Previous Next
Logo
Properties : C.13 IceBox Properties
Copyright © 2003-2009 ZeroC, Inc.

C.13 IceBox Properties

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.InstanceName

Synopsis

IceBox.InstanceName=name

Description

Specifies an alternate identity category for the IceBox service manager object. If defined, the identity of the object becomes name/ServiceManager. If not specified, the default identity category is IceBox.

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 wish to wait until all services are ready to be used.

IceBox.Service.name

Synopsis

IceBox.Service.name=entry_point[,version] [args]

Description

Defines a service to be loaded during IceBox initialization.

Platform Notes

C++
The value of entry_point has the form basename[,version]:function. The basename and optional version components are used to construct the name of a DLL or shared library. If no version is supplied, the version is the empty string. The function component is the name of a function with extern C linkage. For example, the entry point IceStormService,33:createIceStorm implies a shared library name of libIceStormService.so.33 on Unix and IceStormService33.dll on Windows. Furthermore, if IceBox is built on Windows with debugging, a d is automatically appended to the version (e.g., IceStormService33d.dll).
The function must be declared with extern C linkage and have the following signature:
IceBox::Service* function(Ice::CommunicatorPtr c);
Note that the function must return a pointer and not a smart pointer. The Ice core deallocates the object when it unloads the library.
Any arguments that follow the entry point are passed to the start method.
Java
The value of entry_point is the name of a class that must implement the IceBox.service interface. Any arguments that follow the class name are passed to the start method.
.NET
The value of entry_point has the form assembly:class. The assembly can be the full assembly name, such as myplugin, Version=0.0.0.0, Culture=neutral, or an assembly DLL name such as myplugin.dll. The specified class must implement the IceBox.Service interface. Any arguments that follow the class name are passed to the start method.

IceBox.ServiceManager.name

Synopsis

IceBox.ServiceManager.name=value

Description

IceBox uses the adapter name IceBox.ServiceManager for its object adapter. Therefore, all the adapter properties detailed in Section C.4 can be used to configure the IceBox object adapter.

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 with the given name 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.
Table of Contents Previous Next
Logo