ORB service settings that can be added to the administrative console

 

Overview

To set and monitor settings associated with the Java ORB service that do not appear on the main settings page...

Servers | Application Servers | serverName | ORB Service | Custom Properties

The page already might include SSL properties that were added during product setup. A list of additional properties associated with the Java ORB service follows.

 

com.ibm.CORBA.BootstrapHost

Specifies the DNS host name or IP address of the machine on which initial server contact for this client resides. This setting is deprecated and will be removed in a future release.

 

com.ibm.CORBA.BootstrapPort

Specifies the port to which the ORB connects for bootstrapping. In other words, the port of the machine on which the initial server contact for this client is listening. This setting is deprecated and will be removed in a future release.

Default 2809

 

com.ibm.CORBA.FragmentSize

  Specifies the size of GIOP fragments used by the ORB. If the total size of a request exceeds the set value, the ORB breaks up and sends multiple fragments until the entire request is sent. This should also be set on the client side with a -D system property if using a stand-alone java application.

Consider adjusting this when the amount of data that is sent over IIOP exceeds 1k. Definitly adjust this if thread dumps show most client side threads stuck in a wait coming from writeLock. Sometimes a low amount of fragmentation is ok, so the parameter should be set such that most messages have few to no fragments.

See Determining the ORB message size

Units Bytes.
Default 1024
Range From 64 to largest value of Java int type that is divisible by 8

 

com.ibm.CORBA.ListenerPort

Specifies the port on which this server listens for incoming requests. The setting of this property is valid only for client-side ORBs.

Default Next available system-assigned port number
Range 0 to 2147483647

 

com.ibm.CORBA.LocalHost

Specifies the host name or IP address of the system on which the server ORB is running. The setting of this property is valid only for client-side ORBs. Otherwise, the ORB obtains a value at run time by calling InetAddress.getLocalHost().getHostAddress().

 

com.ibm.CORBA.ServerSocketQueueDepth

Corresponds to the length of the TCP/IP stack listen queue and prevents WAS from rejecting requests when there is not space in the listen queue. If there are several simultaneous clients connecting to the server-side ORB, you can increase this parameter to support up to 1000 clients.

Default 50
Range From 50 to the largest value of Java int type

 

com.ibm.CORBA.ShortExceptionDetails

If set to any value, this specifies that the exception detail message that is returned whenever the server ORB encounters a CORBA system exception is to contain a short description of the exception as returned by the toString() method of java.lang.Throwable. Otherwise, the message contains the complete stack trace as returned by the printStackTrace() method of java.lang.Throwable.

 

com.ibm.websphere.threadpool.strategy.implementation

  If set to com.ibm.ws.threadpool.strategy.LogicalPoolDistribution, this enables the LPD thread pool strategy the next time you start the appserver.

Some requests have shorter execution times than others. LPD is a mechanism for allowing these shorter requests greater access to execution threads.

 

com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.calcinterval

  Specifies how often the LPD mechanism will readjust the pool execution target times. It cannot be turned off once this support is installed.

LPD must be enabled (see com.ibm.websphere.threadpool.strategy.implementation).

Data type Integer
Units Milliseconds
Default 30
Range 20,000 minimum

 

com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.lruinterval

  Specifies how long the Logical Pool Distribution internal data is kept for inactive requests. The mechanism tracks several statistics for each request type received. Consider removing requests that have not been active for a while.

LPD must be enabled (see com.ibm.websphere.threadpool.strategy.implementation).

Data type Integer
Units Milliseconds
Default 300,000 (5 minutes)
Range 60,000 (1 minute) minimum

 

com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.outqueues

  Specifies how many pools are created and how many threads are allocated to each pool in the Logical Pool Distribution mechanism.

The ORB parameter for max threads controls the total number of threads. The outqueues parameter is specified as a comma separated list of percentages that should add up to 100. For example, the list 25,25,25,25 will set up 4 pools, each allocated 25% of the available ORB thread pool. The pools are indexed left to right from 0 to n-1. Each outqueue is dynamically assigned a target execution time by the calculation mechanism. Target execution times are assigned to outqueues in increasing order so pool 0 gets the requests with the least execution time and pool n-1 gets requests with the highest execution times.

LPD must be enabled (see com.ibm.websphere.threadpool.strategy.implementation).

Data type Integers in comma separated list
Default 25,25,25,25
Range Percentages in list must total 100 percent

 

com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.statsinterval

  If active, statistics will be dumped to stdout after this interval expires, but only if requests have been processed. This keeps the mechanism from filling the log files with redundant information. These stats are beneficial for tuning the Logical Pool Distribution mechanism.

LPD must be enabled (see com.ibm.websphere.threadpool.strategy.implementation).

Data type Integer
Units Milliseconds
Default 0 (meaning Off)
Range 30,000 (30 seconds) minimum

 

com.ibm.websphere.threadpool.strategy.LogicalPoolDistribution.workqueue

  Specifies the size of a new queue where incoming requests wait for dispatching. Pertains to the Logical Pool Distribution mechanism.

LPD must be enabled (see com.ibm.websphere.threadpool.strategy.implementation).

Data type Integer
Default 96
Range 10 minimum

 

See Also

ORB Tuning Guidelines
Administrative console preference settings
Character codeset conversion support for the Java ORB service
Client-side programming tips for the Java ORB service
ORB service settings in administrative console
ORBs: Resources for learning
Tuning performance parameter index