WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

WebSphere MQ server and mediated exchange scenarios

When you mediate a service integration bus destination, your mediation runs in a bus member (the "mediation execution point") and you specify a combination of mediation points and queue points to handle the messages that are mediated. When you interoperate with WebSphere MQ using WebSphere MQ server, you can use one of several mediated exchange scenarios.

Queue-type destinations assigned to a WebSphere MQ server bus member can be mediated in much the same way as destinations assigned to other bus members. In addition to the mediation task described in Mediating a destination using a WebSphere MQ queue as the mediation point, WebSphere MQ server supports other mediation scenarios that you also set up using the administrative console Mediation wizard.

Note: Although WebSphere MQ server extends the way in which queue-type destinations can be mediated, the way in which topic spaces are mediated does not change.
You need to understand the following terms:
mediation point
This is the location where messages are placed before they are mediated. It can be either a service integration bus member (an application server or a cluster) or a WebSphere MQ queue.
queue point
This is the location where messages are placed after they have been mediated. It can be either a service integration bus member (an application server or a cluster) or a WebSphere MQ queue. If there is a default forward routing path and the destination is a queue-type destination, the queue point is unused. If the destination is a service type destination, the queue point is absent.
mediation execution point
This is the server where the mediation process runs. If the mediation point is a service integration bus member then the mediation execution point is the same bus member as the mediation point.
For more information, see WebSphere MQ queue points and mediation points.

WebSphere MQ server supports the following mediated exchange scenarios:

Alternatively (scenario 4) you can use a WebSphere MQ application or a WebSphere Message Broker flow to mediate the destination. In this case, the application or broker flow retrieves messages from the mediation point (which is a WebSphere MQ queue), mediates the messages, then places the mediated messages on the queue point (which is also a WebSphere MQ queue). You do not specify a mediation execution point when you configure the mediation; instead, you specify that there is an external mediation process.

Figure 1. Queue-type destinations assigned to a service integration bus member. Queue points and mediation points are queues of service integration messages held in service integrationFor a queue point, message producers place messages on the queue point and consumers receive messages from the queue point. For a mediation point, message producers place messages on the mediation point. The messages are mediated then put on a post-mediation queue point. Consumers receive messages from the post-mediation queue point.
Figure 2. Queue-type destinations assigned to a WebSphere MQ server bus member. Queue points and mediation points can be queues of WebSphere MQ messages held in WebSphere MQ. A WebSphere Message Broker, or other WebSphere MQ application, can perform mediations externally.For a queue point, message producers place messages on the queue point and consumers receive messages from the queue point. If the queue point is a WebSphere MQ queue point, message producers place messages on the WebSphere MQ queue and consumers receive the messages from the WebSphere MQ queue. For a mediation point, message producers place messages on the mediation point (a WebSphere MQ queue). The messages are mediated, perhaps by an external WebSphere Message Broker flow, then put on a post-mediation queue point (another WebSphere MQ queue). Consumers receive messages from the post-mediation queue point.

The following table describes the mediated exchange scenarios in more detail:

Scenario How messages are processed Steps to complete in the Mediation wizard

Scenario 1: Mediate a conventional queue-type destination where the queue point is a service integration queue point, and assign a WebSphere MQ queue as the mediation point (the input side of the destination).

As the mediation point is a WebSphere MQ queue, a queue point must also be specified.

Messages arriving at the WebSphere MQ queue are processed by the mediation running in an application server. When the messages have been processed by the mediation, they are placed onto the service integration queue point.

The mediation itself runs on a service integration bus member nominated as the mediation execution point.

This example assumes that the destination is assigned to a service integration bus member:

  1. Navigate to the destinations collection panel for the bus that hosts the destination you want to mediate.
  2. Select the queue-type destination that you want to mediate, then click Mediate. This starts the Mediate destination wizard:
  3. Step 1: select the mediation that you want to use to mediate the service integration destination.
  4. Step 2: select a WebSphere MQ server bus member to host the mediation point.
  5. Step 3: enter details of the WebSphere MQ queue that will be the mediation point.
  6. Step 4: select a bus member where you want the mediation code to run.
  7. Step 5: review the summary of changes you are about to make, then click Finish.

Scenario 2: Mediate a WebSphere MQ queue type, with a WebSphere MQ queue point, and assign a WebSphere MQ queue as the mediation point (the input side of the destination).

As the mediation point is a WebSphere MQ queue, a mediation execution point must also be specified.

Messages arriving at the destination are processed by the mediation, then placed on the WebSphere MQ queue.

The mediation itself will run on the service integration bus member nominated as the mediation execution point.

This example assumes that the destination is assigned to a WebSphere MQ server bus member:

  1. Navigate to the destinations collection panel for the bus that hosts the destination you want to mediate.
  2. Select the queue-type destination that you want to mediate, then click Mediate. This starts the Mediate destination wizard:
  3. Step 1: select the mediation that you want to use to mediate the service integration destination.
  4. Step 2: select a WebSphere MQ server bus member to host the mediation point.
  5. Step 3: enter details of the WebSphere MQ queue that will act as the mediation point.
  6. Step 4: select the service integration bus member where you want the mediation to run.
  7. Step 5: review the summary of changes you are about to make, then click Finish.

Scenario 3: Mediate a WebSphere MQ queue type and assign a service integration mediation point.

Messages arriving at the destination are processed by the mediation, then placed on the WebSphere MQ queue.

The mediation code runs in the service integration bus member that is assigned as the mediation point.

This example assumes that the destination is assigned to a WebSphere MQ server bus member:

  1. Navigate to the destinations collection panel for the bus that hosts the destination you want to mediate.
  2. Select the queue-type destination that you want to mediate, then click Mediate. This starts the Mediate destination wizard:
  3. Step 1: select the mediation that you want to use to mediate the service integration destination.
  4. Step 2: select the service integration bus member to host the mediation point. The mediation code also runs in this bus member.
  5. Step 3: review the summary of changes you are about to make, then click Finish.

Scenario 4: Mediate a WebSphere MQ queue-type destination and assign a WebSphere MQ queue as the mediation point (the input side of the destination). The mediation of messages is performed by an external process.

Messages arriving at the WebSphere MQ queue are processed by an external process, then placed by the external process on the WebSphere MQ queue-type destination.

This example assumes that the destination is assigned to a WebSphere MQ server bus member:

  1. Navigate to the destinations collection panel for the bus that hosts the destination you want to mediate.
  2. Select the queue-type destination that you want to mediate, then click Mediate. This starts the Mediate destination wizard.
  3. Step 1: select an external process to use for mediating the destination.
  4. Step 2: enter details of the WebSphere MQ queue that you want to act as the mediation point.
  5. Step 3: review the summary of changes you are about to make, then click Finish.
Related tasks
Creating the queue-type destination and assigning it to a WebSphere MQ queue
Mediating a destination using a WebSphere MQ queue as the mediation point
Related reference
Creating a new bus destination using the wsadmin tool
Creating new bus destinations using the wsadmin tool
Mediating a bus destination using the wsadmin tool
Unmediating a bus destination using the wsadmin tool
Related information
A practical introduction to message mediation -- Part 1
A practical introduction to message mediation -- Part 3
A practical introduction to message mediation -- Part 4
A practical introduction to message mediation -- Part 5

Concept topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/concepts/cjfp0020_.html

Copyright IBM Corporation 2004, 2008. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)