COBOL Manual for TNS and TNS/R Programs

Procedure Division Verbs
HP COBOL Manual for TNS and TNS/R Programs—522555-006
9-35
CHECKPOINT
checkpoint-list-name
is the name of a checkpoint list containing information that must be transferred to
the backup process. The checkpoint list is a COBOL record with a specific
structure in which the message changes are recorded. The information is returned
by these Saved Message Utility (SMU) routines:
For information on SMU routines and a description of the checkpoint list record, see
Saved Message Utility (SMU) Overview.
Usage Considerations:
•
Reason to Checkpoint
If a backup process takes over, the contents of items that are not checkpointed are
undefined.
•
Conditions Under Which Data Items Are Checkpointed
°
COBOL85 compiler
°
Working-Storage Section
The COBOL85 compiler automatically checkpoints data items that are
stored directly on the stack in 2 or fewer bytes (that is, if they are level 01
or 77, in the Working-Storage Section, and fewer than three characters
long).
°
Extended-Storage Section
The COBOL85 compiler checkpoints data items in the Extended-Storage
Section only if all of these conditions are true:
°
The program runs in the CRE (see ENV).
°
The STARTBACKUP statement backs up the Extended-Storage
Section (see STARTBACKUP).
°
One or more CHECKPOINT statements explicitly specify the data
items.
°
NMCOBOL compiler (RVU D46.00 and G06.00 or later, software product
revision T8107AAT)
The NMCOBOL compiler checkpoints only those data items that one or more
CHECKPOINT statements specify explicitly. These data items can be in either
the Working-Storage Section or the Extended-Storage Section.
ALTERPARAMTEXT DELETESTARTUP PUTPARAMTEXT
DELETEASSIGN PUTASSIGNTEXT PUTSTARTUPTEXT
DELETEPARAM PUTASSIGNVALUE