The CONFIG$ element contains the configuration settings for the Data Exchange Director server and Data Exchange in general. Configuration information for more than one Data Exchange Director server may be provided. The CONFIG$ element may contain element cycles, but only the most current element cycle's images is utilized. Only the first 252 characters in a given image are processed; any characters beyond that are ignored.
A configuration setting is specified by a keyword=value sequence, where keyword is one of the configuration keywords described in the following paragraphs, and value is the setting associated with that configuration keyword.
Comments may appear anywhere within the element. Comment lines begin with a period ("."). A comment may follow a setting by placing a space-period sequence (" .") just after the value portion of the setting. Leading and trailing spaces are ignored, so individual configuration lines may be indented for additional clarity.
The first line in the configuration file is: . Data Exchange Server Name. This comment line is followed by the configuration entry for one or more Data Exchange Director servers. Each configured Data Exchange Director server has an entry containing these required and optional configuration settings for that Director.
Table 10. Configurations in CONFIG$ Element
| Configuration Keyword | Description |
DIRECTOR | This is the name of the Data Exchange Director. Example: D5159E. Note: For more information about the OS 2200 Director, see “Console Operations for Director and Agent”. |
PORT | This is the port number on which the Director listens on to talk to the Administration Service. The default port number is 5150. |
HOST | This setting provides the IP address that the Director uses in establishing a TCP/IP listening socket for network communication with other Data Exchange components. You can either specify an explicit IP address or use a name string that can be found using the 2200 system's host file or DNS service that returns the desired IP address. This allows you to have Data Exchange components follow your network guidelines for access and security. The HOST setting is optional. A default setting of * is used for HOST if not otherwise specified. |
| HOST = nnn.nnn.nn.nn . Utilize the specific IP address for network access. It may have specific customer access, performance conditions. | |
| HOST=XXXX.YYYY.UNISYS.COM. Use the hosts file or customer allowed DNS service to get an IP address. | |
| HOST=* . Use the simple OS 2200 system's host name, and find an IP address using the host file or customer allowed DNS service to get an IP address. | |
LOGFILES | The LOGFILES setting is a portion of the OS 2200 @CAT statement
as follows:@CAT,P FILE,value Where value can contain the OS 2200 command syntax (including commas) to allow specification of pack-ids. The LOGFILES setting is optional. A default setting of f2/10/TRK/500 is used for LOGFILES if not otherwise specified. |
LANGUAGE | The LANGUAGE setting is optional. A default setting of ENG is used for LANGUAGE if not otherwise specified. |
R_OPTION | This setting indicates the desired executing priority to set
for the Director or the Server when the R option letter is present
on their program invocation. The R_OPTION setting is optional. A
default setting of RT35 is used for R_OPTION if not otherwise specified. The values for this option can be any of the following: |
| RUN, indicates to leave the Director or server at its current executing priority (that is, at whatever priority the @RUN that invoked the program has established). | |
| RTnn, where nn is from 20 to 35, indicating to set the Director or server to a real time priority level of nn. | |
| TXN, indicates to set the Director or server to a transactional priority. | |
| USER, indicates to set the Director or server to a USER level of switching priority. | |
| DEMAND, indicates to set the Director or server to a DEMAND level of switching priority. | |
| BATCH, indicates to set the Director or server to a BATCH level of switching priority. | |
| 0nnnnnnnnnnnn, where 0nnnnnnnnnnnn is a specific switching priority level. (See your system administrator for details on Level$ switching levels). | |
S_OPTION | This setting indicates the desired executing priority to set
for the Director or other server when the S option letter is present
on their program invocation. S_OPTION can take one of the same values
as described for R_OPTION. The S_OPTION setting is optional. A default setting of TXN is used for S_OPTION if not otherwise specified. |
T_OPTION | This setting indicates the desired executing priority to set
for the Director or other server when the T option letter is present
on their program invocation. T_OPTION can take one of the same values
as described for R_OPTION. The T_OPTION setting is optional. A default setting of TXN is used for T_OPTION if not otherwise specified. |
MAX_QB_QENTRIES | This parameter specifies the maximum number of active QBANKs. A QBANK is created to package data capture records from audit trail for transport to DE Runtime Service or Runtime Service in all instances. Once a QBANK is full, it is closed and sent to Runtime Service and another QBANK is obtained for the next lot of data capture records. Until the OS 2200 Agent receives acknowledgement of a successful QBANK delivery from DE Runtime Service, the QBANK remains active. This is a required parameter. The minimum value for MAX_QB_QENTRIES is 4 and maximum is 20; the recommended initial value is 4. |
MAX_AT_SECS | This parameter specifies the duration the OS 2200 Agent will have to wait for the available QBank if all QBanks are in use. if none becomes available, the OS 2200 Agent will terminate. This is a required parameter. The minimum value for MAX_AT_SECS is 1 second and maximum is 3,600 seconds; the recommended initial value is 30 seconds. |
MAX_QB_RCVTIMEO | This parameter specifies the number of seconds the OS 2200 Agent will wait for QBANK delivery acknowledgement from DE Runtime Service. Its value should be set to a value higher than MAX_AT_SECS to minimize the chances of the OS 2200 Agent terminating. If MAX_QB_ RCVTIMEO is set to its maximum value of 262,143 seconds, the OS 2200 Agent will wait indefinitely for QBANK delivery acknowledgement. This is an optional parameter, if not specified, MAX_QB_ RCVTIMEO will default to 60 seconds. The minimum value for MAX_QB_ RCVTIMEO is 1 second and maximum is 262,143 seconds. |
CDT_SCHEMA_NAME | This parameter is used to specify an Application Group and RDMS schema name with which you want to filter the FSAH audit trail records. Each director in CONFIG$ can specify one schema filter for each Application Group on your system. Provide the value for this parameter in the following format :The format of the CONFIG$ parameter is: CDT_SCHEMA_NAME=<Application Group Name>.<RDMS Schema Name> For example, DIRECTOR=D5159E .....CDT_SCHEMA_NAME=APP01.Sch01. Here, for the Director D5159E, in Application Group APP01, audit trail records will be processed only for the schema APP01.Sch01. You can specify only one schema per Application Group. If the CONFIG$ contains more than one entry for a given Application Group then only the schema in the last entry for that Application Group will be used. |
FSAH_MIN_ WAIT_TIME | This parameter specifies the minimum amount of time (in milliseconds) for which the Agent will wait when there is no data available in the audit trial, before checking for new records in the audit trail. This is an optional parameter. If not specified, FSAH_MIN_WAIT_TIME defaults to 100 milliseconds. |
FSAH_MAX_ WAIT_TIME | This parameter specifies the maximum amount of time (in milliseconds) for which the Agent will wait when there is no data available in the audit trial. This is an optional parameter. If not specified, FSAH_MAX_WAIT_TIME defaults to 14700 milliseconds. |
FSAH_SAFE_READ_FENCE | If the FSAH_SAFE_READ_FENCE parameter is ON, the audit read will return only completely written audit blocks. The default value for this parameter is ON. If the parameter is set to OFF, FSAH reads as much of the audit as it can. Notes:
|
A sample Director entry can be as follows:
DIRECTOR=D5159E
HOST=192.61.nnn.nn
PORT=5159
LOGFILES=F2/10/POS/50 . Pre-allocate 10 positions of file space.
R_OPTION=RT35
S_OPTION=TXN
T_OPTION=USER
CDT_SCHEMA_NAME=APP001.RDMSSchName