Guardian Procedure Calls Reference Manual

FILE_RESTOREPOSITION_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The FILE_RESTOREPOSITION_ procedure supersedes the REPOSITION Procedure (Superseded by
FILE_RESTOREPOSITION_ Procedure) (page 1246) and is used to position a disk file to a saved
position (the positioning information having been saved by a call to the FILE_SAVEPOSITION_
Procedure (page 504)). The FILE_RESTOREPOSITION_ procedure passes the positioning block
obtained by FILE_SAVEPOSITION_ back to the file system. Following a call to
FILE_RESTOREPOSITION_, the disk file is positioned to the point where it was when
FILE_SAVEPOSITION_ was called. Unlike the REPOSITION procedure, this procedure can be used
with Enscribe format 2 files and OSS files greater than approximately 2 gigabytes as well as with
other files.
A call to the FILE_RESTOREPOSITION_ procedure is rejected with an error if any incomplete nowait
operations are pending on the specified file.
Syntax for C Programmers
#include <cextdecs(FILE_RESTOREPOSITION_)>
short FILE_RESTOREPOSITION_ ( short filenum
,short *savearea
,short savesize );
Syntax for TAL Programmers
error := FILE_RESTOREPOSITION_ ( filenum ! i
,savearea ! i
,savesize ); ! i
Parameters
filenum
input
INT:value
is the number that identifies the open disk file.
savearea
input
INT EXT:ref:*
is the positioning information from the FILE_SAVEPOSITION_ procedure. The size is given by
the savemax parameter.
502 Guardian Procedure Calls (F)