Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-59
CHECKPOINTX Procedure
Parameters
status returned value
INT
returns a status word of the following form:
<0:7> = 0 No error
<0:7> = 1 No backup or unable to communicate with backup; then <8:15> =
file-system error number
<0:7> = 2 Takeover from primary process; then <8:15> =
0 Primary process stopped
1 Primary process abnormally ended
2 Primarys process processor failed
3 Primary process called CHECKSWITCH
<0:7> = 3 Illegal parameter; then <8:15> = number of parameter in error:
1
stack-origin parameter
2 Parameter set 1
3 Parameter set 2
4 Parameter set 3
5 Parameter set 4
6 Parameter set 5
7 Total message too large
stack-origin input
INT:ref:*
contains an address. CHECKPOINTX checkpoints the process’s data stack from
the address in
stack-origin through the current tip-of-stack location (‘S’). A
checkpoint of the data stack defines a restart point for the backup process.
See “Considerations” for details.
segment-idn input
INT:value
contains the segment ID of the extended data segment if the
bufferx-n
parameter is provided and the data block to be checkpointed is in an extended
data segment. If
segment-idn is omitted or equal to -1, the data block is
assumed to be either in the flat segment, in the selectable segment currently in
use, or on the stack, depending on the address provided.
If
bufferx-n is omitted, segment-id contains the file number of a file whose file
synchronization block is to be checkpointed. The
count-n parameter is ignored in
this case.