Guardian Procedure Calls Reference Manual

A value of -2 specifies that the next write should occur at an unused record position.
The recordspecifier parameter is an eight-byte recordnum value.Relative Files
A value of -2 specifies that the next write must occur at an unused record position.
A value of -1 specifies that subsequent writes must be appended to the end-of-file location.
The recordspecifier parameter is an eight-byte relative-byte-addr valueUnstructured Files
A value of -1 specifies that subsequent writes must be appended to the end-of-file location.
(For relative and unstructured files, the -1 and -2 remain in effect until a new recordspecifier
is supplied.)
The recordspecifier parameter is an eight-byte recordaddr (the primary key), whose
format contains these elements:
Entry-Sequenced
Files
• Block number (4 bytes)
• Relative record number within the block (4 bytes)
Returned Value
INT
A file-system error code that indicates the status of the operation.
FILE_SETPOSITION_ Procedure 515