weblogic.management.configuration
Interface JTAMBean
- public interface JTAMBean
- extends ConfigurationMBean
This interface provides access to the JTA configuration
attributes. The methods defined herein are applicable for
JTA configuration at the domain level.
- Author:
- Copyright © 2004 BEA Systems, Inc. All Rights Reserved.
Method Summary
|
int |
getAbandonTimeoutSeconds()
The transaction abandon timeout in seconds. |
int |
getBeforeCompletionIterationLimit()
The maximum number of cycles the transaction manager will
perform the beforeCompletion synchronization callback. |
int |
getCheckpointIntervalSeconds()
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. |
boolean |
getForgetHeuristics()
Whether or not the transaction manager
automatically performs an XA Resource forget() operation
for all resources reporting a heuristic decision. |
int |
getMaxResourceRequestsOnServer()
Maximum number of concurrent requests to resources
allowed for each server. |
long |
getMaxResourceUnavailableMillis()
Maximum duration in milliseconds that a resource is declared dead. |
int |
getMaxTransactions()
The maximum number of simultaneous in-progress
transactions allowed on a server. |
int |
getMaxUniqueNameStatistics()
The maximum number of unique transaction names for which
statistics will be maintained. |
long |
getMaxXACallMillis()
Maximum allowed duration of XA calls to resources. |
long |
getSerializeEnlistmentsGCIntervalMillis()
The interval at which internal objects used to serialize resource
enlistment are cleaned up. |
int |
getTimeoutSeconds()
The transaction timeout in seconds. |
void |
setAbandonTimeoutSeconds(int timeout)
The transaction abandon timeout in seconds. |
void |
setBeforeCompletionIterationLimit(int iterations)
Sets the maximum number of cycles the transaction manager will
perform the beforeCompletion synchronization callback. |
void |
setCheckpointIntervalSeconds(int interval)
Sets 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. |
void |
setForgetHeuristics(boolean forget)
Controls whether or not the transaction manager
automatically performs an XA Resource forget() operation
for all resources reporting a heuristic decision. |
void |
setMaxTransactions(int max)
The maximum number of simultaneous in-progress
transactions allowed on a server. |
void |
setMaxUniqueNameStatistics(int max)
Sets the maximum number of unique transaction names for which
statistics will be maintained. |
void |
setTimeoutSeconds(int timeout)
The transaction timeout in seconds. |
Methods inherited from interface javax.management.DynamicMBean |
getAttribute,
getAttributes,
invoke,
setAttribute,
setAttributes |
Methods inherited from interface javax.management.MBeanRegistration |
postDeregister,
postRegister,
preRegister |
Methods inherited from interface javax.management.NotificationBroadcaster |
addNotificationListener,
getNotificationInfo,
removeNotificationListener |
CACHING_STUB_SVUID
public static final long CACHING_STUB_SVUID
getTimeoutSeconds
public int getTimeoutSeconds()
- The transaction timeout in seconds. If the transaction is
still in the "active" state after this time (counting from
begin()), it is automatically rolled back. Once the transaction
moves on to the prepared state, however, this timeout parameter
does not apply; the transaction is retried until all the resources
are committed.
- Default Value: 30
- Returns:
- Transaction timeout in seconds.
setTimeoutSeconds
public void setTimeoutSeconds(int timeout)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- The transaction timeout in seconds. If the transaction is
still in the "active" state after this time (counting from
begin()), it is automatically rolled back. Once the transaction
moves on to the prepared state, however, this timeout parameter
does not apply; the transaction is retried until all the resources
are committed.
- A dynamic MBean attribute
- Legal Minimum Value: 1
- Legal Maximum Value: java.lang.Integer.MAX_VALUE
- Parameters:
timeout
- Transaction timeout in seconds.- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getAbandonTimeoutSeconds
public int getAbandonTimeoutSeconds()
- The transaction abandon timeout in seconds. During the second phase
of the two-phase commit process, the transaction manager will continue
to try to complete the transaction until all resource managers indicate
that the transaction is completed. Using the AbandonTimeoutSeconds
attribute, you can set the maximum time that a transaction manager will
persist in attempting to complete a transaction during the second phase
of the transaction. After the abandon transaction timer expires,
no further attempt is made to resolve the transaction. If the transaction
is in a prepared state before being abandoned, the transaction manager will
roll back the transaction to release any locks held on behalf of the
abandoned transaction.
- Default Value: 86400
- Returns:
- Abandon timeout in seconds. Default is 24 hours.
setAbandonTimeoutSeconds
public void setAbandonTimeoutSeconds(int timeout)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- The transaction abandon timeout in seconds. During the second phase
of the two-phase commit process, the transaction manager will continue
to try to complete the transaction until all resource managers indicate
that the transaction is completed. Using the AbandonTimeoutSeconds
attribute, you can set the maximum time that a transaction manager will
persist in attempting to complete a transaction during the second phase
of the transaction. After the abandon transaction timer expires,
no further attempt is made to resolve the transaction. If the transaction
is in a prepared state before being abandoned, the transaction manager will
roll back the transaction to release any locks held on behalf of the
abandoned transaction.
- A dynamic MBean attribute
- Legal Minimum Value: 1
- Legal Maximum Value: java.lang.Integer.MAX_VALUE
- Parameters:
timeout
- Abandon timeout in seconds.- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getForgetHeuristics
public boolean getForgetHeuristics()
- Whether or not the transaction manager
automatically performs an XA Resource forget() operation
for all resources reporting a heuristic decision. The default
is true; a forget is issued as soon as the transaction learns
of a heuristic outcome. Set it to false only if you know what
to do with the resource when it reports a heuristic decision.
- Default Value: true
- Returns:
- true if heuristic transactions are to be forgotten in
affected resource managers, false otherwise.
setForgetHeuristics
public void setForgetHeuristics(boolean forget)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- Controls whether or not the transaction manager
automatically performs an XA Resource forget() operation
for all resources reporting a heuristic decision. The default
is true; a forget is issued as soon as the transaction learns
of a heuristic outcome. Set it to false only if you know what
to do with the resource when it reports a heuristic decision.
- A dynamic MBean attribute
- Parameters:
forget
- Whether or not to forget heuristic transactions
in affected resource managers.- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getBeforeCompletionIterationLimit
public int getBeforeCompletionIterationLimit()
- The maximum number of cycles the transaction manager will
perform the beforeCompletion synchronization callback. Nothing
prevents a Synchronization object from registering another during
beforeCompletion, even those whose beforeCompletions have already
been called. For example, an EJB can call another in its ejbStore()
method. To accomodate this, the transaction manager calls all
Synchronization objects, then repeates the cycle if new ones have been
registered. This count sets a limit to the number of cycles that
can happen.
- Default Value: 10
- Returns:
- The maximum beforeCompletion iterations
setBeforeCompletionIterationLimit
public void setBeforeCompletionIterationLimit(int iterations)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- Sets the maximum number of cycles the transaction manager will
perform the beforeCompletion synchronization callback. Nothing
prevents a Synchronization object from registering another during
beforeCompletion, even those whose beforeCompletions have already
been called. For example, an EJB can call another in its ejbStore()
method. To accomodate this, the transaction manager calls all
Synchronization objects, then repeates the cycle if new ones have been
registered. This count sets a limit to the number of cycles that
can happen.
- A dynamic MBean attribute
- Legal Minimum Value: 1
- Legal Maximum Value: java.lang.Integer.MAX_VALUE
- Parameters:
iterations
- The maximum number of beforeCompletion iterations
among registered objects.- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getMaxTransactions
public int getMaxTransactions()
- The maximum number of simultaneous in-progress
transactions allowed on a server.
- Default Value: 10000
- Returns:
- The maximum number of concurrent transactions.
setMaxTransactions
public void setMaxTransactions(int max)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- The maximum number of simultaneous in-progress
transactions allowed on a server.
- A dynamic MBean attribute
- Legal Minimum Value: 1
- Legal Maximum Value: java.lang.Integer.MAX_VALUE
- Parameters:
max
- The maximum number of concurrent transactions.- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getMaxUniqueNameStatistics
public int getMaxUniqueNameStatistics()
- The maximum number of unique transaction names for which
statistics will be maintained. A transaction name typically
represents a category of business transactions (such as
"funds-transfer")
- Default Value: 1000
- Returns:
- Limit of individual transaction name statistics.
setMaxUniqueNameStatistics
public void setMaxUniqueNameStatistics(int max)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- Sets the maximum number of unique transaction names for which
statistics will be maintained. A transaction name typically
represents a category of business transactions (such as
"funds-transfer")
- A dynamic MBean attribute
- Legal Minimum Value: 0
- Legal Maximum Value: java.lang.Integer.MAX_VALUE
- Parameters:
max
- Limit of individual transaction name statistics- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getMaxResourceRequestsOnServer
public int getMaxResourceRequestsOnServer()
- Maximum number of concurrent requests to resources
allowed for each server.
- Default Value: 50
- Returns:
- The maxResourceRequestsOnServer value
getMaxXACallMillis
public long getMaxXACallMillis()
- Maximum allowed duration of XA calls to resources. If a
particular XA call to a resource exceeds the limit, the resource
is declared unavailable.
- Default Value: 120000
- Returns:
- The maxXACallMillis value
getMaxResourceUnavailableMillis
public long getMaxResourceUnavailableMillis()
- Maximum duration in milliseconds that a resource is declared dead. After
the duration, the resource will be declared available again, even if
the resource provider does not explicitly re-register the resource.
- Default Value: 1800000
- Returns:
- The maxResourceUnavailableMillis value
getCheckpointIntervalSeconds
public int getCheckpointIntervalSeconds()
- 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.
Default is 300 seconds (5 minutes); minimum is 10 seconds;
maximum is 1800 seconds (30 minutes).
- Default Value: 300
- Returns:
- The checkpointIntervalSeconds value
setCheckpointIntervalSeconds
public void setCheckpointIntervalSeconds(int interval)
throws javax.management.InvalidAttributeValueException,
DistributedManagementException
- Sets 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.
Default is 300 seconds (5 minutes); minimum is 10 seconds;
maximum is 1800 seconds (30 minutes).
- A dynamic MBean attribute
- Legal Minimum Value: 10
- Legal Maximum Value: 1800
- Parameters:
interval
- The new checkpointIntervalSeconds value- Throws:
- javax.management.InvalidAttributeValueException -
- DistributedManagementException -
getSerializeEnlistmentsGCIntervalMillis
public long getSerializeEnlistmentsGCIntervalMillis()
- The interval at which internal objects used to serialize resource
enlistment are cleaned up.
- Default Value: 30000
- Legal Minimum Value: 0
- Returns:
- The serializeEnlistmentsGCIntervalMillis value