Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-3
SAVEPOSITION Procedure
(Superseded by FILE_SAVEPOSITION_ Procedure)
SAVEPOSITION Procedure
(Superseded by FILE_SAVEPOSITION_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Summary
The SAVEPOSITION procedure is used to save a disk file’s current file positioning
information in anticipation of a need to return to that position. The positioning
information is returned to the file system in a call to the REPOSITION procedure when
you want to return to the saved position.
Syntax for C Programmers
•
The function value returned by SAVEPOSITION, 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
#include <cextdecs(SAVEPOSITION)>
_cc_status SAVEPOSITION ( short filenum
,short _near *positioning-block
,[ short _near *positioning-blksize ]
);
CALL SAVEPOSITION ( filenum ! i
,positioning-block ! o
,[ positioning-blksize ] ); ! o