HANDLEAID - IBM Mainframe

You can also use a HANDLE AID command to identify the attention key used (unless you are writing in C or C++, which does not support HANDLE AID commands). HANDLE AID works like other HANDLE commands; you issue it before the first RECEIVE command to which it applies, and it causes a program branch on completion of subsequent RECEIVEs if a key named in the HANDLE AID is used. No more than 16 options are allowed in the same command. If more options are needed then additional commands can be executed. In addition, if the print key function is specified in the CICS SIT (System Initialization Table) it then takes precedence over a HANDLE AID command.

If task initiation is invoked from a terminal by means of an AID, then the first RECEIVE command in the task reads data from the input buffer (even if the length of the data is zero) and not from the terminal, so that control can be passed through the use of a HANDLE AID command for that AID.

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. The C/370 language does not support HANDLE AID.

The syntax of the command is given below:

An example of the command is given below:

The following list is the possible options that can be specified:

  • 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)
  • 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)

The handle condition for HANDLE AID is INVREQ. It means that the command is not allowed for a distributed program link server program.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics