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

report-name
is an alphanumeric or equivalent data item that specifies the spooler job report name. Any
value provided is adjusted to a length of 16 characters (by extending with spaces or truncating).
The first character cannot be a space. No character can be a hyphen (-). If no value is specified,
the routine uses the user name associated with the calling process. This parameter applies only
to spooler collectors.
copies
is a numeric operand that specifies the number of copies of the job the spooler must print. The
evaluation of this operand includes, if necessary, truncation to an integer value. If no value is
specified, the routine uses a value of 1. This parameter applies only to spooler collectors.
page-size
is a numeric operand that specifies the number of lines the spooler interface program is to
consider as a page. The evaluation of this operand includes, if necessary, truncation to an
integer value. If no value is specified, the routine uses the value 60. This parameter applies
only to spooler collectors.
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:
ContentsBits
Reserved0
ASCII compression flag (0 = OFF, 1 = ON). Ignored if code-129 is omitted. See the
description of code-129 for more information.
1
Reserved2-8
HOLD flag (0 = OFF, 1 = ON)9
HOLDAFTER flag (0 = OFF, 1 = ON)10
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.
11
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.
12
Job priority13-15
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.
ZCOBDLL Routines 639