Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-130
FILE_OPEN_CHKPT_ Procedure
FILE_OPEN_CHKPT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Example
Summary
The FILE_OPEN_CHKPT_ procedure is called by a primary process to open a
designated file for its backup process. The following two conditions must be met
before FILE_OPEN_CHKPT_ can be called successfully:
•
The primary process must open the file.
•
The backup process must be in the “monitor” state (that is, in a call to
CHECKMONITOR).
The call to FILE_OPEN_CHKPT_ causes the CHECKMONITOR procedure in the
backup process to call the FILE_OPEN_ procedure for the designated file.
Syntax for C Programmers
This passive backup procedure is not supported in C programs. For a comparison of
active backup and passive backup, refer to the
Guardian Programmer’s Guide.
Syntax for TAL Programmers
Parameters
error returned value
INT
is a file-system error number indicating the outcome of the checkpoint operation.
Additional error information is returned in the
status parameter.
filenum input
INT:value
is the number identifying the open file to be opened in the backup process. This
value was returned by FILE_OPEN_ when the file was opened in the primary
process.
error := FILE_OPEN_CHKPT_ ( filenum ! i
,[ status ] ); ! o