Queue Messages with DLQ Header workspace

The Queue Messages with DLQ Header workspace enables you to browse messages with DLQ headers located in the selected queue that are not in the dead letter queue for a queue manager and delete or forward them to another destination. To access this workspace, do the following steps:
  1. Open the Queue Definitions workspace (or Queue Statistics workspace)
  2. Right-click a row in the Queue Definitions table (or Queue Statistics table) and select Link To > Queue Messages with DLQ Header from the menu.
After you confirm that you want to delete or forward a message, a return code and message display. Zero indicates successful completion. Non zeros indicate a problem. For an explanation of non-zero return codes, refer to the reason code information in the IBM MQ documentation. This type of information used to be covered in the Application Programming Reference book.

Deleting a message with DLQ Header

Use this procedure to delete a message with DLQ header from the selected queue:
  1. Within the Queue Messages with DLQ Header workspace, right-click the message that you want to delete.
  2. Select MQ Commands > Delete from the menu.
  3. A confirmation window appears, asking if you want to delete the message. Click Yes to delete the message.
  4. The status of your delete request appears. The return code zero indicates successful completion. Non zeros indicate a problem.
  5. Click OK to close the status window.

Forwarding a message with DLQ header to another destination

Use this procedure to forward a message with DLQ header to another destination:
  1. In the Queue Messages with DLQ Header workspace, right-click the message that you want to forward.
  2. Select MQ Commands > Forward from the menu.
  3. Enter the name of the destination queue and that of its queue manager in the window and click Yes.
  4. The status of your forwarding request appears. The return code zero indicates successful completion. Non zeros indicate a problem.
  5. Click OK to close the status window.

Predefined views

The Queue Messages with DLQ Header workspace includes the following predefined view:
  • Messages with DLQ Header This view gives you an overview of messages with DLQ Header.
  • Message Log The message log gives you an overview of changes in the status of your monitored system. It also provides information about the status of monitoring agents and other system events. For more information about this view, see Tivoli Enterprise Portal Help.

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 Queue Messages with DLQ Header workspace:

  • Message Descriptor
  • Message Contents

Accessing this workspace

Link to this workspace in one of the following ways:

  • In the navigator view of the selected queue manager, right click a row in the Queue Definitions table (or Queue Statistics table), and then select Link To > Queue Messages with DLQ Header from the menu.
  • In the following workspaces, right click a row in the table and click Link To > Queue Messages with DLQ Header:
    • Queue Definitions
    • Queue Definitions for Alias Queues
    • Queue Definitions for Cluster Queues
    • Queue Definitions for Local Queues
    • Queue Definitions for Model Queues
    • Queue Definitions for Local Queues
    • Queue Definitions for Predefined Queues
    • Queue Definitions for Remote Queues
    • Queue Definitions for Temporary Dynamic Queues
    • Queue Statistics for Monitored Open Queues
    • Queue Statistics for Monitored Permanent Dynamic Queues
    • Queue Statistics for Monitored Predefined Queues
    • Queue Statistics for Monitored Queues with Messages
    • Queue Statistics for Monitored Temporary Dynamic Queue
    • Queue Statistics for Monitored Transmission Queues
    • Queue Statistics