R-READ-FUNCTION

This function reads a record out of the 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-READ-FUNCTION TO TRUE    CALL "R$IO" USING RIO-FUNCTION                     f                     recBuffer                     keyVal             GIVING returnCode

Parameters:

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

Return code:

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

>0	Number of bytes read.
0	Operation failed.