data-source-aliases.dtd 

Use

Use this document type definition (DTD) to produce XML files for to set aliases for a previously deployed DataSource.

You can deploy a DataSource alias definition by:

...

       1.      Creating a data-source-aliases.xml file based on this DTD,

       2.      Including the file in:

                            a.      The META-INF directory of the application archive (EAR)

                            b.      The ./server/descriptors directory of library SDA.

For more information, see Registering a DataSource Alias.

Structure

The data-source-aliases.dtd has the following structure:

The use of each element is explained below:

<!--

Data-source-aliases is the root element for this deployment descriptor. It contains information about the application name to which the DataSource is associated, and the aliases for this DataSource.

-->

<!ELEMENT data-source-aliases (application-name?, aliases+)>

 

<!--

Application-name element defines the name of the application to which the DataSource is associated. If the data-source-aliases.xml file is included in the archive file (EAR) of the application, this tag is ignored. If you deploy a standalone DataSource, the application name you specify is a formal name used for the configuration where the DataSource is stored; therefore, you can specify any name.

Used in: data-source-aliases

-->

<!ELEMENT application-name (#PCDATA)>

 

<!--

Aliases element contains information about the name of the DataSource and the alias(es) that you specify for the DataSource. You can include multiple <aliases> tags in a single XML to add aliases for more than one DataSource objects.

Used in: data-source-aliases

-->

<!ELEMENT aliases (data-source-name, alias+)>

 

<!--

Data-source-name element defines the DataSource for which you add aliases. The DataSource is defined by its name.

Used in: aliases

Example: <data-source-name>myDataSource</data-source-name>

-->

<!ELEMENT data-source-name (#PCDATA)>

 

<!--

Alias element defines the alias for the DataSource. The alias is used for binding the same DataSource with a different name in the naming, so that multiple applications can use a single DataSource.

Used in: aliases

Example: <alias>myDS</alias>

-->

<!ELEMENT alias (#PCDATA)>