This property defines the number of times an operation is re-tried and the delay between each retry. For example, if the property is set to 0 100 500, the operation is re-tried 3 times: immediately upon the first failure, again after waiting 100 (ms) upon the second failure, and again after waiting 500 (ms) upon the third failure. The default value is to retry once immediately (0). If set to -1, no retry occurs.
This property controls the maximum size (in kilobytes) of a protocol message that is accepted or sent by the Ice run time. The size includes the size of the Ice protocol header. Messages larger than this size cause a [MemoryLimitException]. The default size is 1024 (1 Megabyte). Settings with a value less than 1 are ignored.
This property adjusts the value of Ice.UDP.RcvSize and Ice.UDP.SndSize, that is, if Ice.UDP.RcvSize or Ice.UDP.SndSize are larger than Ice.MessageSizeMax * 1024 + 28, they are adjusted to Ice.MessageSizeMax * 1024 + 28.
If num is set to a value larger than zero, ACM (Active Connection Management) is enabled. This means that connections are automatically closed after they have been idle for num seconds. This is transparent to user code, i.e., closed connections are automatically reestablished in case they are needed again. The default value is 60, meaning that idle connections are automatically closed after one minute.
name is the program name, which is set automatically from argv[0] (C++) and from AppDomain.CurrentDomain.FriendlyName (C#) during initialization. (For Java, Ice.ProgramName is initialized to the empty string.) For all languages, the default name can be overridden by setting this property.
The value id is used as the server id when an object adapter registers the server with the locator registry. Refer to the description of the object adapter property adapter.RegisterProcess for more information.
If num is set to a value larger than zero, Ice automatically calls Communicator::shutdown once the Communicator has been idle for num seconds. This shuts down the Communicator's server side and causes all threads waiting in Communicator::waitForShutdown to return. After that, a server will typically do some cleanup work before exiting. The default value is zero, meaning that the server will not shut down automatically.
If num is set to a value larger than zero, the C++ classes Ice::Application and Ice::Service ignore SIGHUP (for UNIX) and CTRL_LOGOFF_EVENT (for Windows). As a result, an application that sets Ice.Nohup continues to run if the user that started the application logs off. The default value for Ice::Application is 0, and the default value for Ice::Service is 1 (C++ only.)
These properties set the UDP receive and send buffer sizes to the specified value in bytes. Ice messages larger than num - 28 bytes cause a DatagramLimitException. The default value depends on the configuration of the local UDP stack. (Common default values are 65535 and 8192 bytes.)
The OS may impose lower and upper limits on the receive and send buffer sizes or otherwise adjust the buffer sizes. If a limit is requested that is lower than the OS-imposed minimum, the value is silently adjusted to the OS-imposed minimum. If a limit is requested that is larger than the OS-imposed maximum, the value is adjusted to the OS-imposed maximum; in addition, Ice logs a warning showing the requested size and the adjusted size.
Settings of these properties less than 28 are ignored.
Note that, on many operating systems, it is possible to set buffer sizes greater than 65535. Such settings do not change the hard limit of 65507 bytes for the payload of a UDP packet, but merely affect how much data can be buffered by the kernel.
Settings less than 65535 limit the size of Ice datagrams as well as adjust the kernel buffer sizes.
If Ice.MessageSizeMax is set and Ice.MessageSizeMax * 1024 + 28 is smaller than the UDP receive or send buffer size, the corresponding UDP buffer size is reduced to Ice.MessageSizeMax * 1024 + 28.
Associates a top-level Slice module with a Java package. If global metadata is used to enclose generated Java classes in a user-defined package, the Ice run time must be configured in order to successfully unmarshal exceptions and concrete class types. If all top-level modules are generated into the same user-defined package, it is easier to use Ice.Default.Package instead.
Specifies a default package to use if other attempts by the Ice run time to dynamically load a generated class have failed. If global metadata is used to enclose generated Java classes in a user-defined package, the Ice run time must be configured in order to successfully unmarshal exceptions and concrete class types. Also see Ice.Package.module.
| <<< Previous | Home | Next >>> |
| Ice Default and Override Properties | Up | IceSSL Properties |