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

is present, it must be in the range 0 through 255. If it is omitted, the value assumed depends
on the nature of the file.
time-limits
is a numeric operand that specifies the TIME-LIMITS attribute for the open operation. The
evaluation of this operand includes, if necessary, truncation to an integer value. The presence
of a nonzero value for this parameter is equivalent to the presence of a TIME LIMITS phrase
with a nonzero value in an ordinary OPEN statement. If the parameter is omitted, the routine
uses a value of zero, which has no effect.
open-mode
is a numeric operand that specifies the open mode attribute for the open operation. The
evaluation of this operand includes, if necessary, truncation to an integer value. If this parameter
is supplied, its value must be one of:
Open ModeValue
Input (default)0
Input-Output1
Output2
Extend3
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:
MeaningValue
Successful execution0
file-name is missing or is invalid, or an extraneous parameter is present.1
The value of the open-type, exclusion, sync-depth, or mount-messages parameter
is invalid.
2
The device-type of the file specified is not compatible with the value specified for
open-type.
4
An operation error occurred (for example, the file could not be opened).5
ZCOBDLL Routines 645