Working with topics

We can use the topics widget in the IBM MQ Console to add and delete topics, and view and set the properties of a topic.


Before you begin

You must create a topics 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 topics widget lists the topics that exist for a specific queue manager. We can select individual topics from the list to work with.

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


Procedure

  • To add a topic:
    1. Click the create icon in the topics widget toolbar.
    2. Enter a name for the new topic. Valid characters are letters and numbers and the ., /, _, and % characters.
    3. Specify the topic string that you publish messages for the topic to. For more information, see Topic properties.
    4. Click Create. The new topic is created.
  • To delete a topic:
    1. Select the topic to delete from the list in the topics widget.
    2. Click the delete icon in the topics widget toolbar.
    3. Confirm to delete the topic by clicking Delete. The topic is deleted.
  • To view and edit the properties of a topic:
    1. Select the topic in the topics widget.
    2. Click the properties icon in the topics widget toolbar. Alternatively, double-click the topic.
    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 Topic properties in the MQ Explorer documentation.
  • To publish a message on a topic:
    1. Click the put message icon in the topics widget toolbar.
    2. Enter a message in the Message field.
    3. Enter the topic string to publish the message on in the Topic string field.
    4. Click Publish.
  • To subscribe to a topic:
    1. Click the subscribe icon in the topics widget toolbar.
    2. Enter the topic string to subscribe to in the Topic string field.
    3. Click Subscribe.
  • To view and edit authority records for a topic:
    1. Select the topic in the topics widget.
    2. Click the ... > Manage authority records. The authority records show the permissions that users and administrators have on the selected topic.