InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.30: Administering Object Request Brokers (overview) >
6.6.30.0: Object Request Broker properties for Advanced Edition

6.6.30.0: Object Request Broker properties for Advanced Edition

These field descriptions apply strictly to the Advanced Edition. They do not apply to Advanced Single Server Edition.

Configure SSL  Property name in the Java-based administrative console
See the Secure Socket Layer property help
Connection Cache Maximum  Property name in the Java-based administrative console
The maximum amount of connections in use kept in the connection cache table at any one time.

The default value is 240, with a range from 0 to 256.

Connection Cache Minimum  Property name in the Java-based administrative console
The number of connections that must be in the connection cache in order for the ORB to clean up any connections that are not busy.

For example, if the default value is 100, then when the cache size reaches 101, the ORB will begin shutting any connections that are open but not busy. It will stop when there are 100 or fewer connections in the cache.

The default value is 100, with a range from 0 to 255.

Enable HTTP Tunneling  Property name in the Java-based administrative console
Controls how the client ORB attempts to use HTTP tunneling. The values of this optional property can be:
  • always - use HTTP tunneling immediately, without trying TCP connections first
  • never - disable HTTP tunneling. If a TCP connection fails, a CORBA system exception COMM_FAILURE is thrown
  • whenrequired - use HTTP tunneling if TCP connections fail
Enable ORB Tracing  Property name in the Java-based administrative console
Whether to enable the ORB Comm Trace
External Config URL  Property name in the Java-based administrative console
The URL of an ORB configuration file
Listener Port  Property name in the Java-based administrative console
The port on which this server will listen for incoming requests. The default is the next available system assigned port number. The range for this optional property is from 0 to 2147483647 (maximum Java Int).
Locate Request Timeout  Property name in the Java-based administrative console
The number of seconds to wait before timing out on a LocateRequest message. The default value of this optional property is 180. The range is from 0 to 2147483647 (maximum Java Int).
Pass by Reference  Property name in the Java-based administrative console
When parameters are passed locally, they are passed "by value" using the standard IIOP copy semantics. Use this property to select "pass by reference" instead. Depending on your application design, using pass by reference might introduce side effects.
Using the pass-by-reference option for enterprise beans violates the EJB specification. Also, there are coding considerations you must keep in mind if you use the pass-by-reference for enterprise beans. Object references passed to EJB methods or EJB home mehtods are copied and therefore can be subject to corruption. Consider the following example:
Iterator iterator = collection.iterator ();
MyPrimaryKey pk = new MyPrimaryKey();
while (iterator.hasNext()){
pk.id = (String) iterator.next();
MyEJB myEJB = myEJBHome.findByPrimaryKey (pk);
}
In this code sample, a reference to the same MyPrimaryKey object is passed onto WebSphere Application Server each time with a different ID value. If this code is run with the pass-by-reference option enabled, it causes a problem within WebSphere Application Server because multiple enterprise beans are referencing the same MyPrimaryKey object. To avoid this problem, set the system property com.ibm.websphere.ejbcontainer.allowPrimaryKeyMutation to true. This causes the EJB container to make a local copy of the PrimaryKey object. However, a small portion of the performance advantage of setting the pass-by-reference option is lost.
Generally, any application code that passes an object reference as a parameter to an EJB method or EJB home method must be scrutinized to determine if passing that object reference causes integrity or other problems.
Request Retry  Property name in the Java-based administrative console
The number of times the ORB will attempt to send an indirect-IOR request in case a server failed. If a server has been determined to have failed, the ORB will give the Location Service Daemon an opportunity to issue a new IOR. The default value of this optional property is 1. The range is from 0 to 2147483647 (maximum Java Int).
Request Retry Delay  Property name in the Java-based administrative console
The amount of delay time between request retries. The default value of this optional property is 0. The range is from 0 to 2147483647 (maximum Java Int).
Request Timeout  Property name in the Java-based administrative console
The number of seconds to wait before timing out on a request message. The default value of this optional property is 180. The range is from 0 to 2147483647 (maximum Java Int).
RMI Remote Codebase  Property name in the Java-based administrative console
The URL locations to download classes that are published by this JVM.
Thread Pool Size  Property name in the Java-based administrative console
Specifies the starting size of the thread pool for the application server.

Each application server has its own thread pool or cache from which it uses threads to process remote method invocations.

The size of a server's thread pool varies throughout the server's lifetime. Threads are created when needed and destroyed when there are too many idle threads.

Server Socket Queue Depth, using com.ibm.CORBA.ServerSocketQueueDepth=value

The property can be specified to change the queue depth of a server.

The field is not available from the property sheet for ORB administration, but is included here for completeness of the ORB property reference. Instead, for an application server, the argument can be specified using the command line arguments of the application server JVM properties.

For Advanced Edition (non-Single Server): Use the administrative configuration file settings for the administrative server, as described in administrative server configuration file properties.

Tunnel Agent URL  Property name in the Java-based administrative console
The URL of the servlet used to support HTTP tunneling. It must be a properly formed URL, such as "http://w3.mycorp.com:81/servlet/com.ibm.CORBA.services.IIOPTunnelServlet" or, for applets, "http://applethost:port/servlet/com.ibm.CORBA.services.IIOPTunnelServlet." There is no default value. This field is required if com.ibm.CORBA.ForceTunnel is set.
Go to previous article: Administering Object Request Brokers (ORBs) (overview) Go to next article: Administering the ORB services of application servers with the Java administrative console

 

 
Go to previous article: Administering Object Request Brokers (ORBs) (overview) Go to next article: Administering the ORB services of application servers with the Java administrative console