COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-75
COBOL85^SPECIAL^OPEN and
COBOL_SPECIAL_OPEN_
flags
is a numeric operand that specifies certain attributes of the job. The evaluation of
this operand includes, if necessary, truncation to an integer value. The value is
represented as a 16-bit integer:
If no value is specified, the routine uses a value of 4 (job priority = 4; all other bits
off).
This parameter applies only to spooler collectors.
owner
is an alphanumeric or equivalent data item that specifies a user name; the job is
created in the spooler as belonging to that user. Any value provided is adjusted to
a length of 16 characters (by extending with spaces or truncating). If no value is
specified, the routine uses the user name associated with the calling process. This
parameter applies only to spooler collectors.
max-lines
is a numeric operand in the range 0 through 65534 that specifies the maximum
number of lines that can be printed. If max-lines is 0 or omitted, no maximum
number is enforced.
max-pages
is a numeric operand in the range 0 through 65534 that specifies the maximum
number of pages that can be printed. If max-lines is 0 or omitted, no maximum
number is enforced.
Bits Contents
0Reserved
1 ASCII compression flag (0 = OFF, 1 = ON). Ignored if code-129 is omitted.
See the description of code-129 for more information.
2-8 Reserved
9 HOLD flag (0 = OFF, 1 = ON)
10 HOLDAFTER flag (0 = OFF, 1 = ON)
11 Specifies whether the output routines of the interface should exit before writing
a level-3 buffer to the collector process, so that you can checkpoint (0 = not
exit, 1 = exit). The run-time library always sets bit 11 to 0 because you cannot
control checkpointing of the level-3 buffer.
12 Purge existing data flag for spooler job files (0 = append new data to existing
data, 1 = purge existing data). Ignored if code-129 is omitted. See the
description of code-129 for more information.
13-15 Job priority