To view a list of queues or topics select "Queues" or "Topics" on the tree view on the left hand side of the main display. The list may be sorted by clicking on the appropriate column header. For example to list queues by message queue depth click on the "PendingMsgCount" column header, or to see which queues are currently most heavily in use click on "InMsgRate".
A separate queues or topics display window may be opened using the "Show Queues..." or "Show Topics..." menu entries. With this display a pattern may be specified to filter the destination list. This is very useful when there are too many destinations to efficiently be displayed easily. It is also possible to view temporary destinations using the View menu.
All destination displays will automatically refresh once very refresh period as configured in the gems.props file. Automatic refresh can be turned off for a display with the AutoRefresh option in the View menu.
To view a complete list of property settings for a destination, double-click on the queue or topic or select "Queue/Topic Properties..." on the right mouse button pop-up menu.
Note; continually displaying 1000's of queues or topics can be slow and can cause a performance impact on the EMS server so the main queues or topics display will be disabled if there are more than 1000 destinations. If this is the case you may view destinations using the "Show Queues..." or "Show Topics..." menu entries and specifying a filter pattern, or by reducing the list for the main display by configuring a QueueNamePattern or TopicNamePattern in the gems.props file.
To browse a queue's messages select "Queue Browser..." from the Queues menu. If a queue was selected the queue name will automatically be shown, if not type in the name of the queue to browse or use the "..." button to display the destination picker. Set the number of messages to browse or specify no limit.
To browse just a certain set of messages a JMS selector may be specified, see the EMS User's Guide on information on specifying selectors. To browse messages based on time use the "..." button to open an editor which can be used to configure a selector to browse messages sent before or after a certain time. By default the editor will configure a selector to browse messages received in the last 10 minutes. For TextMessage types it is possible to filter messages based on message content, use the "TextMessage Filter..." option in the Edit menu to set a regular expression, for example .*[Ee]rror.*
will match all messages with a text body that contains "Error" or "error".
To begin browsing click the Start button, the display will show one line for each message browsed. The display shows the following information for each message:
To display further information about the message the message display can be opened by double-clicking on a message or using the right mouse button pop-up menu.
The following options may be set using the options editor on the Edit menu:
To save browsed messages to a file use the "Save Messages to File..." option in the File menu.
Note; messages that have been sent to a client application and not yet acknowledged, or messages that have been sent to the EMS client library and held in a prefetch queue CANNOT be browsed. If this condition persists its possible that the client application has stalled and may need to be shutdown.
To view messages that are published to a topic select "Topic Subscriber..." from the Topics menu. If a topic was selected the topic name will automatically be shown, if not type in the name of the topic to subscribe to or use the "..." button to display the destination picker. Set the number of messages to receive or specify no limit.
To receive just a certain set of messages a JMS selector may be specified, see the EMS User's Guide on information on specifying selectors.
To begin subscribing click the Start button, the display will show one line for each message received. The display shows the following information for each message:
To display further information about the message the message display can be opened by double-clicking on a message or using the right mouse button pop-up menu.
The following options may be set using the options editor on the Edit menu:
Note; all received messages can be saved to a file using the "Save Messages to File..." option in the File menu.
You can monitor (or snoop) messages as they pass through the EMS server. To monitor queue messages select "Queue Monitor..." from the Queues menu, to monitor topic messages select "Topic Monitor..." from the Topics menu.
The monitor display uses $sys.monitor topics to receive monitor event messages as JMS messages are received by the EMS server and delivered to a client application. If a destination was selected the topic or queue being monitored will automatically be shown, if not use the "..." button to display the destination picker. Set the number of monitor events to receive or specify no limit. You may also optionally select for the original JMS message to be included in the monitor event (Note; use this option with caution particularly if messages could be large).
To receive just a certain set of monitor events a selector may be specified via the Edit menu, see the EMS User's Guide on information on specifying selectors. Note; the selector applies to the $sys.monitor event message not the original JMS message, see EMS User's Guide for description of $sys.monitor message properties.
To begin monitoring click the Start button, the display will show one line for each monitor event received. For each queue message being snooped up to three monitor events will be displayed; one for JMS message being received from a producer, one for the JMS message being sent to a consumer, and one for the sent JMS message being acknowledged. For topic messages, sent and acknowledge monitor messages will be received for each subscriber. The display shows the following information for each monitor event:
To display further information about the monitor event open the message display by double-clicking on a monitor event or using the right mouse button pop-up menu. To view the original JMS message use the "Open Original JMS Message..." option in Message menu or right mouse button pop-ip menu.
The following options may be set using the options editor on the Edit menu:
All received events can be saved to a file using the "Save Monitor Events to File..." option in the File menu.
Note; monitoring destinations under high load can cause message backlogs in the EMS server, the monitor will automatically stop if the message backlog exceeds the configuration property MaxMonitorBacklog (default 1000). MaxMonitorBacklog may be set in the gems.props file.
Sometimes it's necessary to purge unwanted messages from the EMS server. To purge all messages on a destination, select the desired queue or topic then select a purge option from the Queues or Topics menu.
Note; once purged, messages on the server will be destroyed and cannot be recovered.
It may also sometimes be necessary to purge or destroy a specific message or messages on a queue. To do this first browse the queue then select the messages to be destroyed then select "Destroy Checked Messages..." from the Message menu. A new window will open where you can select whether to destroy the message using the Admin API or to read the message with a selector using the JMS API. To use the Admin API first track_message_ids must be enabled on the EMS server.
It is also possible to copy messages from a queue to another destination or even to another EMS server.. To do this first browse the queue then select the messages to be copied then select "Copy Checked Messages..." from the Message menu. A new window will open where you can select which EMS server and which destination to copy the messages to. Note; the messages will be sent to the specified destination all in one transaction, so if any message fails the transaction will be rolled back and no messages copied.