CALL (calling external CICS programs and transactions)

The CALL command calls a CICS transaction or program with optional parameters.

The format of the CALL command is one of the following:
CALL cicstran [optional parameters…]
 
CALL PROGRAM cicsprog [optional parameters…]
Note: CICS can be used as a synonym for CALL.

cicsprog
Is a program ID that must be defined to CICS.
cicstran
Is a transaction ID that must be defined to CICS.

The parameters are passed as a TIOA area, so anything that can be entered at the transaction's or program's initial screen can be specified as an optional parameter. There is no validation of the optional parameters.

For transaction calls, the transaction ID is placed as the first field in the constructed TIOA (as it would be from the terminal). Make sure the transaction is defined as conversational. Pseudo- or nonconversational programs return immediately to COD0.

For program calls, you must enter the transaction ID as the first parameter, if the program you are calling expects this.

While the task is running, all the facilities of that CICS transaction or program are available to you. When you end the task, you return to COD0.

Note: You should not attempt to call:
  • The COLU transaction, which is used by CICSPlex SM
  • CICSPlex SM programs, which begin with the letters 'EYU'


eyus1d4.html | Timestamp icon Last updated: Monday, 5 June 2017