[MQ 9.4.0 Jun 2024]

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.

About this task

The queues view lists the queues that exist for a specific queue manager. You access the queues list by clicking on a queue manager and selecting the Queues tab. You can select individual queues from the list to work with.

[z/OS]You cannot view or edit authority records for queues on z/OS®.

Procedure

  • To add a queue:
    1. In the Queues tab, click the create button shows 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 shows 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 shows the delete icon
    3. Confirm that you want to clear the queue by clicking Clear queue.
  • [MQ 9.4.0 Jun 2024]To delete an individual message from a queue:
    1. Locate the message that you want to delete.
    2. Click the delete icon next to the message shows the delete icon.
    3. Confirm that you want to clear the message by clicking Delete.
  • 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.
  • To delete a queue:
    1. Click on the local queue that you want to delete in the queues list.
    2. Click the Actions button Shows the actions buttonand 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 Shows the menu icon next to the queue that you want to edit.
    2. Click the Edit button shows the edit icon
    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 Shows the menu icon 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.
  • [MQ 9.4.0 Jun 2024] To view the IBM MQ objects associated with a queue:
    1. Select View associated objects from the menu Shows the menu icon 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.