Guardian Procedure Calls Reference Manual

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.
NOTE: Typically, SETSYNCINFO is not called directly by application programs. Instead, it is
called indirectly by CHECKMONITOR.
Syntax for C Programmers
#include <cextdecs(SETSYNCINFO)>
_cc_status SETSYNCINFO ( short filenum
,short _near *sync-block );
• 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
CALL SETSYNCINFO ( filenum ! i
,sync-block ); ! i
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file whose synchronization block is being passed.
sync-block
input
INT:ref:*
is the latest synchronization block received from the primary process.
SETSYNCINFO Procedure (Superseded by FILE_SETSYNCINFO_ Procedure) 1355