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.8 EDIT-RECORD Method

�¡Class

FJDB-RECORDSET-class

�¡Function

Copies into the data buffer the current row that is located on the recordset.

�¡Syntax

INVOKE RECORDSET-A "EDIT-RECORD" RETURNING RET-CODE.

�¡Object identifier

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

Specifies an object of the FJDB-RECORDSET 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

Data on the database is not updated until an UPDATE-RECORD method is issued.

If an EDIT-RECORD method is issued to a recordset that cannot be updated, an error will be returned upon issuance. (See IS-UPDATABLE method about conditions that the recordset is not updatable.)

An error would also be returned if the row in the record selected for editing has already been updated on the database. (See "11.1 Notes on Updating recordset rows.")

If a MOVE-NEXT, MOVE-LAST, MOVE-PREVIOUS, or MOVE-FIRST method is issued before an UPDATE-RECORD method is issued, the updated version of data will be destroyed.

Once an EDIT-RECORD method is issued, an ADD-NEW-RECORD, EDIT-RECORD, or DELETE-RECORD method cannot be issued to the same recordset or to another recordset on the same database before an UPDATE-RECORD method is issued. EXECUTE-SQL and EXECUTE-COMMAND methods cannot be issued to the database.

Contents Index