Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual522629-013
3-41
CHECKOPEN Procedure
(Superseded by FILE_OPEN_CHKPT_ Procedure )
If no error is returned in backerror, the operation must be completed by a call to
AWAITIO in the primary process. If you specify the
tag parameter, the value
returned by AWAITIO is -29D; the returned count and buffer address are
undefined. If the condition code CCL is returned by AWAITIO, the file is
automatically checkclosed by the checkpointing facility. For a nonprocess file or a
process file that is opened in a waited manner, bit <8> of the
flag parameter is
reset internally to zero and ignored.
Primary process open
A
backerror value of 17 is returned if a device or process being opened is not, in
its own view, currently open by the primary process. This can occur, for example,
after a device has been rought UP or DOWN.
See “Considerations” for the OPEN procedure.
Opening a Licensed object file with write or read-write access turns off the License
attribute, even if opened by the Superid.
Messages
Unable to communicate with backup
If an “unable to communicate with backup” error occurs (that is,
backerror = -1),
it normally indicates either that the backup process does not exist or that a system
resource problem exists.