CICS-Specific Parameters

The CICS-specific Parameters table lists the specific and advanced parameters for Substation ES CICS. Change these parameters only if you are knowledgeable about the system or if you are assisted by a Substation ES representative.

Note: If you change the values of these parameters, you must also make corresponding changes in the CICS Resource definitions supplied by the installation.
CICS-Specific Parameters
Parameter Description
MIRROR-TRAN = {SXEX | name} The MIRROR-TRAN parameter specifies the Mirror Transaction name in the CICS online region.

The default name is SXEX.

A-NODENAME = {SXCSSADM | name} The A-NODENAME parameter defines the node name on the CICS Connection resource for the administrative services of Substation ES. The resource definitions are supplied on the product installation media by default. The default name is SXCSSADM.
T-NODENAME = {SXCSSTRG | name} The T-NODENAME parameter defines the node name on the CICS Connection resource for the trigger event services of Substation ES. The resource definitions are supplied on the product installation media by default. The default name is SXCSSTRG.
QNAME-TGDQ = {SXQG | name} The QNAME-TGDQ parameter defines the name of CICS TDQ to which records are written for guaranteed outbound triggered messages. The default name is SXQG.
QNAME-TRDQ = {SXQT | name} The QNAME-TRDQ parameter defines the name of CICS TDQ to which records are written for reliable outbound triggered messages. The default name is SXQT.
WORKERS = {5 | number} The WORKERS parameter specifies the number of concurrent DPL CICS sessions that are started to service Substation ES requests. The valid values range from 1 through 40.
HVS-BATCH-YN = {N | Yes, No} The HVS-BATCH-YN parameter specifies whether the CICS HV TSQ Reliable trigger process will batch the TSQ extracts from a CICS region when the RRMS is enabled for this CICS region.

The HVS-BATCH-YN parameter should only be set to YES when the TSQ volumes are very high. Otherwise, it adds unnecessary overhead.

HVS-BATCH-SIZE = {50 | number} The HVS-BATCH-SIZE parameter specifies the number of CICS HV TSQ reliable trigger process records that will be in the batch when a commit is issued. The valid values range from 5 to 2048. The default value is 50.
HVS-WORKERS = {0 | number} The HVS-WORKERS parameter specifies the number of concurrent HV TSQ reliable trigger sessions that will be created and available for offload processing. The valid values are from 0 to 6.

If you do not specify a keyword and value, the default value of 0 applies and no HV TSQ reliable sessions are started.

HVT-G-WORKERS = {2 | number} The HVT-G-WORKERS parameter specifies the number of concurrent HVT guaranteed trigger sessions that will be created and available for offload processing. The valid values are 0 and 2 through 10.

If you do not specify a keyword and value, the default value of 0 applies and no HVT guaranteed sessions will be started.

HVT-R-WORKERS = {0 | number} The HVT-R-WORKERS parameter specifies the number of concurrent HVT reliable trigger sessions that will be created and available for offload processing. The valid values are 0 and 2 through 6.

If you do not specify a keyword and value, the default value of 0 applies and no HVT reliable sessions will be started.

TRIG-MIRROR = {N | Yes, No} The TRIG-MIRROR parameter specifies whether the records read from the trigger queue are mirrored to another queue. This parameter is used if other processes or systems want to process the same information that Substation ES has read and published to TIBCO messaging applications.

If the transaction fails when Substation ES reads a record from the trigger queue, no records are written to the mirror queue.

N means that trigger queue items are not mirrored; Y, otherwise. You must define and enable the TDQ named SXQM.

LOOPBACK = {N | Yes, No} The LOOPBACK parameter is mostly used in a QA and testing environment by TIBCO Support to determine whether the messages received by Substation ES are passed through to the CICS region. The keyword value is Y or N.
Note: Do not change this value unless requested by TIBCO Support.
TRCLVL-HVS = {1 | 0-3} The TRCLVL-HVS parameter specifies the trace level of CICS Interface when tracing reliable TSQ trigger entries that pass through the interface. The valid values range from 0 to 3. The default value is 1.
TRCLVL-TRIG = {0 | 0-3} The TRCLVL-TRIG parameter specifies the trace level of CICS Interface when tracing trigger entries that pass through the interface. The valid values are as follows:
  • Level 1 only traces an entry in the log file.
  • Level 2 dumps the buffer content in the trace file into the log file.
  • Level 3 includes all details from trigger processes in the trace file.

This parameter does not duplicate what is set on the trigger definition in the configuration file. The value on the trigger definition traces the trigger entry only when the ESB receives and processes it. The TRCLVL-TRIG parameter traces the entry as soon as the entry arrives in the Substation CICS Interface.

TRCLVL-ONL = {0 | 0-5} The TRCLVL-ONL parameter specifies the trace level of the messages produced by CICS resident programs that act on or on behalf of Substations ES. Messages are written to the CEEOUT and CEEMSG CICS output data sets.