JMSToolBox is an "Universal" JMS Client able to interact with the greatest number of Queue Managers/Queue providers on the market in a consistent manner.
JMSToolBox is a JMS client based on the Eclipse RCP platform, and interactions with Q Managers are implementend via "Eclipse plugins"
JMSToolBox exposes some of its features as REST services so it can be easily used in a continuous integration pipe, or for unit testing or test automation.
- Browse, Post, Remove, Move messages to/from Queues and Topics
- "Message templates": Save message as templates, create new templates from scratch
- "Dynamic variables" of various kind (String, integers, dates, list of values etc.) to be used in templates
- "Scripts": define a sequence of message template post to a destination, can be used for load tests
- Some features are exposed as REST services (get destination, browse/get/post messages etc.)
- Fast and easy configuration compared to other similar tools
- Share setup/configuration with co-workers via import/export fonctions (config, variables, templates,...)
- Display messages published to a JMS Topic
- Perfect for testing JMS based applications (Create templates with random values, replay them...)
- Internally architected as "eclipse plugins". 1 Q Manager = 1 Plugin
Feedback is welcome, please help us offer a better product..
- IBM MQ : Tested with v9.x, v8.x. v7.x, v6.x. May work with other versions also
- IBM WebSphere SIB : Direct connection to the internal SIB Tested with v8.5, v9.0. May work with other versions also
- IBM WebSphere AS : Destinations are read from a JMS Connection Factory. Tested with v8.5, v9.0. May work with other versions also
- IBM WebSphere Liberty : v16.x+, v8.5. May work with other versions also
- Apache ActiveMQ : Tested v5.x (5.4, 5.7, 5.13+)
- Apache ActiveMQ Artemis : v2.x, v1.5.x
- Azure Service Bus
- JBoss HornetQ : v2.4.6
- Open Liberty : v18.x+
- OpenMQ : v5.1+
- Oracle AQ : v21c+ May work with other versions also
- Oracle WebLogic Server : v12.2. May work with other versions also
- Solace PubSub+ : v9.0+. May work with other versions also
- Sofware AG Universal Messaging : v9.+. May work with other versions also
- SonicMQ : 2015 (v10.0)
- TIBCO ems : v8.3
https://github.com/jmstoolbox/jmstoolbox/wiki
Unpack the dowloaded package somewhere.
From v6, JMSToolBox requires Java 17. JMSToolBox v5.x needed Java 11 64Bit and for linux, a machine with GTk3+ is required
If you are stuck with an older version of Java, or with a 32 bits OS, or with a linux machine with GTK2 only, please use an older release (v5.x or v4.x)
For Windows users:
- JMSToolBox is packaged with Java JRE 17 (64 bits) so no extra steps are required
For linux:
- have a 64 bits JRE (17+) present on the execution path (or Java 11 for v5.x.x or Java 8 for v4.x.x)
- make the JMSToolBox executable in the JMSToolBox folder (eg
chmod u+x JMSToolBox) - start JMSToolBox:
./JMSToolBox
For Mac OS X users:
- have a 64 bits JRE (17+) present on the execution path, or configure JMSToolbox to use your own JDK as described here: https://wiki.eclipse.org/Eclipse.ini#-vm_value:_Mac_OS_X_Example (eclipse "init" file is named JMSToolBox.ini)
- in the JMSToolBox.app/Contents/MacOS folder,
- clear attributes: xattr -cr /path/to/JMSToolBox.app
- set executable permission on JMSToolBox
- start JMSToolBox
- remove the folder where JMSToolBox have been previously unpacked
- the settings (with the product logs) will be preserved as they are stored in the
"<user_home>/.jtb"folder - redo the installation procedure
- remove the folder where JMSToolBox have been previously unpacked
- remove the "
<user_home>/.jtb" folder
In order to access a specific Queue Provider, it is necessary to have the jars specific to this Queue manager
Usually, if those jars can be freely distributed, they are included with JMSToolBox
For the others, jars are not bundled with JMSToolBox for legal reasons.
To configure a Queue provider:
- start JMSToolBox
- open the "Q Managers" tab
- double click on the Queue Provider you want to configure
- add the jars to the list of jars The "help" icon will give you an idea of what jars to add and how to configure the Q Manager. The WiKi list them also (https://github.com/jmstoolbox/jmstoolbox/wiki)
- Save -> JMSToolBox : will restart
- Menu File/New Session..., choose the Q Provider and specify the various parameters. Use the help icon for this
- Double click on the session, the list of queues and topics should appear...