2.2.9 Details of the Connector property

This tag defines the information concerning rar.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This is a key for identifying the resource adapter.

The set value is specified according to the following conditions:

For an application that includes application.xml

• Common to the archive format and exploded archive format

  This tag specifies the character string specified in <application>-<module>-<connector> in application.xml.

For an application that does not include application.xml

• Archive format (cjimportapp command (-f/-d))

  This tag specifies the location of the RAR file within the J2EE application using the relative path from the EAR root.

• Exploded archive format (cjimportapp command (-a))

  This tag specifies the location of the RAR file within an application directory using the relative path from the application directory.

Precautions when using a relative path

• Use a forward slash (/) as the path delimiter.

• You cannot specify a forward slash (/) at the beginning of the path string.

• You cannot specify "./", "../", and "//" in the path string.

There are no limitations for the input value.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag defines the information about the resource adapter.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag defines the resource adapter in the outbound direction.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag defines the connection interface class.

Supplement

About the lower tag <connector-property>

The <property-value> tag is mentioned in each property because the range of the set value is different for each <property-name> tag.

When multiple <property> tags are specified, and the set values of the <property-name> tags are the same, the tags are merged into one. In such cases, a warning message (KDJE42377-W) is output, and the value of the <property-value> tag of the <property> tag defined first is enabled.

None.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the class name of the ConnectionFactory interface supported by the resource.

For a resource adapter conforming to Connector 1.5 or later versions, the value of this tag is the connection definition identifier.

Specify this tag from the package when the package is defined.

There are no limitations for the input value.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the MaxPoolSize property.

You can specify the following character strings:

• MaxPoolSize

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the maximum value of the pool as the property value.

Specify an integer value of -1 (infinite) or from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the MinPoolSize property.

You can specify the following character strings:

• MinPoolSize

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the minimum value of the pool as the property value.

Specify an integer value from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the LogEnabled property.

You can specify the following character strings:

• LogEnabled

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the requirement of the log output by LogWriter, as the property value.

• true

  The log will be output.

• false

  The log will not be output.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the User property.

You can specify the following character strings:

• User

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the user name as the property value.

There are no limitations for the input value.

None.

You cannot omit this tag.

You can omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the Password property.

You can specify the following character strings:

• Password

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the password as the property value.

There are no limitations for the input value.

None.

You cannot omit this tag.

You can omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the ValidationType property.

You can specify the following character strings:

• ValidationType

None.

You cannot omit this tag.

You cannot omit the value of this tag.

Specifies the property value of the connection check trigger.

• 0: Connection check functionality OFF

• 1: Connection is checked when the connection is acquired

• 2: Connection is checked at a fixed interval

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the ValidationInterval property.

You can specify the following character strings:

• ValidationInterval

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the connection check interval (seconds) as the property value.

Specify an integer value from 1 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the RetryCount property.

You can specify the following character strings:

• RetryCount

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the connection retry count as the property value.

Specify an integer value from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the RetryInterval property.

You can specify the following character strings:

• RetryInterval

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the connection retry interval (seconds) as the property value.

Specify an integer value from 1 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the ConnectionTimeout property.

You can specify the following character strings:

• ConnectionTimeout

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the timeout value (seconds) until the release of a connection, as the property value.

Specify an integer value from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the ConnectionPoolAdjustmentInterval property.

You can specify the following character strings:

• ConnectionPoolAdjustmentInterval

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the soft landing operation adjustment interval (seconds) of the connection count as the property value.

Specify an integer value from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the SweeperInterval property.

You can specify the following character strings:

• SweeperInterval

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the connection sweeper operation time interval (seconds) as the property value.

Specify an integer value from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the RequestQueueEnable property.

You can specify the following character strings:

• RequestQueueEnable

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the requirement of a connection pending queue for connection depletion, as the property value.

• true

  The connection pending queue functionality during connection depletion will be enabled.

• false

  The connection pending queue functionality during connection depletion will be disabled.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the RequestQueueTimeout property.

You can specify the following character strings:

• RequestQueueTimeout

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the maximum value (seconds) for which the connection pending queue for connection depletion can be retained, as the property value.

Specify an integer value from 0 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the WatchEnabled property.

You can specify the following character strings:

• WatchEnabled

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies whether to enable the output of an alert for connection pool monitoring, as the property value.

• true

  Alert output will be enabled.

• false

  Alert output will be disabled.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the WatchInterval property.

You can specify the following character strings:

• WatchInterval

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the connection pool monitoring interval (seconds) as the property value.

Specify an integer value from 1 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the WatchThreshold property.

You can specify the following character strings:

• WatchThreshold

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the threshold value (%) for monitoring the connection pool usage status, as the property value.

Specify an integer value from 1 to 100.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the WatchWriteFileEnabled property.

You can specify the following character strings:

• WatchWriteFileEnabled

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies whether to output the connection pool monitoring results to a file, as the property value.

• true

  The monitoring results will be output to a file.

• false

  The monitoring results will not be output to a file.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the Warmup property.

You can specify the following character strings:

• Warmup

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies whether to enable the warming up functionality of the connection pool, as the property value.

• true

  The warming up functionality of the connection pool will be enabled.

• false

  The warming up functionality of the connection pool will be disabled.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag sets up the information unique to the connection interface class.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the NetworkFailureTimeout property.

You can specify the following character strings:

• NetworkFailureTimeout

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies whether to enable the timeout of the network failure detection functionality, as the property value.

• true

  The timeout of the network failure detection functionality will be enabled.

• false

  The timeout of the network failure detection functionality will be disabled.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag defines the resource.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the optional name of the resource.

You can specify alphanumeric characters (0 to 9, A to Z, and a to z) and the following special characters:

Space ( ), exclamation mark (!), double quotation mark ("), hash mark (#), dollar sign ($), percent sign (%), ampersand (&), single quotation ('), left parenthesis and right parenthesis (() ()), asterisk (*), plus sign (+), comma (,), hyphen (-), period (.), forward slash (/), colon (:), semicolon (;), less-than sign (<), equal sign (=), greater-than sign (>), question mark (?), at mark (@), square brackets ([) (]), yen sign (), caret (^), underscore (_), grave accent mark (`), curly brackets ({) (}), vertical bar (|), and tilde (~).

You can specify 1 to 255 characters.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies whether to perform authentication for using a resource in the application or to entrust authentication to the container.

You can specify the following character strings:

• Application

• Container

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies whether to enable the sharing of a resource connection.

You can specify the following character strings:

• Shareable

• Unshareable

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag defines the administered objects provided by the resource adapter.

You must set up as many tags as the number of <adminobject> tags in the DD and in the same order (if the same number of tags is not set up, you specify the empty tag <adminobject/>).

If it is not required to set up <adminobject-name> in all the <adminobject> tags, you can omit this tag.

None.

This tag depends on the <adminobject> tag of DD.

You can omit this tag.

You can omit the value of this tag.

This tag specifies the administered object name. This name must be unique within a resource adapter.

You can use alphanumeric characters (0 to 9, A to Z, and a to z) and the following special characters:

Space ( ), exclamation mark (!), double quotation mark ("), hash mark (#), dollar sign ($), percent sign (%), ampersand (&), single quotation ('), left parenthesis and right parenthesis (() ()), asterisk (*), plus sign (+), comma (,), hyphen (-), period (.), colon (:), semicolon (;), less-than sign (<), equal sign (=), greater-than sign (>), question mark (?), at mark (@), square brackets ([) (]), yen sign (), caret (^), underscore (_), grave accent mark (`), curly brackets ({) (}), vertical bar (|), and tilde (~)

You cannot, however, specify the following names:

• Name containing a period (.) at the beginning or at the end

• Name containing a period (.) only

• Name containing continuous underscores (_)

None.

You cannot omit this tag.

You can omit the value of this tag.

This tag defines a resource adapter corresponding to the Connector 1.5 specifications.

Note that tags lower than this tag can be specified only for a resource adapter conforming to Connector 1.5 or later versions.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the MaxTPoolSize property.

You can specify the following character strings:

• MaxTPoolSize

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the maximum number of threads executed concurrently in a thread pool, as the property value.

Specify an integer value from 1 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag defines a resource adapter corresponding to the Connector 1.5 specifications.

Note that tags lower than this tag can be specified only for a resource adapter conforming to Connector 1.5 or later versions.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the MinTPoolSize property.

You can specify the following character strings:

• MinTPoolSize

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the minimum number of threads that exist in the thread pool, as the property value.

Specify an integer value from 0 to 1024.

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag defines a resource adapter corresponding to the Connector 1.5 specifications.

Note that tags lower than this tag can be specified only for a resource adapter conforming to Connector 1.5 or later versions.

None.

None.

You can omit this tag.

You cannot omit the value of this tag.

This tag specifies the TpoolKeepalive property.

You can specify the following character strings:

• TPoolKeepalive

None.

You cannot omit this tag.

You cannot omit the value of this tag.

This tag specifies the timeout value (seconds) until the release of threads of the thread pool, as the property value.

Specify an integer value from 1 to 2147483647.

None.

You cannot omit this tag.

You cannot omit the value of this tag.