Format of the request status message

The IMS Connect request status message (RSM) is returned as the only structure of an output message from the message exit if IMS Connect or the message exit determined an error occurred.

The following table shows the output message format of the request status message for an error condition. The table includes the field name, field length, field meaning.

Table 1. Request status message output message format
Field Length Meaning
RSM_LEN 2 bytes Length of RSM message
RSM_FLG1 1 byte Flag byte:
X'80'
Asynchronous message queued in IMS
X'40'
Conversational output message
X'20'
ACK/NAK required

RSM_RACFRC or
RSM_OTMRSN

1 byte

If this RSM is generated by a RACF® security error, this is the RSM_RACFRC field, which contains the return code from a RACROUTE REQUEST=VERIFY command.

Otherwise, this is the RSM_OTMRSN field, which contains a reason code from OTMA.

RSM_ID 8 bytes Character value of *REQSTS*
RSM_RETCOD 4 bytes Return code
RSM_RSNCOD 4 bytes Reason code