Use the JMS postcard application to verify a local installation

 

To verify that the local installation is working, we can run two instances of the JMS Postcard application on the same machine and send messages between them. This shows that WebSphere MQ messaging is working correctly on the machine, and that WebSphere MQ Java™ Messaging support is successfully installed.

The JMS Postcard application has a graphical interface, to view this interface, your system requires the ability to view a graphical display. If you want the JMS Postcard application to use font and color settings different from the Java Virtual Machine defaults, change the Postcard.ini file. For more information see WebSphere MQ Using Java.

  1. Log on as a user in group mqm.

  2. Change directory to /usr/mqm/java/bin

  3. If you have not already run setjmsenv as described in Set environment variables using setjmsenv do so now.

  4. Run the postcard shell script.
    ./postcard
    If there are no queue managers on your machine, you are invited to run the Default Configuration wizard to create a queue manager to use with the JMS Postcard application before signing on to the JMS postcard application.

    If you already have a queue manager on your machine you will go straight to the JMS sign on window.

  5. At the JMS Postcard - Sign On window , type in a nickname to use to send messages within the postcard application (for example, user1).

  6. Select the queue manager to use as the mailbox:

    • If the only queue manager on your machine is the default queue manager that you created by running the Default Configuration wizard, this queue manager is used automatically as your mailbox for postcards.

    • If you have created one or more of your own queue managers, but you have not run the Default Configuration wizard, select the appropriate queue manager from the list displayed.

    • If you have run the Default Configuration wizard and you want to use the default queue manager, but there is more than one queue manager on your machine, select the Advanced checkbox, then select Use Default Configuration as mailbox.

    • If you have run the Default Configuration wizard and also created one or more of your own queue managers, and you do not want to use the default queue manager, select the Advanced checkbox, select Choose queue manager as mailbox, then select the appropriate queue manager from the list displayed.

    When your selection is complete, click OK to display your first postcard window.

  7. Run the Postcard shell script again in a different shell window. This opens a second postcard window.

  8. The JMS Postcard - Sign On panel is displayed again. Type in a second nickname to use to send messages within the Postcard application (for example, user2).

  9. Repeat the selection of the queue manager that you want to use as the mailbox (as described in step 5). The queue manager you select for this second postcard must either be the same queue manager, be in the same cluster as the queue manager for the first postcard, or communication links must have been set up between them. You now have two postcards, one with the nickname user1 and one with the nickname user2.

  10. In one of the postcards (for example, user1), enter the nickname for the other postcard application in the To: field and the queue manager it is using in the On: field.

  11. Type a message in the Message: field and click Send.

  12. The Postcards sent and received area of the postcard shows details of the message. In the sending postcard, the message is displayed as sent. In the receiving postcard, the message is displayed as received.

  13. From the receiving postcard, double-click the message in the Postcards sent and received area to view it.

Depending on your situation, you might want to do the following:

 

Parent topic:

Verifying the installation using the JMS Postcard application


aq10490_