Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-50
CHECKPOINTMANY Procedure
(Superseded by CHECKPOINTMANYX Procedure )
•
Takeovers and selectable segments
The selectable segment put into use following takeover depends on several
factors:
•
The segment in use at the time of the last checkpoint is put into use if it is
available; that is, the segment was allocated to the backup using the
SEGMENT_ALLOCATE_CHKPT_ or CHECKALLOCATESEGMENT procedure
and has not since been deallocated by the
SEGMENT_DEALLOCATE_CHKPT_ or CHECKDEALLOCATESEGMENT
procedure.
•
The segment in use when the CHECKMONITOR or CHECKSWITCH
procedure was called is used if the segment in use at the time of the last
checkpoint is no longer available.
•
No segment is used if the segment in use at the time of the last checkpoint and
the segment in use when the CHECKMONITOR or CHECKSWITCH procedure
was called are both unavailable.
•
See also “Considerations” for the CHECKPOINT procedure.
Example
DESCRIPTORS[0] := 2; ! count of items.
DESCRIPTORS[1] := -1; ! sync item.
DESCRIPTORS[2] := FNUM^A; ! file number.
DESCRIPTORS[3] := @BUFFER; ! data item: word address.
DESCRIPTORS[4] := 512; ! number of words.
STAT:= CHECKPOINTMANY( STK^ORIGIN , DESCRIPTOR);
! this is equivalent to:
! STAT := CHECKPOINT( STK^ORIGIN, , FNUM^A, BUFFER, 512 );