About the type-1 AO application program (GU, GN, CMD, and GCMD calls)
The Automated Operator Interface (AOI) consists of several IMS functions that allow installations to better monitor and control IMS activities. These functions can be used separately or in conjunction with user-written programs and the master terminal operator.
For example, one function includes a system definition option and an operator command that gives the master terminal operator more control of the command messages sent to the secondary master terminal.
An AO application can issue a subset of IMS commands normally reserved for the master terminal operator and receive responses to those commands by using the following DL/I calls:
- CMD (to issue commands and receive the first command response segment)
- GCMD (to receive subsequent command response segments)
If there are any response segments, the first is returned to the user's I/O work area. Subsequent segments are retrieved with GCMD. GCMD, similar to a get next (GN), places subsequent command response segments in the user's I/O work area.
The AO application receives control from IMS whenever a message with the correct transaction code has been queued for processing.
The following figure shows an AO application issuing a command with the CMD call (1) and receiving the initial response segment to the command (2). The AO application uses the GCMD call (3) to obtain additional response segments (4), if they exist.
Another AOI function lets an AO application retrieve messages. GU and GN calls retrieve messages. The retrieved message can be from either:
- A terminal from which the transaction was entered
- AO exit routine DFSAOUE0
An AO application using this function typically retrieves messages from the AO exit routine and then takes specific actions based on the content of the message.
