Package weblogic.management.runtime

Interface JMSDurableSubscriberRuntimeMBean

All Superinterfaces:

CursorRuntimeMBean, javax.management.DynamicMBean, JMSMessageCursorRuntimeMBean, JMSMessageManagementRuntimeMBean, javax.management.MBeanRegistration, MessageCursorRuntimeMBean, javax.management.NotificationBroadcaster, RuntimeMBean, WebLogicMBean

public interface JMSDurableSubscriberRuntimeMBean
extends JMSMessageManagementRuntimeMBean

This class is used for monitoring a WebLogic JMS durable subscriber.

Method Summary

Modifier and Type	Method	Description
void	destroy()	Completely removes this durable subscriber (and all messages associated with this durable subscription).
long	getBytesCurrentCount()	The number of bytes received by this durable subscriber.
long	getBytesPendingCount()	The number of bytes pending by this durable subscriber.
java.lang.String	getClientID()	A unique client identifier for this durable subscriber.
java.lang.String	getClientIDPolicy()	The policy for the client identifier for this durable subscriber.
javax.management.openmbean.CompositeData	getCurrentConsumerInfo()	Specifies information about the current consumer.
java.lang.String	getDestinationID()	Returns the destination ID.
javax.management.openmbean.CompositeData	getDestinationInfo()	Specifies information about the durable subscriber's internal destination in JMX open data representation.
JMSDestinationRuntimeMBean	getDestinationRuntime()	The runtime MBean of the Topic to which this durable subscriber is associated.
long	getLastMessagesReceivedTime()	The time when the last time a subscriber received a message from the subscription.
long	getMessagesCurrentCount()	The number of messages still available by this durable subscriber.
long	getMessagesHighCount()	The peak number of messages for the durable subscriber since the last reset.
long	getMessagesPendingCount()	The number of messages pending (uncommitted and unacknowledged) by this durable subscriber.
long	getMessagesReceivedCount()	The number of messages received by the durable subscriber since that reset.
java.lang.String	getSelector()	The message selector defined for this durable subscriber.
int	getSubscribersCurrentCount()	The number of subscribers that currently share this subscription.
int	getSubscribersHighCount()	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.
int	getSubscribersTotalCount()	The total number of subscribers that have accessed this subscription since the creation or the last reboot of the subscription, whichever is later.
long	getSubscriptionLimitDeletedCount()	The number of messages deleted because of a subscription limit.
java.lang.String	getSubscriptionName()	The subscription name for this durable subscriber.
java.lang.String	getSubscriptionSharingPolicy()	The SubscriptionSharingPolicy on this subscriber.
boolean	isActive()	Indicates whether this subscription is being used by a durable subscriber.
boolean	isNoLocal()	Specifies whether this durable subscriber receives local messages that it has published.
void	purge()	Deprecated. As of WLS 9.0.

Methods inherited from interface weblogic.management.runtime.CursorRuntimeMBean

closeCursor, getCursorEndPosition, getCursorSize, getCursorStartPosition, getItems, getNext, getPrevious

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface weblogic.management.runtime.JMSMessageCursorRuntimeMBean

sort

Methods inherited from interface weblogic.management.runtime.JMSMessageManagementRuntimeMBean

deleteMessages, exportMessages, getJMSMessage, getJMSMessages, getJMSTextMessage, getMessage, getMessages, getMessages, getMessagesDeletedCurrentCount, getMessagesMovedCurrentCount, getTasks, importMessages, importMessages, importMessages, moveMessages, moveMessages, moveMessages, produceTextMessage

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preRegister

Methods inherited from interface weblogic.management.runtime.MessageCursorRuntimeMBean

getMessage, getMessage

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Methods inherited from interface weblogic.management.runtime.RuntimeMBean

addPropertyChangeListener, removePropertyChangeListener

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent

Method Detail

getClientID

java.lang.String getClientID()

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.

Returns:

The clientID value

getClientIDPolicy

java.lang.String getClientIDPolicy()

The policy for the client identifier for this durable subscriber.

Note: The client ID policy is either Restricted or Unrestricted.

Returns:

The clientIDPolicy value weblogic.management.configuration.JMSConstants.CLIENT_ID_POLICY_RESTRICTED : Only one connection that uses this policy exists in a cluster at any given time for a particular ClientID. weblogic.management.configuration.JMSConstants.CLIENT_ID_POLICY_UNRESTRICTED : Connections created using this policy can specify any ClientID, even when other restricted or unrestricted connections already use the same ClientID.

getSubscriptionName

java.lang.String getSubscriptionName()

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"?".

Returns:

The subscriptionName value

isNoLocal

boolean isNoLocal()

Specifies whether this durable subscriber receives local messages that it has published.

To prevent this, set the noLocal parameter to true.

Returns:

The noLocal value

isActive

boolean isActive()
          throws java.rmi.RemoteException

Indicates whether this subscription is being used by a durable subscriber.

Returns:

The active value

Throws:

java.rmi.RemoteException

getSelector

java.lang.String getSelector()

The message selector defined for this durable subscriber.

Returns:

The selector value

getMessagesPendingCount

long getMessagesPendingCount()

The number of messages pending (uncommitted and unacknowledged) by this durable subscriber.

Returns:

The messagesPendingCount value

getMessagesCurrentCount

long getMessagesCurrentCount()

The number of messages still available by this durable subscriber.

Returns:

The messagesCurrentCount value

getMessagesHighCount

long getMessagesHighCount()

The peak number of messages for the durable subscriber since the last reset.

Returns:

The messagesHighCount value

getMessagesReceivedCount

long getMessagesReceivedCount()

The number of messages received by the durable subscriber since that reset.

Returns:

The messagesReceivedCount value

getSubscriptionLimitDeletedCount

long getSubscriptionLimitDeletedCount()

The number of messages deleted because of a subscription limit.

Returns:

The deleted messages count value

getBytesPendingCount

long getBytesPendingCount()

The number of bytes pending by this durable subscriber.

Returns:

The bytesPendingCount value

getBytesCurrentCount

long getBytesCurrentCount()

The number of bytes received by this durable subscriber.

Returns:

The bytesCurrentCount value

getLastMessagesReceivedTime

long getLastMessagesReceivedTime()

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.

Returns:

the time in milliseconds

purge

@Deprecated
void purge()

Deprecated.

As of WLS 9.0. Use JMSMessageManagementRuntimeMBean.deleteMessages(String)

Purges all the pending and current messages for this durable subscriber.

getDestinationRuntime

JMSDestinationRuntimeMBean getDestinationRuntime()

The runtime MBean of the Topic to which this durable subscriber is associated.

Returns:

The runtime MBean of the subscriber's Topic.

getCurrentConsumerInfo

javax.management.openmbean.CompositeData getCurrentConsumerInfo()
                                                         throws javax.management.openmbean.OpenDataException

Specifies information about the current consumer. The information is returned in the form of an OpenMBean CompositeData object.

Returns:

A CompositeData object that contains information about the consumer, including information about the JMS session and connection.

Throws:

javax.management.openmbean.OpenDataException - Thrown when an error occurs while constructing the CompositeData return value.

See Also:

ConsumerInfo

destroy

void destroy()
      throws javax.jms.JMSException

Completely removes this durable subscriber (and all messages associated with this durable subscription). After calling this method the durable subscription represented by this MBean is no longer be valid.

Throws:

javax.jms.JMSException

getDestinationInfo

javax.management.openmbean.CompositeData getDestinationInfo()
                                                     throws javax.management.openmbean.OpenDataException

Specifies information about the durable subscriber's internal destination in JMX open data representation. The resulting object is intended for use in the message management APIs for identifying a target destination.

Returns:

The subscriber's destination.

Throws:

javax.management.openmbean.OpenDataException - Thrown when an error occurs while constructing the CompositeData return value.

See Also:

JMSMessageManagementRuntimeMBean.moveMessages(String, CompositeData), JMSMessageManagementRuntimeMBean.moveMessages(String, CompositeData, Integer)

getDestinationID

java.lang.String getDestinationID()
                           throws javax.jms.JMSException

Returns the destination ID.

Returns:

The destination ID.

Throws:

javax.jms.JMSException

See Also:

JMSMessageManagementRuntimeMBean.moveMessages(String, String, int)

getSubscriptionSharingPolicy

java.lang.String getSubscriptionSharingPolicy()

The SubscriptionSharingPolicy on this subscriber.

Returns:

the SubscriptionSharingPolicy weblogic.management.configuration.JMSConstants.SUBSCRIPTION_EXCLUSIVE : This subscriber exclusively uses one subscription. weblogic.management.configuration.JMSConstants.SUBSCRIPTION_SHARABLE : This subscriber may share a subscription with others.

Default Value:

weblogic.management.configuration.JMSConstants.SUBSCRIPTION_EXCLUSIVE

getSubscribersTotalCount

int getSubscribersTotalCount()

The total number of subscribers that have accessed this subscription since the creation or the last reboot of the subscription, whichever is later.

Returns:

the total number of subscribers

Default Value:

0

getSubscribersHighCount

int getSubscribersHighCount()

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.

Returns:

the number of subscribers

Default Value:

0

getSubscribersCurrentCount

int getSubscribersCurrentCount()

The number of subscribers that currently share this subscription.

Returns:

the number of subscribers

Default Value:

0