Guardian Procedure Calls Reference Manual

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
#include <cextdecs(REPOSITION)>
_cc_status REPOSITION ( short filenum
,short _near *positioning-block );
• 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
CALL REPOSITION ( filenum ! i
,positioning-block ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file to be positioned to a saved position.
positioning-block
input
INT:ref:*
indicates a saved position to be repositioned to. This value must not be altered by the user.
Condition Code Settings
indicates that an error occurred (call FILE_GETINFO_ or FILEINFO).< (CCL)
indicates that RESETSYNC is successful.= (CCE)
indicates that the file is not a disk file.> (CCG)
1246 Guardian Procedure Calls (R)