Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-147

FILE_SETSYNCINFO_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Summary

The FILE_SETSYNCINFO_ procedure supersedes the SETSYNCINFO Procedure

(Superseded by FILE_SETSYNCINFO_ Procedure). Unlike the SETSYNCINFO

procedure, the FILE_SETSYNCINFO_ procedure can be used with Format 2 files 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.

Syntax for C Programmers

Syntax for TAL Programmers

Note. Typically, FILE_SETSYNCINFO_ is not called directly by application programs. Instead,

it is called indirectly by CHECKMONITOR.

#include <cextdecs(FILE_SETSYNCINFO_)>

short FILE_SETSYNCINFO_ ( short filenum

, short * infobuf

, short infosize );

error := FILE_SETSYNCINFO_ ( filenum ! i

,infobuf ! i

,infosize ); ! i