Registering a JMS Destination

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.

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  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. Caution 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. Tip 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.

   Tip

   If you want to create a JMS Destination similar to an already existing one, use  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  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 .

See also:

Editing JMS ConnectionFactory and Destination