Setting up the environment for JMS transport

Because the sending and receiving of documents to and from InterChange Server involves ICS-compatible components, you must perform the setup and configuration tasks described in Table 72. For information on how to configure Business Integration Connect for use with InterChange Server over JMS, see Configuring Business Integration Connect for InterChange Server.

Table 72. Setting up the environment for use of JMS transport protocol

Configuration step For more information
1. Configure your JMS queues. Configuring the JMS queues

2. Configure the WebSphere Business Integration Adapter for JMS.

Configuring the Adapter for JMS

Note:
If your documents contain attachments, you must also install and configure the Attachment data handler. For more information, see Handling documents with attachments.

Configuring the JMS queues

To use the JMS transport protocol with InterChange Server, you must set up the JMS system that WebSphere MQ provides. Supported versions of InterChange Server use version 5.3 of WebSphere MQ as a JMS provider. Therefore, you can use the steps in Appendix A, Configuring a JMS protocol with WebSphere MQ to set up the JMS transport-protocol mechanism.

Important:
The steps in Appendix A, Configuring a JMS protocol with WebSphere MQ must be performed on the machine on which WebSphere Business Integration Connect resides. This guide assumes that the JMS transport-mechanism required by the Adapter for JMS and InterChange Server has already been set up as part of the InterChange Server installation.

When you create your JMS queues for use between Business Integration Connect and InterChange Server, consider the following points:


Table 73. Naming JMS queues for InterChange Server directionality

Original queue name Directional queue name
inQ ICS2WBIC
outQ WBIC2ICS

Configuring the Adapter for JMS

The Adapter for JMS is the ICS-compatible component that allows Business Integration Connect to exchange documents with InterChange Server in the form of JMS messages. It supports the following interactions with InterChange Server:

Important:
WebSphere Business Integration Connect does not include the WebSphere Business Integration Adapter for JMS. You must obtain this product separately and install it according to the instructions in its Adapter for JMS User Guide. It is important that you read the steps described in this guide to correctly install and configure your Adapter for JMS.

When you have configured the Adapter for JMS to communicate with InterChange Server, follow the steps in this section to configure this adapter to accept JMS messages from Business Integration Connect:

Specifying the payload data handler

As Figure 21 shows, the Adapter for JMS uses a data handler to convert the business objects it receives from InterChange Server into the appropriate JMS messages.

Note:
The data handler that the Adapter for JMS calls converts the payload of the document. If your document is wrapped in an XML transport envelope (it contains attachments or the Envelope Flag is Yes), configure the Attachment data handler as the payload data handler. For more information, see Handling documents with attachments.

To indicate which data handler to use to convert the payload, you must take the steps listed in Business object conversion. In addition, you must configure the Adapter for JMS to use this payload data handler. In Connector Configurator, take the following steps:

You can also specify the data handler to use in the static or dynamic meta-object. The same properties (DataHandlerMimeType, DataHandlerConfigMO, and DataHandlerClassName) are available as attributes in these meta-objects. For a complete description, refer to the Adapter for JMS User Guide.

Identifying the JMS queues

When the Adapter for JMS receives a document from InterChange Server, puts the message in its outbound queue, which is the one that Business Integration Connect's Receiver is polling. Similarly, when Business Integration Connect sends a document to InterChange Server, it puts the document in its outbound queue, which is the one that the Adapter for JMS is polling.

Table 74 summarizes how to configure the JMS queues that the Adapter for JMS uses to receive and send documents.

Note:
For a complete description of how to configure JMS queues, refer to the Adapter for JMS User Guide.

Table 74. JMS queues

JMS queue Configuration set
Input queue

Set the InputDestination connector configuration property to the name of the JMS queue that the Adapter for JMS will poll for incoming messages.

Make sure that the name of this queue is the same as the one Business Integration Connect is using as its JMS outbound queue. If this queue is not specified in InputDestination, the Adapter for JMS will not poll the queue.

Note:
The InputDestination property contains a comma-separated list of input queues. If the Adapter for JMS polls multiple queues, make sure that this list includes the name of the JMS queue that Business Integration Connect is using as its JMS outbound queue.
Output queue At run-time, the collaboration can dynamically set the OutputQueue attribute in the dynamic meta-object to the name of the JMS queue that the Adapter for JMS will send its outgoing message.

You must make sure that the static or dynamic meta-objects are configured so that they can write to the queue on which the Business Integration Connect target is listening.

Copyright IBM Corp. 2003, 2004