IMS Version 9

Command Responses to OM

When an IMSplex command or IMS classic command is issued from the OM API, OM routes it to one or more IMS systems based on the command routing. Each IMS returns the command response to OM. The command responses from each IMS are grouped together by OM and returned to the caller.

For each IMS command that is issued from OM API, the response is encapsulated in XML tags. For a list of XML tags used, an explanation of the format, and meaning of the tags, see IMS Version 9: Common Service Layer Guide and Reference.

The IMSplex command responses to OM also include a return code, reason code, and a possible completion code. The OM return and reason codes can be found in the 'CSLOMCMD Return and Reason Codes' table in the IMS Version 9: Common Service Layer Guide and Reference.

When the following classic commands are issued from OM API, the DFS058I COMMAND IN PROGRESS message is not returned. Instead, the messages that result as a part of command processing are returned to OM. Following is the list of commands that do not return the DFS058I COMMAND IN PROGRESS:

Command Responses

|With the exception of the /DISPLAY command, /FORMAT command, and type-2 commands returned through the OM API, |responses to IMS commands are prefixed by the letters DFSnnn; nnn identifies the message. For information about the messages, |see IMS Version 9: Messages and Codes, Volume 1. A response to an IMS command |is an acknowledgment from IMS to the originating terminal that the |command has been received. Responses that go to the system console |have an IMS ID identifying the IMS system that issued the message. |For example, the response to /DBDUMP DATABASE MSDB would be: |

|
DFS058I (time stamp) DBDUMP COMMAND IN PROGRESS  (IMS id)

At system definition, the TIMESTAMP/NOTIMESTP parameter of the COMM macro determines whether the time stamp is present or absent. If the time stamp feature is included, the date and time of the response appear between the response prefix and the text.

|The DFS058 COMMAND COMPLETED/IN PROGRESS response indicates whether IMS accepted the command. If some |parameters of the command are not accepted, the response includes |the EXCEPT phrase and indicates the parameters that were not accepted. If |IMS does not have the space for all of the not-accepted parameters, |it truncates the EXCEPT phrase and terminates it with ...etc.. Commands that specify the ALL parameter are most likely |to be truncated. Truncated EXCEPT phrases on commands are normally caused by: |

|

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004