Methods of Invocation
The following table describes the constraints and usage of Substation ES methods of invocation in a CICSplex environment.
| Recipe MOI Selection | Constraints and Usage |
|---|---|
| 2 DPL (COMMAREA) | Can route to a dynamic or static AOR region.
Is limited to 32 KB data size for both input and output. Generates the least overhead. Uses DFHCOMMAREA for input and output. |
| 3 PGM (XTCL) |
Cannot dynamically route to an AOR. Substation ES uses a CICS XCTL, which is not routable. Issues a start transaction with DFHCOMMAREA. |
| 4 Task (Start Task) |
Can route to an AOR. Substation ES uses a CICS START, which is routable. Routes TRANID to the correct AOR according to CICS TDQ definitions. Uses Resource Name as the Tran ID in the CICS Start command and CommArea as the FROM data. Is limited to 32 KB data size for input. |
| 5 TDQ Write |
Can route to an AOR. Routes the TDQ to the correct AOR according to CICS TDQ definitions. Issues a write to TDQ. |
| 6 TSQ Write |
Can route to an AOR. Routes the TSQ to the correct AOR according to CICS TSQ definitions (TSMODEL). Is limited to one 32 KB record in TSQ. Writes Temporary Queue Records; the location of the TSQ can be any AOR. |
| 9 DPL MRO |
Can route to an AOR. Is limited to 32 KB data size for both input and output. Substation ES server issues a CICS LINK to Resource Name and CommArea is the FROM data. Uses DFHCOMMAREA for input and output. |
| 10 Container |
Can route to an AOR. Uses Containers for Input and Output so user data can be greater than 32 KB. The Substation ES server issues a CICS LINK or a CICS START TRAN using the Resource Name, and uses a single or multiple containers for data. When using a single container, the channel and container name can be set in the CICS panel of the recipe. The container invocation method, either Program or Transaction, can be set in the CICS panel of the recipe. |
| 11 Storage |
Cannot route to an AOR. The storage is in the Substation-Owning Region (SOR); AORs do not have visibility to that storage area. Uses Storage Pointers, which means this MOI cannot be routed. |
| 12 DPL TSQ |
Can route to an AOR. Routes the TSQ to the correct AOR according to the CICS TSQ definitions (TSMODEL). Segments data into multiple 32 KB records. Passes a Temporary Queue to the user program; the location of the TSQ and user program can be any AOR. |