To enable WebSphere Application Server to work with a connector, you need to create and configure WebSphere MQ queues.
The WebSphere Application Server environment allows you to map the names of physical WebSphere MQ queues to the JNDI names used in the binding properties of WebSphere Application Server. If circumstances at a later time require you to use a different queue or queue manager, you can change that name in the local configuration file, and change it in the WebSphere Application Server Administrative Console, without having to regenerate .wsdl files.
Creating and configuring the queues includes the following tasks:
Message queues provides information about how WebSphere MQ queues are used in the WebSphere business integration system. Setting the connection mode with the queue manager explains how to specify the connection mode in the connector's configuration file.
The business integration system requires that you create queues with the properties listed below.
You can configure the WebSphere MQ queues needed for your adapter, using any of the following methods:
Tip |
---|
To make it easy to identify the connector with which a queue is associated, use the name of the connector as a prefix in the queue name. For example, name the Clarify connector's event delivery queue: clarifyconnector/deliveryqueue. |
WebSphere Business Integration Adapters provides a set of batch files that you can run to configure the WebSphere MQ queues needed for the adapters you are deploying. The batch files, located in ProductDir\templates, consist of:
Run this batch file to configure the WebSphere MQ queues specified in crossworlds_mq.tst
For more information about using clear_mq.bat, seeClearing messages from WebSphere MQ queues.
The contents of the crossworlds_mq.tst file are shown below. You can use this one file to specify the queues needed by each adapter you are configuring. Edit the file as follows:
DEFINE QLOCAL(IC/SERVER_NAME/DestinationAdapter) DEFINE QLOCAL(AP/DestinationAdapter/SERVER_NAME)
These apply only to business integration systems that use WebSphere InterChange Server.
*******************************************************************/ * For each JMS queue (delivery Transport is JMS), * default values follow the convention: * AdapterName/QueueName ********************************************************************/ DEFINE QLOCAL(AdapterName/AdminInQueue) DEFINE QLOCAL(AdapterName/AdminOutQueue) DEFINE QLOCAL(AdapterName/DeliveryQueue) DEFINE QLOCAL(AdapterName/RequestQueue) DEFINE QLOCAL(AdapterName/ResponseQueue) DEFINE QLOCAL(AdapterName/FaultQueue) DEFINE QLOCAL(AdapterName/SynchronousRequestQueue) DEFINE QLOCAL(AdapterName/SynchronousResponseQueue) ********************************************************************/ * Define the default CrossWorlds channel type */ ********************************************************************/ DEFINE CHANNEL(CHANNEL1) CHLTYPE(SVRCONN) TRPTYPE(TCP) ********************************************************************/ * End of CrossWorlds MQSeries Object Definitions */ ********************************************************************/
For information about configuring queues using WebSphere MQ Explorer, open WebSphere MQ Explorer and refer to its online help.
For information about configuring queues using WebSphere MQ commands, see WebSphere MQ: System Administration Guide and WebSphere MQ: Script (MQSC) Command Reference.
The WebSphere business integration system supports several queue managers and queue configurations. The connector can communicate with the queue manager in any of the following modes.
With bindings mode, the integration broker and the connector can communicate directly with the queue manager, without using a TCP/IP connection. The integration broker and the connector need to be installed on the same machine so that they can use the same queue manager. This is the default mode.
If WebSphere Application Server and the connector are installed on separate machines, with each machine running its own queue manager, the connector and the integration broker can still communicate with their respective queue managers using bindings mode. However, you need to specify remote queue definitions as explained in the example below.
Suppose brokerQM is the queue manager used by the integration broker and connQM is the queue manager used by the connector. To enable communication between the two queue managers, you need to set up the following channel definitions:
If WebSphere Application Server and the connector must use TCP/IP to communicate with their respective queue managers, then they must use a client mode connection. Communication occurs through a client connection that uses TCP/IP as its underlying transport.