uCosminexus Application Server, Application and Resource Definition Reference Guide

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

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