COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-98
COBOLSPOOLOPEN
report-name
is a 16-character alphanumeric, PIC X(16), that identifies the string passed to the
spooler as its report-name parameter. The data item must be at least 16
characters. If longer, only the first 16 characters are passed to the spooler. Only
letters, digits, and spaces are acceptable to the spooler. The first character cannot
be a space. No character can be a hyphen.
The access mode (see Linkage Section) of report-name must be STANDARD.
copies
is a numeric item (COMPUTATIONAL or DISPLAY), a numeric literal, or a
parenthetical expression, the value of which is passed to the spooler as its
number-of-copies parameter. The value must evaluate to a positive integer in
the range 1 through 32767.
page-size
is a numeric item (COMPUTATIONAL or DISPLAY), a numeric literal, or a
parenthetical expression, the value of which is passed to the spooler as its page-
size parameter. The value must evaluate to a positive integer in the range 1
through 32767.
flags
is a numeric item (COMPUTATIONAL or DISPLAY), a numeric literal, or a
parenthesized expression, the value of which is passed to the spooler as its flags
parameter. The value must evaluate to a positive integer whose value is consistent
with the specifications below.
The appropriate value of flags is the sum of the values associated with the
defined options, which follow:
HOLD 64 (decimal)
HOLDAFTER 32 (decimal)
PRIORITY 0, 1, 2, 3, 4, 5, 6, or 7
exclusion
is a numeric item (COMPUTATIONAL or DISPLAY), a numeric literal, or a
parenthetical expression, the value of which is used as the exclusion attribute
of the file open operation (for the purpose of this parameter, see OPEN).
exclusion must evaluate to a positive integer consistent with these
specifications.
The defined options for exclusion and their associated values are:
Value Meaning
SHARED 0
EXCLUSIVE 1
PROTECTED 3 (equivalent to SHARED in this context)