data-source-aliases.dtd 

Use

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

You can deploy a DataSource alias definition by creating a data-source-aliases.xml file based on this DTD, and including it in the META-INF directory of the application archive (EAR).

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. The alias contains information about the application name to which the data source alias is associated, and the aliases for the specified DataSource.

-->

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

 

<!--

Application-name element defines the name of the application to which the data source alias 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 data source alias, the application name you specify is a formal name used for the configuration where the data source alias is stored; therefore, you can specify a unique 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. On a system DataSource you can use com.sap.dataSource.default.

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. Aliases must be different from the other aliases on the DataSource names.

Used in: aliases

Example: <alias>myDS</alias>

-->

<!ELEMENT alias (#PCDATA)>