Guardian Procedure Calls Reference Manual

FILE_CLOSE_CHKPT_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The FILE_CLOSE_CHKPT_ procedure is called by a primary process to close a designated file in
its backup process.
The backup process must be in the monitor state (that is, in a call to CHECKMONITOR) for
FILE_CLOSE_CHKPT_ to be called successfully. The call to FILE_CLOSE_CHKPT_ causes the
CHECKMONITOR procedure in the backup process to call the FILE_CLOSE_ 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, see the Guardian Programmer's Guide.
Syntax for TAL Programmers
error := FILE_CLOSE_CHKPT_ ( filenum ! i
,[ tape-disposition ] ); ! i
Parameters
filenum
input
INT:value
is the number identifying the open file to be closed in the backup process. This value was
returned by FILE_OPEN_ or OPEN when the file was originally opened.
tape-disposition
input
INT:value
is one of these values, indicating the tape control action to take:
Rewind and unload; do not wait for completion.0
Rewind and take offline; do not wait for completion.1
Rewind and leave online; do not wait for completion.2
Rewind and leave online; wait for completion.3
Do not rewind; leave online.4
Other input values result in an error if the file is a tape device; otherwise they are ignored.
If omitted, 0 is used.
364 Guardian Procedure Calls (F)