To enable a WebSphere message broker to work with a connector, you need to configure the WebSphere MQ queues that carry messages between the connector and the integration broker, and define appropriate queue configurations. You also need to ensure that the connector's configuration file contains correctly specified queue and queue manager information.
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. For detailed information about WebSphere MQ queues, queue managers, and queue configurations, see WebSphere MQ: Intercommunication.
The business integration system requires that you configure 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, see Clearing 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.
*******************************************************************/ * */ * Define the local queues for all Server/Adapter pairs. */ * For MQ queues, they must have the following definition: */ * Application = DEFINE QLOCAL (AP/AdapterName/ServerName) */ * */ * Example: */ * DEFINE QLOCAL(AP/ClarifyConnector/CrossWorlds) */ * */ * DEFINE QLOCAL(AP/SAPConnector/CrossWorlds) */ * */ * If your server is named something different than 'CrossWorlds' */ * make sure to change the entries to reflect that. */ ********************************************************************/ DEFINE QLOCAL(IC/SERVER_NAME/DestinationAdapter) DEFINE QLOCAL(AP/DestinationAdapter/SERVER_NAME) ********************************************************************/ * 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 WebSphere message 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 the WebSphere message broker 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 the message broker 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.