Create a JMS connection profile to supply the runtime connection information for a Java Message Service (JMS) endpoint.
You have the option of using the configured JMS connection profiles supplied by Sybase WorkSpace or defining a connection profile for an external JMS provider. In the latter case, you must specify the connection properties using this procedure.
To create a JMS connection profile:
Open the Enterprise Explorer.
Right-click Message Transports and select New.
In the Wizard Selection Page, select JMS and click Next.
Name the JMS connection profile. Complete the following:
Name and Description page
| Field | Description |
|---|---|
| Name | Enter a meaningful name for the profile. For example, JMS01. |
| Description | Enter a description that helps you distinguish this connection profile from others. For example, Java messaging queue. |
| Auto-Connect | (Optional) Select the check box to automatically connect to the server and display its contents in the Enterprise Explorer. This happens whenever the Enterprise Explorer is opened. Clear the check box to allow only manual connections. |
In the Driver Details page, specify the driver and connection properties as needed. Choose from the following:
To use a JMS provider supplied by Sybase WorkSpace, select a driver from the drop-down list and click Next.
The fields are automatically populated according to your selection. Go to the step 6.
To use an external, user-defined JMS provider, do the following:
Click [...] to select the Generic JMS driver definition for your external JMS provider.
See Setting Up JMS Drivers for Development for more information on the Generic JMS driver.
Define the following properties and click Next.
Connection Properties
| Property | Description |
|---|---|
Provider URL | Enter the URL address for the external JMS provider. |
Initial Context Factory | Enter the context factory for the external JMS provider. |
User Name | Enter the user name to access the external JMS provider. |
Password | Enter the user name password for the external JMS provider. |
In the Queues contained within page, define the queues for the external JMS provider:
Enter a queue name.
Define the connection factory for the queue and click Add.
(Optional) Reorder or remove existing queues using Up, Down, Remove, or Clear All buttons.
Click Next.
Review the Summary page and click Finish.
The connection profile appears in the Enterprise Explorer under the Message Transports folder. If you selected Auto-Connect in the Name and Description page, WorkSpace connects to the JMS provider.
At any time, if you change the properties of a connection profile that is currently connected, the connection to the JMS provider is automatically broken, an update is made with the new configuration information, and then an attempt is made to reconnect with the JMS provider.
Send your feedback on this help topic to Sybase Tech Pubs: pubs@sybase.com