Mediate a destination by using the administrative console to specify
a WebSphere MQ server bus member where the mediation point is to be assigned,
a WebSphere MQ queue to act as the mediation point and a second bus member
(not a WebSphere MQ server) to act as the mediation execution point and process
the messages.
Before you begin
You can mediate a destination through the administrative console
as described in this task, or you can mediate a destination using the wsadmin tool.
Before
performing this task, ensure that the following resources exist:
- The mediation that you want to apply to the destination.
- The WebSphere MQ server bus member where the mediation point is to be
assigned.
- The WebSphere MQ queue to use as the mediation point.
- The second bus member (not a WebSphere MQ server bus member) to use as
the mediation execution point where the mediation code runs.
Note: When you complete this task, the queue manager on the WebSphere
MQ network does not have to be available, but the destination is not usable
until the queue manager is available.
About this task
You can mediate a destination with a WebSphere MQ mediation point.
This ensures that messages arriving at the designated WebSphere MQ queue are
mediated. In this scenario, the mediated messages are delivered to the queue
point, or to another destination that is determined by the default forward
routing path destination, or by the mediation code.
Procedure
- Start the administrative console.
- Navigate to the list of destinations for the appropriate bus. Click bus_name .
- Select the check box beside the destination to mediate, then click Mediate. The Mediation wizard is displayed.
- Select the mediation, then click Next. From the drop-down list, select the mediation to apply to the destination.
- Assign the mediation to a bus member:
- From the first drop-down list, select the WebSphere MQ server
bus member where the mediation point is to be assigned.
- From the second drop-down list, select the bus member where
the mediation is to run.
When a mediation is assigned to a WebSphere MQ server bus member, you
need a separate bus member that is not a WebSphere MQ server to act as the
mediation execution point and process the messages.
- Set the WebSphere MQ mediation point attributes:
- Specify a WebSphere MQ queue name.
Select a queue name from the list. If the list does not include the queue that you want, select the last entry in the list labeled "other, please specify". A text entry box is displayed next to the drop-down list. Type the queue name into the text entry box.
If the queue is found on the remote WebSphere MQ system, the properties of the queue as defined within WebSphere MQ are displayed as read-only fields. This should help you to confirm that you have found the queue that you want, and that it is configured as you intend. If the queue is not found, these read-only fields are removed from view.
- Specify the reliability level that you require for inbound nonpersistent
and inbound persistent messages. Specify the level of reliability to apply when a nonpersistent WebSphere MQ message is received, and when a persistent WebSphere MQ message is received. For information about the available reliability levels, see WebSphere MQ queue points [Settings].
- Specify whether you want to include an RFH2 message header when
sending messages to WebSphere MQ. The RFH2 header stores messaging information that does not have a corresponding WebSphere MQ message header field. Enable this if messages being sent to WebSphere MQ might reenter the bus.
- Click Next.
- Click Finish to confirm mediation of the
destination.
Results
You have mediated a destination using a WebSphere MQ queue as the
mediation point.