The sample DLQ handler, amqsdlq

In addition to the DLQ handler invoked using the runmqdlq command, WebSphere® MQ provides the source of a sample DLQ handler, amqsdlq, with a function that is similar to that provided by runmqdlq.

You can customize amqsdlq to provide a DLQ handler that meets your requirements. For example, you might decide that you want a DLQ handler that can process messages without dead-letter headers. (Both the default DLQ handler and the sample, amqsdlq, process only those messages on the DLQ that begin with a dead-letter header, MQDLH. Messages that do not begin with an MQDLH are identified as being in error, and remain on the DLQ indefinitely.)

MQ_INSTALLATION_PATH represents the high-level directory in which WebSphere MQ is installed.

In WebSphere MQ for Windows, the source of amqsdlq is supplied in the directory:


 MQ_INSTALLATION_PATH\tools\c\samples\dlq

and the compiled version is supplied in the directory:


  MQ_INSTALLATION_PATH\tools\c\samples\bin

In WebSphere MQ for UNIX and Linux® systems, the source of amqsdlq is supplied in the directory:

MQ_INSTALLATION_PATH/samp/dlq

and the compiled version is supplied in the directory:

MQ_INSTALLATION_PATH/samp/bin