COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

The required number of table elements depends on the number of operations the list must
record. The worst-case situation uses six elements.
A complete checkpoint list is required only when a program has a backup that must be kept
current. When a record of changes is not required, a null checkpoint list can be used. This is
an example description:
03 CP-LIST-1 PIC 9(9) COMP VALUE IS 0.
error-return
is a numeric data item that has one of these values upon completion:
MeaningValue
The call to SETMODE caused Guardian file error n.n
No error occurred.0*
A required parameter is missing.1
file-name is not a COBOL file name.2
One of:5
• file-name specifies an open file that is either $RECEIVE or is open for HP COBOL Fast
I-O.
• file-name specifies a closed file and there is not enough control space to allocate the
queued information for the next open request.
*error-return is 0 for a deferred call (that is, one that is held until the file is open). If an error occurs at that
time, a run-time diagnostic is issued.
Usage Consideration: In a fault-tolerant program, put the CHECKPOINT statement that specifies
cpinfo immediately before the call to COBOL_SETMODE_; otherwise, the queued information
can be lost if a backup process takes over.
COBOL_SPECIAL_OPEN_
The COBOL_SPECIAL_OPEN_ routine opens these:
• Printers or Spoolers
• System Log Files
• Partitioned Disk Files
• Tape Files
The COBOL file-control entry, file description entry, and OPEN statement do not provide a way to
specify these attributes.
636 Libraries and Utility Routines