Monitoring JMS IQ Manager

Enterprise Manager lets you perform the following management tasks for JMS IQ Manager:

• Monitoring Topics and Queues for JMS IQ Manager

• Sending and Publishing Messages for JMS IQ Manager

• Viewing Message Properties for JMS IQ Manager

• Viewing and Editing Message Payload for JMS IQ Manager

Monitoring Topics and Queues for JMS IQ Manager

You can use Enterprise Manager to monitor message traffic in topics and queues.

To Monitor Topics and Queues

1. In the Explorer panel of Enterprise Manager, select the JMS IQ Manager node (for example, IQ_Manager_18007).
2. In the Details panel, click the Topics tab.

   The following table describes the columns in the Topics tab.

   
   

   Column Name Description Topic Name The name of the topic. Min Sequence Number The sequence number of the oldest message available for this topic. If no messages are available, this column shows the sequence number of the last message processed. Max Sequence Number The sequence number of the most recent message available for this topic. If no messages are available, this column shows the sequence number of the last message processed. Available Count The number of messages for this topic that are still unprocessed by at least one subscriber. Number of Subscribers The number of subscribers registered to consume messages for this topic (including durable subscribers that are currently disconnected). Last Published Date/Time The date and timestamp of the most recent message currently available in the topic. If no messages are available, this column shows the last publication date and time of the last message.

3. Click the Queues tab.

   The following table describes the columns in the Queues tab.

   
   

   Column Name Description Queue Name The name of the queue. Min Sequence Number The sequence number of the oldest message available for this queue. If no messages are available, this column shows the sequence number of the last message processed. Max Sequence Number The sequence number of the most recent message available for this queue. If no messages are available, this column shows the sequence number of the last message processed. Available Count The number of unprocessed messages in the queue. Number of Receivers The number of receivers for this queue. Last Published Date/Time The date and timestamp of the most recent message currently available in the queue. If no messages are available, this column shows the last publication date and time of the last message.

4. When you select a topic or queue, the Messages tab in the lower portion of the Details panel displays information about the topic or queue.

   The Messages tab includes a toolbar for working with messages.

5. If journaling is enabled, you can switch between displaying live and journaled messages by clicking the Show Live and Show Journaled icons in the toolbar. If journaling is not enabled, these buttons do not appear.
6. Topics also include a Summary tab and a Subscribers tab. The Subscribers tab displays information about durable subscribers. The toolbar lets you create a new durable subscriber and to unsubscribe an existing durable subscriber.

Sending and Publishing Messages for JMS IQ Manager

You can send and publish messages from Enterprise Manager. The messages can be text or binary.

To Send and Publish Messages

1. Select the topic or queue as described in Monitoring Topics and Queues for JMS IQ Manager.
2. In the Messages tab, click the Send/Publish icon.

   The Send/Publish New Message dialog box appears.

3. To publish a text message, select the Text option and enter the text or specify the text file.
4. To publish a binary message, select the Binary option and specify the binary file.
5. Review the default values for the Time to Live, Priority, and Delivery Mode fields. If desired, change the default values.

   The Time to Live field has a default value of 0, which specifies that the message does not expire.

6. Click Submit.

Viewing Message Properties for JMS IQ Manager

You can view the properties of a message. The properties include the message type, destination name, and expiration time.

To View Message Properties

1. Select the topic or queue as described in Monitoring Topics and Queues for JMS IQ Manager.
2. In the Messages tab, select the message and click the Properties icon.

   The View Message Property dialog box appears. The following table describes the message properties.

   
   

   Property Name Description Correlation ID An identifier that is used to associate the message with a previous message or application-specific identifier. Time Stamp The date and time when the message was received. Message Payload Size The size of the message payload (in bytes). Message Source File If the message is persistent, then this property displays the fully qualified name of the database file in which the message is stored. Type The message type of the message, such as text or bytes. Message Enqueue Time The date and time when the message was received by its message destination. Delivery Mode Indicates whether the message is persistent or non-persistent. Message Size The size of the message including the JMS header (in bytes). Sequence Number The sequence number of the message. Redelivery Flag Indicates whether this message is set for redelivery. Destination Name The name of the topic or queue. Message ID The unique identification number for the message. Priority The priority of the message from 0 to 9. The lowest priority is 0. The highest priority is 9. Expiration Time The date and time when the message will expire. Message Body Size The size of the message body (in bytes).

3. When you are done, click Close.

Viewing and Editing Message Payload for JMS IQ Manager

A message contains two main components: the headers and the payload. The headers contain metadata about the message. The payload contains the actual content of the message.

Working with Text Messages

Enterprise Manager enables you to view and edit the payload of live text messages. In addition, you can view and republish the payload of journaled text messages.

To View and Edit the Payload of Live Text Messages

1. Select the topic or queue as described in Monitoring Topics and Queues for JMS IQ Manager.
2. In the Messages tab, select the message and click the View/Edit icon.

   The Text Message Payload (Live) dialog box appears.

3. To display any carriage return and line feed characters in the message, select the Show Carriage Return/Line Feed check box.
4. If the message contains XML and you want to view the XML in browser format, click View XML.
5. To change the payload, do one of the following:

   • Modify the text in the text area and click Change Payload.

   • Select the From File option, select the text file, and click Change Payload.

6. To delete the message, click Delete.
7. To save the payload to a file, click Download Payload.

To View and Republish the Payload of Journaled Text Messages

1. Select the topic or queue as described in Monitoring Topics and Queues for JMS IQ Manager.
2. In the Messages tab, select the message and click the View/Edit icon.

   The Text Message Payload (Journaled) dialog box appears.

3. To display any carriage return and line feed characters in the message, select the Show Carriage Return/Line Feed check box.
4. If the message contains XML and you want to view the XML in browser format, click View XML.
5. To republish the payload to a topic or queue, click Republish.
6. To save the payload to a file, click Download Payload.

Working with Byte Messages

Enterprise Manager enables you to view the payload of live byte messages. You cannot edit the payload.

To View the Payload of Live Byte Messages

1. Select the topic or queue as described in Monitoring Topics and Queues for JMS IQ Manager.
2. In the Messages tab, select the message and click the View/Edit icon.

   The Bytes Message Payload (Live) dialog box appears.

3. To delete the message, click Delete.
4. To save the payload to a file, click Download Payload.