Viewing Messages

The SwiftMQ Explorer contains a powerful message viewer which can be invoked on 2 different ways.

The first way is to select the queue node of the "Usage" folder of the Queue Manager Swiftlet and press the right mouse button.

The second way is to open the Entity Table of the "Usage" folder of the Queue Manager Swiftlet, select the queue and press the "View Messages" button on the toolbar.

Thereafter the message viewer frame is shown:

The message viewer works like a database query tool. You first specify your select condition, execute it and see the result. The select condition is entered into the "Selection Attributes" panel. The first field may contain an optional SQL92 message selector. The fields "From" and "To" specify the range of the result set one like to select. Both values are indexes, starting with 0 (first row) and are inclusive. The "To" field may contain a "*" which means to select till the end of the result set. If a message selector is specified, the result set is first reduced to those message matching the selector, and the from/to indexes then specify the part of the result set to display. Note that the maximum number of messages returned is 200 to avoid overloading the router through transfering huge result sets. However, one is able to look at every message by reducing the range by specifying the from/to indexes.

The field "Body Truncate" contains the number of characters the message body is truncated to. This is also to avoid overloading the router with large message results. The default is 2048 characters. One may specify any value here.

After all selection attributes have been entered, the "Execute Select" button may be pushed and the table "Selection Result" will contain all messages of the result set.

One or more messages may be selected. If a single message is selected, the content is displayed in the tabbed panel below. To delete the selected messages, one may push the "Deleted selected Messages" button.

The chart at the end of the frame displays the message flow and the current number of messages in the queue. It can be switched on/off with the "Message Flow Chart" button on the toolbar. The update interval depends on the attribute "Collect Interval" of the Queue Manager Swiftlet and may be changed accordingly.