This topic explains how to use the Queue Browser view, which allows you to see the contents of queues deployed on Websphere MQ, Websphere Application Server, Tibco EMS, Sonic MQ, ActiveMQ, and any other JMS provider.
The Queue Browser allows you to connect to a JMS broker to retrieve the list of queues provided by that broker and show the messages currently sitting on each queue. You can see the headers as well as the message contents. The Queue Browser also lets you delete messages off the queues. This feature provides visibility into (and control over) the messages present on queues—which is helpful when analyzing the interaction between the test scenarios and the system under test.
The following JMS providers are supported:
The Queue Browser can be configured to display the available MQ queues and show the messages available within them—similar to the WebSphere MQ Browser tool from IBM.
To configure the view for this, add the WebSphere MQ jars for JMS messaging and configure the browser view following the JMS instructions described in IBM WebSphere MQ (MQ Series).
Once this configuration is completed, MQ Messages that are generated via the MQ native API might appear in a hexadecimal encoded (non-readable) format in the Queue Browser view. A hexadecimal decoding tool can be used to convert text/XML messages to a human readable format. Such tools are available online; for example, see.
In order to automatically see queues on Tibco, you need to:
tibjmsadmin.jarin the System Properties preferences (see System Properties Settings).
To browse a queue:
Specify the connection settings needed to access your JMS provider.
In many cases you can leave the Connection Factory field at the default value. In some cases, you need to fill it out. For WebSphere MQ, use the name of whatever queue manager holds the queues you are connecting to. For WebSphere Default JMS, use the name of the connection factory that was created on WebSphere Application Server.
You can explore the queue as follows:
|To achieve this...||Do this...|
|See the available queues||Review the box in the top left of the view|
|See all messages on a given queue||Select that queue|
|See the contents of a given message||Select that message|
|Remove a message from the queue||Right-click that message, then choose Delete Message|