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


Chapter 3 Configuring and Operating : Supplying the Gateway Configuration Parameters

Supplying the Gateway Configuration Parameters
Setting and Modifying the Gateway Configuration Parameters
The default Gateway configuration parameters are pre-set for all SLK Gateways during setup. If you want to specify individual values for a particular SERVERID, you use the @CONFIGURESERVER tool to set and modify gateway configuration parameters for the Gateway.
Creating the Gateway Configuration Parameters for a New SERVERID
To create or modify gateway configuration parameters for a SERVERID, complete the following steps:
1.
EX Execute Rule ==> @CONFIGURESERVER(SLK)
A screen similar to the one below appears, showing a listing of defined SLK server IDs.

 
Command==> SCROLL: P
NUMBER SERVERTYPE SERVERID
----------- ---------- --------
_ 1 SLK SLK01
_ 2 SLK SLKTEST
_ 3 ORS ORS01
_ 4 ORS ORSTEST2
A-ADD D-DELETE S-SELECT
PFKEYS: 12=EXIT 13=PRINT 3=END 5=FIND NEXT 9=RECALL

 
2.

 
To complete this command:
NUMBER SERVERTYPE SERVERID
----------- ---------- --------
A 4 SLK SLK01
Enter parameter(s)
SERVERTYPE ===>
SERVERID ===>
 
 
PFKEYS: ENTER=PROCESS 3=END 5=FIND NEXT 9=RECALL

 
3.
4.
5.
6.
Type SLK in the SERVERTYPE field for TIBCO Service Gateway for ODBC or type ORS in the SERVERTYPE field for TIBCO Service Gateway for Oracle.
7.
A screen similar to the one shown below appears, showing the default configuration settings.

 
          External Server Configuration Utility
COMMAND ==>
Server Type: ORS Server ID: ORS01
Recommended/
Name Value Allowed Values
---------------- -------------------------------------------- ----------------
DEBUGLEVEL 0 0, 1
DUMP N Y, N
DUMPLIMIT 2048 '1...2147483647'
INTCOMMIT Y Y, N
KEEPLOG N Y, N
LOGMEDIA TBL                                          TBL, SCR, PRT
SERVERSTATISTICS N Y, N
TRACE N Y, N
FCNKEYS: ENTER=VALIDATE 3=SAVE & EXIT 12=EXIT

 
8.
Valid values are shown in the Recommended/Allowed Values field. For descriptions of the gateway configuration parameters, refer to Supplying the Gateway Configuration Parameters.
9.
If you are modifying the setting for an active Gateway, you must recycle the Gateway for the new values to be applied.
The Gateway Configuration Parameters
The following configuration parameters are available for a Gateway:
 
Used during problem analysis to determine which portion of the server code is in error. The default is 0. Valid values:
Specifies whether TIBCO Object Service Broker and ODBC or Oracle messages and control blocks should be logged (in the location specified via the LOGMEDIA configuration parameter). The default is N. Valid values:
Specifies the amount (in bytes) of messages and control blocks that can be logged. The default is 2,048 bytes. Valid values are between 1 and 2,147,483,647 bytes.
Specifies whether intermediate COMMITs are allowed. A COMMIT request is ignored in two cases: in a BROWSE transaction and when no updates against SLK tables are pending. A COMMIT request is considered intermediate if it is not ignored and is followed by access requests within the same transaction. The default is Y. Valid values:
Specifies whether the Gateway should keep the previous login startup. This applies only if the LOGMEDIA configuration parameter is set to TBL. The default is N. Valid values:
Y – The Gateway log that matches the current SERVERTYPE, SERVERID, and SERVERUSERID is deleted on server startup.
N – The Gateway log that matches the current SERVERTYPE, SERVERID, and SERVERUSERID is kept on startup. Subsequent logs are appended.
PRT – DUMP, TRACE, and error message information is sent to the default print file for the TIBCO Object Service Broker user ID.
SCR – DUMP, TRACE, and error message information appears in the session.log file. This can be viewed only after the server is shut down.
TBL – DUMP, TRACE, and error message information is inserted into the @SERVERLOG TDS table (parameterized by SERVERTYPE, SERVERID, and SERVERUSERID). Browse this table while the Gateway is running.
The SERVERUSERID is generated by the Gateway, and consists of the ID Prefix concatenated with two characters. For example, the Data Object Broker log displays the SERVERTYPE (SLK), SERVERID (SLKNT), and SERVERUSERID (SLKID01) in the S6BUA023I message as follows:
Note  For best performance do not change the default N, as the server transaction is independent of the client transaction.
Specifies whether TIBCO Object Service Broker requests and SQL statements should be logged (in the location specified in the LOGMEDIA configuration parameter). The default is N. Valid values:
 

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