Guardian Procedure Calls Reference Manual

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-idn contains the file number of a file whose file
synchronization block is to be checkpointed. The count-n parameter is ignored in this case.
bufferx-n
input
STRING .EXT:ref:*
is the address of the data area to be checkpointed. See Considerations (page 157) for details.
If bufferx-n is omitted, a file synchronization block is to be checkpointed and the file number
is specified in the segment-idn parameter.
count-n
input
INT(32):value
contains the number of bytes to be checkpointed if bufferx-n is provided.
If bufferx-n is omitted, this parameter is ignored.
Returned Value
INT
A status word of this form:
No error.<0:7> = 0
No backup or unable to communicate with backup; then <8:15> = file-system error number.<0:7> = 1
Takeover from primary process; then <8:15> =<0:7> = 2
Primary process stopped.0
Primary process abnormally ended.1
Primarys process processor failed.2
Primary process called CHECKSWITCH.3
Invalid parameter; then <8:15> = number of parameter in error:<0:7> = 3
stack-origin parameter1
Parameter set 12
Parameter set 23
Parameter set 34
Parameter set 45
Parameter set 56
Total message too large7
156 Guardian Procedure Calls (C)