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


Chapter 3 Operational Requirements for Adabas Access : Supplying the Startup Parameters

Supplying the Startup Parameters
You can specify the server parameters on the EXEC statement in the startup JCL, in a data set or both. For more information on how to specify the server parameters, refer to Startup Parameters.
 
Available Parameters
The available parameters are as follows:
 
1 – Activate Fail Safe Level 1. The server informs the Data Object Broker that it can support Fail Safe level‑1 processing. If the server is to attach to a z/OS Data Object Broker, the Data Object Broker’s connection attribute setting “commit level” must be set to 1. If not, the connection is rejected. Refer to Implementing Fail Safe Processing for more information. You must specify the TRXDB, FSTABLENAME, RECOVERYID, and RECOVERYPASSWORD parameters.
0 – De-activate Fail Safe processing. If attaching to a z/OS Data Object Broker, the Data Object Broker’s connection attribute setting “commit level” must be set to 0. If not, the connection is rejected. Refer to Implementing Fail Safe Processing for more information.
The ADA table name of the Adabas transaction database. Required only if FSLEVEL=1. A sample ADA table definition is supplied with the name @ADAFSTRXDB (default). For more information, refer to Implementing Fail Safe Processing.
Prefix used to construct a unique name for each instance of the server. Four decimal digits are appended to this prefix and the resulting value is used to log in to TIBCO Object Service Broker. It uniquely identifies each instance to TIBCO Object Service Broker. Each instance must have a unique IDPREFIX. This parameter must be a valid TIBCO Object Service Broker user ID.
The pattern for selecting the VTAM ACB name that is used for communications. If not specified, the TDS parameter is used as the pattern. If you do not specify an MDL parameter, ensure that the TDS parameter is always a valid VTAM ACB model.
Identifies a pool of instances of the server with common characteristics. SERVERID can have up to eight characters and you must specify one when you are defining an ADA table.
The number of instances of the server that the initializer program should attach to the server address space at startup.
This number can be from 1 to a value less than or equal to the value set in the Maximum Connection Count field in your network configuration. The default value is 1.
For more information, refer to TIBCO Object Service Broker for z/OS Installing and Operating.
 
If you have multiple server initializer programs with the same SERVERID value, ensure that the FSLEVEL and FSTABLENAME Fail Safe server parameters are assigned the same values for each server address space.
Estimation of the CTABLESIZE Parameter
The number of fields in an ADA table definition is dependent upon the Data Object Broker CTABLESIZE parameter. To estimate the number of bytes required to support a specified number of fields, run the ESTIMATEBLDFN tool:
EX ESTIMATETBLDFN(num_fields)
You must supply a value for the argument num_fields, which is the maximum number of fields accessed by any ADA table in your system. This tool returns an estimate of the maximum CTABLESIZE that is required to support the number of fields you specify.
Following is a sample result of executing ESTIMATETBLDFN for 50 fields:

 
----------------------------- INFORMATION LOG --------------------------------:
COMMAND ===> SCROLL ===> P
DATE: Mar 28,2007 REPORT ON ESTIMATE CTABLESIZE
FOR "50" FIELDS

Table Type CTablesize(K) XTablesize(K)
---------- ------------- -------------

ADA 5
DAT 7
DB2 5
IDM 6
IMS 6 3
MAP 4
SLK 4
204 6
TDS 3



PFKEYS: 2=NEXT LOG 3=EXIT 5=REPEAT FIND 12=EXIT 13=PRINT 9=RECALL


See Also
TIBCO Object Service Broker Parameters for more information about the CTABLESIZE parameter.

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