4.1.1 Specifications of the HITACHI Connector Property file

The following table lists and describes the items used in the tables of the HITACHI Connector Property file:

Item nameExplanation
Tag nameDisplays the tag to be set.
Occurrence patternIndicates the frequency of occurrence of the tag.
ContentsIndicates the contents to be defined for the tag.
Specifiable valueIndicates the values that you can specify in the tag. If no value can be specified, a hyphen (-) is specified.
DefaultIndicates the value that is enabled when the contents to be specified in the tag are omitted. If no default value exists, "None" is specified.
VersionIndicates the Application Server version that can be defined.

The details on the omission of the keys and values and the contents are described in each definition of the HITACHI Connector Property File.

The HITACHI Connector Property file has the following DOCTYPE declaration:

<!DOCTYPE hitachi-connector-property PUBLIC '-//Hitachi, Ltd.//DTD Connector Property 7.6//EN' 'file:///Cosminexus-installation-directory/CC/admin/dtds/hitachi-connector-property_7_6.dtd'>

The HITACHI Connector Property file is an xml file containing the following tags. Note that you can also use earlier versions of the property file.

Tag nameOccurrence patternContentsSpecifiable valueDefaultVersion
<hitachi-connector-property>Zero or onceThis is the root tag.--None05-05

<description>Zero or more timesDescribes the resource adapter.There are no limitations for the input value.None05-05

<display-name>

One or more times

Specifies the name of the resource adapter displayed on the Deploy tool.

You can use only alphanumeric characters or underscore (_).
You can specify the value in the range of 1 [Figure]character-string-length [Figure]240. The number of characters that you can specify is 1 to range-estimated-with-the-formula#-for-estimating-the-work-directory-path-length.
To change the value, you can use alphanumeric characters (0 to 9, A to Z, a to z), and the following special characters:
plus sign (+), hyphen (-), period (.), caret (^), underscore (_)
"TP1/Message Queue - Access" is the rar display name of TP1/Message Queue - Access, and therefore, can be specified. You cannot, however, specify the following names:
  • Name containing a period (.) at the beginning or at the end
  • Name containing only a period (.)
If you specify the following names, you might not be able to operate the J2EE applications. Therefore, do not specify the following names:
  • Name specifying an underscore (_) before and after a sign (example: abc_+_001)
  • Name ending with a sign (example: abc+)
None

05-05

<icon>Zero or more timesDefines the icons of the resource adapter displayed on the Deploy tool.--None05-05

<small-icon>Zero or onceSpecifies the file name for small icons (16[Figure] 16).There are no limitations for the input value.None05-05

<large-icon>Zero or onceSpecifies the file name for large icons (32[Figure] 32).There are no limitations for the input value.None05-05

<vendor-name>OnceSpecifies the vendor name of the resource adapter provider.
You cannot change this tag.
There are no limitations for the input value.None05-05

<spec-version>OnceSpecifies the version of the connector architecture specifications supported by the resource adapter.
You cannot change this tag.
There are no limitations for the input value.None05-05

<eis-type>OnceSpecifies the information about the EIS type.
You cannot change this tag.
There are no limitations for the input value.None05-05

<version>OnceSpecifies the resource adapter version.
You cannot change this tag.
There are no limitations for the input value.None05-05

<license>Zero or onceDefines the license request of the resource adapter module.--None05-05

<description>Zero or more timesDescribes the license.There are no limitations for the input value.None07-60

<license-required>OnceSpecifies the flag for license request when deploying or using resource adapters.
You cannot change this tag.
You can specify the following strings:
  • true: Requested
  • false: Not requested
None05-05

<resourceadapter>OnceDefines the resource adapter settings.--None05-05

<resourceadapter-class>Zero or onceSpecifies the Java class name in which javax.resource.spi.ResourceAdapter is implemented.
You cannot change this tag.
There are no limitations for the input value.None07-50

<config-property>Zero or more timesDefines the configuration properties of the ResourceAdapter instance.
You can specify this tag only for resource adapters conforming to Connector 1.5 specifications.
--None05-05

<description>Zero or more timesDescribes the configuration property.There are no limitations for the input value.None05-05

<config-property-name>OnceSpecifies the name of the configuration property.You cannot specify a duplicate name.
For details on the TP1 inbound adapter settings, see 4.1.11 Properties that you can specify in the <config-property> tag set up for TP1 inbound adapter.
For details on the resource adapter settings of Cosminexus JMS provider, see 4.1.12 Properties that you can specify in the <config-property> tag set up for resource adapters of Cosminexus JMS provider.
None05-05

<config-property-type>OnceSpecifies the Java type of the configuration property requested by ResourceAdapter.Specify any one of the following:
  • java.lang.Boolean
  • java.lang.String
  • java.lang.Integer
  • java.lang.Double
  • java.lang.Byte
  • java.lang.Short
  • java.lang.Long
  • java.lang.Float
  • java.lang.Character
None05-05

<config-property-value>Zero or onceSpecifies the configuration property value. When the <config-property-value> tag is not specified, the information about that property is not changed. The already set up information is retained as is.
When the <config-property-value> tag is specified, and if no value is specified, a space will be specified in the information of that property.
When the <config-property-value> tag is specified, and a value is also specified, the specified value will be set up in the property.
There are no limitations for the input value.None05-05

<outbound-resourceadapter>Zero or onceSpecifies the definition of the resource adapter in the Outbound direction.--None07-50

<connection-definition>One or more timesDefines the connection interface class.--None07-50

<managedconnectionfactory-class>OnceSpecifies the Java class name in which the javax.resource.spi.ManagedConnectionFactory interface is implemented.
Specified from the package when the package is defined.
You cannot change this tag.
There are no limitations for the input value.None05-05

<config-property>Zero or more timesDefines the configuration property.--None05-05

<description>Zero or more timesDescribes the configuration property.There are no limitations for the input value.None05-05

<config-property-name>OnceSpecifies the configuration property name.You cannot specify a duplicate name.
For details on the DB Connector settings, see 4.1.10 Properties that you can specify in the <config-property> tag set up for DB Connector.
For details on the resource adapter settings of Cosminexus JMS provider, see 4.1.12 Properties that you can specify in the <config-property> tag set up for resource adapters of Cosminexus JMS provider.
None05-05

<config-property-type>OnceSpecifies the Java type of the configuration property requested by ResourceAdapter.Specify any one of the following:
  • java.lang.Boolean
  • java.lang.String
  • java.lang.Integer
  • java.lang.Double
  • java.lang.Byte
  • java.lang.Short
  • java.lang.Long
  • java.lang.Float
  • java.lang.Character
None05-05

<config-property-value>

Zero or once

Specifies the configuration property value.
When the <config-property-value> tag is not specified, the information about that property is not changed. The already set up information is retained as is.
When the <config-property-value> tag is specified, and if no value is specified, a space will be specified in the information of that property.
When the <config-property-value> tag is specified, and a value is also specified, the specified value will be set up in the property. When XAOpenString is set in the <config-property-name> tag, and a value is specified in the <config-property-value> tag, the <config-property-value> tag is not displayed for security reasons. To change the value, add the <config-property-value> tag, and then specify the value after change.
If XAOpenString is set in the <config-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 config-property-value has already been set. -->
When no value is specified:
Empty tag <>
There are no limitations for the input value.

None

05-05

<connectionfactory-interface>OnceSpecifies the class name of the ConnectionFactory interface supported by the resource. Specified from the package when the package is defined.
For resource adapters conforming to Connector 1.5 specifications, the value of this tag will become the connection definition identifier.
You cannot change this tag.
There are no limitations for the input value.None05-05

<connectionfactory-impl-class>OnceSpecifies the Java class name in which the ConnectionFactory interface is implemented. You specify from the package when the package is defined.
You cannot change this tag.
There are no limitations for the input value.None05-05

<connection-interface>OnceSpecifies the class name of the Connection interface supported by the resource adapter.
Specified from the package when the package is defined.
You cannot change this tag.
There are no limitations for the input value.None05-05

<connection-impl-class>OnceSpecifies the Java class name in which the Connection interface is implemented. Specified from the package when the package is defined.
You cannot change this tag.
There are no limitations for the input value.None05-05

<connector-runtime>Zero or onceDefines the runtime property.--None07-50

<property>Zero or more timesSets up the information unique to the connection interface class.--None05-05

<property-name>OnceSpecifies the property name.Specify any one of the following:
  • MaxPoolSize
  • MinPoolSize
  • LogEnabled
  • User
  • Password
  • ValidationType
  • ValidationInterval
  • RetryCount
  • RetryInterval
  • ConnectionTimeout
  • SweeperInterval
  • RequestQueueEnable
  • RequestQueueTimeout
  • WatchEnabled
  • WatchInterval
  • WatchThreshold
  • WatchWriteFileEnabled
  • ConnectionPoolAdjustmentInterval
  • Warmup
  • NetworkFailureTimeout
None05-05

<property-type>OnceSpecifies the Java type of the property value.There are no limitations for the input value.None05-05

<property-value>Zero or onceSpecifies the property value.
When the <property-value> tag is not specified, the information about that property is not changed. The already set up information is retained as is.
When the <property-value> tag is specified, and if no value is specified, a blank will be specified in the information of that property.
When the <property-value> tag is specified, and a value is also specified, the specified value will be set up in the property.
When User or Password is specified in the <property-name> tag, and a value is specified in the <property-value> tag, the <property-value> tag is not displayed for security reasons. To change the value, add the <property-value> tag, and then specify the value after change.
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.
See 4.1.13 Properties that you can specify for the <property> tag.
--05-05

<property-default-value>Zero or onceSpecifies the default value of the property.
You cannot change this tag.
There are no limitations for the input value.--05-05

<resource-external-property>Zero or more timesDefines the external properties of the resource.
When multiple <resource-external-property> tags are specified and the set value of <optional-name> is the same, the tags are merged into one.
In such cases, a warning message (KDJE37600-W) is output, and the value of <res-auth> and <res-sharing-scope> of the <resource-external-property> tag defined later becomes valid.
--None07-00

<description>Zero or onceDescribes the optional name of the resource.There are no limitations for the input value.None07-00

<optional-name>

Once

Specifies the optional name of the resource.
If multiple <resource-external-property> tags are specified within the same resource, and the specified value of <optional-name> configures the lower hierarchy of the specified value of another <optional-name> tag, a warning message (KDJE37602-W) is output.
Example:

Optional name 1: AAA
Optional name 2: AAA/BBB
1 [Figure] character-string-length [Figure] 255

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 (.), forward slash (/), colon (:),semicolon (;), less-than sign (<), equal sign (=), greater-than sign (>), question mark (?), at mark (@), square brackets ([) (]), yen sign ([Figure]), caret (^), underscore (_), grave accent mark (`), curly brackets ({) (}), vertical bar (|), and tilde (~)
You can specify 1 to 255 characters.
You cannot specify the following names:
  • Names beginning with the reserved word HITACHI_EJB (case sensitive)
  • Names with a forward slash (/) or period (.) specified at the beginning or end
  • Names containing only forward slash (/) or period (.)
  • Names containing continuous forward slashes (/).

Any single-byte space or linefeed at the beginning or end of the character string is removed. If a space or linefeed appear in the middle of the character string, an error occurs.
None

07-00

<res-auth>Zero or onceSpecifies whether to perform authentication for using resources in the application or to entrust authentication to the container.You can specify the following strings:
  • Application
  • Container
Container07-00

<res-sharing-scope>Zero or onceSpecifies whether to enable the sharing of a resource connection.You can specify the following strings:
  • Shareable
  • Unshareable
Shareable07-00

<transaction-support>OnceSpecifies the transaction support level provided in the resource adapter.You can specify the following strings:
  • NoTransaction
  • LocalTransaction
  • XATransaction
None05-05

<reauthentication-support>OnceSpecifies whether to support the reauthentication of the ManagedConnection instance.You can specify the following strings:
  • true
  • false
None05-05

<inbound-resourceadapter>Zero or onceDefines the resource adapter in the Inbound direction. You cannot change this tag.--None07-60

<messageadapter>Zero or onceDefines the messaging-related functionality of the resource adapter.
You cannot change this tag.
--None07-60

<messagelistener>One or more timesDefines the message listener.
You cannot change this tag.
--None07-60

<messagelistener-type>OnceSpecifies the message listener type.
You cannot change this tag.
There are no limitations for the input value.None07-60

<activationspec>OnceSpecifies the information for message endpoint activation. You cannot change this tag.--None07-60

<activationspec-class>OnceSpecifies the class in which the ActivationSpec interface is implemented. You cannot change this tag.There are no limitations for the input value.None07-60

<required-config-property>Zero or more timesSpecifies the properties that must be set up for message endpoint activation.
You cannot change this tag.
--None07-60

<description>Zero or more timesDescribes the properties that must be set up for message endpoint activation.
You cannot change this tag.
There are no limitations for the input value.None07-60

<config-property-name>OnceSpecifies the name of the properties that must be set up for message endpoint activation.
You cannot change this tag.
There are no limitations for the input value.None07-60

<adminobject>Zero or more timesDefines the administered objects provided by the resource adapter.
You can specify the definition about the Administered object, only for the resource adapter that complies with the specifications of Connector 1.5.
--None07-60

<adminobject-name>

Zero or once

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 ([Figure]), caret (^), underscore (_), grave accent mark (`), curly brackets ({) (}), vertical bar (|), and tilde (~)
Note that you cannot use continuous underscores (_).
You cannot specify the following names:
  • Name containing a period (.) at the beginning or at the end
  • Name containing a period (.) only
  • Name containing continuous underscores (_)

Any single-byte space or linefeed at the beginning or end of the character string is removed.
None

07-60

<adminobject-interface>OnceSpecifies the interface implemented by the administered object class.There are no limitations for the input value.None07-60

<adminobject-class>OnceSpecifies the administered object class.There are no limitations for the input value.None07-60

<config-property>Zero or more timesDefines the configuration property for the administered object.--None07-60

<description>Zero or more timesDescribes the configuration property.There are no limitations for the input value.None07-60

<config-property-name>OnceSpecifies the name of the configuration property.You cannot specify a duplicate name.None07-60

<config-property-type>OnceSpecifies the Java type of the configuration property requested by the adminobject instance.Specify any one of the following:
  • java.lang.Boolean
  • java.lang.String
  • java.lang.Integer
  • java.lang.Double
  • java.lang.Byte
  • java.lang.Short
  • java.lang.Long
  • java.lang.Float
  • java.lang.Character
None07-60

<config-property-value>Zero or onceSpecifies the configuration property value. The following operation is performed when executing the cjsetresprop command and the cjsetrarprop command:
When the <config-property-value> tag is not specified
The property information is set up as blank.
When the <config-property-value> tag is specified, and the value is blank
The property information is set up as blank.
When the <config-property-value> tag is specified, and a value is also specified
The value specified in the property is set up.
There are no limitations for the input value.None07-60

<security-permission>Zero or more timesDefines the security permission.
You cannot change this tag.
--None05-05

<description>Zero or more timesDescribes the security permission requested from the code of the resource adapter.
You cannot change this tag.
There are no limitations for the input value.None05-05

<security-permission-spec>OnceSpecifies the security permission for the security policy file.
You cannot change this tag.
There are no limitations for the input value.None05-05

<resourceadapter-runtime>Zero or onceYou can specify this tag only for the resource adapters conforming to Connector 1.5 specifications.--None07-50

<property>Zero or more timesSets up unique information for the resource adapter.--None05-05

<property-name>OnceSpecifies the property name.Specify any one of the following:
  • MaxTPoolSize
  • MinTPoolSize
  • TPoolKeepalive
None05-05

<property-type>OnceSpecifies the property type.There are no limitations for the input value.None05-05

<property-value>Zero or onceSpecifies the Java type of the property value.There are no limitations for the input value.
See 4.1.13 Properties that you can specify for the <property> tag.
--05-05

<property-default-value>Zero or onceSpecifies the default value of the property.
You cannot change this tag.
There are no limitations for the input value.
See 4.1.13 Properties that you can specify for the <property> tag.
--05-05
#
For details on the formula for estimating the length of the work directory path, see Appendix C.1 Work directory of the J2EE server in the uCosminexus Application Server System Setup and Operation Guide.
Legend:
--: You cannot specify any value.