Dead-letter queue handler sample

A sample dead-letter queue handler is provided, the name of the executable version is amqsdlq. If you want a dead-letter queue handler that is different from RUNMQDLQ, the source of the sample is available for you to use as your base.

The sample is similar to the dead-letter handler provided within the product but trace and error reporting are different. There are two environment variables available to you:

ODQ_TRACE: Set to YES or yes to switch tracing on.
ODQ_MSG: Set to the name of the file containing error and information messages. The file provided is called amqsdlq.msg.

You need to make these variables known to your environment using either the export or set commands, depending on your platform; trace is turned off using the unset command.

You can modify the error message file, amqsdlq.msg, to suit your own requirements. The sample puts messages to stdout, not to the IBM® MQ error log file.

For more information on how the dead-letter handler works, and how you run it, see Processing messages on an IBM MQ dead-letter queue or the System Management Guide for your platform.