Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (S)
Guardian Procedure Calls Reference Manual—522629-013
14-117
SETSYNCINFO Procedure
(Superseded by FILE_SETSYNCINFO_ Procedure)
SETSYNCINFO Procedure
(Superseded by FILE_SETSYNCINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Summary
The SETSYNCINFO procedure is used by the backup process of a process pair after a
failure of the primary process.
The 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 SETSYNCINFO procedure, the backup process can retry the same series of
write operations started by the primary before its failure. The use of the sync block
ensures that operations which might have been completed by the primary before its
failure are not duplicated by the backup.
Syntax for C Programmers
•
The function value returned by SETSYNCINFO, which indicates the condition
code, can be interpreted by
_status_lt(), _status_eq(), or _status_gt()
(defined in the file
tal.h).
Syntax for TAL Programmers
Note. Typically, SETSYNCINFO is not called directly by application programs. Instead, it is
called indirectly by CHECKMONITOR.
#include <cextdecs(SETSYNCINFO)>
_cc_status SETSYNCINFO ( short filenum
,short _near *sync-block );
CALL SETSYNCINFO ( filenum ! i
,sync-block ); ! i