Managing the retrieval of output messages

When retrieving either asynchronous output messages or synchronous callout request messages with the RESUME TPIPE call, you have options regarding how messages are returned.

You specify your retrieval options in the IRM of the RESUME TPIPE request message and the user message exit sets the options in the OTMA header.

The retrieval options that you can specify include:

• Single
• Single with wait
• Noauto
• Nooption
• Auto

The IMS Connect user message exits HWSSMPL1 and HWSSMPL0 support all these options. To choose a type of message control, the client code sets the IRM field IRM_FLG5 to be one of the following values:

IRM_F5_ONE

Retrieves a single message (single).

IRM_F5_SWAIT

Waits for a single message if none are currently present in the IMS message queue (single with wait).

IRM_F5_NOAUTO

Retrieves all messages that have been queued (noauto).

IRM_F5_AUTO

Retrieves all messages that have been queued, then retrieves any additional messages that are queued later (auto).

IRM_F5

Makes a RESUME TPIPE call function like NOAUTO (nooption) when set to X'00'.

The HWSSMPL0 and HWSSMPL1 user message exits default to the noauto type of asynchronous output message management.

The following subsections describe the asynchronous output message control options in detail.