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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-51
COBOL_SPECIAL_OPEN_
error-return
is a numeric data item that has one of these values upon completion:
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.
Usage Considerations:
•
Acceptable Values for the Parameter open-type
The value of the open-type parameter determines what type of device the
COBOL_SPECIAL_OPEN_ routine opens. Acceptable values for open-type
(after truncation to an integer value, if necessary) and their meanings are:
Value Meaning
n The call to SETMODE caused Guardian file error n.
0* No error occurred.
1 A required parameter is missing.
2 file-name is not a COBOL file name.
5 One of:
•
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.
Value Meaning
1 Open a printer or spooler.
2 Open a system log file.
3 Open a partitioned disk file.
4 Open a tape file in the CRE.