Hitachi

uCosminexus Application Server Application and Resource Definition Reference Guide


4.1.12 Properties that you can specify for the <property> tag

This subsection describes the properties that you can specify for the <property> tag.

Table 4‒14: List of information to be set in the <property> tag

property-name

property-type

property-value

Specifiable value

Default

Version

ConnectionPoolAdjustmentInterval

int

Specifies an integer (unit: seconds) for the interval at which the connection adjustment functionality is to be operated.

If you specify 0, the operation is not performed.

Specify an integer value from 0 to 2147483647.

600

06-70

ConnectionTimeout

int

Specifies an integer (unit: seconds) for the timeout value until the connection is cancelled.

If the time period from the last usage of connection until the time when the timeout is determined is greater than the specified value, the connection sweeper deletes the connection. When 0 is specified, a timeout will not occur.

We recommend that you use a value greater than 3600.

Specify an integer value from 0 to 2147483647.

0

06-50

LogEnabled

boolean

Specifies whether to output log using LogWriter.

If you specify true:

Log will be output using LogWriter.

If you specify false:

Log will not be output using LogWriter.

You can specify the following strings:

  • true

  • false

true

05-05

MaxPoolSize

3.14.1 in the Application Server Common Container Functionality Guide

int

Specifies the maximum number of connections within a pool. If you specify -1, the number of connections within a pool will be unlimited.

You can specify the following values (integers):

  • -1

  • 0 to 2147483647

10

05-05

MaxTPoolSize#

int

Specifies an integer for the maximum number of threads executed concurrently in a thread pool.

When the lifecycle management functionality is not enabled (when <resourceadapter-class> is not specified), the property value is ignored.

Specify an integer from 1 to 2147483647.

10

07-50

MinPoolSize

3.14.1 in the Application Server Common Container Functionality Guide

int

Specifies the minimum number of connections within a pool.

Specify an integer value from 0 to 2147483647.

10

05-05

MinTPoolSize#

int

Specifies an integer for the minimum number of threads existing in a thread pool.

When the lifecycle management functionality is not enabled (when <resourceadapter-class> is not specified), the property value is ignored.

Specify an integer from 0 to 1024.

0

07-50

NetworkFailureTimeout

boolean

Specifies whether to enable the timeout value of the network failure detection functionality.

If you specify true:

The timeout of the network failure detection functionality is enabled.

If you specify false:

The timeout of the network failure detection functionality is disabled.

You can specify the following strings:

  • true

  • false

true

07-00

Password

String

Specifies the password.

When a value is set in the <property-value> tag, this tag is not displayed for security reasons. To change the value, add the <property-value> tag, and then specify the value after change.

When User or Password is set in the <property-name> tag when you execute the cjgetresprop or cjgetrarprop command, the tag will be displayed as follows:

When a value is specified:

Comment tag <!-- The property-value has already been set. -->

When no value is specified:

Empty tag <>

There are no limitations for the input value.

None

05-05

RequestQueueEnable

boolean

Specifies whether to enable the acquire connection queue when the connections are depleted.

If you specify true:

The acquire connection queue functionality is enabled when the connections are depleted.

If you specify false:

The acquire connection queue functionality is disabled when the connections are depleted.

You can specify the following strings:

  • true

  • false

true

06-50

RequestQueueTimeout

int

Specifies an integer (unit: seconds) for the maximum time period for which the connection acquisition pending queue can be retained when the connections are depleted.

If you specify 0, the connection waits in the queue infinitely.

Specify an integer value from 0 to 2147483647.

30

06-50

RetryCount

int

Specifies an integer (unit: number of times) for the connection retry frequency.

Specify an integer value from 0 to 2147483647.

0

05-05

RetryInterval

int

Specifies an integer (unit: seconds) for the connection retry interval.

This property is enabled when RetryCount is 1 or more.

Specify an integer from 1 to 2147483647.

10

05-05

SweeperInterval

int

Specifies an integer (unit: seconds) for the operation time interval of the connection sweeper.

A connection sweeper operates at the specified interval and deletes the connection that has timed out. When 0 is specified, connection sweeper does not operate.

We recommend that you use a value greater than 3600.

Specify an integer value from 0 to 2147483647.

0

06-50

TPoolKeepalive#

int

Specifies an integer for the timeout value (unit: seconds) until the release of threads of a thread pool.

When the lifecycle management functionality is not enabled (when <resourceadapter-class> is not specified), the property value is ignored.

Specify an integer from 1 to 2147483647.

300

07-50

User

String

Specifies the user name.

When a value is set in the <property- value> tag, this tag is not displayed for security reasons. To change the value, add the <property-value> tag, and then specify the value after change.

When User or Password is set in the <property-name> tag when you execute the cjgetresprop or cjgetrarprop command, the tag will be displayed as follows:

When a value is specified:

Comment tag <!-- The property-value has already been set. -->

When no value is specified:

Empty tag <>

There are no limitations for the input value.

None

05-05

ValidationInterval

int

Specifies an integer (unit: seconds) for the connection check interval.

Specify an integer from 1 to 2147483647.

3600

05-05

ValidationType

3.15.1 in the Application Server Common Container Functionality Guide

int

Specifies the trigger for checking the connection. You can specify the following values:

  • 0: Check connection functionality Off

  • 1: Check when acquiring the connection

  • 2: Check at fixed intervals

You can specify the following values (integers):

  • 0

  • 1

  • 2

1

05-05

Warmup

boolean

Specifies whether to enable the warming up functionality of the connection pool.

If you specify true:

The warming up functionality of the connection pool is enabled.

If you specify false:

The warming up functionality of the connection pool is disabled.

You can specify the following strings:

  • true

  • false

true

07-00

WatchEnabled

boolean

Specifies whether to enable the output of an alert for connection pool monitoring.

If you specify true:

Alert output is enabled.

If you specify false:

Alert output is disabled.

You can specify the following strings:

  • true

  • false

true

06-50

WatchInterval

int

Specifies an integer (unit: seconds) for the connection pool monitoring interval.

Specify an integer from 1 to 2147483647.

30

06-50

WatchThreshold

int

Specifies an integer (unit: %) for the threshold value for monitoring the connection pool usage status.

Specify an integer from 1 to 100.

80

06-50

WatchWriteFileEnabled

boolean

Specifies whether to output the connection pool monitoring result to a file.

If you specify true:

The result is output to a file.

If you specify false:

The result is not output to a file.

You can specify the following strings:

  • true

  • false

true

06-50

Legend:

--: Not set up

#

The property value is ignored when the lifecycle management functionality is not enabled (when <resourceadapter-class> is not specified).