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.