Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Reference

- Previous: S
- Next: U

# T

## thread-pool

Defines a thread pool.

### Superelements

thread-pools

### Subelements

none

### Attributes

Table 1–124 `thread-pool` Attributes

Attribute | Default | Description
--- | --- | ---
`thread-pool-id` | none | Specifies the thread pool ID.
`min-thread-pool-size` | `0` | (optional) Specifies the minimum number of threads in the pool. These are created when the thread pool is instantiated.
`max-thread-pool-size` | `200` | (optional) Specifies the maximum number of threads the pool can contain.
`idle-thread-timeout-in-seconds` | `120` | (optional) Specifies the amount of time after which idle threads are removed from the pool.
`num-work-queues` | `1` | (optional) Specifies the total number of work queues serviced by this thread pool.

## thread-pools

Contains thread pools.

### Superelements

config

### Subelements

The following table describes subelements for the `thread-pools` element.

Table 1–125 `thread-pools` Subelements

Element | Required | Description
--- | --- | ---
thread-pool | one or more | Defines a thread pool.

## transaction-service

Configures the Java Transaction Service (JTS).

### Superelements

config

### Subelements

The following table describes subelements for the `transaction-service` element.

Table 1–126 `transaction-service` Subelements

Element | Required | Description
--- | --- | ---
property | zero or more | Specifies a property or a variable.

### Attributes

The following table describes attributes for the `transaction-service` element.

Table 1–127 `transaction-service` Attributes

Attribute | Default | Description
--- | --- | ---
`automatic-recovery` | `false` | (optional) If `true`, the server instance attempts transaction recovery during startup.
`timeout-in-seconds` | `0` | (optional) Specifies the amount of time after which the transaction is aborted. If set to `0`, the transaction never times out.
`tx-log-dir` | directory specified by the `log-root` attribute of the domain element | (optional) Specifies the parent directory of the transaction log directory `tx`. The directory in which the transaction logs are kept must be writable by the user account under which the server runs. A relative path is relative to the `log-root` attribute of the domain element.
`heuristic-decision` | `rollback` | (optional) If the outcome of a distributed transaction cannot be determined because other participants are unreachable, this property determines the outcome. Allowed values are `rollback` and `commit`.
`retry-timeout-in- seconds` | `600` | (optional) Determines the retry time in the following scenarios: At the transaction recovery time, if resources are unreachable. If there are any transient exceptions in the second phase of a two phase commit protocol. A negative value specifies infinite retries. A value of `0` (zero) specifies no retries. A positive value indicates the time after which a retry is attempted.
`keypoint-interval` | `2048` | (optional) Specifies the number of transactions between keypoint operations in the log. Keypoint operations reduce the size of the transaction log file by compressing it. A larger value for this attribute (for example, `4096`) results in a larger transaction log file, but fewer keypoint operations and potentially better performance. A smaller value (for example, `100`) results in smaller log files, but slightly reduced performance due to the greater frequency of keypoint operations.

### Properties

The following table describes properties for the `transaction-service` element.

Table 1–128 `transaction-service` Properties

Property | Default | Description
--- | --- | ---
`oracle-xa-recovery-workaround` | `true` | If `true`, the Oracle XA Resource workaround is used in transaction recovery.
`disable-distributed-transaction-logging` | `false` | If `true`, disables transaction logging, which might improve performance. If the `automatic-recovery` attribute is set to `true` , this property is ignored.
`xaresource-txn-timeout` | specific to the `XAResource` used | Changes the `XAResource` timeout. In some cases, the `XAResource` default timeout can cause transactions to be aborted, so it is desirable to change it.
`pending-txn-cleanup-interval` | none if this property is absent, `60` if this property is present but has no value | Specifies the interval, in seconds, at which an asynchronous thread checks for pending transactions and completes them.
`use-last-agent-optimization` | `true` | If `true`, enables last agent optimization, which improves the throughput of transactions. If one non-XA resource is used with XA resources in the same transaction, the non XA resource is the last agent.

- Previous: S
- Next: U

- © 2010, Oracle Corporation and/or its affiliates