Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-138

FILE_RESTOREPOSITION_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Summary

The FILE_RESTOREPOSITION_ procedure supersedes the REPOSITION Procedure

(Superseded by FILE_RESTOREPOSITION_ Procedure) and is used to position a disk

file to a saved position (the positioning information having been saved by a call to the

FILE_SAVEPOSITION_ Procedure

). The FILE_RESTOREPOSITION_ procedure

passes the positioning block obtained by FILE_SAVEPOSITION_ back to the file

system. Following a call to FILE_RESTOREPOSITION_, the disk file is positioned to

the point where it was when FILE_SAVEPOSITION_ was called. Unlike the

REPOSITION procedure, the FILE_RESTOREPOSITION_ procedure is used with

Format 2 files as well as with other files.

A call to the FILE_RESTOREPOSITION_ procedure is rejected with an error if any

incomplete nowait operations are pending on the specified file.

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_RESTOREPOSITION_)>

short FILE_RESTOREPOSITION_ ( short filenum

,short * savearea

,short savesize );

error := FILE_RESTOREPOSITION_ ( filenum ! i

,savearea ! i

,savesize ); ! i