Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)
Guardian Procedure Calls Reference Manual—522629-013
3-48
CHECKPOINTMANY Procedure
(Superseded by CHECKPOINTMANYX Procedure )
. .
Otherwise, the pair of words describes a data block to be checkpointed: the first
word contains the word address of the data block, and the second word contains the
length, in words, of the data block:
|----------------------------------------|
descriptors[n] | word address of the data block |
|----------------------------------------|
[n+1] | length in words of the data block |
|----------------------------------------|
. .
. .
The size, in words, of the descriptors array must be at least
1 + 2 * descriptors[0]
•
Illegal parameter location
If
status.<0:7> = 3, then status.<8:15> has the following meaning:
status.<8:15> = 1error in stack-origin parameter
= n, n > 1error in word [n-2]
If the
descriptors pair describes a file synchronization block (first word of pair =
-1, second word of pair = file number), then:
°
If the filesync block makes the checkpoint exceed 32,500 bytes, then
descriptors [n-2] is the first word of the pair.
°
If any other error occurs (such as GETSYNCINFO fails or bad file number),
then descriptors [n-2] is the second word of the pair.
If the pair describes a buffer (first word = address, second word = length), then:
°
If the address, or the address plus the length, results in a bounds violation,
then
descriptors[n-2] is the first word of the pair.
°
If this buffer makes the total amount of data to be checkpointed (data + sync
blocks + stack) exceed 32,500 bytes, then descriptors [n-2] is the first word of
the pair.