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
- See the Secure Socket Layer property help
-
Connection Cache Maximum
- 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
- 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
- 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
- Whether to enable the ORB Comm Trace
-
External Config URL
- The URL of an ORB configuration file
-
Listener Port
- 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
- 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
- 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
- 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
- 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
- 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
- The URL locations to download classes that are published by this JVM.
-
Thread Pool Size
- 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
- 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.
|
|