Registering a JMS Destination (SAP Library

Registering a JMS Destination

Use

Use this procedure to register a JMS Topic or Queue Destination object.

The J2EE Engine administration tools enable you to register a standalone JMS Destination. It is deployed on the server as an application that contains only the deployment descriptor for the Destination object.

Procedure

You can register a standalone JMS Destination using the:

· Visual Administrator

· Console Administrator

Visual Administrator

1. In the Runtime tab of JMS Connector Service, choose Resources → Destinations.

2. Choose This graphic is explained in the accompanying text New on the toolbar.

3. In the right-hand tab complete the following fields:

Field	Description	Example
Application Name	Specify a name to which the Destination is assigned. This name is used for the configuration that holds the object. Do not enter the name of an application that is already deployed on the server. This leads to re-deployment of the application and data loss.	myApplication
Destination Name	Specify a name for the object that you create.	myTopicDestination
Factory Name	Specify the name of a Queue- or TopicConnectionFactory. If the ConnectionFactory that you specify does not exist on the J2EE Engine, you cannot start the JMS Destination. After you deploy a ConnectionFactory with the specified name on the J2EE Engine, the JMS Destination is automatically started.	myTopicConnectionFactory
Description	You can enter a short description for the object you create.	This is a Topic JMS Destination for <X> provider.
User	Enter a username for authentication to the JMS provider. This must be an existing user. If you leave this field empty, the user and password for the used ConnectionFactory are assigned to the Destination object.	Administrator
Password	Enter a password that corresponds to the specified username.

Note

If you want to create a JMS Destination similar to an already existing one, use This graphic is explained in the accompanying text Copy on the toolbar to copy the properties of the existing JMS Destination. Then choose New and Paste to paste the properties. Modify the parameters and save the JMS Destination object with a new name or in another application.

4. Choose This graphic is explained in the accompanying text Save changes on the toolbar to save the object.

Console Administrator

To create a JMS Destination, use the deploy_destination command from the JMSCONNECTOR command group. For more information, see JMSCONNECTOR.

Note

The J2EE Engine supports registration of a JMS Destination when deploying a J2EE application. You have to include a relevant XML definition of the JMS object in the application archive file (EAR). For more information about the format of the XML file, see jms-destinations.dtd.