4.1.7 Defining administered objects

This subsection describes the details on defining the administered objects in the HITACHI Connector Property File with reference to each tag. You can specify the definition about the Administered object only for the resource adapter that complies with the specifications of Connector 1.5.

Note that the tag details are described in the order mentioned in 4.1.1 Specifications of the HITACHI Connector Property file.

Organization of this subsection
(1) <adminobject>
(2) <adminobject-name>
(3) <adminobject-interface>
(4) <adminobject-class>
(5) <config-property>
(6) <description>
(7) <config-property-name>
(8) <config-property-type>
(9) <config-property-value>

(1) <adminobject>

Description
This tag defines the administered objects provided by the resource adapter.
Specifiable value
--
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(2) <adminobject-name>

Description
This tag specifies the administered object name.
This name must be unique within a resource adapter.
Specifiable value
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 (~)
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.
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(3) <adminobject-interface>

Description
This tag specifies the interface implemented by the administered object class.
Specifiable value
There are no limitations for the input value.
Tag omission
You cannot omit this tag.
Value omission
You cannot omit the value of this tag.

(4) <adminobject-class>

Description
This tag specifies the administered object class.
Specifiable value
There are no limitations for the input value.
Tag omission
You cannot omit this tag.
Value omission
You cannot omit the value of this tag.

(5) <config-property>

Description
This tag defines the configuration property for the administered object.
Specifiable value
--
Tag omission
You can omit this tag.
Value omission
You cannot omit the value of this tag.

(6) <description>

Description
This tag describes the configuration property.
Specifiable value
There are no limitations for the input value.
Tag omission
You can omit this tag.
Value omission
You can omit the value of this tag.

(7) <config-property-name>

Description
This tag specifies the configuration property name.
Specifiable value
You cannot specify a duplicate name. See 4.1.10 Properties that you can specify in the <config-property> tag set up for DB Connector.
Tag omission
You cannot omit this tag.
Value omission
You cannot omit the value of this tag.

(8) <config-property-type>

Description
This tag specifies the Java type of the configuration property requested by the adminobject instance.
Specifiable value
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
Tag omission
You cannot omit this tag.
Value omission
You cannot omit the value of this tag.

(9) <config-property-value>

Description
This tag specifies 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 if 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.
Specifiable value
There are no limitations for the input value.
Tag omission
You can omit this tag.
Value omission
You can omit the value of this tag.