Guardian Procedure Calls Reference Manual

FILE_SETSYNCINFO_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The FILE_SETSYNCINFO_ procedure supersedes the SETSYNCINFO Procedure (Superseded by
FILE_SETSYNCINFO_ Procedure) (page 1355). Unlike the SETSYNCINFO 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.
The FILE_SETSYNCINFO_ procedure is used by the backup process of a process pair after a failure
of the primary process.
The FILE_SETSYNCINFO_ procedure passes a process pair's latest synchronization block (received
in a checkpoint message from the primary) to the file system. Following a call to the
FILE_SETSYNCINFO_ procedure, the backup process can retry the same series of write operations
started by the primary process before its failure. The use of the sync block ensures that operations
that might have been completed by the primary process before its failure are not duplicated by
the backup.
NOTE: Typically, FILE_SETSYNCINFO_ is not called directly by application programs. Instead,
it is called indirectly by CHECKMONITOR.
Syntax for C Programmers
#include <cextdecs(FILE_SETSYNCINFO_)>
short FILE_SETSYNCINFO_ ( short filenum
,short *infobuf
,short infosize );
Syntax for TAL Programmers
error := FILE_SETSYNCINFO_ ( filenum ! i
,infobuf ! i
,infosize ); ! i
Parameters
filenum
input
INT:value
is the number that identifies the open file.
516 Guardian Procedure Calls (F)