Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-39
CHECKOPEN Procedure
(Superseded by FILE_OPEN_CHKPT_ Procedure )
CHECKOPEN Procedure
(Superseded by FILE_OPEN_CHKPT_
Procedure )
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Messages
Summary
The CHECKOPEN procedure is called by a primary process to open a designated file
for its backup process. The following two conditions must apply before the call to
CHECKOPEN:
•
The primary process must first open the file.
•
The backup process must be in the “monitor” state (that is, in a call to
CHECKMONITOR) for the CHECKOPEN to be successful.
The call to CHECKOPEN causes the CHECKMONITOR procedure in the backup
process to call the file-system 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
Note. This procedure is supported for compatibility with previous software and should not be
used for new development.
CALL CHECKOPEN ( [ file-name ] ! i
,filenum ! i
,[ flags ] ! i
,[ sync-or-receive-depth ] ! i
,[ sequential-block-buffer-id ] ! i
,[ buffer-length ] ! i
,backerror ); ! o