Sending and receiving test publications for specific topics

You can send (publish) and receive (subscribe to) test publications (messages) to check that your Publish/Subscribe Engine network and topics work as intended. You can configure a publication so that the Publish/Subscribe Engine retains a copy after publishing it to the subscribers. This enables new subscribers to receive the publication even if they subscribed after it was published.

Before you begin

Before you start:

About this task

To send and receive test publications for a specific topic:

Procedure

  1. Subscribe to the topic that you want to test:
    1. In the Navigator view, expand the queue manager that hosts the Publish/Subscribe Engine.
    2. Click the Topics folder.
      All the topics display in the Content view.
    3. Right-click a specific topic in the Content view, then click Test Subscription....
      The Subscribe application opens.
  2. Publish a message to the same topic:
    1. In the Navigator view, expand the queue manager that hosts the Publish/Subscribe Engine.
    2. Click the Topics folder.
      All the topics display in the Content view.
    3. Right-click the a specific topic in the Content view, then click Test Publication....
      The Publish Test Message application opens.
    4. In the Message data field, type a message to send in the publication.
      For example, type Hello, world!
    5. Click Publish message to send the message to the Publish/Subscribe Engine.
    The subscriber receives the message (the publication).
  3. Start another instance of the Subscribe application.
    The second Subscribe application does not receive the message that was published by the Publish Test Message application because it was not subscribing to the topic at the time that the publication was sent to the Publish/Subscribe Engine.
  4. Unsubscribe the second Subscribe instance from the topic.
    1. In the second Subscribe application, click Unsubscribe.
      The second Subscribe application can no longer receive publications on that topic. The first Subscribe application can still receive publications on that topic.
  5. Publish a retained publication to the topic.
    1. In the Publish Test Message application, select the Retained message check box.
    2. Change the text in the Message data field.
      For example, type Hi, I'm home.
    3. Click Publish message.
      The retained publication is published to the Publish/Subscribe Engine. The first Subscribe application receives the retained publication. The second Subscribe application does not receive the publication because it is currently not subscribed.
  6. Subscribe the second Subscribe application to the topic again:
    1. In the second Subscribe application, click Subscribe.
      The second Subscribe application is subscribed to the topic again and receives the retained publication because the Publish/Subscribe Engine kept a copy of the retained publication.

Results

You have now published and subscribed to test publications, including retained publications on a specific topic.