Object Request Broker service settings

Specifies the number of seconds to wait before timing out on a request message.

If you use command-line scripting, the full name of this system property is com.ibm.CORBA.RequestTimeout.

Specifies the number of times that the ORB attempts to send a request if a server fails. Retrying sometimes enables recovery from transient network failures. This field is ignored for z/OS®.

If you use command-line scripting, the full name of this system property is com.ibm.CORBA.requestRetriesCount.

Specifies the number of milliseconds between request retries. This field is ignored for z/OS.

If you use command-line scripting, the full name of this system property is com.ibm.CORBA.requestRetriesDelay.

Specifies the maximum number of entries that can occupy the ORB connection cache before the ORB starts to remove inactive connections from the cache. This field is ignored for z/OS.

It is possible that the number of active connections in the cache can temporarily exceed this threshold value. If necessary, the ORB can continue to add connections if resources are available.

For use in command-line scripting, the full name of this system property is com.ibm.CORBA.MaxOpenConnections.

Specifies the minimum number of entries in the ORB connection cache. This field is ignored for z/OS.

The ORB does not remove inactive connections when the number of entries does not meet this value.

For use in command-line scripting, the full name of this system property is com.ibm.CORBA.MinOpenConnections.

Enables the tracing of ORB General Inter-ORB Protocol (GIOP) messages that includes both ORBRas=all trace and ORB CommTrace.

Specifies the number of seconds to wait before timing out on a LocateRequest message. This field is ignored for z/OS.

If you use command-line scripting, the full name of this system property is com.ibm.CORBA.LocateRequestTimeout.

Controls how the client ORB attempts to use HTTP tunneling. This field is ignored for z/OS.

If you use command-line scripting, the full name of this system property is com.ibm.CORBA.ForceTunnel.

Specifies the web address of the servlet to use in support of HTTP tunneling. This field is ignored on the z/OS platform.

This web address must be a proper format:

http://w3.mycorp.com:81/servlet/com.ibm.CORBA.services.IIOPTunnelServlet

For applets: http://applethost:port/servlet/com.ibm.CORBA.services.IIOPTunnelServlet.

This field is required if HTTP tunneling is set. If you use command-line scripting, the full name of this system property is com.ibm.CORBA.TunnelAgentURL.

Specifies how the ORB passes parameters. If enabled, the ORB passes parameters by reference instead of by value, to avoid making an object copy. If you do not enable the pass by reference option, a copy of the parameter passes rather than the parameter object itself. This copy can be expensive because the ORB must first make a copy of each parameter object.

You can use this option only when the Enterprise JavaBeans (EJB) client and the EJB are on the same classloader. This requirement means that the EJB client and the EJB must be deployed in the same EAR file.

If you use command-line scripting, the full name of this system property is com.ibm.CORBA.iiop.noLocalCopies.

The use of this option for enterprise beans with remote interfaces violates Enterprise JavaBeans (EJB) Specification, Version 2.0 (see section 5.4). Object references passed to Enterprise JavaBeans (EJB) methods or to EJB home methods are not copied and can be subject to corruption.

Iterator iterator = collection.iterator();
MyPrimaryKey pk = new MyPrimaryKey();
while (iterator.hasNext()) {
   pk.id = (String) iterator.next();
   MyEJB myEJB = myEJBHome.findByPrimaryKey(pk);
}

In this example, a reference to the same MyPrimaryKey object passes into the product with a different ID value each time. Running this code with pass by reference enabled causes a problem within the application server because multiple enterprise beans are referencing the same MyPrimaryKey object. To avoid this problem, set the com.ibm.websphere.ejbcontainer.allowPrimaryKeyMutation system property to true when the pass by reference option is enabled. Setting the pass by reference option to true causes the EJB container to make a local copy of the PrimaryKey object. But as a result, a small portion of the performance advantage of setting the pass by reference option is lost.

As a rule, any application code that passes an object reference as a parameter to an enterprise bean method or to an EJB home method must be scrutinized. Passing the object reference might result in loss of data integrity or other problem.

After examining your code, you can enable the pass by reference option by setting the com.ibm.CORBA.iiop.noLocalCopies system property to true. You can also enable the pass by reference option in the administrative console. Click Servers > Server Types > Application servers > server_name > Container services > ORB Service and select Pass by reference.

Specifies which thread pool will be used for the ORB Service, as well as the ability to make any thread pool adjustments for either thread pool option.