COBOL Manual for TNS and TNS/R Programs

Procedure Division Verbs
HP COBOL Manual for TNS and TNS/R Programs—522555-006
9-254
STARTBACKUP
•
Creation and Maintenance of a Backup Process
Execution of the STARTBACKUP statement assigns a value to the special register
PROGRAM-STATUS, reflecting the success or failure of the creation of the backup
process. PROGRAM-STATUS is a record with two fields, PROGRAM-STATUS-1
and PROGRAM-STATUS-2:
01 PROGRAM-STATUS.
02 PROGRAM-STATUS-1 PIC X.
02 PROGRAM-STATUS-2 PIC XXX.
Automatic backup process maintenance (for levels below 3) does not take effect
until after the successful execution of a STARTBACKUP statement.
For PROGRAM-STATUS values, see Table 32-1 and Table 32-2.
•
Unnamed Processes
If the process to which the STARTBACKUP statement applies was not initiated as
a named process (that is, with the NAME option of the RUN command), the
STARTBACKUP statement returns a specific value in the special register
PROGRAM-STATUS. In the CRE, the value is 4922; in the non-CRE environment,
it is 4013.
•
STARTBACKUP Options
For most applications, use option 0 or 1. For either of these options, a
STARTBACKUP statement must execute once during the initialization phase of the
program (check the outcome of the STARTBACKUP execution by examining the
PROGRAM-STATUS variable). At each successive checkpoint, the fault-tolerant
facility checks the state of the backup process and processor. If the backup
process is inoperable, the fault-tolerant facility re-creates the backup process. If
the backup’s processor is operable, the fault-tolerant facility re-creates the backup
process immediately. If the backup’s processor is inoperable, the fault-tolerant
facility re-creates the backup process when backup’s processor becomes
operable.
•
What Fault-Tolerant Facility Checkpoints
°
TNS
The fault-tolerant facility checkpoints the lower 32 KB of user data space, all
open files, and (if selected) extended storage when the STARTBACKUP
statement is executed; however, your program must contain a CHECKPOINT
statement to verify the creation of a backup process and to establish a valid
takeover point in the program code (rather than in the run-time library).