IMS Connect dead letter queue (HWS$DLQ)

In certain instances, if OTMA receives a NAK response from IMS Connect, OTMA stores the undelivered message on the IMS Connect dead letter queue. The IMS Connect dead letter queue is identified by the tpipe name HWS$DLQ.

The instances in which OTMA stores messages on HWS$DLQ include:
  • When IMS Connect returns a NAK response to OTMA for a message that is missing the user data section of the OTMA header. In this case, IMS issues message HWSD0255W.
  • When IMS Connect returns a NAK response to OTMA because IMS Connect could not process an asynchronous callout request. In this case, IMS issues message HWSP1510E.

Except in the case where a message has no user data section, you can retrieve messages on HWS$DLQ by specifying HWS$DLQ as the alternate client ID on the RESUME TPIPE call. Messages on HWS$DLQ that are missing the user data section of the OTMA header must be dequeued before subsequent messages on the queue can be retrieved.

To dequeue a message from HWS$DLQ:

  1. Stop HWS$DLQ by issuing the command /STOP TMEMBER tmembername TPIPE hws$dlq.
  2. Dequeue the message by issuing the command /DEQUEUE TMEMBER tmembername TPIPE hws$dlq PURGE1.
  3. Start HWS$DLQ by issuing the command /START TMEMBER tmembername TPIPE hws$dlq.

To view the queue counts for HWS$DLQ issue the command /DISPLAY TMEMBER tmembername TPIPE hws$dlq.