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 PropertiesThe 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