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.

   The Connector Wizard appears.

4. Ensure that JMS is selected and then select the type of web server you are using. Click Next.

5. In the Connector Names page, enter the following values:

   • Connector Name   The connector address that a QAnywhere client should use to address the connector.

     See Sending a QAnywhere message to a JMS connector.

   • Receiver Destination   The queue name used by the connector to listen for messages from JMS targeted for QAnywhere clients.

6. In the JNDI Settings page, enter the following values:

   • JNDI Factory   The factory name used to access the external JMS JNDI name service.

   • Name Service URL   The URL to access the JMS JNDI name service.

   • User Name   The authentication name to connect to the external JMS JNDI name service.

   • Password   The authentication password to connect to the external JMS JNDI name service.

7. In the JMS Queue Settings page, enter the following values:

   • Queue Factory   The external JMS provider queue factory name.

   • User Name   The user ID to connect to the external JMS queue connection.

   • Password   The password to connect to the external JMS queue connection.

8. In the JMS Topic Settings page, enter the following values:

   • Topic Factory   The external JMS provider topic factory name.

   • User Name   The user ID to connect to the external JMS topic connection.

   • Password   The password to connect to the external JMS topic connection.

9. Click Finish.

   You are prompted to add the client JAR files in the mlsrv11 command line.

10. Start the MobiLink server with a connection to the server message store and the -sl java option.

    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.