REWRITE-FUNCTION

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

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	Operation successful.
0	Operation failed.