Steps for customizing the Object Request Broker

Perform the following steps to customize the Object Request Broker:

  1. Refer to Table 23 for the properties that the IBM Java ORB supports to customize its behavior.
  2. Specify the IBM ORB property and its value as a command-line option to the component's startup script. When you specify the IBM ORB property on the command line, you change it only for the component that you are starting. You specify an ORB property by preceding it with the -D command-line option. Properties you specify on the command line override any other property settings within the system or from the CWSharedEnv file.
  3. Edit the appropriate variable in the CWSharedEnv file. When you change the variable in the CWSharedEnv file, you change it for all components that read this file during their startup process. These components include any adapters, InterChange Server Express instances, the repos_copy utility, and the InterChange Server Express tools.
    Note:
    For more information on the CWSharedEnv file, see Steps for managing run-time properties.

    As Table 23 shows, the ORB location is specified by special variables in the CWSharedEnv file. You must modify these variables in the CWSharedEnv file to change its location.

    Other ORB properties are listed in the ORB_PROPERTY variable of the CWSharedEnv file. In this variable, each IBM ORB property is preceded by the -D command-line option. To add or change an ORB property, you must add or change the appropriate -D option in the ORB_PROPERTY variable of the CWSharedEnv file. Properties you specify in the CWSharedEnv file override any other settings from the configuration file.

  4. Specify the configuration parameter (if one exists) in the appropriate configuration (.cfg) file. You can set many of the ORB properties with configuration parameters in the CORBA section of the configuration file. Both the InterChange Server Express configuration file (InterchangeSystem.cfg) and the adapter local configuration file can contain a CORBA section. When you specify the configuration parameter in the CORBA configuration file, you change it for all ORB-related tasks that the ORB server performs.
    Important:
    The configuration files are in XML format. Do not modify these files unless you use an XML editor or are very familiar with XML format!

    For example, to specify the maximum number of threads, you can take any of the following actions:


Table 23. IBM Java ORB properties that can be customized

IBM ORB property Configuration parameter Description
com.ibm.CORBA.ListenerPort OAport Port number on which the ORB server (within InterChange Server Express) listens for incoming requests.
com.ibm.CORBA.LocalHost OAipAddr IP address or host name of the machine on which the ORB server (within InterChange Server Express) is running.
com.ibm.CORBA.ThreadPool. MaximumSize OAthreadMax Maximum number of threads that the connection manager can create. The default value (zero) indicates that no size restriction exists.
com.ibm.CORBA.ThreadPool. InactivityTimeout OAthreadMaxIdle The time (in seconds) before an idle thread is destroyed.
com.ibm.CORBA.RequestTimeout None Number of seconds that a CORBA request waits before timing out. By default, there is no timeout; the ORB waits indefinitely for a response.
com.ibm.CORBA.LocateRequest None Timeout value (in seconds) for Locate Requests.
com.ibm.CORBA.FragmentTimeout None Maximum length of time that the ORB waits for second and subsequent message fragments before it times out. Set this property to zero to indicate no timeout. The default value is 30000.

Copyright IBM Corp. 2004