Chapter 5 C Routines Reference

JagContinueWork

Description

Indicate that the component should not be deactivated after the current method invocation; allow the current transaction to be committed if the component instance is deactivated.

Syntax

void JagContinueWork();

Usage

JagContinueWork specifies that the component instance should not be automatically deactivated after the current method completes. If the instance is deactivated before the next method invocation, the current transaction is committed.

When a method calls JagContinueWork, the component instance is not deactivated until one of the following happens:

• The component's stub is destroyed explicitly by the client.
• The client disconnects without explicitly destroying the stub (the current transaction is always rolled back in this case).
• The component instance calls JagCompleteWork or JagRollbackWork during a subsequent method invocation.

JagContinueWork and JagDisallowCommit allow components that maintain state between method calls (using JagGetInstanceData and JagSetInstanceData ). If a component is not transactional, JagContinueWork and JagDisallowCommit have the same effect: both prevent immediate deactivation of the component.

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, JagDisallowCommit, JagRollbackWork

Copyright © 2000 Sybase, Inc. All rights reserved.