uCosminexus Application Server, Expansion Guide

[Contents][Index][Back][Next]

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.

# 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

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 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
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

#: For details on the HITACHI Connector Property file, see 4. Property files used for resource settings 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 items to be set up and operations in the uCosminexus Application Server Application Setup Guide.