Responses to commands

The execution of a command with a CMD 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 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 will be time-stamped even if the NOTIMESTP keyword was coded on the COMM macro.

No response segments

This condition is indicated by a PCB status of blanks, showing that the 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.

DFS058 COMMAND COMPLETED indicates that 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). A command might have executed successfully even though a non-blank PCB status code is returned. The status code CC indicates that one or more response segments have been produced, which occurs when a command partially executes. For example, the EXCEPT condition of this message might be returned as multiple segments.