This section explains how to configure and use micro broker JMS client in HermesJMS. HermesJMS can be used for browsing and processing messages on different messaging providers like WebSphere MQ or micro broker, the advantage is having a JMS browser GUI when testing several use cases described in this publication.
HermesJMS is a generic JMS graphical user interface for working with JMS clients. It has the ability to send and browse messages of a messaging system using JMS. It has a wide range of applications and provides a common view across messaging providers.
Download and installation
HermesJMS is an open source utility available at http://www.hermesjms.org
. Current stable version per 08/12/02 is 1.13. Follow the download and installation instructions at the main website to setup a running instance of HermesJMS on your system.
Please check the HermesJMS license carefully before using it for your purposes of message browsing and processing.
Configuration and use with micro broker
HermesJMS comes with built-in plug-ins for the most popular JMS providers including WebSphere MQ. Check the detailed setup of WebSphere MQ at http://www.hermesjms.org/confluence/display/HJMS/WebSphereMQ
. For micro broker JMS is no plug-in available but nevertheless you can connect to using micro broker JMS client libraries. The following steps have been tested with built-in micro broker in Lotus Expeditor integrator.
Step 1 - create a new ClasspathGroup
Start HermesJMS and select Options - Configuration
. Create a new ClasspathGroup for micro broker as JMS provider with the libraries shown in picture above. The name of ClasspathGroup can be set as you want.
Step 2 - create a new session
Give the session a name you want. Select the loader you've defined in step 1 and afterwards the class shown in the figure above. You need to define the destinations (queues/topics) manually because discovery of micro broker sessions doesn't work with the Default Plug In. Add the Property URL and enter the correct IP address and port number.
Step 3 - open a queue and browse messages
Double click on a queue to browse messages and dig into message details.
Step 4 - put a message into a queue
Select Messages - Send XML Encoded Messages
and select a (JMS) XML message from the local file system. Press Send file to
button to send message to the queue. Press Refresh now.
button and discover the new message.