Use this task to configure the properties of a mediation in the
administrative console.
Before you begin
This task assumes that you have defined a new mediation. For more
information, see
Defining a mediation.
Why and when to perform this task
Configuring the properties of a mediation controls how it behaves
at run-time. To configure the properties of a selected mediation,
use the administrative console to complete the following steps:
Steps for this task
- Display a selected mediation:
- In the navigation pane, click
- In the content pane, click
the name of the service integration bus
- In the content pane, under Destination resources, click Mediations.
- In the content pane, select
the name of the mediation for which you want to configure properties.
- Specify the following properties for the mediation:
- Description
- Optionally, type a description of the behavior of the mediation, taking
into account any properties specified for the mediation.
- Handler list name
- Type the name of the handler list that was defined when the mediation
was deployed. Handler list names start with an upper case letter, and are
unique within the Service integration bus.
- Global transaction
- Optionally, select this option (setting it to true) if you want to start
a global transaction for each message mediated by the mediation.
By default, Global transaction is
set to false, and a global transaction is not started when a message is mediated.
- Allow concurrent mediation
- Optionally, select this option (setting it to true) if you want to mediate
multiple messages at the mediated destination.
By default,
Allow concurrent mediation is set to false, and concurrent mediations are not allowed.
Note: Do
not allow concurrent mediation if message ordering is important.
- Selector
- Optionally, type a message selector to control which messages are mediated
by the mediation. The selector operates on the content of the message header.
The syntax of the message selector is defined by the JMS specification.
If
the message meets the conditions of the selector, the message is mediated.
Otherwise, the message is not mediated.
For information about the properties
that can be used in selectors, see Message properties support for mediations.
- Discriminator
- Optionally, type a message discriminator to control which messages are
mediated by the mediation. Message discriminators conform to the publish/subscribe
topic space syntax.
If the message meets the conditions of the discriminator,
the message is mediated. Otherwise, the message is not mediated.
- Specify any additional properties.
- Click OK.
- Save your changes to the master configuration.
The configuration properties for the mediation are created.
If you want to configure the mediation context information, see
Configuring mediation context properties. To use the configured
mediation at a destination, see
Mediating a destination.