DB Access Class Library for COBOL V1.0 API Reference - Microsoft(R) Windows(R) - - Microsoft(R) Windows NT(R) - - Microsoft(R) Windows(R) 2000 -

Contents Index

Chapter 6 DB Access Library API Reference

6.2 Methods

6.2.38 ROLLBACK-TRAN Method

�¡Class

FJDB-DATABASE-class

�¡Function

Rollback a transaction directed at the database associated with an object of the FJDB-DATABASE class.

�¡Synopsis

INVOKE DATABASE-A "ROLLBACK-TRAN" RETURNING RET-CODE.

�¡Object identifier

DATABASE-A [attribute:OBJECT REFERENCE FJDB-DATABASE]

Specifies an object of the FJDB-DATABASE class.

�¡Return value

RET-CODE [attribute:S9(9) COMP-5]

Returns a value of 0 if the method ends normally; otherwise, returns an error code.

�¡Explanation

The ROLLBACK-TRAN method closes a transaction by canceling data manipulations carried out during the transaction.

When a ROLLBACK-TRAN method is issued, the transaction enters automatic transaction mode. Issue a BEGIN-TRAN method to restart the transaction.

When a ROLLBACK-TRAN method is issued, the existing recordset is abandoned but the contents of the local cache are not rolled back. If the recordset is updated during the transaction and then a ROLLBACK-TRAN method is issued, inconsistencies arise between the database and the local cache. To continue using the recordset, issue a REFRESH-RECORDSET method to recreate the recordset.

Contents Index