Catch

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 5 General Activities Palette : Catch

Catch

Activity

The Catch activity receives control of execution when an unhandled exception occurs. You can select a specific exception type to catch or you can specify that this activity should catch all unhandled exceptions. You can have more than one Catch activity in each exception scope, but each Catch activity must have a unique exception type.

The Catch activity allows you to transition to activities you want to perform to handle the exception. Transitions are permitted between Catch tracks within an exception scope, but you cannot transition back to the main execution track from the Catch track.

If you want to propagate the caught exception to the next highest scope, use the Rethrow activity.

See the description error handling in TIBCO ActiveMatrix BusinessWorks Process Design for more information about using the Catch activity.

Configuration

The Configuration tab has the following fields.

Field

Description

Name

The name to appear as the label for the activity in the process definition.

Description

Short description of the activity.

Catch All

Checking this box indicates you want processing to resume with this activity when any exception is encountered that is not already handled by an error transition or another Catch activity.

You can have only one Catch activity within an exception scope that has this field checked.

Exception to Catch

Specifies the exception type to catch. The list of available exceptions that can be raised in the current scope is automatically placed in the drop-down list in this field. This field is not available when the Catch All field is checked.

Each Catch activity within an exception scope must specify a different value for this field.

Input

This activity has no Input.

Output

The output for the activity is the following.

Output Item

Datatype

Description

<exceptionName>

varies

Contains the schema for the thrown exception. The contents of this element vary depending upon the exception that is encountered.

Field	Description
Name	The name to appear as the label for the activity in the process definition.
Description	Short description of the activity.
Catch All	Checking this box indicates you want processing to resume with this activity when any exception is encountered that is not already handled by an error transition or another Catch activity. You can have only one Catch activity within an exception scope that has this field checked.
Exception to Catch	Specifies the exception type to catch. The list of available exceptions that can be raised in the current scope is automatically placed in the drop-down list in this field. This field is not available when the Catch All field is checked. Each Catch activity within an exception scope must specify a different value for this field.

Output Item	Datatype	Description
<exceptionName>	varies	Contains the schema for the thrown exception. The contents of this element vary depending upon the exception that is encountered.