Terminal connects to a TOR which routes the application to an AOR; debugging profiles managed by DTCN
In this scenario, your terminal (TRMC) connects to a TOR, which uses a CICS® transaction to route the application you want to debug to an AOR. The debugging profiles are managed by DTCN and are stored in a temporary storage queue (EQADTCN2) located in a queue-owning region (QOR). You can run the DTCN transaction in any of the regions.
.---------------. .---------------. .---------------. | 3270 terminal | | 3270 terminal | | 3270 terminal | | | | | | | | TRMA | | TRMB | | TRMC | '------,--------' '-------,-------' '-,-------------' | | | | | | '-----------------, | ,-----------' | | | | | | .---'----'---'--. | | | TOR | | | '---.---,---.---' | | | | | | ,------' | '------, | | | .-------'-------. | .------'--------. | AOR | | | AOR | | | | | | | CICSAOR1 | | | CICSAOR2 | | | | | | '---------------' | '---------------' | | | | | | '------, | ,------' | | | .---'---'----'----. | QOR | | EQADTCN2 | '-----------------'
For this scenario to work, the CICS system administrator must complete the following tasks for both AORs and the TOR:
- Define z/OS® Debugger resources in the CICS CSD and install them in the CICS region, as described in Adding support for debugging under CICS, step 1.
- Provide access to these resources, as described in Adding support for debugging under CICS, step 2.a.
- Designate a single CICS region as the QOR and define the queue accessible remotely, as described in Sharing DTCN debug profile repository among CICS systems.
Variation on this scenario: The temporary
storage queue (EQADTCN2) does not need to be located in a QOR. It
can be located in the TOR, any of the AORs, or in the coupling facility.
Wherever you put the temporary storage queue, keep the following considerations
in mind:
- Place the queue where it can be accessed efficiently when the application programs begin, since it is referenced at that point to determine whether the program should be debugged.
- The temporary storage queue is accessed by Function Shipping, so allocate a sufficient number of connections between the regions to handle READQ requests.