Type-Safe Access to BEA WebLogic Server 9.1 MBeans (Deprecated)

(Methods marked with @since 9.0.0.0 or later are not available through the deprecated MBeanHome interface.)

weblogic.management.runtime
Interface JTARuntimeMBean

All Superinterfaces:

DynamicMBean, weblogic.health.HealthFeedback, JTAStatisticsRuntimeMBean, JTATransactionStatisticsRuntimeMBean, MBeanRegistration, NotificationBroadcaster, weblogic.management.runtime.RuntimeMBean, weblogic.management.WebLogicMBean

public interface JTARuntimeMBean

extends JTATransactionStatisticsRuntimeMBean, weblogic.health.HealthFeedback

This interface is used for accessing transaction runtime characteristics within a WebLogic 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/documentation/index.html.

Copyright © 2005 BEA Systems, Inc. All Rights Reserved.

Method Summary

void	forceGlobalCommit(Xid xid) Forces the transaction represented by xid to be committed at all participating SubCoordinators.
void	forceGlobalRollback(Xid xid) Forces the transaction represented by xid to be rolled-back at all participating SubCoordinators.
void	forceLocalCommit(Xid xid) Forces the transaction represented by xid to be committed at the local SubCoordinator only.
void	forceLocalRollback(Xid xid) Forces the transaction represented by xid to be rolled-back at the local SubCoordinator only.
int	getActiveTransactionsTotalCount() The number of active transactions on the server.
weblogic.health.HealthState	getHealthState() The health state of the JTA subsystem.
JTATransaction	getJTATransaction(String xid) Returns the JTATransaction information object for the specified Xid.
JTATransaction[]	getJTATransactions() An array of JTATransaction objects.
NonXAResourceRuntimeMBean[]	getNonXAResourceRuntimeMBeans() An array of NonXAResourceRuntimeMBeans that each represents the statistics for a non-XA resource.
JTARecoveryRuntimeMBean	getRecoveryRuntimeMBean(String serverName) Returns the runtime MBean for the Transaction Recovery Service of the specified server.
JTARecoveryRuntimeMBean[]	getRecoveryRuntimeMBeans() Returns the runtime MBeans for the Transaction Recovery Services that were deployed on this server.
String[]	getRegisteredNonXAResourceNames() An array of NonXA resource names that are registered with the transaction manager.
String[]	getRegisteredResourceNames() An array of XA resource names that are registered with the transaction manager.
TransactionNameRuntimeMBean[]	getTransactionNameRuntimeMBeans() An array of TransactionNameRuntimeMBeans that represent statistics for all transactions in the server, categorized by transaction name.
TransactionResourceRuntimeMBean[]	getTransactionResourceRuntimeMBeans() An array of TransactionResourceRuntimeMBeans that each represents the statistics for a transaction resource.
JTATransaction[]	getTransactionsOlderThan(Integer seconds) An array of JTATransaction objects.

Methods inherited from interface weblogic.management.runtime.JTATransactionStatisticsRuntimeMBean

getSecondsActiveTotalCount, getTransactionAbandonedTotalCount, getTransactionRolledBackAppTotalCount, getTransactionRolledBackResourceTotalCount, getTransactionRolledBackSystemTotalCount, getTransactionRolledBackTimeoutTotalCount

Methods inherited from interface weblogic.management.runtime.JTAStatisticsRuntimeMBean

getTransactionCommittedTotalCount, getTransactionHeuristicsTotalCount, getTransactionRolledBackTotalCount, getTransactionTotalCount

Methods inherited from interface weblogic.management.WebLogicMBean

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

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preDeregister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Method Detail

forceGlobalCommit

public void forceGlobalCommit(Xid xid)
                       throws RemoteException

Forces the transaction represented by xid to be committed at all participating SubCoordinators. If the server on which the method is invoked is not the coordinating server then the coordinating server will be notified to process the commit.

Parameters:

xid -

Throws:

RemoteException

forceGlobalRollback

public void forceGlobalRollback(Xid xid)
                         throws RemoteException

Forces the transaction represented by xid to be rolled-back at all participating SubCoordinators. If the server on which the method is invoked is not the coordinating server then the coordinating server will be notified to process the rollback.

Parameters:

xid -

Throws:

RemoteException

forceLocalCommit

public void forceLocalCommit(Xid xid)
                      throws RemoteException

Forces the transaction represented by xid to be committed at the local SubCoordinator only.

Parameters:

xid -

Throws:

RemoteException

forceLocalRollback

public void forceLocalRollback(Xid xid)
                        throws RemoteException

Forces the transaction represented by xid to be rolled-back at the local SubCoordinator only.

Parameters:

xid -

Throws:

RemoteException

getActiveTransactionsTotalCount

public int getActiveTransactionsTotalCount()

The number of active transactions on the server.

Returns:

The activeTransactionsTotalCount value

getHealthState

public weblogic.health.HealthState getHealthState()

The health state of the JTA subsystem.

Specified by:

getHealthState in interface weblogic.health.HealthFeedback

Returns:

The healthState value

getJTATransaction

public JTATransaction getJTATransaction(String xid)
                                 throws RemoteException

Returns the JTATransaction information object for the specified Xid. If the transaction represented by xid does not exist on the server, then the method will return null.

Parameters:

xid -

Returns:

The jTATransaction value

Throws:

RemoteException

getJTATransactions

public JTATransaction[] getJTATransactions()

An array of JTATransaction objects. Each object provides detailed information regarding an active transaction.

Returns:

The jTATransactions value

getNonXAResourceRuntimeMBeans

public NonXAResourceRuntimeMBean[] getNonXAResourceRuntimeMBeans()
                                                          throws RemoteException

An array of NonXAResourceRuntimeMBeans that each represents the statistics for a non-XA resource.

Returns:

The nonXAResourceRuntimeMBeans value

Throws:

RemoteException

See Also:

NonXAResourceRuntimeMBean

getRecoveryRuntimeMBean

public JTARecoveryRuntimeMBean getRecoveryRuntimeMBean(String serverName)

Returns the runtime MBean for the Transaction Recovery Service of the specified server. If the Transaction Recovery Service of the specified server is not deployed on this server, null will be returned.

Parameters:

serverName -

Returns:

The recoveryRuntimeMBean value

getRecoveryRuntimeMBeans

public JTARecoveryRuntimeMBean[] getRecoveryRuntimeMBeans()

Returns the runtime MBeans for the Transaction Recovery Services that were deployed on this server.

Returns:

The recoveryRuntimeMBeans value

getRegisteredNonXAResourceNames

public String[] getRegisteredNonXAResourceNames()

An array of NonXA resource names that are registered with the transaction manager.

Returns:

The registeredNonXAResourceNames value

getRegisteredResourceNames

public String[] getRegisteredResourceNames()

An array of XA resource names that are registered with the transaction manager.

Returns:

The registeredResourceNames value

getTransactionNameRuntimeMBeans

public TransactionNameRuntimeMBean[] getTransactionNameRuntimeMBeans()
                                                              throws RemoteException

An array of TransactionNameRuntimeMBeans that represent statistics for all transactions in the server, categorized by transaction name.

Returns:

The transactionNameRuntimeMBeans value

Throws:

RemoteException

See Also:

TransactionNameRuntimeMBean

getTransactionResourceRuntimeMBeans

public TransactionResourceRuntimeMBean[] getTransactionResourceRuntimeMBeans()
                                                                      throws RemoteException

An array of TransactionResourceRuntimeMBeans that each represents the statistics for a transaction resource.

Returns:

The transactionResourceRuntimeMBeans value

Throws:

RemoteException

See Also:

TransactionResourceRuntimeMBean

getTransactionsOlderThan

public JTATransaction[] getTransactionsOlderThan(Integer seconds)

An array of JTATransaction objects. Each object provides detailed information regarding an active transaction that has existed for a period longer than the time specified.

Parameters:

seconds - The transaction duration in seconds qualifier.

Returns:

The transactionsOlderThan value