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

When a file is assigned to a process that is not a spooler collector, the records are written
immediately, with no optimization attempted and no SETMODE or CONTROL procedure
involvement.
System Log Files
When the parameter open-type has the value 2, the COBOL_SPECIAL_OPEN_ routine does
one of:
• Opens the EMS device ($0) or an alternate collector so that it can receive EMS events
NOTE: To send an ASCII text message (rather than an EMS event) to a collector, open the
collector with an OPEN statement, not with the COBOL_SPECIAL_OPEN_ routine.
• Opens the SPI device ($0.#ZSPI) so that it can receive SPI commands.
NOTE: To send SPI commands to an alternate collector, open the collector with an OPEN
statement, not with the COBOL_SPECIAL_OPEN_ routine.
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.
ZCOBDLL Routines 641