HANDLE AID

Handle attention identifiers (AIDs).

Read syntax diagramSkip visual syntax diagram
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.

 

Description

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.

The options that can be specified are:
  • ANYKEY (any PA key, any PF key, or the CLEAR key, but not ENTER)
  • CLEAR (for the key of that name)
  • CLRPARTN (for the key of that name)
  • ENTER (for the key of that name)
  • LIGHTPEN (for a light-pen attention)
  • OPERID (for the operator identification card reader, the magnetic slot reader (MSR), or the extended MSR (MSRE)
  • PA1, PA2, or PA3 (any of the program access keys)
  • PF1 through PF24 (any of the program function keys)
  • TRIGGER (for a trigger field attention)

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.

Conditions

INVREQ
RESP2 values:
200
The command was issued by a distributed program link server application.

Default action: terminate the task abnormally.

Examples

The following example shows a HANDLE AID command that specifies one label for the PA1 key; and a second label for CLEAR, PA2, PA3, and all the PF keys except PF10. If a PF10 AID is received or ENTER is pressed, control returns to the application program at the instruction immediately following the input command.
EXEC CICS HANDLE AID PA1(LAB1)
     ANYKEY(LAB2) PF10