Configure a new mediation

Configure a mediation in the administrative console.

This task assumes that we have installed a mediation application on the server or cluster where we want to run the mediation. For more information, see Install a mediation.

Configure a new mediation makes it available for use in mediating one or more destinations.

In this task, we use the administrative console to configure a mediation:

Tasks

1. Click Service integration -> Buses -> bus_name -> [Destination resources] Mediations.

2. In the content pane, click New.

3. Specify the following properties for the mediation:

   Mediation name

   Type a name for the mediation that is unique to the service integration bus. This name is used to identify the mediation for administrative purposes.

   Description

   Optionally, type a description for the mediation.

   Handler list name

   Type the handler list name. This is the name that was used when the mediation handler was deployed. Handler list names are unique within the WebSphere Application Server administrative cell.

   Global transaction

   Optionally, select this option (setting it to true) 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) to mediate multiple messages at the mediated destination.

   By default, Allow concurrent mediation is set to false, and concurrent mediations are not allowed.

   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 content meets the conditions of the selector, the message is mediated. Otherwise, the message is not mediated.

   Discriminator

   Optionally, type a message discriminator to control which messages are mediated by the mediation. Message discriminators conform to the publish/subscribe topicspace syntax.

   If the message meets the conditions of the discriminator, the message is mediated. Otherwise, the message is not mediated.

4. Click OK.

5. Save changes to the master configuration.

We have configured a new mediation.

What to do next

Use the mediation to mediate a destination. For more information, see Mediating a destination.

Related:

Mediation handlers and mediation handler lists

Transactionality in mediations

Concurrent mediations

Topic names and use of wildcard characters in topic expressions

Message properties support for mediations