WebSphere WebSphere Application Server Network Deployment, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Defining a mediation

Use this task to define a mediation in the administrative console.

Before you begin

This task assumes that you have installed your mediation handler module on the WebSphere Application Server server where you intend to use your mediation. For more information, see Installing a mediation application into WebSphere Application Server.

Why and when to perform this task

Defining a mediation in the administrative console makes it available for the administrator to use to mediate destinations.

To define a mediation, use the administrative console to complete the following steps:

Steps for this task

  1. Display the Mediations page:
    1. In the navigation pane, click Service integration > Buses
    2. In the content pane, click the name of the service integration bus
    3. Under Destination resources, click 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 of the behavior of the mediation, taking into account any properties specified for the mediation.
    Handler list name
    Type the handler list name. This is the name used by the programmer who deployed the mediation handler. Handler list names are unique within the WebSphere Application Server administrative cell.
    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.

    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 your changes to the master configuration.

A named mediation is defined for the deployed handler list.

Next, you can add the mediation to a destination, see Mediating a destination.
Related concepts
Mediations
Mediation handler lists
Transactionality in mediations
Concurrent mediations
Related reference
Topic names and use of wildcard characters in topic expressions
Message properties support for mediations

Task topic

Terms of Use | Feedback

Last updated: 15 Mar 2007
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\tasks\tjp0005_.html

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