isCOBOL Evolve : Appendices : Library Routines : R$IO : R-READ-FUNCTION
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, plus one.
0
Operation failed.