COBOL Manual for TNS and TNS/R Programs

Procedure Division Verbs
HP COBOL Manual for TNS and TNS/R Programs—522555-006
9-252
STARTBACKUP
STARTBACKUP
STARTBACKUP defines options for handling process pairs and starting the backup
process.
cpu
is the processor module where the backup process is to run. The cpu parameter
is either an integer numeric literal or an identifier that designates an integer
numeric data item. The value associated with cpu must not be less than 0 nor
greater than 15 and cannot designate the same processor in which the process
executing the STARTBACKUP statement is running.
options
is either an integer numeric literal or an identifier that designates an integer
numeric data item. The value must be 0, 1, 2, or 3.
Note.
•
Do not use this directive in the OSS environment.
•
Before RVU D46.00 and G06.00, software product revision T8107AAT (run-time library
T8108AAR), tThe NMCOBOL compiler ignores this directive and issues a warning.
Value Meaning (page 1 of 2)
0 The fault-tolerant facility is to read and process system messages, and the
primary process is to terminate abnormally if a trap condition occurs. If this
option is specified and the primary process is stopped (because of a command
interpreter STOP command or by a third process), the backup process stops.
The non-CRE environment run-time processes relevant system messages,
such as CPU-DOWN, as part of this activity. The occurrence of a trap condition
in the primary process causes it to fail (see the explanation of ARMTRAP in
the Guardian Programmer’s Guide.) Additionally, if the backup process fails,
the primary process automatically starts a new backup process when it is
possible to do so.
1 This option is the same as option 0 except that if the primary process stops,
the backup process takes over processing of the application.
2 This option is the same as option 1 except that if the primary process
encounters a trap condition, it enters the DEBUG procedure instead of being
terminated abnormally. (For an explanation of traps and the DEBUG
procedure, see the Guardian Programmer’s Guide.)
STARTBACKUP cpu options backup-ext
VST224.vsd