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
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.
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.
(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.
Category |
Field |
Setting contents |
---|---|---|
General information |
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 |
Specify a waiting time of a batch application until a database connection is established, in loginTimeout of the <config-property> tag. |
|
Specify whether the statement cancellation performed when a transaction timeout occurs is to be enabled, in CancelStatement of the <config-property> tag. |
||
Specify pool size of PreparedStatement, in PreparedStatementPoolSize of the <config-property> tag. |
||
Specify pool size of CallableStatement, in CallableStatementPoolSize of the <config-property> tag. |
||
Runtime properties |
Specify minimum value and maximum value of connections to be pooled in the connection pool, in MinPoolSize and MaxPoolSize of the <property> tag. |
|
Specify a timing of detecting connection failure, in ValidationType 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 |
||
Specify retry count in case of connection acquisition failure, in RetryCount of the <property> tag. Specify retry intervals in RetryInterval. |
||
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. |
||
Specify whether to wait for acquiring connections when connections exhaust, in RequestQueueEnable of the <property> tag. Specify waiting time in RequestQueueTimeout. |
||
When using the warm-up functionality of connection pool, specify Warmup in the <property> tag. |
||
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. |
||
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.