Guardian Procedure Calls Reference Manual

FILE_GETSYNCINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The FILE_GETSYNCINFO_ procedure is called by the primary process of a process pair before
starting a series of write operations to a file open with paired access. FILE_GETSYNCINFO_ returns
a file's synchronization block so that it can be sent to the backup process in a checkpoint message.
The FILE_GETSYNCINFO_ procedure supersedes the GETSYNCINFO Procedure (Superseded by
FILE_GETSYNCINFO_ Procedure) (page 670). Unlike the GETSYNCINFO procedure, this procedure
can be used with Enscribe format 2 files and OSS files greater than approximately 2 gigabytes
as well as with other files.
NOTE: Typically, FILE_GETSYNCINFO_ is not called directly by application programs. Instead,
it is called indirectly by CHECKPOINT.
Syntax for C Programmers
#include <cextdecs(FILE_GETSYNCINFO_)>
short FILE_GETSYNCINFO_ ( short filenum
,short *infobuf
,short infomax
,short *infosize );
Syntax for TAL Programmers
error := FILE_GETSYNCINFO_ ( filenum ! i
,infobuf ! o
,infomax ! i
,infosize ); ! o
Parameters
filenum
input
INT:value
is the number that identifies the open file.
infobuf
output
INT .EXT:ref:*
is where the synchronization information is stored. The size is given in the infomax parameter.
infomax
input
INT:value
specifies the size in bytes of the infobuf parameter. See Considerations.
FILE_GETSYNCINFO_ Procedure 447