Define - CICS Interface Details

From the Define - Interfaces: CICS page, click Add or double-click an existing CICS interface, and then the CICS Interface Details page is displayed.

The following table describes the items that are available on the CICS Interface Details page:

Item Description
Name Type a CICS interface name.
Description Type a short description for the CICS interface.
Interface ID Type the interface identifier, which is the internal interface name for Substation ES.
Output Interface Type an output interface, or click the icon to select one.
CICS Endpoint Type a CICS endpoint, or click the icon to select one.
Mirror Transaction ID Type the Mirror Transaction name in the CICS online region.
User ID Type the default user identifier with which the CICS interface establishes connections and initializes Substation ES components in the CICS Region.

This user ID is only used on administrative and trigger calls into the specific CICS region.

In the Activate Triggers area, the following items are available:
Ordered If you want to activate Ordered Delivery Trigger Events for outbound messages, select this check box.
Request/Reply If you want the CICS initiated request or reply facility resources to be activated by Substation ES, select this check box.
In the Workers area, the following two items are available:
ESB Request/Reply Enter the number of concurrent DPL CICS sessions that are started to service Substation ES requests. Valid values for this field are in the range 1 - 40.
Triggers In the Guaranteed field, enter the number of concurrent HVT guaranteed trigger sessions that will be created and available for offload processing.

In the Reliable field, enter the number of concurrnet HVT reliable trigger sessions that will be created and available for offload processing.

CICS Request/Reply Max Size Enter the maximum allowable size for outbound data requested by Substation ES from the messages that are written to the trigger TDQ. If a message with a larger size is written to the trigger TDQ, the message is truncated to the size specified here.
Loopback Loopback is 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. It can be set to Yes or No.
Note: Do not change this value unless requested by TIBCO Support.
Trace Level: Trigger Enter the trace level of the CICS interface when tracing trigger entries that pass through the interface,

where:

  • 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.

The default value is 0, which disables the tracing of trigger entries on the IMS interface.

In the TSQ Processing area, the following items are available:
Batching Select whether the CICS HV TSQ Reliable trigger process batches the TSQ extracts from the CICS region when RRMS is enabled for this CICS region. It must only be set to YES when the TSQ volumes are very high; otherwise, it adds unnecessary overhead.
Workers Enter the number of concurrent HV TSQ Reliable trigger sessions that are created and available for off-load processing.

Valid values for this field are in the range 0 - 6.

The default value is 0, which means no HV TSQ Reliable sessions are started.

Batch Size Enter the number of CICS HV TSQ reliable trigger process records that are in the batch when a commit is issued. Valid values for this field are in the range 5 - 2048.

The default value is 50.

Trace Level: TSQ Enter the trace level of the CICS interface when tracing reliable TSQ trigger entries that pass through the interface. Valid values for this field are in the range 0 - 3.

The default value is 1.