4.3 HITACHI Mail Property file

The HITACHI Mail Property file has the following DOCTYPE declaration:

<!DOCTYPE hitachi-mail-property PUBLIC '-//Hitachi, Ltd.//DTD Mail Property 7.1//EN' 'file:///Cosminexus-installation-directory/CC/admin/dtds/hitachi-mail-property_7_1.dtd'>

The HITACHI Mail Property file is an xml file containing the following tags:

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

<description>Zero or onceDescribes the setup information.

<display-name>OnceSpecifies the mail display name.
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 a period (.) only
Also, any single-byte space at the beginning or end of the character string is removed and does not cause an error.

<from>OnceSpecifies the mail address of the sender.

<server>OnceSpecifies the host name or IP address of the mail server.

<runtime>Zero or once--

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

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

<optional-name>OnceSpecifies the optional name of the resource.
When setting the value, you can use alphanumeric characters (0 to 9, A to Z, a to z), underscore (_), hyphen (-), period (.), and forward slash (/) as the hierarchical delimiter.
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

<res-auth>Zero or onceSpecifies whether the authentication for using the resource is to be performed in the application or is to be entrusted to the container.
You can specify the following strings:
  • Application
  • Container
The default value is Container.

<res-sharing-scope>Zero or onceSpecifies whether to share the resource connection.
You can specify the following strings:
  • Shareable
  • Unshareable
The default value is Shareable.