isCOBOL Evolve : Appendices : Library Routines : I$IO : NEXT-FUNCTION
NEXT-FUNCTION
This function reads the next record in the sequence of records specified by the current key of reference.
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.
If this function succeeds, RETURN-CODE is set to the size of the record read. RETURN-CODE is set to zero on failure.
Syntax
 SET NEXT-FUNCTION TO TRUE
 
 CALL "I$IO" USING IO-FUNCTION
                   f
                   record
            GIVING returnCode
Parameters:
f
must be a valid file handle returned by OPEN-FUNCTION.
record
points to the area to hold the record read.
 
Note: in order to gain performance, in isCOBOL File Server environment the previous content of this parameter is discarded before reading. After reading, the bytes exceeding the number of read bytes are initialized to low-values.
Return code:
returnCode can be any signed numeric data item and provides additional information:
>0
Number of read bytes.
0
Operation failed.