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.34 MOVE-PREVIOUS Method

�¡Class

FJDB-RECORDSET-class

�¡Function

Locates the current row of a recordset on the previous row.

�¡Synopsis

INVOKE RECORDSET-A "MOVE-PREVIOUS" 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

If a MOVE-PREVIOUS method is issued while the current row is located on the first row of a recordset, the IS-BOF method is set to a nonzero value. If another MOVE-PREVIOUS method is issued in this state, an error is returned.

An error is returned if a MOVE-PREVIOUS method is issued to a null recordset.

If a MOVE-PREVIOUS method is issued while data is being updated with an EDIT-RECORD or ADD-NEW-RECORD method, the updated version of data is destroyed.

An error is returned if a MOVE-PREVIOUS method is issued to a recordset that MOVE-PREVIOUS method cannot be used.(See IS-SCROLLABLE method about conditions that the recordset cannot use MOVE-PREVIOUS method)

Contents Index