+

Search Tips   |   Advanced Search

Mediations [Settings]

A mediation that is associated with a bus destination to apply processing to messages on that destination.

To view this page in the console, click the following path:

  • Service integration -> Buses -> bus_name -> [Destination resources] Mediations -> mediation_name.


    Configuration tab

    The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.


    General Properties

    Mediation name

    The name by which this mediation is known for administrative purposes.

    Information Value
    Required No
    Data type String

    UUID

    The universal unique identifier assigned by the system to this mediation for administrative purposes.

    Information Value
    Required No
    Data type String

    Description

    An optional description for the mediation, for administrative purposes.

    Information Value
    Required No
    Data type Text area

    Handler list name

    The name of the handler list that was defined when the mediation was deployed.

    Information Value
    Required Yes
    Data type String

    Global transaction

    Whether or not a global transaction is started for each message processed.

    Cleared

    A local transaction is started for each message processed. You only need to select this option for mediations that access other resource managers such as databases, or interact with Enterprise JavaBeans that require a global transaction.

    Selected

    A global transaction is started for each message processed.

    Information Value
    Required No
    Data type Boolean

    Allow concurrent mediation

    Select this option (setting it to true) to apply the mediation to multiple messages concurrently. Message ordering is not preserved. The default option is false.

    Selected

    Apply the mediation to multiple messages concurrently, and preserve message ordering.

    Cleared

    Apply the mediation to a single message at a time. This setting is required to ensure that message ordering is preserved.

    Information Value
    Required No
    Data type Boolean

    Selector

    Controls which messages are sent to the mediation. If a message matches the rule defined by the selector text string, then the mediation is applied to the message.

    If the message does not match the rule defined by the selector text string, then the message is not mediated. If a message contains both Selector and Discriminator, it must match both rules for the message to be mediated. If either the Selector or the Discriminator rule does not match, the message is not mediated.

    You should base the content of the selector text string on an understanding of which messages should be processed by the mediation. The format of the selector string is the same as for JMS selectors.

    Information Value
    Required No
    Data type String

    Discriminator

    Controls which messages have the mediation applied to them. If the topic of a message matches the rule specified by the discriminator text string, then the mediation is applied to the message. If both the selector and discriminator are specified, the message must match both rules for the mediation to be applied to the message.

    Compare this property with the Selector property. The rule specified by the Selector examines the header and properties of the message, whereas the discriminator examines the topic of the message. If a message contains both Selector and Discriminator, it must match both rules for the message to be mediated. If either the Selector or the Discriminator rule does not match, the message is not mediated.

    You should base the content of the discriminator text string on an understanding of which message topics should be processed by the mediation. The format of the discriminator is the same as the topic discriminator specification.

    Information Value
    Required No
    Data type String


    Additional Properties

    Context properties

    Context information passed to the mediation.


    Related concepts

  • Mediation points


    Related tasks

  • Mediating a destination

  • Configure mediation points


    Related information:

  • Administrative console buttons

  • Administrative console preference settings Reference topic