Handle attention identifiers (AIDs).
HANDLE AID .--------------------------. V | >>-HANDLE AID----+----------------------+-+-------------------->< +-ANYKEY-+---------+---+ | '-(label)-' | +-CLEAR-+---------+----+ | '-(label)-' | +-CLRPARTN-+---------+-+ | '-(label)-' | +-ENTER-+---------+----+ | '-(label)-' | +-LIGHTPEN-+---------+-+ | '-(label)-' | +-OPERID-+---------+---+ | '-(label)-' | +-PA1-PA3-+---------+--+ | '-(label)-' | +-PF1-PF24-+---------+-+ | '-(label)-' | '-TRIGGER-+---------+--' '-(label)-'
Condition: INVREQ
This command is threadsafe.
You can use the HANDLE AID command to specify the label to which control is to be passed when an AID is received from a display device. Control is passed after the input command is completed; that is, after any data received in addition to the AID has been passed to the application program.
To ignore an AID, issue a HANDLE AID command that specifies the associated option without a label. This deactivates the effect of that option in any previously-issued HANDLE AID command.
If no HANDLE AID commands are in effect, that is, none have been issued or all have been canceled, control returns to the application program at the instruction immediately following the input command. Look in EIBAID to determine which key was pressed.
You cannot include more than 16 options in the same command.
If a task is initiated from a terminal by means of an AID, the first RECEIVE command in the task does not read from the terminal but copies only the input buffer (even if the length of the data is zero) so that control can be passed by means of a HANDLE AID command for that AID.
For the standard attention identifier list (DFHAID), and the standard attribute and printer control character list (DFHBMSCA), see BMS-related constants.
The label receives control in the same execution key as the execution key that the program was running in when the HANDLE AID command was issued.
A print key specified by the system PRINT initialization parameter takes precedence over a HANDLE AID command.
Default action: terminate the task abnormally.
EXEC CICS HANDLE AID PA1(LAB1)
ANYKEY(LAB2) PF10