Returning an error response to IMS

If an error occurs after the user-written IMS Connect client has already returned an ACK message to IMS Connect and either the IMS Connect client or the data or service provider cannot complete the callout request, the IMS Connect client can return an error response to IMS instead of the expected data.

To code an error response to a DL/I ICAL call:

Procedure

Specify the following field values in the IRM prefix of the error response:
  • IRM_ARCH = X'03' (IRM_ARCH3)
  • IRM_F0 = X'10' (IRN_F0_NAKRSN), if a NAK reason code is sent with the error response
  • IRM_F0 = X'20' (IRM_F0_SYNCNAK), if no NAK reason code is sent with the error response
  • IRM_NAK_RSNCDE = 2-byte hexadecimal extended error code
  • IRM_F4 = L (IRM_F4_SYNRESPA), if the client requires IMS to return an acknowledgment
  • IRM_F4 = M (IRM_F4_SYNRESP), if the client does not require IMS to return an acknowledgment
  • IRM_CORTKN = the 40-byte correlation token generated by the original DL/I ICAL call.