Dead-letter queue definitions


Warning icon No dead-letter queue is defined for <queue manager name>.

The dead-letter queue is the queue on which messages are put if they cannot be routed to their correct destination. By default, messages are put on this queue when they cannot be delivered to the destination queue.

IBM MQ Administering suggests that you create a local queue on each queue manager to be used as a dead-letter queue, so that messages that cannot be delivered to their correct destination can be stored for later retrieval.

However, using dead-letter queues can affect the sequence in which messages are delivered, so you might choose not to use them.

Error icon Dead-letter Queue attribute (<queue name>) might have incorrect capitalization

The queue manager Dead-letter Queue attribute specifies a queue that could not be found. A queue with a very similar name was found that is identical, except for the capitalization of one or more letters.

If a message is received but cannot be delievered, and no dead-letter queue is found, then the channel stops and the message remains on the transmission queue.

There might be an error in the value of the Dead-letter Queue attribute, or the intended dead-letter queue might be misnamed.

Error icon Dead-letter Queue attribute refers to a queue object that does not exist (<queue name>).

The queue manager Dead-letter Queue attribute specifies a queue that does not exist. If a message is received but cannot be delivered, and no dead-letter queue is found, the channel stops and the message remains on the transmission queue.

There might be an error in the value of the Dead-letter Queue attribute, or the intended dead-letter queue might be misnamed.

Error icon Dead-letter queue (<queue name>) defined for the queue manager is not a local queue .

The queue manager Dead-letter Queue attribute specifies a queue that is not a local queue. If a message is received but cannot be delievered and no dead-letter queue is found, the channel stops and the message remains on the transmission queue.

There might be an error in the value of the Dead-letter Queue attribute, or you need to re-create the intended dead-letter queue as a local queue.

Warning icon Dead-letter queue (<queue name>) has no dead-letter queue handler running.

The IBM MQ dead-letter queue handler can automatically perform actions on messages that arrive on the dead-letter queue based on a set of rules that are configured when the handler is started. For more information, see the IBM MQ Information Center.

No running handler could be detected for the dead-letter queue; this might be because no handler exists, or it might be because the handler is not currently running.

Error icon Channel (<channel name>) has a maximum message length (<number>) greater than the maximum message length (<number>) of the dead-letter queue (<queue name>).

If a message is too big for the dead-letter queue, the channel stops and the message remains on the transmission queue. The dead-letter queue must be big enough for the largest messages that the queue manager might have to handle, including the space required for the dead-letter header.

Warning icon Dead-letter queue (<queue name>) has a current depth of (<number>).

The presence of messages on the dead-letter queue is indicative of some problems with the IBM MQ environment, and must be further investigated.

Error icon Dead-letter queue (<queue name>) is full.

If a message is received but cannot be delievered, and the dead-letter queue is full, the channel stops and the message remains on the transmission queue. Process the messages on the dead-letter queue, or increase the maximum depth of the queue to allow more messages.

The presence of any messages on the dead-letter queue is indicative of a problem with the IBM MQ environment, and must be further investigated.

Error icon Dead-letter queue (<queue name>) is not put-enabled.

The queue manager Dead-letter Queue attribute specifies a queue that is not put-enabled, so messages cannot be put on the queue. If a message is received but cannot be delivered, and the dead-letter queue cannot be used, the channel stops and the message remains on the transmission queue.

Ensure that the queue is put-enabled, or select an alternative queue to be used as the dead-letter queue.