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.33 MOVE-NEXT Method

�¡Class

FJDB-RECORDSET-class

�¡Function

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

�¡Synopsis

INVOKE RECORDSET-A "MOVE-NEXT" 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-NEXT method is issued while the current row is located on the last row of a recordset, the IS-EOF method is set to a nonzero value. If another MOVE-NEXT method is issued in this state, an error is returned.

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

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

Contents Index