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.

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

The WebSphere MQ System Administration Guide or the System Management Guide for your platform explains how the dead-letter handler works, and how you run it.

 

Parent topic:

Sample programs (all platforms except z/OS)

fg17920_