Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-140

FILE_SAVEPOSITION_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Considerations

Summary

The FILE_SAVEPOSITION_ procedure supersedes the SAVEPOSITION Procedure

(Superseded by FILE_SAVEPOSITION_ Procedure), and 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

FILE_RESTOREPOSITION_ procedure when you want to return to the saved position.

Unlike the SAVEPOSITION procedure, this procedure can be used with Format 2 files

as well as with other files.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

error

INT:value

is a file-system error code that gives the status of the operation.

filenum input

INT:value

is the number that identifies the open disk file.

#include <cextdecs(FILE_SAVEPOSITION_)>

short FILE_SAVEPOSITION_ ( short filenum

,short * savearea

,short savemax

,short * savesize );

error := FILE_SAVEPOSITION_ ( filenum ! i

,savearea ! o

,savemax ! i

,savesize); ! o