COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-70
COBOL85^SPECIAL^OPEN and
COBOL_SPECIAL_OPEN_
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.
COBOL85^SPECIAL^OPEN and COBOL_SPECIAL_OPEN_
The COBOL85^SPECIAL^OPEN and COBOL_SPECIAL_OPEN_ routines open these:
•
Printers or Spoolers
•
System Log Files
•
Partitioned Disk Files
•
Tape Files in the CRE
The COBOL file-control entry, file description entry, and OPEN statement do not
provide a way to specify these attributes.
Usage Considerations:
•
Calling COBOL85^SPECIAL^OPEN or COBOL_SPECIAL_OPEN_ From the CRE
in the Guardian Environment
In the Guardian environment, a CRE HP COBOL program can call either
COBOL85^SPECIAL^OPEN (the COBOL-environment routine) or
COBOL_SPECIAL_OPEN_ (the equivalent CRE routine). If it calls
COBOL85^SPECIAL^OPEN, it actually calls COBOL_SPECIAL_OPEN_ indirectly.
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.
•
The program is running in the non-CRE environment and cpinfo has
too few entries.
Value Meaning (page 2 of 2)
*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.