Setting up JMS connectors

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.

  3. Connect to your server message store using the QAnywhere plug-in.

    Click Connections » Connect with QAnywhere 12.

    The Connect to a Generic ODBC Database window appears

  4. In the User ID field, type ml_server.

  5. In the Password field, type sql.

  6. Click OK.

  7. Click File » New » Connector.

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

  9. On the Connector Names page:

    • In the Connector Name field, type the JMS System you are using. See Sending a QAnywhere message to a JMS connector.

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

    • Click Next.

  10. 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.

  11. 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.

  12. 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.

  13. Click OK.

  14. 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.

    Starting the MobiLink server

    When a JMS Connector is defined in this way, you must always start the MobiLink server as described, with the JMS client classes defined in the -sl java options. If the JMS Connector is no longer needed and you want to start MobiLink without the -sl java options, you must first remove the JMS Connector using Sybase Central.

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

    For a list of available properties, see JMS connector property configuration.

    For information about how to set connector properties with server management requests, see Connector administration with server management requests.

 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

Starting the MobiLink server for JMS integration
JMS connector property configuration
Multiple connector configuration

Copyright © 2012, iAnywhere Solutions, Inc. - SQL Anywhere 12.0.1