Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Appendix A Setting OIG Session Initialization Parameters : Session Parameters

Session Parameters
You can set the following initialization parameters for an Object Integration Gateway session.
DATAIN
Specifies the datain size in bytes.
DATAOUT
Specifies the dataout size in bytes.
DEBUG
Specifies whether debugging messages are written to the System.out stream for significant internal events. It also causes session data to be included in the table of contents. The information provided in the system log can be requested by support if you have an issue under investigation.
Debug should be used carefully with high performance applications, because access to the System.out stream is serialized and can adversely affect performance.
HOST
The name of the host machine where the TIBCO Object Service Broker monitor process is running.
HOST must be used in pair with the PORT parameter to fully identify the target TIBCO Object Service Broker monitor process (Open Systems) or Execution Environment (z/OS).
LIBRARY
The name of the local library for rule calls.
MAXSESSION
The maximum number of sessions that the Gateway can execute simultaneously.
Exceeding the limit specified by the MAXSESSION parameter setting results in the rejection of the offending HTTP request.
PASSWORD
The user’s login password to be passed to TIBCO Object Service Broker. The value is case-sensitive on Open Systems.
POOLTIMEOUT
The number of milliseconds the pool manager waits for a session to become available if all sessions in the pool are busy.
If a session becomes available within the specified time, the pool manager returns the session to the requesting client.
If no session becomes available within the specified time, an exception is thrown indicating that MAXSESSION is exceeded.
PORT
The number of the TIBCO Object Service Broker monitor socket port.
PREFIX
The character value used as a prefix for generated user IDs.
A generated user ID is composed of two parts: a character prefix that is constant, and a numeric suffix that is incremented. A generated user ID is always a total of eight characters long, so the number of digits used for the numeric suffix depends on the length of the prefix: if a prefix is, say, five characters long, three digits are used for the suffix (for example, HURON001). The digits start numbering at zero, and are incremented by one as each user ID is generated.
The number of user IDs that can be generated depends on the length of the prefix: if five characters are used for the prefix, three digits are used for the numeric suffix, accommodating a maximum of 1000 generated user IDs.
SEARCH
The library search environment for the first rule to be executed.
Specify I or L only when one or more required rules reside in the site’s installation or local library. Specification L causes overhead in finding rules; the local library must be searched whenever a new rule name is encountered for the first time in a transaction. Significant performance benefits can be realized when frequently used rules are promoted to the installation library.
If SEARCH=S is specified, TIBCO Object Service Broker searches for rules, external routines, or builtins in the following order:
If SEARCH=I is specified, TIBCO Object Service Broker searches for rules, external routines, or builtins in the following order:
If SEARCH=L is specified, TIBCO Object Service Broker searches for rules, external routines, or builtins in the following order:
STANDBYWAIT
Specifies whether the start request of the Object Integration Gateway session is to wait for an available standby session if all the standby sessions are busy.
A YES setting puts the request on a wait queue for a standby session. The STANDBYWAITLIMIT parameter controls the length of the wait time. See the description of that parameter in the TIBCO Object Service Broker Parameters manual. This value overrides STANDBYWAIT specified as a configuration or EE initialization parameter in TIBCO Service Object Broker.
This parameter is accepted by Open Systems TIBCO Service Object Broker on z/OS and Open Systems. However, it has no effect on Open Systems.
The exact behavior is defined by this parameter and the STANDBYWAITLIMIT and STANDBYWAITMSG settings of Object Service Broker. See TIBCO Object Service Broker Parameters for details.
TRACEMESSAGES
Specifies the file to which debug tracing messages are written, if the DEBUG parameter is set to TRUE.
USERID
The TIBCO Object Service Broker session user ID.
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved