REWRITE-FUNCTION

This function replaces an existing record in the file.

If this function succeeds, RETURN-CODE is set to the size of record written. RETURN-CODE is set to zero on failure.

Syntax

SET REWRITE-FUNCTION TO TRUE    CALL "I$IO" USING IO-FUNCTION                    f                    record                    size             GIVING returnCode

Parameters:

f	must be a valid file handle returned by OPEN-FUNCTION.
record	points to the new record to place in the file.
size	may be zero to indicate the maximum record size for the file.   The record replaced is specified by the primary key value found in record.   The size of the new record need not match the size of the existing record.

Return code:

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

>0	Number of bytes rewritten.
0	Operation failed.