COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-84
COBOL85^SPECIAL^OPEN and
COBOL_SPECIAL_OPEN_
mount-messages
is the name of a data item that describes the name of the file to be used for tape
mount messages. The file name must be left-justified and in Guardian external
format with no trailing spaces. Reference modification can give the length of the
name. The file must be a process or terminal.
If mount-messages is omitted, tape mount messages are written to the
execution log file.
end-of-tape-process
is an alphanumeric data item of at least seven characters, whose value specifies
the action to be taken if the file operation causes a reel swap.
If the value is “RETURN ” (in any combination of uppercase and lowercase letters
and with a space after N ), a read or write operation returns an I-O status code of
“97” and a GUARDIAN-ERR of 150 when a reel swap occurs. If the reel swap
occurs during a WRITE statement, the record that was just written and several of
the records previously written might or might not be on the tape just completed.
If the value is not “RETURN ” or end-of-tape-process is omitted, a read or
write operation does not return anything to the program when a reel swap occurs.
return-code
is an identifier of a numeric data item in which an error value will be returned. The
expected values and their respective meanings are:
Value Meaning
0 Successful execution
1 file-name is missing or is invalid, or an extraneous parameter is present.
2 The value of the open-type, exclusion, sync-depth, or mount-
messages parameter is invalid.
4The device-type of the file specified is not compatible with the value
specified for open-type.
5 An operation error occurred (for example, the file could not be opened).