[UNIX, Linux, Windows, IBM i]

Collecting information for dead-letter queue problems

If an IBM® MQ queue manager is placing messages on its dead-letter queue (DLQ) on Multiplatforms, you might to collect troubleshooting information to help with finding a solution.

Before you begin

Before you start this task, answer the following questions about the problem:
  • What dead-letter queue problem did you observe on the system?
  • What time did the dead-letter queue problem start and when did it stop?
  • Where are the dead-letter messages coming from, and what is their intended route?

About this task

If the messages are going to the dead-letter queue right now, or if you can reproduce the problem that causes the messages to go there, you can generate data to provide more information about the problem.

After collecting the troubleshooting information, you can send it to IBM.


  1. Generate a trace of the queue manager while messages are going to the dead-letter queue:
  2. Browse the messages on the dead-letter queue using a sample program such as amqsbcg just before it is retrieved by the target application.
    For example, to browse messages on a queue called 'Target.Queue' on queue manager called 'QMA', enter this command:
    amqsbcg Target.Queue QMA > Target.Queue.browse.txt
    Place the browse output file, that is QMA.DLQ.browse.txt directly in the high-level error log directory, that is:
    • [Linux]var/mqm/errors on Linux.
    • [Windows]MQ_INSTALLATION_PATH\errors on Windows.
    Both the automatic and the manual collection processes described in Step 3 collect files found in this directory.
  3. Collect the IBM MQ data.
    You can collect do this either automatically or manually:
  4. Send the information that you have collected to IBM.

    A good description of the problem and the data is the most important information you can provide to IBM. Do not send data without providing a description!

    For FTP and email instructions, see Exchanging information with IBM Software Support.

    To open or update a case, go to the IBM My Support site.
    Note: Always update your case to indicate that data was sent.

    If you need to speak with IBM Software Support, contact your country representative. If you need to speak with IBM Software Support in the US, you can call 1-800-IBM-SERV.