WebSphere

Fail mediation primitive

Use the Fail mediation primitive to stop a mediation flow, and generate an exception.

Introduction

The Fail mediation primitive halts a mediation flow and raises an exception. The Fail mediation primitive allows you to raise an exception at a point you choose in the flow. It also lets you add information about a failure.

The Fail mediation primitive has one input terminal (in). The input terminal is wired to accept a message that triggers a FailFlowException. A FailFlowException is a specific runtime exception that causes the flow instance to fail. You can wire the output terminal of another mediation primitive to the in terminal of a Fail mediation primitive, to cause a FailFlowException.

Usage

You can use the Fail mediation primitive to define your own error conditions, based on the business logic of the flow.

You can use the Error message property to provide an additional error message that is specific to your business logic or domain. The Error message you create is added to the automatically generated exception.

You can use the Fail mediation primitive to roll back a global transaction under certain conditions. For example, if you wire an output terminal of a Message Filter mediation primitive to a Fail mediation primitive, the transaction is rolled back if the filter condition occurs.

Properties

Error message
An optional, user-supplied, error message. The Error message value is added to the FailFlowException generated by the Fail mediation primitive.
Table 1. Fail mediation primitive properties
Property Valid Values Default
Error message String  

reference Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 20 June 2010 00:39:55 BST (DRAFT)


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.wbit.help.medprim620.doc/ref/rwesb_Failmediationprimitive.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).
iDoc on