COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-81
COBOL85^SPECIAL^OPEN and
COBOL_SPECIAL_OPEN_
exclusion
is a numeric operand that specifies the exclusion attribute for the open operation.
The evaluation of this operand includes, if necessary, truncation to an integer
value. If the parameter is present, its value must be 0 (shared), 1 (exclusive), or 3
(protected); if it is omitted, the routine determines the exclusion attribute from a
command interpreter ASSIGN command (when one applies to the specified FD-
name); otherwise the routine assumes the value 3 (protected) when the open
mode is Input or assumes the value 1 (exclusive) for any other open mode.
sync-depth
is a numeric operand that specifies the sync-depth attribute for the open operation.
The evaluation of this operand includes, if necessary, truncation to an integer
value. If this parameter 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. For a disk file, the
routine uses a value of 1.
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 0 (open mode is Input),
1 (I-O), 2 (Output), or 3 (Extend). If the parameter is omitted, the routine uses a
value of 0 (Input).
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, or sync-depth 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).