# JTARuntimeMBean

Overview | Related MBeans | Attributes | Operations

## Overview

This interface is used for accessing transaction runtime characteristics within a WebLogic server.

Fully Qualified Interface Name | If you use the `getMBeanInfo` operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name: `weblogic.management.runtime.JTARuntimeMBean`
Factory Methods | No factory methods. Instances of this MBean are created automatically.
Access Points | You can access this MBean from the following MBean attributes:
ServerRuntimeMBean.JTARuntime |

## Related MBeans

This section describes attributes that provide access to other MBeans. For more information about the MBean hierarchy, refer to WebLogic Server MBean Data Model.

NonXAResourceRuntimeMBeans RecoveryRuntimeMBeans TransactionNameRuntimeMBeans | TransactionResourceRuntimeMBeans

### NonXAResourceRuntimeMBeans

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

For more information, see:

- NonXAResourceRuntimeMBean

Privileges | Read only
Type | NonXAResourceRuntimeMBean[]
Relationship type: | Reference.

### RecoveryRuntimeMBeans

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

Factory Methods | No explicit creator method. The child shares the lifecycle of its parent.
Privileges | Read only
Type | JTARecoveryRuntimeMBean[]
Relationship type: | Containment.

### TransactionNameRuntimeMBeans

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

For more information, see:

- TransactionNameRuntimeMBean

Privileges | Read only
Type | TransactionNameRuntimeMBean[]
Relationship type: | Reference.

### TransactionResourceRuntimeMBeans

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

For more information, see:

- TransactionResourceRuntimeMBean

Privileges | Read only
Type | TransactionResourceRuntimeMBean[]
Relationship type: | Reference.

## Attributes

This section describes the following attributes:

ActiveTransactionsTotalCount HealthState JTATransactions Name Parent RegisteredNonXAResourceNames RegisteredResourceNames SecondsActiveTotalCount TransactionAbandonedTotalCount TransactionCommittedTotalCount | TransactionHeuristicsTotalCount TransactionRolledBackAppTotalCount TransactionRolledBackResourceTotalCount TransactionRolledBackSystemTotalCount TransactionRolledBackTimeoutTotalCount TransactionRolledBackTotalCount TransactionTotalCount Type

### ActiveTransactionsTotalCount

The number of active transactions on the server.

Privileges | Read only
Type | int

### HealthState

The health state of the JTA subsystem.

Privileges | Read only
Type | weblogic.health.HealthState

### JTATransactions

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

Privileges | Read only
Type | interface weblogic.management.runtime.JTATransaction[]

### Name

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

Privileges | Read only
Type | java.lang.String

### Parent

Return the immediate parent for this MBean

Privileges | Read/Write
Type |

### RegisteredNonXAResourceNames

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

Privileges | Read only
Type | class java.lang.String[]

### RegisteredResourceNames

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

Privileges | Read only
Type | class java.lang.String[]

### SecondsActiveTotalCount

The total number of seconds that transactions were active for all committed transactions.

Privileges | Read only
Type | long

### TransactionAbandonedTotalCount

The total number of transactions that were abandoned since the server was started.

Privileges | Read only
Type | long

### TransactionCommittedTotalCount

The total number of transactions committed since the server was started.

Privileges | Read only
Type | long

### TransactionHeuristicsTotalCount

The number of transactions that completed with a heuristic status since the server was started.

Privileges | Read only
Type | long

### TransactionRolledBackAppTotalCount

The number of transactions that were rolled back due to an application error.

Privileges | Read only
Type | long

### TransactionRolledBackResourceTotalCount

The number of transactions that were rolled back due to a resource error.

Privileges | Read only
Type | long

### TransactionRolledBackSystemTotalCount

The number of transactions that were rolled back due to an internal system error.

Privileges | Read only
Type | long

### TransactionRolledBackTimeoutTotalCount

The number of transactions that were rolled back due to a timeout expiration.

Privileges | Read only
Type | long

### TransactionRolledBackTotalCount

The number of transactions that were rolled back since the server was started.

Privileges | Read only
Type | long

### TransactionTotalCount

The total number of transactions processed. This total includes all committed, rolled back, and heuristic transaction completions since the server was started.

Privileges | Read only
Type | long

### Type

Returns the type of the MBean.

Privileges | Read only
Type | java.lang.String

## Operations

This section describes the following operations:

forceGlobalCommit forceGlobalRollback forceLocalCommit forceLocalRollback | getJTATransaction getRecoveryRuntimeMBean getTransactionsOlderThan

### forceGlobalCommit

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.

Operation Name | `"forceGlobalCommit"`
Parameters | `Object [] { xid }` where: `xid` is an object of type `javax.transaction.xa.Xid` that specifies: xid
Signature | `String [] { "javax.transaction.xa.Xid" }`
Returns | `void`
Exceptions | `java.rmi.RemoteException`

### forceGlobalRollback

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.

Operation Name | `"forceGlobalRollback"`
Parameters | `Object [] { xid }` where: `xid` is an object of type `javax.transaction.xa.Xid` that specifies: xid
Signature | `String [] { "javax.transaction.xa.Xid" }`
Returns | `void`
Exceptions | `java.rmi.RemoteException`

### forceLocalCommit

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

Operation Name | `"forceLocalCommit"`
Parameters | `Object [] { xid }` where: `xid` is an object of type `javax.transaction.xa.Xid` that specifies: xid
Signature | `String [] { "javax.transaction.xa.Xid" }`
Returns | `void`
Exceptions | `java.rmi.RemoteException`

### forceLocalRollback

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

Operation Name | `"forceLocalRollback"`
Parameters | `Object [] { xid }` where: `xid` is an object of type `javax.transaction.xa.Xid` that specifies: xid
Signature | `String [] { "javax.transaction.xa.Xid" }`
Returns | `void`
Exceptions | `java.rmi.RemoteException`

### getJTATransaction

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.

Operation Name | `"getJTATransaction"`
Parameters | `Object [] { xid }` where: `xid` is an object of type `java.lang.String` that specifies: xid
Signature | `String [] { "java.lang.String" }`
Returns | `JTATransaction`
Exceptions | `java.rmi.RemoteException`

### getRecoveryRuntimeMBean

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.

Operation Name | `"getRecoveryRuntimeMBean"`
Parameters | `Object [] { serverName }` where: `serverName` is an object of type `java.lang.String` that specifies: serverName
Signature | `String [] { "java.lang.String" }`
Returns | `JTARecoveryRuntimeMBean`

### getTransactionsOlderThan

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.

Operation Name | `"getTransactionsOlderThan"`
Parameters | `Object [] { seconds }` where: `seconds` is an object of type `java.lang.Integer` that specifies: The transaction duration in seconds qualifier.
Signature | `String [] { "java.lang.Integer" }`
Returns | `class`