JMS Topic: Monitoring: Durable Subscribers
Buttons Column Display Configuration Options Advanced Configuration Options Related Tasks Related Topics
Use this page to monitor and manage durable subscribers that are running on a JMS topic. From this page, you can view detailed runtime statistics for each durable subscriber, as well as create new durable subscribers or delete existing ones.
Click on a subscriber to view its configuration details. To view a subscriber's messages, select the check box next to its name, and then click the Show Messages button.
Durable subscribers are persisted to a disk-based file store or a JDBC-accessible database until the message has been delivered to the subscribers or has expired, even if those subscribers are not active when the message is delivered. A durable subscriber registers a durable subscription with a unique identity that is retained by JMS. Subsequent subscriber objects with the same identity resume the subscription in the state it was left by the prior subscriber. If there is no active subscriber for a durable subscription, JMS retains the subscription's messages until they are received by the subscription or until they expire.
Configuration Options
Name Description Uniform Distributed Topic Members Filter by member topic: only display subscriptions that exists on selected member topics
Each selection is a fully-qualified name of this uniform distributed topic member resource. The uniform distributed topic name is preceded by the parent module name, separated by an exclamation point (!).
Advanced Configuration Options
Name Description Client ID Filter by Client ID: only display subscriptions that contain the given string somewhere in their client-id.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.ClientID
Subscription Name Filter by Subscription Name: only display subscriptions that contain the given string somewhere in their subscription name.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.SubscriptionName
Selector Filter by Selector: only display subscriptions that contain the given string somewhere in their selector string.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.Selector
Minimum Message Count Filter by Minimum Message Count: only display subscriptions whose current and pending messages total is greater than this value.
Minimum Message Bytes Filter by Minimum Message Bytes: only display subscriptions whose current and pending bytes total is greater than this value.
Minimum Idle Seconds Filter by Minimum Idle Seconds: only display subscriptions that have been idle for greater than this value.
Maximum Subscriptions Allowed Filter by Maximum Subscriptions Allowed: Do not display subscriptions higher than this count.
Buttons
Name Description New Creates a new durable subscriber on the topic.
Delete Deletes specific durable subscribers from the topic.
Show Messages Displays all messages sent to selected durable subscribers.
Show Durable Subscriptions Matching the Above Criteria Applies the pre-filter criteria for durable subscription selection.
Column Display
You can show fewer or additional data points on this page by expanding Customize this table and modifying the Column Display list. Each data point displays in its own table column.
The following table lists all of the data points that you can display in columns on this page.
Name Description Subscription Name The subscription name for this durable subscriber. This name must be unique for each client ID.
Valid durable subscription names cannot include the following characters: comma ",", equals "=", colon ":", asterisk "*", percent "%", or question mark"?".
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.SubscriptionName
Client ID A unique client identifier for this durable subscriber.
Note: The client ID is not necessarily equivalent to the WebLogic Server username; that is, a name used to authenticate a user in the WebLogic security realm. You can set the client ID to the WebLogic Server username if it is appropriate for your JMS application.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.ClientID
Client ID Policy The policy for the client identifier for this durable subscriber.
Note: The client ID policy is either
Restricted
orUnrestricted
.MBean Attribute:
JMSDurableSubscriberRuntimeMBean.ClientIDPolicy
Subscription Sharing Policy The Subscription Sharing Policy on this subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.SubscriptionSharingPolicy
No Local Messages Specifies whether this durable subscriber receives local messages that it has published.
To prevent this, set the
noLocal
parameter totrue
.MBean Attribute:
JMSDurableSubscriberRuntimeMBean.NoLocal
Active Indicates whether this subscription is being used by a durable subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.Active
Selector The message selector defined for this durable subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.Selector
Messages Pending Count The number of messages pending (uncommitted and unacknowledged) by this durable subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.MessagesPendingCount
Messages Current Count The number of messages still available by this durable subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.MessagesCurrentCount
Bytes Pending Count The number of bytes pending by this durable subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.BytesPendingCount
Bytes Current Count The number of bytes received by this durable subscriber.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.BytesCurrentCount
Last Messages Received Time in Millis The time when the last time a subscriber received a message from the subscription. The returned value is a standard java absolute time, which is measured in milliseconds since midnight, January 1, 1970 UTC
This returns the JMS durable subscription boot time if there were no messages that were successfully delivered to any subscriber on this subscription since the subscription was booted. We define the boot time of a durable subscription to be the time the subscription is originally created or recovered during a server reboot or jms migration, which ever is latest.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.LastMessagesReceivedTime
Subscribers Total Count The total number of subscribers that have accessed this subscription since the creation or the last reboot of the subscription, whichever is later.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.SubscribersTotalCount
Subscribers High Count The highest number of subscribers that have shared this subscription at the same time since the creation or the last reboot of the subscription, which ever is later.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.SubscribersHighCount
Subscribers Current Count The number of subscribers that currently share this subscription.
MBean Attribute:
JMSDurableSubscriberRuntimeMBean.SubscribersCurrentCount