3.4.12 Settings in the execution environment

To use the resource connection and transaction management functionality, you must set up the J2EE server and the resource adapters.

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

(1) J2EE server settings

Specify the J2EE server settings with the Easy Setup definition file. Define the resource connection and the transaction management functionality in the <configuration> tag of the logical J2EE server (j2ee-server) in the Easy Setup definition file. The following table describes the settings in the Easy Setup definition file. Note that with transaction management you can also specify a transaction timeout.

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.

For details on the transaction timeout, see 3.15.8 Transaction timeout and statement cancellation.

Table 3-18 Definition in the Easy Setup definition file for using the resource connection and transaction management functionality

ItemsSpecified parametersSettings
Transaction typesejbserver.distributedtx.XATransaction.enabledSpecifies whether to use the light transaction or the global transaction. By default, the light transaction is enabled.
Client transaction operations when a system exception occursejbserver.distributedtx.rollbackClientTxOnSystemExceptionSpecifies whether to mark the client transaction for rollback when a system exception occurs.
Directory storing the status file
  • ejbserver.distributedtx.ots.status.directory1
  • ejbserver.distributedtx.ots.status.directory2
Specified as a directory for storing the status file of the in-process transaction service and the status file backup.
Timeout in error detectionejbserver.connectionpool.validation.timeoutSpecifies the timeout value for the connection error detection functionality and the timeout value for the deletion of connections using the connection count adjustment functionality.
Note
Specifying the directory for storing the status file of the in-process transaction service and the status file backup
To guarantee transaction consistency, the in-process transaction service imports the host name or IP address as the identity information of the J2EE server into the status file. Therefore, to change the value set in the vbroker.se.iiop_tp.host parameter in the J2EE server configuration definition, or to change the IP address of the computer on which the J2EE server is running, without specifying the vbroker.se.iiop_tp.host parameter:
  1. Stop the J2EE server when there are no transactions on the J2EE server.
  2. Change the IP address, or the settings in the vbroker.se.iiop_tp.host parameter.
  3. Delete the directory specified in the ejbserver.distributedtx.ots.status.directory1 parameter.
  4. Start the J2EE server.

(2) Resource adapter settings

Use the server management commands and property files to specify the resource adapter settings in the execution environment. Define the functionality for managing transactions in the <resourceadapter> tag of the HITACHI Connector Property file. The following table describes the settings.

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.

Table 3-19 Definition in the HITACHI Connector Property file for the transaction management functionality

ItemsSpecified tagsSettings
Transaction support level<outbound-resourceadapter>-<transaction-support> tagSpecifies the transaction support levels.
Specify no transaction management (NoTransaction), local transaction (LocalTransaction), or global transaction (XATransaction).