3.15.13 Settings in the execution environment

This subsection describes the settings for using the functionality for fault tolerance.

Note that the settings for the following functionality need not be specified beforehand.

Organization of this subsection
(1) J2EE server settings
(2) Resource adapter settings
(3) J2EE application settings

(1) J2EE server settings

You implement the J2EE server settings in the Easy Setup definition file. Specify the fault tolerance definition in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file.

The following table describes the definition of the functionality for fault tolerance in the Easy Setup definition file.

Table 3-62 Definition of the functionality for fault tolerance in the Easy Setup definition file

CategoryPropertySettings
Automatically closing the connectionsejbserver.webj2ee.connectionAutoClose.enabledSpecifies whether the connection will be automatically closed by the Web application.
Transaction timeout (for J2EE servers)#1ejbserver.jta.TransactionManager.defaultTimeOutSpecifies the default timeout value for the transactions running on the J2EE server.
Transaction recoveryejbserver.distributedtx.recovery.portSpecifies the fixed port number used for transaction recovery when a global transaction is used.
Timeout during the checking of unconcluded transactions#2ejbserver.distributedtx.recovery.completionCheckOnStopping.timeoutSpecifies the timeout value for checking if an in-progress transaction is complete, when the J2EE server is stopped.
Timeout in error detectionejbserver.connectionpool.validation.timeoutSpecifies the timeout value for the connection error detection functionality and the timeout value for the connection deletion processing by the connection count adjustment functionality.

#1: In the CMT, you can also specify the settings for the Enterprise Beans, interfaces, and methods. To specify the settings for Enterprise Beans, interfaces, and methods, use the server management commands to specify the settings in the property files when the J2EE applications are set up. For details on the J2EE application settings, see 3.15.12 Definitions in cosminexus.xml.

#2: Set up the timeout during application development. To guarantee transaction reliability during the operations of the J2EE applications, we recommend that you do not set a timeout value.


For details on the Easy Setup Definition file and parameters, see 4.6 Easy Setup Definition file in the uCosminexus Application Server Definition Reference Guide.

(2) Resource adapter settings

Use the server management commands and property files to specify the resource adapter settings in the execution environment. Use the HITACHI Connector Property file to define the functionality for fault tolerance.

The following table describes the definition of the functionality for fault tolerance in the HITACHI Connector Property file.

Table 3-63 Definition of the functionality for fault tolerance in the HITACHI Connector Property file

ItemsSpecified parametersSettings
Detecting the connection errorsValidationType and ValidationInterval in the <property> tagSpecifies the time at which the connection errors will be detected and the intervals at which the errors will be detected.
Note that to set up a timeout for detecting the connection errors, you enable the usage of the connection management threads with NetworkFailureTimeout. #1
Connection management threadsNetworkFailureTimeout in the <property> tagSpecifies whether the connection management threads will be used.
When you use the connection management threads, a timeout is set for the connection error detection functionality and the connection count adjustment functionality. The timeout value is fixed at 5 seconds with version 07-60 or earlier. With version 08-00 or later, you can specify any timeout value (default value is 5 seconds).
Waiting for a connection when connections depleteRequestQueueEnable in the <property> tagSpecifies whether to enable the waiting for a connection when connections deplete.
RequestQueueTimeout in the <property> tagSpecifies the waiting time for obtaining a connection.
Retrying to obtain a connectionRetryCount in the <property> tagSpecifies the retry count for a failure to obtain a connection.
RetryInterval in the <property> tagSpecifies the retry interval for a failure to obtain a connection.
Connection sweeperSweeperInterval in the <property> tag#2Specifies the interval at which the automatic destruction of connections (connection sweeper) will operate.
ConnectionTimeout in the <property> tag#2Specifies the time from the last use of the connection until the determination of the automatic destruction of the connection.
Statement cancellationCancelStatement in the <property> tagSpecifies whether to enable statement cancellation when a transaction times out.

#1: You set up the timeout for the connection error detection functionality and the connection count adjustment functionality in the same key. Therefore, when you use a timeout for the connection error detection functionality, a timeout is also used for the connection count adjustment functionality.

#2 If the set value is less than 3600 seconds, KDJE48604-W is output.


For details on the HITACHI Connector Property file, see 4.1 HITACHI Connector Property file in the uCosminexus Application Server Application and Resource Definition Reference Guide.

(3) J2EE application settings

You implement the J2EE application settings in the execution environment with the server management commands and property files. To define the functionality for fault tolerance, use the Session Bean property file, Entity Bean property file, or Message-driven Bean property file.

The tags specified in these property files are mapped in cosminexus.xml. For details on the definitions in cosminexus.xml, see 3.15.12 Definitions in cosminexus.xml.