IBM MQ Console: Working with queues

You can view the queues that exist for a specific queue manager in the Queues tab. You can add and delete queues, add and clear messages on a queue, browse messages, view and set the properties of a queue, and manage the authority records of a queue.

• To add a queue:
  1. In the Queues tab, click the create button .
  2. Select the type of queue that you want to create:
     • Local queue - store messages within the queue manager it belongs to.
     • Alias queue - a pointer to another queue on the same queue manager.
     • Remote queue - a pointer to another queue on a different queue manager.
     • Model queue - a template for a queue used when a dynamic queue manager is created.
  3. Provide the required information for the type of queue you are creating. By default the minimum recommended properties are displayed for you to provide values for. You can view all of the available properties by selecting Custom create.
  4. Click Create. The new queue is created.
• To put messages to a queue:
  1. Click the queue that you want to add messages to in the list in the queues list view. You cannot select a model queue.
  2. Click the Create button
  3. Enter the message that you want to put onto the queue.
  4. Click Create.
• To clear messages from a queue:
  1. Click the local queue that you want to clear messages from in the queues list.
  2. Click the Clear queue icon
  3. Confirm that you want to clear the queue by clicking Clear queue.
• To copy all messages from one queue to another queue:
  1. Click the local queue that you want to copy messages from in the queues list.
  2. Click the Copy messages icon .
  3. Select the queue that you want to move the message to and click Copy messages. You are told how many messages have been copied.
• To move all messages from one queue to another queue:
  1. Click the local queue that you want to move messages from in the queues list.
  2. Click the Move messages icon .
  3. Select the queue that you want to move the message to and click Move messages. You are told how many messages have been moved.
• To delete an individual message from a queue:
  1. Locate the message that you want to delete.
  2. Click the menu icon next to the message and select Delete.
  3. Confirm that you want to clear the message by clicking Delete.
• To move an individual message to a different queue:
  1. Locate the message that you want to move.
  2. Click the menu icon next to the message and select Move.
  3. Select the queue that you want to move the message to and click Move message.
• To copy an individual message to a different queue:
  1. Locate the message that you want to move.
  2. Click the menu icon next to the message and select Copy.
  3. Select the queue that you want to copy the message to and click Copy message.
• To browse messages on a queue, click on the queue in the queues list view. A list of the messages on that queue is displayed, and you can select a message to view its properties.
  

  The properties are displayed in tabs. The tabs displayed depend upon the properties that are present. You can use the Show MQRFH2 Structure control to toggle between displaying MQRFH2 message headers in a dedicated MQRFH2 properties tab or in the Named properties tab.

• To delete a queue:
  1. Click on the local queue that you want to delete in the queues list.
  2. Click the Actions button and select Delete queue.
  3. Confirm that you want to delete the queue by clicking Delete. The queue is deleted.
• To view and edit the properties of a queue:
  1. Select View configuration from the menu next to the queue that you want to edit.
  2. Click the Edit button
  3. Edit the properties as required. If the property text box is disabled, the property is read-only, or can be edited only from the command line. For information about the properties, see Queue properties in the IBM® MQ Explorer documentation
  4. Click Save to save your changes.
• To view and edit authority records for a queue:
  1. Select View configuration from the menu next to the queue that you want to edit.
  2. Click the Security tab.
  3. Work with the authority records as described for queue manager authority records. See IBM MQ Console: Working with queue manager authority records.
• To view the IBM MQ objects associated with a queue:
  1. Select View associated objects from the menu next to the queue that you want to view.
  2. View the objects in the panel that appears. Click the links to view more details about each of the listed objects.
  You can use the panel to view which applications are putting messages on queues and see the relationships between different queues. This can help you to identify and resolve issues.