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

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

Table 4-16 List of information to be set in the <property> tag

property-nameproperty-typeproperty-valueSpecifiable valueDefaultVersion
ConnectionPoolAdjustmentIntervalintSpecifies 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​.60006-70
ConnectionTimeoutintSpecifies 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​.006-50
LogEnabledbooleanSpecifies 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
true05-05
MaxPoolSizeintSpecifies 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​
1005-05
MaxTPoolSize#intSpecifies 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​.1007-50
MinPoolSizeintSpecifies the minimum number of connections within a pool.Specify an integer value from 0 to 2147483647​.1005-05
MinTPoolSize#intSpecifies 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.007-50
NetworkFailureTimeoutbooleanSpecifies 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
true07-00
PasswordStringSpecifies 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.None05-05
RequestQueueEnablebooleanSpecifies 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
true06-50
RequestQueueTimeoutintSpecifies 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​.3006-50
RetryCountintSpecifies an integer (unit: number of times) for the connection retry frequency.Specify an integer value from 0 to 2147483647​.005-05
RetryIntervalintSpecifies 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​.1005-05
SweeperIntervalintSpecifies 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​.006-50
TPoolKeepalive#intSpecifies 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​.30007-50
UserStringSpecifies 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.None05-05
ValidationIntervalintSpecifies an integer (unit: seconds) for the connection check interval.Specify an integer from 1 to 2147483647​.360005-05
ValidationTypeintSpecifies 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
105-05
WarmupbooleanSpecifies 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
true07-00
WatchEnabledbooleanSpecifies 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
true06-50
WatchIntervalintSpecifies an integer (unit: seconds) for the connection pool monitoring interval.Specify an integer from 1 to 2147483647​.3006-50
WatchThresholdintSpecifies an integer (unit: %) for the threshold value for monitoring the connection pool usage status.Specify an integer from 1 to 100.8006-50
WatchWriteFileEnabledbooleanSpecifies 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
true06-50
Legend:
--: Not set up
#
The property value is ignored when the lifecycle management functionality is not enabled (when <resourceadapter-class> is not specified).