Sun Java System Web Server 6.1 SP11 Administrator's Configuration File Reference

sun-web-server_6_1.dtd File

The sun-web-server_6_1.dtd file defines the structure of the server.xml file, including the elements it can contain and the subelements and attributes these elements can have. The sun-web-server_6_1.dtd file is located in the install_dir/bin/https/dtds directory.

Each element defined in a DTD file (which might be present in the corresponding XML file) can contain the following:

Subelements

Elements can contain subelements. For example, the following file fragment defines the VSCLASS element.

<!ELEMENT VSCLASS (VARS?, VS*, QOSPARAMS?)>

The ELEMENT tag specifies that a VSCLASS element can contain VARS, VS, and QOSPARAMS elements in that order.

The following table shows how optional suffix characters of subelements determine the requirement rules or number of allowed occurrences for the subelements.

Table 2–1 Requirement Rules and Subelement Suffixes


Subelement Suffix	Requirement Rule
element*	Can contain zero or more of this subelement
element?	Can contain zero or one of this subelement
element+	Must contain one or more of this subelement
element (no suffix)	Must contain only one of this subelement

If an element cannot contain other elements, you see EMPTY or (#PCDATA) instead of a list of element names in parentheses.

Data

Some elements contain character data instead of subelements. These elements have definitions of the following format:

<!ELEMENT element-name (#PCDATA)>

For example:

<!ELEMENT DESCRIPTION (#PCDATA)>

In the server.xml file, white space is treated as part of the data in a data element. Therefore, there should be no extra white space before or after the data delimited by a data element. For example:

<DESCRIPTION>myserver</DESCRIPTION>

Attributes

Elements that have ATTLIST tags contain attributes (name-value pairs). For example:

<!ATTLIST JDBCRESOURCE

jndiname CDATA #REQUIRED

poolname CDATA #REQUIRED

enabled %boolean; "true">

A JDBCRESOURCE element can contain jndiname, poolname, and enabled attributes.

The #REQUIRED label means that a value must be supplied. The #IMPLIED label means that the attribute is optional, and that Sun Java System Web Server generates a default value. Wherever possible, explicit defaults for optional attributes (such as "true") are listed.

Attribute declarations specify the type of the attribute. For example, CDATA means character data, and %boolean is a predefined enumeration.