Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.2)

Part Number E27170-01

weblogic.management.configuration
Interface JTAClusterMBean

All Superinterfaces:
ConfigurationMBean, DescriptorBean, DynamicMBean, JTAMBean, MBeanRegistration, NotificationBroadcaster, SettableBean, WebLogicMBean

public interface JTAClusterMBean
extends JTAMBean

This interface provides access to the JTA configuration attributes. The methods defined herein are applicable for JTA configuration at the clluster level.


Field Summary
 
Fields inherited from interface weblogic.management.configuration.JTAMBean
CLIENTCERTREQUIRED, SSLNOTREQUIRED, SSLREQUIRED
 
Fields inherited from interface weblogic.management.configuration.ConfigurationMBean
DEFAULT_EMPTY_BYTE_ARRAY
 
Method Summary
 int getAbandonTimeoutSeconds()
          Specifies the maximum amount of time, in seconds, a transaction manager persists in attempting to complete the second phase of a two-phase commit transaction.
 int getBeforeCompletionIterationLimit()
          The maximum number of cycles that the transaction manager performs the beforeCompletion synchronization callback for this cluster.
 int getCheckpointIntervalSeconds()
          The interval at which the transaction manager creates a new transaction log file and checks all old transaction log files to see if they are ready to be deleted.
 int getCompletionTimeoutSeconds()
          Specifies the maximum amount of time, in seconds, a transaction manager waits for all resource managers to respond and indicate if the transaction can be committed or rolled back.
 boolean getForgetHeuristics()
          Specifies whether the transaction manager automatically performs an XA Resource forget operation for heuristic transaction completions.
 int getMaxResourceRequestsOnServer()
          Maximum number of concurrent requests to resources allowed for each server.
 long getMaxResourceUnavailableMillis()
          Maximum duration time, in milliseconds, that a resource is declared dead.
 int getMaxTransactions()
          The maximum number of simultaneous in-progress transactions allowed on a server in this cluster.
 long getMaxTransactionsHealthIntervalMillis()
          The interval for which the transaction map must be full for the JTA subsystem to declare its health as CRITICAL.
 int getMaxUniqueNameStatistics()
          The maximum number of unique transaction names for which statistics are maintained.
 long getMaxXACallMillis()
          Maximum allowed time duration, in milliseconds, for XA calls to resources.
 int getMigrationCheckpointIntervalSeconds()
          The time interval, in seconds, that the checkpoint is done for the migrated transaction logs (TLOGs).
 String getParallelXADispatchPolicy()
          The dispatch policy to use when performing XA operations in parallel.
 boolean getParallelXAEnabled()
          Indicates that XA calls are executed in parallel if there are available threads.
 int getPurgeResourceFromCheckpointIntervalSeconds()
          The interval that a particular resource must be accessed within for it to be included in the checkpoint record.
 long getRecoveryThresholdMillis()
          The interval that recovery is attempted until the resource becomes available.
 String getSecurityInteropMode()
          Specifies the security mode of the communication channel used for XA calls between servers that participate in a global transaction.
 long getSerializeEnlistmentsGCIntervalMillis()
          The time interval, in milliseconds, at which internal objects used to serialize resource enlistment are cleaned up.
 int getTimeoutSeconds()
          Specifies the maximum amount of time, in seconds, an active transaction is allowed to be in the first phase of a two-phase commit transaction.
 int getUnregisterResourceGracePeriod()
          The amount of time, in seconds, a transaction manager waits for transactions involving the resource to complete before unregistering a resource.
 String getWSATTransportSecurityMode()
           Specifies transport security mode required by WebService Transaction endpoints.
 boolean isClusterwideRecoveryEnabled()
          Indicates that cluster-wide recovery is used for distributed transactions.
 boolean isTightlyCoupledTransactionsEnabled()
          Indicates tight coupling of transaction branches that span different transaction manager systems.
 boolean isTwoPhaseEnabled()
          Indicates that the two-phase commit protocol is used to coordinate transactions across two or more resource managers.
 boolean isWSATIssuedTokenEnabled()
          Specifies whether to use issuedtoken to enable authentication between the WS-AT coordinator and participant.
 
Methods inherited from interface weblogic.management.configuration.JTAMBean
setAbandonTimeoutSeconds, setBeforeCompletionIterationLimit, setCheckpointIntervalSeconds, setClusterwideRecoveryEnabled, setCompletionTimeoutSeconds, setForgetHeuristics, setMaxTransactions, setMaxUniqueNameStatistics, setParallelXAEnabled, setSecurityInteropMode, setTightlyCoupledTransactionsEnabled, setTimeoutSeconds, setTwoPhaseEnabled, setUnregisterResourceGracePeriod, setWSATIssuedTokenEnabled, setWSATTransportSecurityMode
 
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
 
Methods inherited from interface weblogic.management.WebLogicMBean
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, 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
 
Methods inherited from interface weblogic.descriptor.DescriptorBean
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener
 

Method Detail

getTimeoutSeconds

int getTimeoutSeconds()

Specifies the maximum amount of time, in seconds, an active transaction is allowed to be in the first phase of a two-phase commit transaction. If the specified amount of time expires, the transaction is automatically rolled back.

Specified by:
getTimeoutSeconds in interface JTAMBean
Returns:
Transaction timeout in seconds.

getAbandonTimeoutSeconds

int getAbandonTimeoutSeconds()

Specifies the maximum amount of time, in seconds, a transaction manager persists in attempting to complete the second phase of a two-phase commit transaction.

Specified by:
getAbandonTimeoutSeconds in interface JTAMBean
Returns:
Abandon timeout in seconds. Default is 24 hours.

getCompletionTimeoutSeconds

int getCompletionTimeoutSeconds()

Specifies the maximum amount of time, in seconds, a transaction manager waits for all resource managers to respond and indicate if the transaction can be committed or rolled back.

Specified by:
getCompletionTimeoutSeconds in interface JTAMBean
Returns:
Completion timeout in seconds.

getForgetHeuristics

boolean getForgetHeuristics()

Specifies whether the transaction manager automatically performs an XA Resource forget operation for heuristic transaction completions.

Specified by:
getForgetHeuristics in interface JTAMBean
Returns:
true if heuristic transactions are to be forgotten in affected resource managers, false otherwise.

getBeforeCompletionIterationLimit

int getBeforeCompletionIterationLimit()

The maximum number of cycles that the transaction manager performs the beforeCompletion synchronization callback for this cluster.

Specified by:
getBeforeCompletionIterationLimit in interface JTAMBean
Returns:
The maximum beforeCompletion iterations

getMaxTransactions

int getMaxTransactions()

The maximum number of simultaneous in-progress transactions allowed on a server in this cluster.

Specified by:
getMaxTransactions in interface JTAMBean
Returns:
The maximum number of concurrent transactions.

getMaxUniqueNameStatistics

int getMaxUniqueNameStatistics()

The maximum number of unique transaction names for which statistics are maintained.

Specified by:
getMaxUniqueNameStatistics in interface JTAMBean
Returns:
Limit of individual transaction name statistics.

getMaxResourceRequestsOnServer

int getMaxResourceRequestsOnServer()

Maximum number of concurrent requests to resources allowed for each server.

Specified by:
getMaxResourceRequestsOnServer in interface JTAMBean
Returns:
The maxResourceRequestsOnServer value

getMaxXACallMillis

long getMaxXACallMillis()

Maximum allowed time duration, in milliseconds, for XA calls to resources. If a particular XA call to a resource exceeds the limit, the resource is declared unavailable.

Specified by:
getMaxXACallMillis in interface JTAMBean
Returns:
The maxXACallMillis value

getMaxResourceUnavailableMillis

long getMaxResourceUnavailableMillis()

Maximum duration time, in milliseconds, that a resource is declared dead.

Specified by:
getMaxResourceUnavailableMillis in interface JTAMBean
Returns:
The maxResourceUnavailableMillis value

getRecoveryThresholdMillis

long getRecoveryThresholdMillis()

The interval that recovery is attempted until the resource becomes available.


getMigrationCheckpointIntervalSeconds

int getMigrationCheckpointIntervalSeconds()

The time interval, in seconds, that the checkpoint is done for the migrated transaction logs (TLOGs).


getMaxTransactionsHealthIntervalMillis

long getMaxTransactionsHealthIntervalMillis()

The interval for which the transaction map must be full for the JTA subsystem to declare its health as CRITICAL.


getPurgeResourceFromCheckpointIntervalSeconds

int getPurgeResourceFromCheckpointIntervalSeconds()

The interval that a particular resource must be accessed within for it to be included in the checkpoint record.


getCheckpointIntervalSeconds

int getCheckpointIntervalSeconds()

The interval at which the transaction manager creates a new transaction log file and checks all old transaction log files to see if they are ready to be deleted.

Specified by:
getCheckpointIntervalSeconds in interface JTAMBean
Returns:
The checkpointIntervalSeconds value

getSerializeEnlistmentsGCIntervalMillis

long getSerializeEnlistmentsGCIntervalMillis()

The time interval, in milliseconds, at which internal objects used to serialize resource enlistment are cleaned up.

Specified by:
getSerializeEnlistmentsGCIntervalMillis in interface JTAMBean
Returns:
The serializeEnlistmentsGCIntervalMillis value

getParallelXAEnabled

boolean getParallelXAEnabled()

Indicates that XA calls are executed in parallel if there are available threads.


getParallelXADispatchPolicy

String getParallelXADispatchPolicy()

The dispatch policy to use when performing XA operations in parallel.


getUnregisterResourceGracePeriod

int getUnregisterResourceGracePeriod()

The amount of time, in seconds, a transaction manager waits for transactions involving the resource to complete before unregistering a resource.

Specified by:
getUnregisterResourceGracePeriod in interface JTAMBean
Returns:
The unregisterResource grace period in seconds.

getSecurityInteropMode

String getSecurityInteropMode()

Specifies the security mode of the communication channel used for XA calls between servers that participate in a global transaction. All server instances in a domain must have the same security mode setting.

Specified by:
getSecurityInteropMode in interface JTAMBean
Returns:
The security interoperability mode.

getWSATTransportSecurityMode

String getWSATTransportSecurityMode()

Specifies transport security mode required by WebService Transaction endpoints.

Transport Security options:

Specified by:
getWSATTransportSecurityMode in interface JTAMBean
Returns:
The WSAT transport security mode.

isWSATIssuedTokenEnabled

boolean isWSATIssuedTokenEnabled()

Specifies whether to use issuedtoken to enable authentication between the WS-AT coordinator and participant.

Specified by:
isWSATIssuedTokenEnabled in interface JTAMBean

isTwoPhaseEnabled

boolean isTwoPhaseEnabled()

Indicates that the two-phase commit protocol is used to coordinate transactions across two or more resource managers.

Specified by:
isTwoPhaseEnabled in interface JTAMBean

isClusterwideRecoveryEnabled

boolean isClusterwideRecoveryEnabled()

Indicates that cluster-wide recovery is used for distributed transactions.

When enabled, recovery operations for a distributed transaction are applied to all the servers of the cluster hosting a InterposedTransactionManager rather than just the server hosting the InterposedTransactionManager.

Specified by:
isClusterwideRecoveryEnabled in interface JTAMBean

isTightlyCoupledTransactionsEnabled

boolean isTightlyCoupledTransactionsEnabled()

Indicates tight coupling of transaction branches that span different transaction manager systems.

When enabled, WebLogic uses the transaction identifier of a transaction imported by the InterposedTransactionManager for XA calls rather than an internally mapped Xid. This applies to inter-domain WebLogic transactions and transactions imported from Tuxedo. This allows for tight coupling of transaction branches for transactions that span across different transaction manager systems.

Specified by:
isTightlyCoupledTransactionsEnabled in interface JTAMBean

Copyright 1996, 2013, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.2)

Part Number E27170-01