weblogic.management.runtime
Interface JMSServerRuntimeMBean

public interface JMSServerRuntimeMBean

This class is used for monitoring a WebLogic JMS server.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX" on http://www.oracle.com/technology/products/weblogic/index.html.

getHealthState

HealthState getHealthState()

The health state of this JMS server.

Returns:

The healthState value

getSessionPoolRuntimes

JMSSessionPoolRuntimeMBean[] getSessionPoolRuntimes()

The session pools running on this JMS server.

Returns:

The sessionPoolRuntimes value

getSessionPoolsCurrentCount

long getSessionPoolsCurrentCount()

The current number of session pools instantiated on this JMS server.

Returns:

The sessionPoolsCurrentCount value

getSessionPoolsHighCount

long getSessionPoolsHighCount()

The peak number of session pools instantiated on this JMS server since the last reset.

Returns:

The sessionPoolsHighCount value

getSessionPoolsTotalCount

long getSessionPoolsTotalCount()

The number of session pools instantiated on this JMS server since the last reset.

Returns:

The sessionPoolsTotalCount value

getDestinations

JMSDestinationRuntimeMBean[] getDestinations()

An array of destinations on this JMS server.

Returns:

The destinations value

getDestinationsCurrentCount

long getDestinationsCurrentCount()

The current number of destinations for this JMS server.

Returns:

The destinationsCurrentCount value

getDestinationsHighCount

long getDestinationsHighCount()

The peak number of destinations on this JMS server since the last reset.

Returns:

The destinationsHighCount value

getDestinationsTotalCount

long getDestinationsTotalCount()

The number of destinations instantiated on this JMS server since the last reset.

Returns:

The destinationsTotalCount value

getMessagesCurrentCount

long getMessagesCurrentCount()

The current number of messages stored on this JMS server. This number does not include the pending messages.

Returns:

The messagesCurrentCount value

getMessagesPendingCount

long getMessagesPendingCount()

The current number of messages pending (unacknowledged or uncommitted) stored on this JMS server.

Pending messages are over and above the current number of messages.

Returns:

The messagesPendingCount value

getMessagesHighCount

long getMessagesHighCount()

The peak number of messages stored in the JMS server since the last reset.

Returns:

The messagesHighCount value

getMessagesReceivedCount

long getMessagesReceivedCount()

The number of messages received on this destination since the last reset.

Returns:

The messagesReceivedCount value

getMessagesThresholdTime

long getMessagesThresholdTime()

The amount of time in the threshold condition since the last reset.

Returns:

The messagesThresholdTime value

getBytesCurrentCount

long getBytesCurrentCount()

The current number of bytes stored on this JMS server.

This number does not include the pending bytes.

Returns:

The bytesCurrentCount value

getBytesPendingCount

long getBytesPendingCount()

The current number of bytes pending (unacknowledged or uncommitted) stored on this JMS server.

Pending bytes are over and above the current number of bytes.

Returns:

The bytesPendingCount value

getBytesHighCount

long getBytesHighCount()

The peak number of bytes stored in the JMS server since the last reset.

Returns:

The bytesHighCount value

getBytesReceivedCount

long getBytesReceivedCount()

The number of bytes received on this JMS server since the last reset.

Returns:

The bytesReceivedCount value

getBytesThresholdTime

long getBytesThresholdTime()

The amount of time in the threshold condition since the last reset.

Returns:

The bytesThresholdTime value

pauseProduction

void pauseProduction()
                     throws JMSException

Pauses the new message production on all the destinations hosted by the JMSServer.

When the production paused, it would prevent any new produce operations from both new and existing producers attached to the destinations. When the destination is "resumed from production pause", all the new message production is allowed from both new and existing producers attached to that destination.

Throws:

JMSException - Thrown when an internal JMS error occurs while pausing the production.

See Also:

JMSServerRuntimeMBean.resumeProduction(), JMSServerRuntimeMBean.pauseInsertion(), JMSServerRuntimeMBean.pauseConsumption()

isProductionPaused

boolean isProductionPaused()

Returns the current production paused state of the JMSServer as boolean value.

Returns:

returns true if the JMSServer is currently paused for new message production, false otherwise.

getProductionPausedState

String getProductionPausedState()

Returns the current production paused state of the JMSServer as string value.

Returns:

The possible values are:

• Production-Paused - indicates that the JMSServer and all of its destinations are currently paused for new message production.
• Production-Pausing - indicates that the JMSServer is in the process of pausing all the destinations for new message production.
• Production-Enabled - indicates that the JMSServer is not currently paused for new message prdoduction.

resumeProduction

void resumeProduction()
                      throws JMSException

Resumes the new message production operation on all the destinations hosted by the JMSServer. The state of the JMSServer shall be marked as "production enabled" thus allowing all the new "producing" activity to continue normally. Invoking this API on a JMSServer that is currently not in "production paused" state has no effect.

Throws:

JMSException - Thrown when an internal JMS error occurs while resuming the production.

pauseInsertion

void pauseInsertion()
                    throws JMSException

Pauses the appearance of any messages on all the destinations of the JMSServer, that are result of the in-flight work completion on all the destinations hosted by this JMSServer.

Definition of In-Flight work

The definitions below are based on the current implementation of WebLogic JMS subsystem.

In-flight messages associated with Producers

• UN-BORN MESSAGES

  Messages that are produced by the producer, with "birth time" (TimeToDeliver) set in future are called un-born messages and are counted as "pending" messages in the destination statistics and are not available for consumers yet.

• UN-COMMITTED MESSAGES

  These are the messages that are produced by the producer as part of the transaction (using either user transaction or transacted session) and the transaction is still not committed or rolled back. These messages are also counted as "pending" messages in the destination statistics and are not available for consumption.

• QUOTA BLOCKING SEND

  These are the messages that are produced by the producers but are not able reach the destination because of (either message or byte or both) quota limit on the destination and the producers are willing to block for a specific period of time for the quota to be available. These messages are invisible to the system and are not counted against any of the destination statistics.

In-flight messages associated with Consumers

• UN-ACKNOWLEDGED (CLIENT ACK PENDING) MESSAGES

  These are the messages that are successfully consumed by the clients using a "client acknowledge" session, and are awaiting acknowledgements from the clients. These are "pending messages" which will be removed from the destination/system when the acknowledgement is received.

• UN-COMMITTED MESSAGES

  These are the messages that are consumed (received) by the clients within a transaction (using either user transaction or transacted session) and the transaction is still not committed or rolled back. When the clients successfully commit the transaction the messages get removed from the system.

• ROLLED BACK MESSAGES

  These are the messages that are put back on the destination because of a successful rollback of transactional receive by the consumers. These messages might or might not be ready for consumption (re-delivered) to the clients immediately, depending on the redelivery parameters, RedeliveryDelay and/or RedeliveryDelayOverride and RedeliveryLimit configured on the associated JMSConnectionFactory and JMSDestination respectively.

  If there is a redelivery delay configured, then for that "delay" duration, the messages are not available for consumption and are counted as "pending" in the destination statistics and after the "delay" period, if the redelivery limit is not exceeded, then they are delivered (made available for consumption) on that destination and are counted as "current" messages in the destination statistics. If the redelivery limit exceeds, then those messages will be moved to the ErrorDestination, if one configured.

  Another parameter that controls the availability of the rolled back messages is RedeliveryLimit.

• RECOVERED MESSAGES

  These messages are similar to ROLLED BACK MESSAGES discussed above. Except that these messages appear on the queue because of an explicit call to session "recover" by the client.

• REDELIVERED MESSAGES

  These are again similar to ROLLED BACK MESSAGES except that these messages may re-appear on the destination because of an un-successful delivery attempt to the client (consumer crash, close etc.).

Throws:

JMSException - Thrown when an internal JMS error occurs while pausing the insertion.

See Also:

JMSServerRuntimeMBean.resumeInsertion(), JMSServerRuntimeMBean.pauseProduction(), JMSServerRuntimeMBean.pauseConsumption()

boolean isInsertionPaused()

String getInsertionPausedState()

void resumeInsertion()
                     throws JMSException

void pauseConsumption()
                      throws JMSException

boolean isConsumptionPaused()

String getConsumptionPausedState()

void resumeConsumption()
                       throws JMSException

String[] getTransactions()

String[] getPendingTransactions()

Integer getTransactionStatus(String xid)

String getMessages(String xid,
                   Integer timeoutSeconds)
                   throws ManagementException

Void forceCommit(String xid)
                 throws ManagementException

Void forceRollback(String xid)
                   throws ManagementException

int getMessagesPageableCurrentCount()

long getBytesPageableCurrentCount()

int getMessagesPagedOutTotalCount()

int getMessagesPagedInTotalCount()

long getBytesPagedOutTotalCount()

long getBytesPagedInTotalCount()