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