The following steps provide an overview of the tasks required to set up QAnywhere with JMS connectors, assuming that you already have QAnywhere set up.

Overview of integrating a QAnywhere application with an external JMS system

1. Create JMS queues using the JMS administration tools for your JMS system. The QAnywhere connector listens on a single JMS queue for JMS messages. You must create this queue if it does not already exist.

   See the documentation of your JMS product for information about how to create queues.

2. Open Sybase Central and connect to your server message store.

3. Choose File » New » Connector.

4. Click JMS and then select the type of web server you are using on the Which JMS System Are You Using list . Click Next.

5. On the Connector Names page:

   • In the Connector Name field, type the connector address that a QAnywhere client should use to address the connector. See Sending a QAnywhere message to a JMS connector.

   • In the Receiver Destination field, type the queue name used by the connector to listen for messages from JMS targeted for QAnywhere clients.

   • Click Next.

6. On the JNDI Settings page:

   • In the JNDI Factory field, type the factory name used to access the external JMS JNDI name service.

   • In the Name Service URL field, type the URL to access the JMS JNDI name service.

   • In the User Name field, type the authentication name to connect to the external JMS JNDI name service.

   • In the Password field, type the authentication password to connect to the external JMS JNDI name service.

   • Click Next.

7. On the JMS Queue Settings page:

   • In the Queue Factory field, type the external JMS provider queue factory name.

   • In the User Name field, type the user ID to connect to the external JMS queue connection.

   • In the Password field, type the password to connect to the external JMS queue connection.

   • Click Next.

8. On the JMS Topic Settings page:

   • In the Topic Factory field, type the external JMS provider topic factory name.

   • In the User Name field, type the user ID to connect to the external JMS topic connection.

   • In the Password field, type the password to connect to the external JMS topic connection.

   • Click Finish.

9. Click OK.

10. Start the MobiLink server with a connection to the server message store and the -sl java options. See Starting the MobiLink server for JMS integration.

11. To set additional options on your JMS connector, right-click the connector you just created and choose properties; or you can use server management requests.

    For a list of available properties, see Configuring JMS connector properties.

    For information about how to set connector properties with server management requests, see Administering connectors with server management requests.

To send messages

1. To send a message from an application in your QAnywhere system to the external messaging system, create a QAnywhere message and send it to connector-address\JMS-queue-name.

   See Sending a QAnywhere message to a JMS connector.

2. To send a message from the external messaging system to an application in your QAnywhere system:

   • Create a JMS message.

   • Set the ias_ToAddress property to the QAnywhere id\queue (where id is the ID of your client message store and queue is your application queue name).

   • Put the message in the JMS queue.

   See Addressing JMS messages meant for QAnywhere.

Other resources for getting started

• QAnywhere JMS samples are installed to samples-dir\QAnywhere\jms. (For information about samples-dir, see Samples directory.)
• You can post questions on the QAnywhere newsgroup:  ianywhere.public.sqlanywhere.qanywhere
• For more information on setting up messaging in a server farm environment, see Running the MobiLink server in a server farm.