The dead-letter queue handler utility (CSQUDLQH) on z/OS®

You can use the default dead-letter utility (CSQUDLQH) to handle message written to the dead-letter queue.

A dead-letter queue (DLQ) is a holding queue for messages that cannot be delivered to their destination queues. Every queue manager in a network can have an associated DLQ.

Queue managers, message channel agents, and applications can put messages on the DLQ. All messages on the DLQ can be prefixed with a dead-letter header structure, MQDLH. Messages put on the DLQ by a queue manager or by a message channel agent always have a dead-letter header; ensure that applications putting messages on the DLQ also supply a dead-letter header structure. The Reason field of the MQDLH structure contains a reason code that identifies why the message is on the DLQ.

Implement a routine that runs regularly to process messages on the DLQ. Such a routine is called a dead-letter queue handler. IBM® MQ supplies a default dead-letter queue handler (DLQ handler) called CSQUDLQH. A user-written rules table supplies instructions to the DLQ handler, for processing messages on the DLQ. That is, the DLQ handler matches messages on the DLQ against entries in the rules table. When a DLQ message matches an entry in the rules table, the DLQ handler performs the action associated with that entry.