WRITE-FUNCTION

This function adds a new record to the passed 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 WRITE-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 record to add.
size	the size of the record. If size is zero, then the maximum record size for the file is used.

Return code:

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

>0	Number of bytes written.
0	Operation failed.