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

Libraries and Utility Routines
HP COBOL Manual for TNS/E Programs—520347-003
13-58
COBOL_SPECIAL_OPEN_
library-reference
is a mnemonic-name in the SPECIAL-NAMES paragraph. This mnemonic-name is
associated with the DLL containing an object copy of 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 system log (device type 1, subdevice type 0 or 1).
open-type
is a numeric operand whose value (after truncation to an integer value, if
necessary) is 2. The value 2 signifies the opening of a system log 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, or assumes the value 0 (shared) for a system log file otherwise.
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 system log file,
the routine uses a value of 1.
time-limits
is a numeric operand that specifies the TIME-LIMITS attribute for a system log file
only when the subdevice type is other than 0; if the subdevice type is 0, this
parameter is ignored. The evaluation of this operand includes, if necessary,
truncation to an integer value. If this parameter is present and its value is not zero,
LOCKFILE and READ statements that refer to the system log file can include the
TIME LIMIT wait-time phrase, indicating the maximum time a process waits for a
request to complete. If the parameter is omitted, the routine uses a value of zero.