Guardian Procedure Calls Reference Manual

CHECKPOINTMANY Procedure (Superseded by CHECKPOINTMANYX
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
NOTE: This procedure cannot be called by native processes. Although this procedure is supported
for TNS processes, it should not be used for new development.
The CHECKPOINTMANY procedure (like the CHECKPOINT procedure) is called by a primary
process to send information about its current executing state to its backup process.
The CHECKPOINTMANY procedure is used in place of CHECKPOINT when there are more than
13 pieces of information to be sent.
Syntax for C Programmers
This passive backup procedure is not supported in C programs. For a comparison of active backup
and passive backup, see the Guardian Programmer's Guide.
Syntax for TAL Programmers
status := CHECKPOINTMANY ( [ stack-origin ] ! i
,[ descriptors ] ); ! i
Parameters
stack-origin
input
INT:ref:*
contains an address. CHECKPOINTMANY checkpoints the process' data stack from
stack-origin through the current tip-of-stack location (‘S'). A checkpoint of the data stack
defines a restart point for the backup process.
descriptors
input
INT:ref:*
is an array that describes the items (data blocks or file synchronization blocks) to be
checkpointed. The first word of the array, descriptors[0], is a count of the number of items
to be checkpointed. The rest of the array consists of pairs of words, each pair describing one
of the items.
CHECKPOINTMANY Procedure (Superseded by CHECKPOINTMANYX Procedure) 145