R-NEXT-FUNCTION

This function reads the next record in the sequence of records in a relative file.

The record locking is controlled by the f-no-lock external data-item. Move 1 to f-no-lock to read without locking. Move 0 to f-no-lock to read with lock. The default value of f-no-lock is 0.

Syntax:

SET R-NEXT-FUNCTION TO TRUE    CALL "R$IO" USING RIO-FUNCTION                    f                    recBuffer             GIVING returnCode

Parameters:

f	the file handle returned by R-OPEN-FUNCTION.
recBuffer	an alphanumeric data-item that receives the record read.

Return code:

returnCode can be any signed numeric data item and provides additional information:

>0	Number of bytes read.
0	Operation failed.