4.2.1 Specifications of the HITACHI JavaBeans Resource Property file

The HITACHI JavaBeans Resource Property file has the following DOCTYPE declaration:

<!DOCTYPE hitachi-javabeans-resource-property PUBLIC '-//Hitachi, Ltd.//DTD JavaBeans Resource Property 7.0//EN' 'file:///Cosminexus-installation-directory/CC/admin/dtds/hitachi-javabeans-resource-property_7_0.dtd'>

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

Tag nameOccurrence patternDescription
<hitachi-javabeans-resource-property>OnceThis is the root tag.

<description>Zero or onceDescribes the JavaBeans resource.

<display-name>OnceSpecifies the display name of the JavaBeans resource.
1[Figure] character-string-length[Figure] 240.
To change the value, you can use alphanumeric characters (0 to 9, A to Z, a to z), and the following special characters:
Space ( ), exclamation mark (!), hash mark (#), dollar sign ($), percent sign (%), ampersand (&), left parenthesis and right parenthesis (() ()), plus sign (+), hyphen (-), period (.), semicolon (;), less-than sign (<), greater-than sign (>), at mark (@), square brackets ([) (]), yen sign ([Figure]), 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 only a period (.)
Also, any single-byte space at the beginning or end of the character string is removed and does not cause an error.

<res-type>Zero or onceSpecifies the resource type.
Specify the class name of the JavaBeans resource. You can omit the resource type when the name is the same as <class-name>.

<class-name>OnceSpecifies the implementation class name.
Specify the implementation class name of the JavaBeans resource.

<runtime>Once--

<property>Zero or more timesIf the <property> tag is specified multiple times and if the setup value of <property-name> is the same, the tags are merged together. In this case, a warning message (KDJE37600-W) is output and the value of <property-value> of the <property> tag that was defined later is enabled.

<property-name>OnceSpecifies the property name.
Specify the set method name and get method name of the JavaBeans resource.

<property-type>OnceSpecifies the types of Java property values.
You can specify the following types:
  • int
  • long
  • short
  • byte
  • double
  • float
  • boolean
  • char
  • java.lang.Integer
  • java.lang.Long
  • java.lang.Short
  • java.lang.Byte
  • java.lang.Double
  • java.lang.Float
  • java.lang.Boolean
  • java.lang.Character
  • java.lang.String

<property-value>Zero or onceSpecifies the property value.

<resource-env-external-property>Zero or more times--

<description>Zero or onceDescribes the optional name of the resource environment.

<optional-name>OnceSpecifies the optional name of the resource environment.
You can use alphanumeric characters (0 to 9, A to Z, a to z) and the following special characters in the value:
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 cannot, however, specify the following names:
  • Names beginning with the reserved word HITACHI_EJB (case sensitive)
  • Names in which forward slash (/) or period (.) is specified at the beginning or end
  • Names containing only forward slash (/) or period (.)
  • Names containing continuous forward slashes (/)
Any space or linefeed at the beginning or end of the character string is removed and does not cause an error. If a space or linefeed appears in the middle of the character string, an error occurs.
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