Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-63
REPOSITION Procedure
(Superseded by FILE_RESTOREPOSITION_
REPOSITION Procedure
(Superseded by FILE_RESTOREPOSITION_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Summary
The REPOSITION procedure is used to position a disk file to a saved position (the
positioning information having been saved by a call to the SAVEPOSITION procedure).
The REPOSITION procedure passes the positioning block obtained by
SAVEPOSITION back to the file system. Following a call to REPOSITION, the disk file
is positioned to the point where it was when SAVEPOSITION was called.
A call to the REPOSITION procedure is rejected with an error if any incomplete nowait
operations are pending on the specified file.
Syntax for C Programmers
•
The function value returned by REPOSITION, which indicates the condition code,
can be interpreted by
_status_lt(), _status_eq(), or _status_gt()
(defined in the file
tal.h).
Syntax for TAL Programmers
Parameters
filenum input
INT:value
is the number of an open file that identifies the file to be positioned to a saved
position.
#include <cextdecs(REPOSITION)>
_cc_status REPOSITION ( short filenum
,short _near *positioning-block );
CALL REPOSITION ( filenum ! i
,positioning-block ); ! i