JMSToolBox

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.

Features

• 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..

Q Managers currently supported:

• 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

Full User manual

https://github.com/jmstoolbox/jmstoolbox/wiki

Quick start:

Installing JMSToolBox

Unpack the dowloaded package somewhere.
The executable is in the JMSToolBox folder

For Mac OS X users:, if JMSToolBox fails to start with a message similar to "JMSToolBox is damaged and can't be opened...":

• open a terminal and remove the restriction:xattr -d -r com.apple.quarantine /<JMSToolBox unpack dir>/
• Ref: https://osxdaily.com/2010/09/12/disable-application-downloaded-from-the-internet-message-in-mac-os-x/

JMSToolBox latest versions are bundled with Java JRE 17. 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 versions prior to v6.2.0 only !

• For linux:

  • set a 64 bits JRE (17+) on the execution path
  • in the JMSToolBox folder: make the JMSToolBox executable (ie chmod u+x JMSToolBox)
  • start JMSToolBox: ./JMSToolBox

• For Mac OS X users:

  • have a 64 bits JRE (17+) present on the execution path
  • in the JMSToolBox.app/Contents/MacOS folder, set executable permission on JMSToolBox
  • if JMSToolBox fails to start with a message like "JMSToolBox is damaged and can't be opened...":
    • remove the restriction:xattr -d -r com.apple.quarantine /Path/to/application/
    • Ref: https://osxdaily.com/2010/09/12/disable-application-downloaded-from-the-internet-message-in-mac-os-x/
  • start JMSToolBox

Updating 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

Uninstalling JMSToolBox

• remove the folder where JMSToolBox have been previously unpacked
• remove the "<user_home>/.jtb" folder

Configuring a Queue Provider:

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

Configuring a Session:

• 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...