The Essential WebSphere MQ Tool

Save Time, Money, and Frustration
Common Capabilities Read The Fine Print STARTER DEVELOPER ADVANCED
DEVELOPER
INTEGRATION
EXPERT
Was FREE
N/A
$29.95
N/A
$149.95
N/A
$199.95
FREE
Number of Queue Manager Connections 1 2 4 4
Number of Queue Opens 1 3 6 6
Sticky Settings y y y y
Queue Manager Connection Options y y y y
Status Log y y y y
Listbox of Local and Remote Queue Managers y y y y
Listbox of Queues on Connected QM y y y y
Auto-convert Q and QM Names to All Capitals y y y
Get/Put Messages Tab Get and Put Messages y y y y
Enter Message Text y y y y
Dynamic Refresh of Queue Depth Indicators y y y y
Action Log y y y y
Get Messages and Save In One Operation Single Single Multiple Multiple
Put Message and Save In One Operation y y y y
Clear Messages from Opened Queue Single Single Multiple Multiple
Move Messages Between Queues Single Multiple Multiple
Save Moved Message y y y
Put Message to Queue Multiple Times y y
Clear All on All Opened Queues y y
Build-A-Message Tab Enter Message Text y y y y
Read Files Single Single Multiple Multiple
Read By Lines y y
Browse Window Browse List y y y y
View Messages and Navigate the List y y y y
Save Browsed Message y y y
Get or Clear Browsed Message y y
Format Window Character Display (Browse/Examine) y y y y
XML Display (Browse/Examine) y y y
Self-Defining Display (Browse/Examine) y y
HEX and Character Display y y y y
HEX and Character Stacked Display y y
Line Terminate by Count y y
Line Terminate by Character y
Monitor Options All Opened Qs on All QMs y y y
All Qs on one Queue Manager y y y
Clear or Browse Queue from Q on All Qs List y y
Timeline Trend for All Qs on One Queue Manager y y
Changed Qs on QM with Timeline Trend y
Clear or Browse Queue from Q on Changed Qs List y
MQSI Features Set Trace Options y
One Button Start/Stop/Display Trace y
Show WMQI Trace File y
Import or Export Message Sets y


Read The Fine Print
MQExerciser is available in a number of editions. The TRIAL edition (not shown) is automatically activated when you install MQExerciser for the first time. It is operational for 30 days and has full function. After the 30 day trial period, you must request a serial number for any of the editions listed here. If you request a serial number within 30 days of the completion of the trial period you will lock in the prices in effect at the time of inital download. After that time, you must reinstall MQExerciser before providing your serial number which will lock in the prices in effect at the time of the new download. When you purchase a DEVELOPER or ADVANCED DEVELOPER edition, you get an additional grace period during which you have the full power of MQExerciser available to you. After the grace period, function reverts to the purchased edition level as indicated in this table.

Return to top.

Number of Queue Manager Connections
MQExerciser allows you to work with queues on multiple queue managers simultaneously. Connect to multiple queue managers, open queues on each one, and get to work. See message traffic on multiple queue managers without repeatedly connecting and disconnecting. This is particularly useful if you have applications that get messages from one queue and build messages destined for queues on different queue managers. Feed messages to one queue and see the results on the others.

Return to top.

Number of Queue Opens
MQExerciser allows you to open multiple queues simultaneously. Take a simple scenario where an application reads messages from a WORK queue on QM1 and puts messages to a SUCCESS queue on QM2 and a FAILURE queue on QM3. With MQExerciser, you open all three queues AT THE SAME TIME. You can put a message to the WORK queue and wait to see where messages go - SUCCESS or FAILURE. And with Dynamic Queue Depth Refresh there is no need to continually refresh the screen to see the results. When messages arrive, you can browse the queue and examinine messages.

Return to top.

Sticky Settings
Tired of continually reentering data or setting up your test environment? MQExerciser remembers what you did and makes it easy to restart with Sticky Settings. There are many variables you enter, settings you configure, and options you select during operation. When you are finish testing, your settings are saved. When you re-start MQExerciser your settings are restored ready for you to pick up where you left off.

Return to top.

Queue Manager Connection Options
Where is that Queue Manger? To connect to a queue manager you need to supply the server connection channel name, the server machine name, and the port the queue manager is listening on. If you have a Client Channel Connection Table (AMQCLCHL) simply supply the queue manager name and make the connection. If you don't, you must supply the necessary information - but just once! MQExerciser remembers so the next time you need to connect to that queue manager, all you have to do is select the queue manager from a drop down list. Sticky Settings provides the rest.

Return to top.

Status Log
Want to see what's happening under the covers? The status log shows the sequence of the various MQ commands issued by MQExerciser along with their return codes. And, if there are errors, there is realtime notification with an description and probable cause.

Return to top.

Listbox of Local and Remote Queue Managers
When you connect to a queue manager, MQExerciser remembers. The next time you want to connect to that queue manager, select it from a drop down list. And in addition, the connection options are automatically set to what they were the last time you connected.

Return to top.

Listbox of Queues on Connected QM
When you want to open a queue you must first select a queue manager from a drop down list. When you do, another drop down list provides the names of the queues on that queue manager. You can select from the list or type the name in directly.

Return to top.

Auto-convert Q and QM Names to All Capitals
Queue and queue manager names are case sensitive. Many companies have set standards for these names to be all capitals. You can have MQExerciser automatically convert the names you to all capital letters. (I got tired of constantly hitting the shift key and sometimes missing, so I put this feature in to keep my life simple.)

Return to top.

Get and Put Messages
You can get messages from a queue or put messages to a queue with one click. The Get/Put Messages tab shows the opened queues along with the depth of each queue. Enter text and click the Put Button to put the message to a queue. Select the Get Button to get a message from the queue. The Dynamic Queue Depth Indicator automatically refreshes the queue depth. With multiple queues open, you can get and put messages without disconnecting or reconnecting to queue managers.

Return to top.

Enter Message Text
Type the text for the message and put a message. Get a message and check a box and the text is available to put to another queue. Additional options are provided for building messages from a file and from the previously read file on the Build-A-Message tab.

Return to top.

Dynamic Refresh of Queue Depth Indicators
Has the application run? Is the message there yet? MQExerciser dynamically updates the queue depth display based on a refresh interval you select. No need to continually click a refresh button to see if your message has arrived - it's automatic! Of course, if you want to do it the old way, you can still do it manually.

Return to top.

Action Log
Can't remember what you did a minute ago? Use the action log to see the sequence of events you have performed in getting and putting messages. This includes reading messages from files, saving messages to files, and moving messages between queues.

Return to top.

Get Messages and Save In One Operation
When getting a message from the queue the message body can be saved automatically. Simply check a box, identify a file location, and get a message. To get and save multiple messages in one operation, check a box and accept the default to get all the messages and save the text of each message to an individual file, or specify a count of messages.

Return to top.

Put Message and Save In One Operation
When putting a message to a queue, the message body can be saved automatically. Simply check a box, identify a file location, and put a message.

Return to top.

Clear Messages from Opened Queue
Ever try to clear messages from a queue using WebSphere MQ Explorer? You can't do it if ANY application is connected. You can with MQExerciser. Clear one or more messages from a queue with the click of your mouse. To clear multiple messages, check a box and specify a count of messages to clear (default is All).

Return to top.

Move Messages Between Queues
Have messages on one queue you need to move to another? It is easy with MQExerciser to move one or more messages between one or more queues. Activate the Move function, identify the 'to' queue or queues to receive the messages, click the 'from' queue with the messages and it's done. Move from one to all messages on a queue at one time. And, if the 'from' queue is also a 'to' queue, you can do it again.

Return to top.

Save Moved Message
You can have MQExerciser save the messages being moved.

Return to top.

Put Message to Queue Multiple Times
Can your application keep up with the volume of input messages? Find out with MQExerciser. A single message can be put to a queue multiple times. You can fill the queue up all at once or specify a time interval to controls the rate the message is put to the queue.

Return to top.

Clear All on All Opened Queues
You've run your test case and have messages on three or four queues. You examine them and all looks good. Now you want to clean things up to run the next test case. MQExerciser lets you clear all messages on all opened queues at one time rather than going to each queue and clearing it individually.

Return to top.

Enter Message Text
Text for a message can be entered on the Build-A-Message tab in addition to the Get/Put Messages tab. Where ever you put the message, it shows up on both text boxes.

Return to top.

Read Files
To read a SINGLE file, identify a file and click a button. The file is read into the message text area. Select a queue and put the message to a queue.

To read MULTIPLE files and build a message for each file first identify a folder and click a button to create a read list. Select a queue and the contents of each file is read into a message that is put onto the queue. Guess what? You just identified a regression bucket!

Return to top.

Read By Lines
Wow! You have a REALLY BIG FILE that would clog your system if put into a single message. You want the lines from the file grouped into messages for better performance. Relief is just a click or two away - identify a file, configure a line count, and specify an interval. Select a queue and messages are built from lines in the file and put to the queue. The interval controls the rate that the messages are put onto the queue.

Return to top.

Browse List
The Browse List provides a view of the messages on a queue with extensive capabilities for working with them. Messages can be examined in detail AND you can read or clear messages from any position in the list.

Return to top.

View Messages and Navigate the List
When you select a message to view you see both the message text and selected MQMD fields. You can easily browse the next or previous message or jump to a specific message with a one button click. Format options are available for XML messages and a truncate option improves performance for very large messages.

Return to top.

Save Browsed Message
The text of a browsed message may be saved to a file. In this way you can save the text of a message for later use in debugging or regression testing.

Return to top.

Get or Clear Browsed Message
Once you have browsed a message you can 'Get' it or 'Clear' it from the queue. When you get a browsed message, it is available to 'Put' to a queue using the 'Get/Put Messages tab. It may also be saved to file. When you clear a browsed message, it is removed from the queue.

Return to top.

Character Display (Browse/Examine)
The default for displaying message text is by character for both browsing messages on a queue or examining a message or file in detail.

Return to top.

XML Display (Browse/Examine)
The XML formatting option formats XML messages to make them easier to read.

Return to top.

Self-Defining Display (Browse/Examine)
Sometimes XML and non-XML messages are mixed on the same queue. With the self-defining display option, MQExerciser automatically selects appropriate formatting based on message content. This is especially useful when browsing messages.

Return to top.

HEX and Character Display
A message may be formated using several options. HEX displays the characters in hex format while HEX and Character adds the text display to the right. 'Line Terminate by Count' and 'Line Terminate by Character' options control the number of characters displayed per line.

Return to top.

HEX and Character Stacked Display
I always found it difficult to match the hex value with the text value when hex and characters are displayed horizontally. So, I added an option to display the text representation beneith the hex representation. In addition, certain characters like tab, line feed, and carrage return are decoded in the text display.

Return to top.

Line Terminate by Count
The number of characters displayed per line can be controlled to make message and file examination fit your needs. While the default is to display 16 characters per line, you might want to specify another value. For example, you might have a message or file with fixed length records. If you specify the length to match the record length, each record will be displayed on a separate line.

Return to top.

Line Terminate by Character
An character can be specified as 'End Of Line'. Each line in the format will then be terminated by that character. For example, if you know a file has lines terminated by Line Feed you might select that as the terminating character. The result is that each line in the display will match one line of the file or message.

Return to top.

All Opened Qs on All QMs
You can monitor changes in queue depth for all opened queues on all queue managers on one screen. You can manually refresh the queue depths or set a refresh interval for automatic refresh. For each queue you see the hosting queue manager, the current queue depth, the queue depth from the previous refresh, the maximum queue depth, and the approximate total number of messages that have been put to the queue. An indicator shows if the depth change is greater, less than, or equal to the count of the previous interval.

Return to top.

All Qs on One Queue Manager
You can monitor changes in queue depth for all queues on one screen whether opened or not. You can manually refresh the queue depths or set a refresh interval for automatic refresh. See 'Browse Queue from Q on All Qs List' and 'Clear Queue from Q on All Qs List' for additional capabilities.

Return to top.

Clear or Browse Queue from Q on All Qs List
You can select a queue on the 'All Qs List' and immediately clear all messages. Or, you can browse all messages using all available browse functions.

Return to top.

Timeline Trend for All Qs on One Queue Manager
This Timeline Trend shows all the queues on a queue manager with the change trend for queues whose depth changes over time. It is easy to see relationships between applications and messages with Timeline Trend. Timeline Trend is started by setting a refresh interval and selecting the Refresh button. See Changed Qs on QM with Timeline Trend for a detailed explaination.

Return to top.

Changed Qs on QM with Timeline Trend
Only the queues on a queue manager with changing queue depths are shown. In the example below, different message flows process messages received on the DEMO.ONE, DEMO.GOOD, and DEMO.FAIL queues. D1 application gets messages and puts them onth either DEMO.GOOD or DEMO.FAIL. DGOOD and DFAIL applications process messages and put a message to TESTOUT. The interval between getting a message from one queue (e.g. DEMO.GOOD) and putting a message to another queue (e.g. TESTOUT) provides an indication of processing time. Changing the width of the window increases or decreases the number of refresh samples in the Timeline.

At T1
a message is put on DEMO.ONE.
Queue Depth = 1
Trend = >(greater)
At T2
D1 application gets message from DEMO.ONE.
Queue Depth = 0
Trend = <(less)
At T3
no queue depth changes. D1 application is processing message.
Trend = -(equal)
At T4
D1 application puts message to DEMO.GOOD.
At T5
DGOOD application gets message from DEMO.GOOD.
A new message arrives on DEMO.ONE.
At T6
D1 application gets message from DEMO.ONE.
At T7
D1 application puts message to DEMO.FAIL.
DGOOD application puts message to TESTOUT.
At T8
DFAIL application gets message from DEMO.FAIL.
At T13
DFAIL application puts message to TESTOUT.
After T13
No message activity.
At T49
DEMO.GOOD queue drops off Timeline list.

Return to top.

Clear or Browse Queue from Q on Changed Qs List
You can select a queue on the 'Changed Qs List' and immediately clear all messages. Or, you can browse all messages using all available browse functions.

Return to top.

Set Trace Options
You can set the options to control trace with a graphical user interface. Identify the execution group and optionally, a specific message flow. Once the options are set, you can start, stop, and display the trace output with a single button.

Return to top.

One Button Start/Stop/Display Trace
Use one button to START, STOP, and DISPLAY trace. Click one button to start tracing a message flow or execution group. Click the button a second time to stop the trace. Click the button a third time to format and display the trace.

Return to top.

Show WMQI Trace File
A previously generated WMQI formatted trace file can be shown with one click of the mouse.

Return to top.

Import or Export Message Sets
Both the import message set and export message set commands are generated from a graphical user interface and can be executed with a mouse click.

Return to top.