Chapter 5 C Routines Reference


JagRollbackWork

Description

Indicate that the component cannot complete its work for the current transaction. The component instance will be deactivated when the method returns.

Syntax

void JagRollbackWork();

Usage

JagRollbackWork specifies that the component cannot complete its work for the current transaction. The transaction will be rolled back when the initiating component is deactivated.

Calling JagRollbackWork does not automatically cause the current method invocation to fail. "Handle Errors in Your C Component" in the Jaguar CTS Programmer's Guide describes how to code graceful method failures.

If a component is not transactional, then JagRollbackWork and JagRollbackWork have the same effect: both cause the component instance to deactivate after the currently executing method returns.

If a method calls none of JagCompleteWork, JagContinueWork, JagDisallowCommit, or JagRollbackWork, the default behavior is that of JagContinueWork.

See "Understanding Transactions and Component Lifecycle Models" in the Jaguar CTS Programmer's Guide for a description of how components participate in transactions.

See Also

JagCompleteWork, JagContinueWork, JagDisallowCommit, JagInTransaction, JagIsRollbackOnly

 


Copyright © 2000 Sybase, Inc. All rights reserved.