COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-83
COBOL85^SPECIAL^OPEN and
COBOL_SPECIAL_OPEN_
file-name
is the name of a COBOL data file; that is, a file described in a File Description
entry. It must be an FD name associated with a file-system file name that specifies
a tape file.
open-type
is a numeric operand whose value (after truncation to an integer value, if
necessary) is 4. The value 4 signifies the opening of a tape file.
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.
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:
Value Open Mode
0 Input (default)
1 Input-Output
2 Output
3Extend