2.7.7 Settings in the execution environment

You must perform batch server and resource adapter settings if you use resource connection functionality.

This subsection describes the settings for using the resource connection functionality.

Organization of this subsection

(1) Batch server settings
(2) Resource adapter settings

(1) Batch server settings

You implement the batch server settings in the Easy Setup definition file. You specify the definition of batch application execution functionality in the <configuration> tag of logical J2EE server (j2ee-server) of the Easy Setup definition file.

The following table describes the definition of resource connection functionality in Easy Setup definition file.

Table 2‒24: Definition of resource connection functionality in Easy Setup definition file
Field	Parameter to be specified	Setting contents
Enabling connection sharing outside the transactions managed by Application Server	`ejbserver.connectionpool.sharingOutsideTransactionScope.enabled`	Specify operation of connection sharing to be performed when you acquire multiple connections outside the transactions managed by Application Server.
Caching of DataSource objects	`ejbserver.jndi.cache.reference`	Specify whether the caching of DataSource object is to be enabled.
Optimizing sign-on in container management of DB Connector	`ejbserver.connectionpool.applicationAuthentication.disabled`	Specify whether the sign-on optimization functionality of container management is to be enabled.

Note: For details on the Easy Setup definition file and parameters, see 4.3 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.

To Page Top

(2) Resource adapter settings

In the case of a batch application to be connected to resources, you specify an optional name to resource adapters by using the user-specified namespace functionality. To lookup resource adapters from a batch application, you use the optional name set up with user-specified namespace functionality. For details on the settings of the user-specified namespace functionality, see 2.3.8 Implementing a batch application (When connecting to resources).

Reference note: Before performing resource settings, understand the notes on resource settings. When using server management commands, customize operation settings of server management commands as and when required. For notes on the resource settings and operation settings for using the server management commands, see 3.3 Customizing operation settings of server management commands in the uCosminexus Application Server Application Setup Guide.

You implement resource adapter settings in the HITACHI Connector Property file.

The following table describes the definition of resource connection functionality in the HITACHI Connector Property file.

Table 2‒25: Definition of resource connection functionality in the HITACHI Connector Property file
Category	Field	Setting contents
General information	Transaction support level	Set transaction support level in the `<transaction-support>` tag. You specify no transaction management (`NoTransaction`) or local transaction (`LocalTransaction`). You cannot specify global transaction (`XATransaction`) for batch servers.
Configuration properties	Waiting time until database connection is established	Specify a waiting time of a batch application until a database connection is established, in `loginTimeout` of the `<config-property>` tag.
	Cancelling statements	Specify whether the statement cancellation performed when a transaction timeout occurs is to be enabled, in `CancelStatement` of the `<config-property>` tag.
	Pool size of PreparedStatement^#1	Specify pool size of `PreparedStatement`, in `PreparedStatementPoolSize` of the `<config-property>` tag.
	Pool size of CallableStatement^#1	Specify pool size of `CallableStatement`, in `CallableStatementPoolSize` of the `<config-property>` tag.
Runtime properties	Minimum value and maximum value of a connection	Specify minimum value and maximum value of connections to be pooled in the connection pool, in `MinPoolSize` and `MaxPoolSize` of the `<property>` tag.
	Detecting failure in a connection	Specify a timing of detecting connection failure, in `Validation`Type of `<property>` tag. Specify failure detection interval in `ValidationInterval` When setting a timeout when connection failure is detected, enable the usage of connection management thread in `NetworkFailureTimeout`. ^#2
	Connection acquisition retry	Specify retry count in case of connection acquisition failure, in `RetryCount` of the `<property>` tag. Specify retry intervals in `RetryInterval`.
	Connection sweeper	Specify an interval for automatically destroying connections (connection sweeper) in `SweeperInterval` of the `<property>` tag. Specify a time from last usage time of connection to judging whether the connection is to be automatically destroyed, in `ConnectionTimeout`.
	Waiting for acquiring connections when connections exhaust	Specify whether to wait for acquiring connections when connections exhaust, in `RequestQueueEnable` of the `<property>` tag. Specify waiting time in `RequestQueueTimeout`.
	Warm-up of connection pool	When using the warm-up functionality of connection pool, specify `Warmup` in the `<property>` tag.
	Connection management threads	When using connection management threads, specify `NetworkFailureTimeout` in the `<property>` tag. When using connection management threads, settings for using a timeout in the connection failure detection functionality and functionality for adjusting number of connections are enabled.
	Functionality for adjusting number of connections	Specify an interval for operating the functionality for adjusting number of connections, in `ConnectionPoolAdjustmentInterval` of the `<property>` tag. When setting a timeout for the functionality for adjusting number of connections, you enable the usage of connection management threads in `NetworkFailureTimeout`. ^#2

Note: For details on the HITACHI Connector Property file, see 4. Property Files Used for Setting Resources in the uCosminexus Application Server Application and Resource Definition Reference Guide.

#1: In the case of XDM/RD E2 11-01 or earlier versions, specify 0 in these properties, because you cannot use the statement pooling functionality.

#2: Set up with the same key. Therefore, when you use a timeout with the connection failure detection functionality, you use of a timeout is also enabled in the functionality for adjusting number of connections. For timeout time, specify any time (default value is 5 seconds) in the key (ejbserver.connectionpool.validation.timeout), specified in a J2EE server of the Easy Setup definition file.

For details on the definition of DB Connector properties specified when connecting to a database by using DB Connector, see 4.1.2 Overview of settings and operations in the uCosminexus Application Server Application Setup Guide.

To Page Top