COBOL Manual for TNS and TNS/R Programs

Fault-Tolerant Processes
HP COBOL Manual for TNS and TNS/R Programs—522555-006
32-11
Using the Fault-Tolerant Facility
If option 3 of the STARTBACKUP statement is specified (that is, if your program
monitors the backup process), then the possible values of PROGRAM-STATUS are as
shown in Table 32-2.
If the primary process fails and a proper takeover occurs, PROGRAM-STATUS is set to
a take-over status values (such as “01nn ”) when the backup process begins
executing. Successive checkpoints set PROGRAM-STATUS to other values (such as
“1000”).
4nnn In the non-CRE environment, 4nnn indicates a NEWPROCESS
failure. If nnn is less than or equal to 255, nnn is the file system
error associated with the disk file where the loadfile was to be found.
If nnn is one of these values, the cause of the failure is:
901 = Undefined externals
902 = No PCB available
904 = Unable to allocate map
905 = Unable to get virtual disk space
906 = Illegal file format
907 = Unlicensed privileged program
910 = Unable to communicate with system monitor process
Errors in the 900 range are not likely to occur and are generally
symptomatic of a system or fault-tolerant facility problem (typically, a
shortage of some resource).
In the CRE, 4nnn indicates a PROCESS_CREATE_ failure. For
more information, see the Guardian Procedure Calls Reference
Manual.
5000 Too many failure-restart cycles (takeovers by backup) or a logic
error in program
6000 Parameter or logic error
Table 32-2. Values for PROGRAM-STATUS When STARTBACKUP Has Option 3
Statement
First Digit of PROGRAM-STATUS
0 123456
STARTBACKUP Yes Yes Yes Yes Yes No Yes
CHECKPOINT Yes Yes Yes No No No Yes
OPEN Yes Yes Yes Yes No No No
CLOSE Yes Yes Yes No No No No
Table 32-1. Values for PROGRAM-STATUS
When STARTBACKUP Has Option 0, 1, or 2 (page 2 of 2)
PROGRAM-STATUS
Value Meaning