Table of Contents Previous Next
Logo
Properties : C.8 Ice Default and Override Properties
Copyright © 2003-2009 ZeroC, Inc.

C.8 Ice Default and Override Properties

Ice.Default.CollocationOptimized

Synopsis

Ice.Default.CollocationOptimized=num

Description

Specifies whether proxy invocations use collocation optimization (see Section 32.22) by default. When enabled, proxy invocations on a collocated servant (i.e., a servant whose object adapter was created by the same communicator as the proxy) are made as a direct method call if possible. Collocated invocations are more efficient because they avoid the overhead of marshaling parameters and sending requests over the network.
Collocation optimization is not supported for asynchronous or Dynamic Ice invocations, nor is it supported in Ice for Python and Ice for Ruby.
If not specified, the default value is 1. Set the property to 0 to disable collocation optimization by default.

Ice.Default.EndpointSelection

Synopsis

Ice.Default.EndpointSelection=policy

Description

This property controls the default endpoint selection policy for proxies with multiple endpoints. Permissible values are Ordered and Random. The default value of this property is Random.

Ice.Default.Host

Synopsis

Ice.Default.Host=host

Description

If an endpoint is specified without a host name (i.e., without a h host option), the host value from this property is used instead. The property has no default value.

Ice.Default.Locator

Synopsis

Ice.Default.Locator=locator

Description

Specifies a default locator for all proxies and object adapters. The value is a stringified proxy to the IceGrid locator interface. The default locator can be overridden on a proxy using the ice_locator operation. The default value is no locator.
The default identity of the IceGrid locator object is IceGrid/Locator (see IceGrid.InstanceName). It is listening on the IceGrid client endpoints. For example, if IceGrid.Registry.Client.Endpoints is set to tcp p 12000 h localhost, the stringified proxy for the IceGrid locator is IceGrid/Locator:tcp p 12000 h localhost.
As a proxy property, you can configure additional aspects of the proxy using the properties described in Section C.9.

Ice.Default.LocatorCacheTimeout

Synopsis

Ice.Default.LocatorCacheTimeout=num

Description

Specifies the default locator cache timeout for indirect proxies. If num is set to a value larger than zero, locator cache entries older than num seconds will be ignored. If set to 0, the locator cache won't be used. If set to 1, locator cache entries won't expire.
Once a cache entry has expired, the Ice run time performs a new locate request to refresh the cache before sending the next invocation; therefore, the invocation is delayed until the run time has refreshed the entry. If you set Ice.BackgroundLocatorCacheUpdates to a non-zero value, the lookup to refresh the cache is still performed but happens in the background; this avoids the delay for the first invocation that follows expiry of a cache entry.

Ice.Default.Package

Synopsis

Ice.Default.Package=package

Description

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. See also Ice.Package.module.

Ice.Default.PreferSecure

Synopsis

Ice.Default.PreferSecure=num

Description

Specifies whether secure endpoints are given precedence in proxies by default. The default value of num is zero, meaning that insecure endpoints are given preference.
Setting this property to a non-zero value is the equivalent of invoking ice_preferSecure(true) on proxies created by the Ice run time, such as those returned by stringToProxy or received as the result of an invocation. Proxies created by proxy factory methods such as ice_oneway inherit the setting of the original proxy. If you want to force all proxies to use only secure endpoints, use Ice.Override.Secure instead.
See Section 37.3.1 for more information on endpoint selection and Section 42.4.7 for a discussion of secure proxies.

Ice.Default.Protocol

Synopsis

Ice.Default.Protocol=protocol

Description

Sets the protocol that is being used if an endpoint uses default as the protocol specification. The default value is tcp.

Ice.Default.Router

Synopsis

Ice.Default.Router=router

Description

Specifies the default router for all proxies. The value is a stringified proxy to the Glacier2 router control interface. The default router can be overridden on a proxy using the ice_router operation. The default value is no router.
As a proxy property, you can configure additional aspects of the proxy using the properties described in Section C.9.

Ice.Override.Compress

Synopsis

Ice.Override.Compress=num

Description

If set, this property overrides compression settings in all proxies. If num is set to a value larger than zero, compression is enabled. If zero, compression is disabled.
The setting of this property is ignored in the server role.
Note that, if a client sets Ice.Override.Compress=1 and sends a compressed request to a server that does not support compression, the server will close the connection and the client will receive ConnectionLostException.
If a client does not support compression and Ice.Override.Compress=1, the setting is ignored and a warning message is printed on stderr.
Regardless of the setting of this property, requests smaller than 100 bytes are never compressed.

Ice.Override.ConnectTimeout

Synopsis

Ice.Override.ConnectTimeout=num

Description

This property overrides timeout settings used to establish connections. num is the timeout value in milliseconds, or 1 for no timeout. If this property is not set, then Ice.Override.Timeout is used.

Ice.Override.Secure

Synopsis

Ice.Override.Secure=num

Description

If set to a value larger than zero, this property overrides security settings in all proxies by allowing only secure endpoints. Defining this property is equivalent to invoking ice_secure(true) on every proxy. If you wish to give priority to secure endpoints without precluding the use of non-secure endpoints, see Ice.Default.PreferSecure. Refer to Section 42.4.7 for more information on secure proxies.

Ice.Override.Timeout

Synopsis

Ice.Override.Timeout=num

Description

If set, this property overrides timeout settings in all endpoints. num is the timeout value in milliseconds, or 1 for no timeout.
Table of Contents Previous Next
Logo