Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-17

FILE_CLOSE_CHKPT_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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, 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.

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 the following values, indicating the tape control action to take:

0 Rewind and unload; do not wait for completion

error := FILE_CLOSE_CHKPT_ ( filenum ! i

,[ tape-disposition ] ); ! i