|
BEA Systems, Inc. | |||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||||
MBeanHome interface.)This interface provides access to the JTA configuration attributes. The methods defined herein are applicable for JTA configuration at the domain level.
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.
| Field Summary |
| Fields inherited from interface weblogic.management.configuration.ConfigurationMBean |
DEFAULT_EMPTY_BYTE_ARRAY |
| Method Summary | |
int |
getAbandonTimeoutSeconds()
The transaction abandon timeout seconds for transactions in the second phase of the two-phase commit (prepared and later). |
int |
getBeforeCompletionIterationLimit()
The maximum number of cycles that the transaction manager will perform the beforeCompletion synchronization callback for this WebLogic Server domain. |
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. |
boolean |
getForgetHeuristics()
Specifies whether the transaction manager will automatically perform an XAResource forget operation for heuristic transaction completions. |
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 in this WebLogic Server domain. |
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. |
String |
getSecurityInteropMode()
Specifies the security mode to use for XA calls in cross-domain transactions. |
long |
getSerializeEnlistmentsGCIntervalMillis()
The interval at which internal objects used to serialize resource enlistment are cleaned up. |
int |
getTimeoutSeconds()
The transaction timeout seconds for active transactions, before the prepared state. |
int |
getUnregisterResourceGracePeriod()
The grace period (number of seconds) that the transaction manager waits for transactions involving the resource to complete before unregistering a resource. |
void |
setAbandonTimeoutSeconds(int timeout)
Sets the value of the AbandonTimeoutSeconds attribute. |
void |
setBeforeCompletionIterationLimit(int iterations)
Sets the value of the BeforeCompletionIterationLimit attribute. |
void |
setCheckpointIntervalSeconds(int interval)
Sets value of the CheckpointIntervalSeconds attribute. |
void |
setForgetHeuristics(boolean forget)
Sets the value of the ForgetHeuristics attribute. |
void |
setMaxTransactions(int max)
Sets the value of the MaxTransactions attribute. |
void |
setMaxUniqueNameStatistics(int max)
Sets the value of the MaxUniqueNameStatistics attribute. |
void |
setSecurityInteropMode(String mode)
Sets the value of the SecurityInteropMode attribute. |
void |
setTimeoutSeconds(int timeout)
Sets the value of the TimeoutSeconds attribute. |
void |
setUnregisterResourceGracePeriod(int seconds)
Sets the unregisterResource grace period. |
| Methods inherited from interface weblogic.management.configuration.ConfigurationMBean |
freezeCurrentValue, getName, getNotes, 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 |
addBeanUpdateListener, addPropertyChangeListener, createChildCopy, createChildCopyIncludingObsolete, getDescriptor, getParentBean, isEditable, removeBeanUpdateListener, removePropertyChangeListener |
| Method Detail |
public int getAbandonTimeoutSeconds()
The transaction abandon timeout seconds for transactions in the second phase of the two-phase commit (prepared and later).
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 this timeout, 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.
public int getBeforeCompletionIterationLimit()
The maximum number of cycles that the transaction manager will perform the beforeCompletion synchronization callback for this WebLogic Server domain.
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 accommodate this, the transaction manager calls all
Synchronization objects, then repeats the cycle if new ones have
been registered. This count sets a limit to the number of cycles
that can happen.
public 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.
public boolean getForgetHeuristics()
Specifies whether the transaction manager will automatically perform an XAResource forget operation for heuristic transaction completions.
When enabled, the transaction manager automatically performs an
XA Resource forget() operation for all resources as
soon as the transaction learns of a heuristic outcome. Disable this
feature only if you know what to do with the resource when it
reports a heuristic decision.
public int getMaxResourceRequestsOnServer()
Maximum number of concurrent requests to resources allowed for each server.
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.
public int getMaxTransactions()
The maximum number of simultaneous in-progress transactions allowed on a server in this WebLogic Server domain.
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")
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.
public String getSecurityInteropMode()
Specifies the security mode to use for XA calls in cross-domain transactions. Only applies to transactions in which some participating resources are running on older versions of WebLogic Server.
In previous releases of WebLogic Server, the transaction coordinator used the kernel identity when calling to remote resources, however calls were made over a non-secure channel. In the current release, remote calls made as the kernel identity must use a secure channel, which causes an interoperability problem with previous WebLogic domains and a possible performance problem in JTA with an admin channel enabled. The security interoperability mode setting enables you to control the XA call behavior.
Security Interoperability Mode options:
anonymous otherwise. anonymous at all times. This
implies a small security risk since a malicious third party
could then try to affect the outcome of transactions.
public long getSerializeEnlistmentsGCIntervalMillis()
The interval at which internal objects used to serialize resource enlistment are cleaned up.
public int getTimeoutSeconds()
The transaction timeout seconds for active transactions, before the prepared state.
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 does not apply; the transaction is retried
until all the resources are committed.
public int getUnregisterResourceGracePeriod()
The grace period (number of seconds) that the transaction manager waits for transactions involving the resource to complete before unregistering a resource. The grace period can help minimize the risk of abandoned transactions because of an unregistered resource, such as a JDBC data source module packaged with an application.
During the specified grace period, the unregisterResource call will block
until the call can return, and no new transactions
are started for the associated resource. If the number of
outstanding transactions for the resource goes to 0, the unregisterResource
call returns immediately.
At the end of the grace period, if there are still outstanding transactions associated with the resource, the unregisterResource call returns and a log message is written on the server on which the resource was previously registered.
public void setAbandonTimeoutSeconds(int timeout)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the AbandonTimeoutSeconds attribute.
timeout - Abandon timeout in seconds.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetAbandonTimeoutSeconds()
public void setBeforeCompletionIterationLimit(int iterations)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the BeforeCompletionIterationLimit attribute.
iterations - The maximum number of beforeCompletion iterations among registered objects.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetBeforeCompletionIterationLimit()
public void setCheckpointIntervalSeconds(int interval)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets value of the CheckpointIntervalSeconds attribute.
interval - The new checkpointIntervalSeconds value
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetCheckpointIntervalSeconds()
public void setForgetHeuristics(boolean forget)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the ForgetHeuristics attribute.
forget - Whether or not to forget heuristic transactions in affected resource managers.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetForgetHeuristics()
public void setMaxTransactions(int max)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the MaxTransactions attribute.
max - The maximum number of concurrent transactions.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetMaxTransactions()
public void setMaxUniqueNameStatistics(int max)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the MaxUniqueNameStatistics attribute.
max - Limit of individual transaction name statistics
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetMaxUniqueNameStatistics()
public void setSecurityInteropMode(String mode)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the SecurityInteropMode attribute.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetSecurityInteropMode()
public void setTimeoutSeconds(int timeout)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the value of the TimeoutSeconds attribute.
timeout - Transaction timeout in seconds.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetTimeoutSeconds()
public void setUnregisterResourceGracePeriod(int seconds)
throws InvalidAttributeValueException,
weblogic.management.DistributedManagementException
Sets the unregisterResource grace period.
seconds - The new grace period value.
InvalidAttributeValueException
weblogic.management.DistributedManagementExceptiongetUnregisterResourceGracePeriod()
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs91 Copyright 2005 BEA Systems Inc. |
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||||