Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (P)
Guardian Procedure Calls Reference Manual—522629-013
12-28
POSITION Procedure
(Superseded by FILE_SETPOSITION_ Procedure)
Syntax for TAL Programmers
Parameters
filenum input
INT:value
is the number of an open file that identifies the file where the positioning is to take
place.
record-specifier input
INT(32):value
is the 4-byte value that specifies the new setting for the current-record and next-
record pointers.
(For relative and unstructured files, the -1D and -2D remain in effect until a new
record-specifier is supplied.)
CALL POSITION ( filenum ! i
,record-specifier ); ! i
Relative Files record-specifier is a 4-byte record-num..
-2D specifies that the next write should occur at an unused
record position.
-1D specifies that subsequent writes should be appended to
the end-of-file location.
Unstructured Files
record-specifier is a 4-byte relative-byte-addr.
-1D or -2D specifies that subsequent writes should be
appended to the EOF location.