The TERMINAL macro
The TERMINAL macro identifies the remote CICS® system to IMS™. It is comparable to DEFINE CONNECTION in CICS.
- NAME=name
- Identifies the CICS node to IMS. It must be the same as the APPLID of the CICS system.
- OUTBUF=number
- Specifies the size of the IMS output buffer. It must be equal to or greater than 256, and should include the size of any function management headers sent with the data. It must not be greater than the value specified in the RECEIVESIZE option of the DEFINE SESSIONS commands for the intersystem sessions.
- SEGSIZE=number
- Specifies the size of the work area that IMS uses for deblocking incoming messages. We recommend that you use the size of the longest chain that CICS may send. However, if IMS record mode (VLVB) is used exclusively, you could specify the largest record (RU) size.
- MODETBL=name
- Specifies the name of the z/OS® Communications Server mode table entry to be used. You must omit this parameter if the CICS system resides in a different SNA domain.
- OPTIONS=[NOLTWA|LTWA]
- Specifies whether Log Tape Write Ahead (LTWA) is required. For LTWA, IMS logs session restart information for all active parallel sessions before sending a syncpoint request. LTWA is recommended for integrity reasons, but it can adversely affect performance. NOLTWA is the default.
- OPTIONS=[SYNCSESS|FORCSESS]
- Specifies the message resynchronization requirement following an abnormal session termination. SYNCSESS is the default. It requires both the incoming and the outgoing sequence numbers to match (or CICS to be cold-started) to allow the session to be restarted. FORCSESS allows the session to be restarted even if a mismatch occurs. SYNCSESS is recommended.
- OPTIONS=[TRANSRESP|NORESP|FORCRESP]
- Specifies the required response mode.
- TRANSRESP
- Specifies that the response mode is determined on a transaction-by-transaction basis. This is the default.
- NORESP
- Specifies that response-mode transactions are not allowed. In CICS terms, this means that a CICS application cannot initiate an IMS transaction by using a SEND command, but only with a START command.
- FORCRESP
- Forces response mode for all transactions. In CICS terms, this means that a CICS application cannot initiate an IMS transaction by using a START command, but only by means of a SEND command.
TRANSRESP is recommended.
- OPTIONS=[OPNDST|NOPNDST]
- Specifies whether sessions can be established from this IMS system. OPNDST is recommended.
- {COMPT1|COMPT2|COMPT3|COMPT4}={SINGLEn|MULTn}
- Specifies the IMS components
for the IMS ISC node. Up to
four components can be defined for each node. The input and output
components to be used for each session are then selected by the ICOMPT
and COMPT parameters of the SUBPOOL macro.
The following types of component can be defined:
- SINGLE1
- Used by IMS for asynchronous output. One output message is sent for each SNA bracket. The message may or may not begin the bracket, but it always ends the bracket.
- SINGLE2
- Each message is sent with the SNA change-direction indicator (CD).
- MULT1
- All asynchronous messages for a given LTERM are sent before the bracket is ended. The end bracket (EB) occurs after the last message for the LTERM is acknowledged and dequeued.
- MULT2
- The same as MULT1, but CD is sent instead of EB.
- SESSION=number
- Specifies the number of parallel sessions for the link. Each session is represented by an IMS SUBPOOL macro and by a CICS DEFINE SESSIONS command.
- EDIT=[{NO|YES}][,{NO|YES}]
- Specifies whether user-supplied physical output and input edit routines are to be used.