Guardian Procedure Calls Reference Manual

GETSYNCINFO Procedure (Superseded by FILE_GETSYNCINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Example
Summary
The 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. GETSYNCINFO returns a file's
synchronization block so that it can be sent to the backup process in a checkpoint message.
NOTE: Typically, GETSYNCINFO is not called directly by application programs. Instead, it is
called indirectly by CHECKPOINT.
Syntax for C Programmers
#include <cextdecs(GETSYNCINFO)>
_cc_status GETSYNCINFO ( short filenum
,[ short _near *sync-block ]
,[ short _near *sync-block-size ] );
• The function value returned by GETSYNCINFO, 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 GETSYNCINFO ( filenum ! i
,[ sync-block ] ! o
,[ sync-block-size ] ); ! o
Parameters
filenum
input
INT:value
is the number of an open file that identifies the file whose sync block is obtained.
sync-block
output
INT:ref:*
returns the synchronization block for this file. The size, in words, of sync-block is determined
as follows:
• For unstructured disk files, size = 8 words.
• For ENSCRIBE structured files, size in words = 11 + (longest alt key len + pri key len + 1)
/ 2.
670 Guardian Procedure Calls (G)