Copyright © Cloud Software Group, Inc. All Rights Reserved

Transaction State

Activity

The Transaction State activity can be used in a transaction group to obtain the current state of the transaction or to set the transaction to a rollback only state. When a transaction is set to the rollback only state, the only outcome of the transaction that is permitted is a rollback.

Configuration

The Configuration tab has the following fields.

Field	Global Var?	Description
Name	No	The name to appear as the label for the activity in the process definition.
Description	No	Short description of the activity.
Options	No	This field specifies the actions this activity can perform. Select one of the following options: • getStatus() — When this option is selected, the current status of the transaction is returned in the output of this activity. • setRollbackOnly() — When this option is selected, the current transaction is set to a rollback only state. The only outcome allowed in this state is for the transaction to rollback. You would use this option if an error condition is detected and you want to rollback the transaction without raising an exeception. You can only use this option when using a transaction mananger that supports the setRollbackOnly method.

Input

This activity has no input.

Output

The output for the activity is the following.

Output Item	Datatype	Description
Status	integer	The numeric code that corresponds to the current status of the transaction. The numeric status codes vary for each transaction manager, but most transaction managers use the value from javax.transaction.Status. See the documentation for your transaction manager for a description of the possible status codes.

Error Output

The Error Output tab lists the possible exceptions that can be thrown by this activity. See TIBCO ActiveMatrix BusinessWorks Error Codes for more information about error codes and corrective action to take.

Exception	Thrown When...
TransactionStateException	An error occurred when attempting to retrieve or change the status of the transaction.
java.lang.Exception	The Java exception class.
exceptionClassName	The name of the exception class.
exceptionMessage	The text of the exception message.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved