Mediations [Settings]

A mediation 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.

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.

We 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.

We 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.

Mediating a destination

Configure bus destination properties