Dead-Letter Queue Messages workspace
IBM® MQ (WebSphere® MQ) puts a message on the Dead-Letter Queue when it cannot be delivered to the requested destination queue. This can occur for various reasons, such as the message being too long, the destination specified in its queue name field being invalid, or the queue being full. Use the Dead-Letter Queue Messages workspace to view the status of dead messages and forward them to the desired location.
Predefined views
The Dead-Letter Queue Messages workspace includes the following predefined views:
- Dead-Letter Queue Messages This view supplies the following information about
undeliverable messages:
- The name of the application that created the message, the message itself, and the message's original time stamp and intended destination.
- A reason code, which indicates why the message was not delivered.
- The time that the message was put onto the DLQ.
- Whether the message has been segmented, is part of a group or both, and, if it is part of a group, the GroupID.
From this view, you can delete or resend dead messages, forward them to different destinations, or link to other workspaces to view message header information or message application data.
Note that if you delete or forward a group or segmented message, all messages belonging to the group or logical message will be deleted or forwarded.
Note that when using IBM MQ (WebSphere MQ) for Windows, the DLQ Appl Type attribute, which indicates the processing platform on which the queue manager is running, always has a value of MQPL_WINDOWS_NT.
- Dead Letter Queue Messages Summary This view shows, as a bar chart, the current depth of the dead-letter queue running on the selected queue manager, in comparison to its maximum depth.
For more information on the attributes listed in the tables of this workspace, see Message Summary attributes.
Predefined links
You can link to the following workspaces from the Dead-Letter Queue Messages workspace:
- Message Descriptor
- Message Contents