Mediations [Settings]

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

To view this pane in the console...

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 admin purposes.

Required

No

Data type

Text

 

UUID

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

Required

No

Data type

Text

 

Description

An optional description for the mediation, for admin purposes.

Required

No

Data type

Text area

 

Handler list name

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

Required

Yes

Data type

Text

 

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 Java Beans™ that require a global transaction.

Selected

A global transaction is started for each message processed.

Required

No

Data type

Check box

 

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.

Required

No

Data type

Check box

 

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.

Required

No

Data type

Text

 

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.

Required

No

Data type

Text

 

Additional Properties


Context properties

Context information passed to the mediation.



Last updated Nov 10, 2010 8:23:07 PM CST