Guardian Procedure Calls Reference Manual

CHECKCLOSE Procedure (Superseded by FILE_CLOSE_CHKPT_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Condition Code Settings
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The CHECKCLOSE 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 the
CHECKCLOSE to be successful. The call to CHECKCLOSE causes the CHECKMONITOR procedure
in the backup process to call the file-system 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
CALL CHECKCLOSE ( filenum ! i
,[ tape-disposition ] ); ! i
Parameters
filenum
input
INT:value
is the file number of an open file to be closed in the backup process.
tape-disposition
input
INT:value
if present, specifies magnetic tape disposition, as follows:
tape-disposition.<13:15>
Rewind and unload, do not wait for completion.0
Rewind, take offline, do not wait for completion.1
Rewind, leave online, do not wait for completion.2
Rewind, leave online, wait for completion.3
Do not rewind, leave online.4
If omitted, 0 is used.
132 Guardian Procedure Calls (C)