jms-destinations.dtd 

Definition

A document type definition (DTD) used for producing XML files for Java Message Service (JMS) destination creation. It contains properties that the system uses to initialize a JMS Destination object.

Structure

The jms-destinations.dtd has the following structure:

The usage of each element is explained in detail as follows:

<!--

Jms-destinations is the root element for this deployment descriptor. It contains information about the JMS destination(s) that you want to create, and the application name to which the destination(s) is associated.

-->

<!ELEMENT jms-destinations (application-name?, destination+)>

 

<!--

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

Used in: jms-destinations

-->

<!ELEMENT application-name (#PCDATA)> 

 

<!--

Destination element contains information about the JMS destination that you create. This information includes: used ConnectionFactory, username and password for the application server, and optionally a description of the destination object. You can include multiple <destination> tags in a single XML to create more than one object.

Used in: jms-destinations

-->

<!ELEMENT destination (connection-factory, destination-name, user-name?, password?, description?)>

 

<!--

Description element enables you to provide details about the JMS destination you create. This element is optional.

Used in: destination

Example: <description>This is an example of a JMS destination.</description>

-->

<!ELEMENT description (#PCDATA)>

 

<!--

Connection-factory element defines the JMS ConnectionFactory object that is used to produce connections for this destination.

Used in: destination

Example: <connection-factory>myConnectionFactory</connection-factory>

-->

<!ELEMENT connection-factory (#PCDATA)>

 

<!--

Destination-name element defines the name for the JMS destination object. Use this name to look up the object.

Used in: destination

Example:<destination-name>myDestination</destination-name>

-->

<!ELEMENT destination-name (#PCDATA)>

 

<!--

User-name element defines the username that is used by JMS provider’s security. If you do not specify a username, the system uses the one from the relevant ConnectionFactory.

Used in: destination

Example: <user-name>Administrator</user-name>

-->

<!ELEMENT user-name (#PCDATA)>

 

<!--

Password element defines the password that corresponds to the specified name in the <user-name> tag.

Used in: destination

-->

<!ELEMENT password (#PCDATA)>