Sending and receiving test publications on a topic object folder

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.

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. Right-click the Topics folder, then click Test Subscription....
      The Subscribe application opens.
   3. Type a topic string in the Topic String field. The topic string must be the same name as the publisher.
2. Publish a message to the same topic:
   1. In the Navigator view, expand the queue manager that hosts the Publish/Subscribe Engine.
   2. Right-click the Topics folder, then click Test Publication....
      The Publish Test Message application opens.
   3. In the Topic field, type the name of the topic on which you want to publish the message.
      You or another publisher can already be registered to publish on the topic, or you can enter a new topic string. When you publish the message, you are automatically registered as a publisher on the topic.
   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 Pub/Sub 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.