Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-146
FILE_SETPOSITION_ Procedure
Parameters
error
INT:value
is a file-system error code that gives the status of the operation.
filenum input
INT:value
is the number that identifies the opened file.
recordspecifier input
INT(64):value
is the 8-byte value that specifies the new setting for the current-record and next-
record pointers.
(For relative and unstructured files, the -1 and -2 remain in effect until a new
recordspecifier is supplied.)
Relative Files The
recordspecifier parameter is an 8-byte record-
num value.
A value of -2 specifies that the next write should occur at an
unused record position.
A value of -1 specifies that subsequent writes should be
appended to the end-of-file location.
Unstructured Files The
recordspecifier parameter is an 8-byte
relative-byte-addr value
A value of -1 specifies that subsequent writes should be
appended to the end-of-file location.
Entry-Sequenced
Files
The
recordspecifier parameter is an 8-byte record-
addr (the primary key), whose format contains the following
elements:
•
Block number (4 bytes)
•
Relative record number within the block (4 bytes)