Invoking the dead-letter queue handler

Invoke the dead-letter queue (DLQ) handler using the runmqdlq control command. You can name the DLQ you want to process and the queue manager you want to use in two ways.

Before you begin

To run the DLQ handler you must be authorized to access both the DLQ itself and any message queues to which messages on the DLQ are forwarded. For the DLQ handler to put messages on queues with the authority of the user ID in the message context, you must also be authorized to assume the identity of other users.

About this task

The following examples apply to the DLQ called ABC1.DEAD.LETTER.QUEUE, owned by the queue manager ABC1.QUEUE.MANAGER.

If you do not specify the DLQ or the queue manager as shown, the default queue manager for the installation is used along with the DLQ belonging to that queue manager.

The runmqdlq command takes its input from stdin. You associate the rules table with runmqdlq by redirecting stdin from the rules table.

For more information about the runmqdlq command, see runmqdlq.

Procedure

You can name the DLQ and the queue manager as parameters to the runmqdlq command.
For example, from the command prompt:
```
runmqdlq ABC1.DEAD.LETTER.QUEUE ABC1.QUEUE.MANAGER <qrule.rul
```
You can name the DLQ and the queue manager in the rules table.
For example:
```
INPUTQ(ABC1.DEAD.LETTER.QUEUE) INPUTQM(ABC1.QUEUE.MANAGER)
```