Responses to commands

The execution of a command with an ICMD call might result in a response that comprises one or more segments. The response is similar to that received by a terminal operator upon entering the same command. The maximum size of the response returned by IMS to the AO application is 132 bytes (including the 4-byte LLZZ field). DFS messages that are the initial response to the command are time-stamped even if the NOTIMESTP keyword is coded on the COMM macro.

No response segments

This condition is indicated when AIB return and reason codes are zero and the length of the message returned is zero. These indicators tell you execution of the command was successful or is in progress and would have resulted in one of the following command responses had the command been entered from a terminal:

DFS058 XXX COMMAND COMPLETED (No EXCEPT phrase)
DFS058 XXX COMMAND IN PROGRESS.

where XXX is the command issued by the automated operator.

When DFS058 COMMAND COMPLETED is issued, no exceptional conditions are reported.

When DFS058 COMMAND IN PROGRESS is issued, one or more additional messages are issued to indicate whether the command was successful. These messages are sent to the master terminal rather than to AOI. Commands such as /DBDDUMP, /DBRECOVERY, /START DATABASE, /STOP DATABASE, and /SSR can result in message DFS058, followed by one or more asynchronous messages. Asynchronous messages are not returned as responses to the AO application.

Response segments

Response segments are identical to the response to a command entered by the operator, with preceding LLZZ and carriage control (optional) and trailing carriage controls (optional). Command responses not retrieved by an RCMD call are discarded on the next ICMD call.