# Substation ES CICS Region Resources

Substation ES CICS resources are defined at installation and used by Substation ES during execution.

For a description of the Substation ES CICS IVP resources, see "Sample IVP Resources" in the TIBCO Substation ES Configuration and Resources manual.

## Connections

Connections, which are defined as External CICS Interface (EXCI), enable communication between the Substation ES region and Substation ES CICS servers and resources.

A CICS resource can connect to 1 to 8 Substation CICS interfaces (either in the same Substation ES or different ones).

The following table lists and describes CICS connections:

CICS Connections
Connection | Description
--- | ---
`SXCA` | The Administrative sever connection.
`SXCD` | The Dynamic Program Link (DPL) server and application program connection.
`SXCT` | The trigger server connection for requests initiating from within the CICS region.

## Tasks

A Substation ES region invokes tasks through an EXCI connection. Those tasks communicate with internal Substation ES CICS servers or task definitions in the CICS region to invoke Substation ES CICS servers or programs.

The following table lists and describes CICS tasks:

CICS Tasks
Task | Description
--- | ---
`SXBX` | The CICS mirror transaction used by a Substation ES region to invoke programs that utilize DSA storage below the 16 MB line. This task is typically used for older CICS programs that are nonreentrant. You can set the task on a recipe definition.
`SXEX` | The CICS mirror transaction used by a Substation ES region to invoke programs that use CICS extended storage. You can set the task on a recipe definition.
`SXPA` | The internal posting task by a High Volume Trigger (HVT) queue threshold event in a Substation ES CICS region.
`SXPG` | The internal posting task by a Guaranteed Trigger event in a Substation ES CICS region.
`SXPT` | The internal posting task by a Reliable Trigger event in a Substation ES CICS region.
`SXTD` | The Substation ES CICS sample program that displays the records on Dead Message Queue (DMQ) and that can delete and resend records.
`SXTE` | An internal task with which the Substation ES CICS region writes error messages to the queue task.
`SXTH` | The Substation ES CICS online help task, which shows Substation ES queue usages, error messages, and trigger and request or reply information.
`SXTO` | The internal Substation ES CICS-initiated request or reply timeout task.
`SXTS` | The task that invokes the Substation ES CICS startup program when the program list table (PLT) entries have not yet been installed.
`SXTU` | The task that invokes Substation ES CICS Token Storage Manager.
`SXTV` | The task that verifies and displays High Volume Trigger (HVT) queues.

## Programs

Substation ES region programs are invoked by tasks or linked to other programs in the CICS region. CICS programs are normally used internally, with the exception of the `SXCREQR` program, which is called by user applications during the CICS-initiated request or reply process.

The following table lists and describes CICS programs:

CICS programs
Program | Description
--- | ---
Administrative
`SXCOSRVA` | The Substation ES Administration server, which is called under the following conditions: At Substation ES startup for a sanity check During trigger processing At CICS shutdown At Substation ES termination
`SXCOSTRT` | The Substation ES startup program that is initiated by CICS at startup. This program must be defined to the CICS PLT startup routines.
`SXCOSHUT` | The Substation ES shutdown program that is initiated by CICS at shutdown. This program must be defined to the CICS PLT shutdown routines.
`SXCOHELP` | The Substation ES CICS program that provides help and displays information on Substation ES error messages and status. See Substation ES Operations for detailed information.
`SXCOERR` | The internal Substation ES CICS program that writes Substation's CICS region errors to an error queue file.
Server
`SXCOSRVD` | The Substation ES DPL server that is called when you must write to a queue, initiate a CICS task with data, or invoke a program to which to pass your data in `DFHCOMMAREA`.
`SXCOSRVG` | The Substation ES DPL server is called when you must invoke a program and pass it to a data area that is greater than 32 KB with Containers, Storage Pointer, or Temporary Storage Queue (TSQ).
`SXCOSRVT` | The Substation ES trigger server that is activated when a trigger record or a CICS-initiated request is to be processed by Substation ES.
Request or Reply
`SXCREQR` | The Substation ES CICS-initiated request or reply requester program to or from which is linked a user application for initiating a request and for receiving a user response. If an error occurs, this program can receive a Substation ES-defined nonzero return and reason code.
`SXCREPLY` | The Substation ES CICS-initiated request or reply program that must be invoked by Substation ES when a reply is received from a request initiated from a CICS application. The reply program checks the context information for validity, ensures that the CICS task is still running, and places the reply information of the user in the awaiting user program `DFHCOMMAREA`.
`SXCRRTO` | The Substation ES CICS initiated request or reply timeout program that monitors the timeout period of user programs that initiate a request from within CICS and that issues a terminate request if the timeout value is exceeded.
IO Routine
`SXCQWRIT` | The Substation ES HVT routine that is called if you must write a trigger record to the HVT queues.
CICS
`SXCCABND` | The internal Substation ES CICS program that performs program abend detection within the CICS region. This program recovers from User Program Abend with `SXCOABND` for large messages.
`SXCOABND` | The internal Substation ES CICS program that performs program abend handler within the CICS region. This program produces error messages for User Program Abend and cleans storage for large messages.
`SXCOEVPA` | The internal Substation ES CICS program that performs ECB posting of HVT queue threshold events within the CICS region.
`SXCOUPD` | The Substation ES CICS program that invokes Substation ES CICS Token Storage Manager.
`SXCOEVPE` | The internal Substation ES CICS program that performs ECB posting of Substation ES error events within the CICS region.
`SXCOEVPO` | The internal Substation ES CICS program that performs ECB posting of Substation ES-ordered events within the CICS region.
`SXCOEVPT` | The internal Substation ES CICS program that performs ECB posting of Substation ES events within the CICS region.
`SXCOEVPG` | The internal Substation ES CICS program that performs ECB posting of Substation ES-guaranteed events within the CICS region.
`SXCCODMQ` | The internal Substation ES CICS sample program that displays the records on DMQ and that can delete and resend records.
`SXC3VQUE` | The Substation ES CICS program that verifies and displays HVT Queues.

## Queues

Substation ES uses TDQs for certain processing requirements.

The following table lists and describes CICS Queues:

CICS Queues
Queue | Description
--- | ---
`SXQG` | The queue that holds guaranteed outbound trigger message records.
`SXQ0` through `SXQ9` | The queues that hold guaranteed outbound High Volume Triggers message records.
`SXQ$` | The queue that holds guaranteed retransmit trigger message records.
`SXQT` | The queue that holds reliable outbound trigger message records.
`SXQU`, ``SXQV``, `SXQW`, `SXQX`, `SXQY`, and `SXQZ` | The queues that hold reliable outbound High Volume Triggers message records.
`SXQ@` | The queue that holds reliable retransmit trigger message records.
`SXQE` | The queue that contains Substation ES CICS online error messages.
`SXQD` | The queue that holds outbound trigger records if Transformer cannot find a conversion definition or if the trigger message was not published during processing.
`SXQM` | The queue that holds a mirror copy of your trigger records after processing by Substation ES.
`SXQO` | The queue that holds ordered delivery, outbound trigger message records.

Copyright © TIBCO Software Inc. All rights reserved.