Guardian Procedure Calls Reference Manual

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
#include <cextdecs(SAVEPOSITION)>
_cc_status SAVEPOSITION ( short filenum
,short _near *positioning-block
,[ short _near *positioning-blksize ] );
• 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
CALL SAVEPOSITION ( filenum ! i
,positioning-block ! o
,[ positioning-blksize ] ); ! o
Parameters
filenum
input
INT:value
is a number of an open file, identifying the file whose positioning block is to be obtained.
positioning-block
output
INT:ref:*
returns the positioning information for the file's current position. The buffer must be large enough
to hold the entire block of information. The following methods are used to calculate the required
buffer size in words. (The maximum value for alternate key length is used to assure that the
buffer is always large enough, although the system might return shorter blocks in specific cases.)
SAVEPOSITION Procedure (Superseded by FILE_SAVEPOSITION_ Procedure) 1257