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.
HANDLE AID is used 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 cause an AID to be ignored, 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 AIDs 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.
No more than 16 options are allowed in the same command.
The C language does not support HANDLE AID.
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 may 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 execution key that the label receives control in, is 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