Oracle GlassFish Server 3.0.1 Domain File Format Reference

T

thread-pool

Defines a thread pool.

Superelements

thread-pools

Subelements

The following table describes subelements for the thread-pool element.

Table 1–165 thread-pool Subelements

Element 

Required 

Description 

property

zero or more 

Specifies a property or a variable. 

Attributes

Table 1–166 thread-pool Attributes

Attribute 

Default 

Description 

name

none 

Specifies the thread pool name. 

classname

com.sun.grizzly.http.StatsThreadPool

(Optional) Specifies the class name of the thread pool implementation. 

min-thread-pool-size

2

(optional) Specifies the minimum number of threads in the pool. These are created when the thread pool is instantiated. 

max-thread-pool-size

5

(optional) Specifies the maximum number of threads the pool can contain. To optimize this thread pool for use with an iiop-listener, set this value to 200.

idle-thread-timeout-seconds

900

(optional) Specifies the amount of time after which idle threads are removed from the pool. 

max-queue-size

4096

(optional) Specifies the maximum number of messages that can be queued until threads are available to process them for , network-listener or iiop-listener elements. A value of -1 specifies no limit.

thread-pools

Contains thread pools.

Superelements

config

Subelements

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

Table 1–167 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–168 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–169 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 instance-name/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

65536 (64 K)

(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 results in a larger transaction log file, but fewer keypoint operations and potentially better performance. A smaller value 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–170 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.

db-logging-resource

none 

Specifies the JNDI name of the JDBC resource for the database to which transactions are logged. For more information, see Chapter 15, Using the Transaction Service, in Oracle GlassFish Server 3.0.1 Application Development Guide.

xa-servername

host name on which the GlassFish Server runs 

Specifies the host name that the transaction service uses to identify transactions being managed by the installed GlassFish Server. This can sometimes be useful for recovering transactions from the log file that was created on a different host running the GlassFish Server. 

transformation-rule

This element is deprecated. Web services are implemented in the engine element.

Configures an eXtensible Stylesheet Language Transformation (XSLT) rule, which transforms a web service message.

Superelements

web-service-endpoint

Subelements

The following table describes subelements for the transformation-rule element.

Table 1–171 transformation-rule Subelements

Element 

Required 

Description 

description

zero or one 

Contains a text description of this element. 

Attributes

The following table describes attributes for the transformation-rule element.

Table 1–172 transformation-rule Attributes

Attribute 

Default 

Description 

name

none 

The name of the rule. 

enabled

true

(optional) Determines whether the rule is enabled. 

apply-to

request

(optional) Specifies whether the rule is applied to the request, the response, or both. Allowed values are: 

  • request - Transformations are applied to the request in the order specified.

  • response - Transformations are applied to the response in the order specified.

  • both - Transformations are applied to both the request and the response. The order is reversed for the response.

rule-file-location

domain-dir/generated/xml/app-or-module/xslt-file

A fully qualified or relative path to the rule file that performs the transformation. Only XSLT files are allowed. 

transport

Configures a transport. You can configure a TCP or UDP transport or provide a custom transport implementation.

Superelements

transports

Subelements

none

Attributes

The following table describes attributes for the transport element.

Table 1–173 transport Attributes

Attribute 

Default 

Description 

name

none 

Specifies a unique name for the transport. 

classname

com.sun.grizzly.TCPSelectorHandler

(Optional) Specifies the class name of the transport implementation. 

selection-key-handler

none 

(optional) Specifies the name of the selection-key-handler associated with this transport.

idle-key-timeout-seconds

30

(Optional) Specifies the idle key timeout. 

read-timeout-millis

30000 (30 seconds)

(optional) Specifies the amount of time the GlassFish Server waits during the header and body parsing phase. 

write-timeout-millis

30000 (30 seconds)

(optional) Specifies the amount of time the GlassFish Server waits before considering the remote client disconnected when writing the response. 

selector-poll-timeout-millis

1000 (1 second)

(optional) Specifies the time a NIO Selector blocks waiting for events (user requests). 

display-configuration

false

(optional) If true, flushes the internal network configuration to the server log. Useful for debugging, but reduces performance.

snoop-enabled

false

(optional) If true, writes request/response information to the server log. Useful for debugging, but reduces performance.

tcp-no-delay

false

(optional) If true, enables TCP_NODELAY (also called Nagle's algorithm).

max-connections-count

4096

(optional) Specifies the maximum number of pending connections on a network-listener that references this transport.

acceptor-threads

1

(optional) Specifies the number of processors in the machine. 

To set the number of request processing threads, use the max-thread-pool-size attribute of the thread-poolelement.

byte-buffer-type

HEAP

(optional) Specifies the type of the buffer to be provided for input streams created by a network-listener. Allowed values are HEAP and DIRECT.

buffer-size-bytes

8192

(optional) Specifies the size, in bytes, of the buffer to be provided for input streams created by a network-listener.

transports

Contains transports.

Superelements

network-config

Subelements

The following table describes subelements for the transports element.

Table 1–174 transports Subelements

Element 

Required 

Description 

selection-key-handler

zero or more 

Configures a selection key handler. 

transport

one or more 

Configures a transport.