Working with queues

We can use the Queues widget in the IBM MQ Console to show the queues that exist for a specific queue manager. We can then 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.


Before you begin

You must create a queues widget before we can use it. For more information about creating IBM MQ object widgets, see Working with IBM MQ objects.


About this task

The queues widget lists the queues that exist for a specific queue manager. We can select individual queues from the list to work with.

We cannot view or edit authority records for queues on z/OS®.


Procedure

  • To add a queue:
    1. Click the create icon in the queues widget toolbar.
    2. Enter a name for the queue. Valid characters are letters and numbers and the ., /, _, and % characters.
    3. Select the type of queue to add.
    4. Click Create. The new queue is created.
  • To put messages to a queue:
    1. Select the queue to add messages to from the list in the queues widget. You cannot select a model queue.
    2. Click the put message icon in the queues widget toolbar.
    3. Enter the message to put onto the queue.
    4. Click Put.
  • To clear messages from a queue:
    1. Select the local queue to clear messages from the list in the queues widget.
    2. Select ... > Clear queue.
    3. Confirm to clear the queue by clicking Clear Queue.
  • To browse messages on a queue:
    1. Select the local or alias queue to browse from the list in the queues widget.
    2. Click the browse icon in the queues widget toolbar. The browse message window opens, displaying messages on the queue.
  • To delete a queue:
    1. Select the queue to delete from the list in the queues widget.
    2. Click the delete icon in the queues widget toolbar.
    3. Optional: If the queue has messages on it, confirm that the queue can be cleared by clicking Clear queue.
    4. Confirm to delete the queue by clicking Delete. The queue is deleted.
  • To view and edit the properties of a queue:
    1. Select the queue in the queues widget.
    2. Click the properties icon in the queues widget toolbar. Alternatively, double-click the queue.
    3. View the properties and edit them 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 a property, view the property information in Queue properties in the MQ Explorer documentation.
  • To view and edit authority records for a queue:
    1. Select the queue in the widget.
    2. Click ... > Manage authority records. The authority records show the permissions that users and administrators have on the selected queue.