MlsTransactionService

This type is a class for model objects.

Configuration of the transaction service for the Managed Liberty Server.

Package: applicationserver
Supertype: Service

Classifier ID:  -1
Instance class name:  * Unspecified *
Instance class:  * Unspecified *



Attributes Summary
transactionLogDirectory : EString A directory for this server where the transaction service stores log files for recovery.
totalTranLifetimeTimeout : EInt Default maximum time allowed for transactions started on this server to complete. Any such transactions that do not complete before this timeout occurs are rolled back. Specify a positive integer for the period of time in seconds. Default=120
clientInactivityTimeout : EInt Maximum duration between transactional requests from a remote client. Any period of client inactivity that exceeds this timeout results in the transaction being rolled back in this application server. Specify a positive integer for the period of time in seconds. Default=60
heuristicRetryLimit : EInt The number of times that the application server retries a completion signal, such as commit or rollback. Retries occur after a transient exception from a resource manager or remote partner. Default=0
heuristicRetryWait : EInt Amount of time that the application server waits before retrying a completion signal, such as commit or rollback, after a transient exception from a resource manager or remote partner. Specify a positive integer for the period of time in seconds. Default=60
enableLoggingForHeuristicReporting : EBoolean Specifies whether the application server logs about-to-commit-one-phase-resource events from transactions that involve both a one-phase commit resource and two-phase commit resources. Default=false
LPSHeuristicCompletion : LPSHeuristicCompletionKind Specifies the direction that is used to complete a transaction that has a heuristic outcome; either the application server commits or rolls back the transaction, or depends on manual completion by the administrator. Allowed values are: COMMIT, ROLLBACK and MANUAL. Default=ROLLBACK
propogatedOrBMTTranLifetimeTimeout : EInt Upper limit of the transaction timeout for transactions that run in this server. This value should be greater than or equal to the value specified for the total transaction timeout. Specify a positive integer for the period of time in seconds. Default=0
acceptHeuristicHazard : EBoolean Specifies whether all applications on this server accept the possibility of a heuristic hazard occurring in a two-phase transaction that contains a one-phase resource. Default=true
recoverOnStartup : EBoolean Specifies whether the server should begin transaction recovery at server startup. Default=false
recoveryGroup : EString Name of the recovery group that this server belongs too. Members of a recovery group can recover the transaction logs of other servers in the group.
recoveryIdentity : EString Unique identity of this server for transaction peer recovery.
datasourceJNDIName : EString This attribute is optional. By default, the transaction service stores its recovery logs in files. Alternatively, you can store the logs in an RDBMS. Set this attribute to the JNDI name for a non-transactional data source where the transaction logs are stored. Do not change the syncQueryTimeoutWithTransactionTimeout value on this data source from the default, which is false.
OnePCOptimization : EBoolean Specifies whether the transaction manager optimizes when all resources but one vote read only. Default=true
backendURL : EString When backend routing is active, the URL is used by peer servers to contact this server.
defaultMaxShutdownDelay : EInt Default maximum shutdown delay. Specify a positive integer for the period of time in seconds. Default=2
enableLogRetries : EBoolean When recovery logs are stored in an RDBMS table, this property allows SQL operations that fail to be retried. Default=false
heuristicRetryInterval : EInt Amount of time that the application server waits before retrying a completion signal, such as commit or rollback, after a transient exception from a resource manager or remote partner. Specify a positive integer for the period of time in seconds. Default=60
leaseCheckInterval : EInt The interval after which the lease check strategy is implemented. Specify a positive integer for the period of time in seconds. Default=60
leaseExpiryThreshold : EInt The number of times an expired lease must be seen before peer recovery is attempted. Default=1
leaseLength : EInt The length of time before a recovery log lease expires. Specify a positive integer for the period of time in seconds. Default=60
leaseRenewalThreshold : EInt The percentage of the duration of the recovery log lease that passes before the lease is renewed. Default=90
logRetryInterval : EInt Specifies the interval in seconds between attempts to recover from a transient error accessing the transaction service logs. Default=10
logRetryLimit : EInt Specifies the maximum number of attempts to recover from a transient error accessing the transaction service logs for an unrecoverable error condition. Default=180
propogateXAResourceTransactionTimeout : EBoolean UNSUPPORTED: Configurations must instead use attribute propagateXAResourceTransactionTimeout.
propagateXAResourceTransactionTimeout : EBoolean Specifies whether the remaining time left in a global transaction is propagated to XAResources on enlistment. Default=false
shutdownOnLogFailure : EBoolean Specifies whether the transaction manager will stop an application server that is part of a recoveryGroup if an unrecoverable error occurs accessing its own transaction service logs. Default=true
throwCheckedExceptions : EBoolean Specifies whether methods annotated with @Transactional can throw undeclared checked exceptions. Default=false
timeoutGracePeriodEnabled : EBoolean Specifies whether there is a delay between a transaction timeout and the abnormal ending of the servant region that was running the transaction. Default=false
transactionLogDBName : EString Specifies the name of the database where recovery log tables are created.
transactionLogDBTableSuffix : EString When recovery logs are stored in an RDBMS table, this property allows the table name to be post-pended with a string to make it unique for this Server.
transactionLogSize : EInt Specifies the size of transaction log files in Kilobytes. Default=1024
waitForRecovery : EBoolean Specifies whether the server should wait for transaction recovery to complete before accepting new transactional work. Default=false



Attribute Details

transactionLogDirectory  -  A directory for this server where the transaction service stores log files for recovery.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

totalTranLifetimeTimeout  -  Default maximum time allowed for transactions started on this server to complete. Any such transactions that do not complete before this timeout occurs are rolled back. Specify a positive integer for the period of time in seconds. Default=120
    Data Type: EInt
    Default value:  120
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

clientInactivityTimeout  -  Maximum duration between transactional requests from a remote client. Any period of client inactivity that exceeds this timeout results in the transaction being rolled back in this application server. Specify a positive integer for the period of time in seconds. Default=60
    Data Type: EInt
    Default value:  60
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

heuristicRetryLimit  -  The number of times that the application server retries a completion signal, such as commit or rollback. Retries occur after a transient exception from a resource manager or remote partner. Default=0
    Data Type: EInt
    Default value:  0
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

heuristicRetryWait  -  Amount of time that the application server waits before retrying a completion signal, such as commit or rollback, after a transient exception from a resource manager or remote partner. Specify a positive integer for the period of time in seconds. Default=60
    Data Type: EInt
    Default value:  60
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

enableLoggingForHeuristicReporting  -  Specifies whether the application server logs about-to-commit-one-phase-resource events from transactions that involve both a one-phase commit resource and two-phase commit resources. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

LPSHeuristicCompletion  -  Specifies the direction that is used to complete a transaction that has a heuristic outcome; either the application server commits or rolls back the transaction, or depends on manual completion by the administrator. Allowed values are: COMMIT, ROLLBACK and MANUAL. Default=ROLLBACK
    Data Type: LPSHeuristicCompletionKind
    Default value:  ROLLBACK
    Allowed values:
        0 - ROLLBACK
        1 - COMMIT
        2 - MANUAL
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

propogatedOrBMTTranLifetimeTimeout  -  Upper limit of the transaction timeout for transactions that run in this server. This value should be greater than or equal to the value specified for the total transaction timeout. Specify a positive integer for the period of time in seconds. Default=0
    Data Type: EInt
    Default value:  0
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

acceptHeuristicHazard  -  Specifies whether all applications on this server accept the possibility of a heuristic hazard occurring in a two-phase transaction that contains a one-phase resource. Default=true
    Data Type: EBoolean
    Default value:  true
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

recoverOnStartup  -  Specifies whether the server should begin transaction recovery at server startup. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

recoveryGroup  -  Name of the recovery group that this server belongs too. Members of a recovery group can recover the transaction logs of other servers in the group.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

recoveryIdentity  -  Unique identity of this server for transaction peer recovery.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

datasourceJNDIName  -  This attribute is optional. By default, the transaction service stores its recovery logs in files. Alternatively, you can store the logs in an RDBMS. Set this attribute to the JNDI name for a non-transactional data source where the transaction logs are stored. Do not change the syncQueryTimeoutWithTransactionTimeout value on this data source from the default, which is false.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

OnePCOptimization  -  Specifies whether the transaction manager optimizes when all resources but one vote read only. Default=true
    Data Type: EBoolean
    Default value:  true
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

backendURL  -  When backend routing is active, the URL is used by peer servers to contact this server.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

defaultMaxShutdownDelay  -  Default maximum shutdown delay. Specify a positive integer for the period of time in seconds. Default=2
    Data Type: EInt
    Default value:  2
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

enableLogRetries  -  When recovery logs are stored in an RDBMS table, this property allows SQL operations that fail to be retried. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

heuristicRetryInterval  -  Amount of time that the application server waits before retrying a completion signal, such as commit or rollback, after a transient exception from a resource manager or remote partner. Specify a positive integer for the period of time in seconds. Default=60
    Data Type: EInt
    Default value:  60
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

leaseCheckInterval  -  The interval after which the lease check strategy is implemented. Specify a positive integer for the period of time in seconds. Default=60
    Data Type: EInt
    Default value:  60
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

leaseExpiryThreshold  -  The number of times an expired lease must be seen before peer recovery is attempted. Default=1
    Data Type: EInt
    Default value:  1
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

leaseLength  -  The length of time before a recovery log lease expires. Specify a positive integer for the period of time in seconds. Default=60
    Data Type: EInt
    Default value:  60
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

leaseRenewalThreshold  -  The percentage of the duration of the recovery log lease that passes before the lease is renewed. Default=90
    Data Type: EInt
    Default value:  90
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

logRetryInterval  -  Specifies the interval in seconds between attempts to recover from a transient error accessing the transaction service logs. Default=10
    Data Type: EInt
    Default value:  10
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

logRetryLimit  -  Specifies the maximum number of attempts to recover from a transient error accessing the transaction service logs for an unrecoverable error condition. Default=180
    Data Type: EInt
    Default value:  180
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

propogateXAResourceTransactionTimeout  -  UNSUPPORTED: Configurations must instead use attribute propagateXAResourceTransactionTimeout.
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

propagateXAResourceTransactionTimeout  -  Specifies whether the remaining time left in a global transaction is propagated to XAResources on enlistment. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

shutdownOnLogFailure  -  Specifies whether the transaction manager will stop an application server that is part of a recoveryGroup if an unrecoverable error occurs accessing its own transaction service logs. Default=true
    Data Type: EBoolean
    Default value:  true
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

throwCheckedExceptions  -  Specifies whether methods annotated with @Transactional can throw undeclared checked exceptions. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

timeoutGracePeriodEnabled  -  Specifies whether there is a delay between a transaction timeout and the abnormal ending of the servant region that was running the transaction. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

transactionLogDBName  -  Specifies the name of the database where recovery log tables are created.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

transactionLogDBTableSuffix  -  When recovery logs are stored in an RDBMS table, this property allows the table name to be post-pended with a string to make it unique for this Server.
    Data Type: EString
    Default value:  unspecified
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

transactionLogSize  -  Specifies the size of transaction log files in Kilobytes. Default=1024
    Data Type: EInt
    Default value:  1024
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

waitForRecovery  -  Specifies whether the server should wait for transaction recovery to complete before accepting new transactional work. Default=false
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false



(C) COPYRIGHT International Business Machines Corp. 1996-2006