Hitachi

uCosminexus Application Server Application and Resource Definition Reference Guide


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 name

Occurrence pattern

Description

<hitachi-mail-property>

Once

This is the root tag.

<description>

Zero or once

Describes the setup information.

<display-name>

Once

Specifies the mail display name.

1character-string-length240.

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>

Once

Specifies the mail address of the sender.

<server>

Once

Specifies the host name or IP address of the mail server.

<runtime>

Zero or once

--

<resource-external-property>

Zero or more times

If 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 once

Describes the optional name of the resource.

<optional-name>

Once

Specifies 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 character-string-length 255

<res-auth>

Zero or once

Specifies 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 once

Specifies whether to share the resource connection.

You can specify the following strings:

  • Shareable

  • Unshareable

The default value is Shareable.