isCOBOL Evolve : Appendices : Library Routines : R$IO : R-START-FUNCTION
R-START-FUNCTION
This function positions the file pointer for the next R-NEXT-FUNCTION or R-PREVIOUS-FUNCTION.
Syntax:
 SET R-START-FUNCTION TO TRUE
 
 CALL "R$IO" USING RIO-FUNCTION
                   f
                   keyVal
                   mode
            GIVING returnCode
Parameters:
f
the file handle returned by R-OPEN-FUNCTION.
keyVal
the record number of the record at which to start.
mode
one of the following values (defined in isfilesys.def):
 
F_EQUALS
F_NOT_LESS
F_GREATER
F_LESS
F_NOT_GREATER
start at the specified key
start at the specified key, or the one after
start at the record beyond the specified key
start at the record before the specified key
start at the specified key, or the one before
Return code:
returnCode can be any signed numeric data item and provides additional information:
>0
Operation successful.
0
Operation failed.