COBOL Manual for TNS and TNS/R Programs

Libraries and Utility Routines
HP COBOL Manual for TNS and TNS/R Programs—522555-006
13-74
COBOL85^SPECIAL^OPEN and
COBOL_SPECIAL_OPEN_
location
is a 16-character alphanumeric, PIC X(16), that identifies the string passed to the
spooler as its location parameter. The data item must be at least 16 characters.
If longer, only the first 16 characters are passed to the spooler. The spooler
expects a two-part location name in the format
#gggggggdddddddd
where #ggggggg is the group name and dddddddd is the destination name. The
pound sign (#) is required. All remaining characters can be letters, digits, or
spaces.
The access mode (see Linkage Section) of location must be STANDARD.
form-name
is an alphanumeric or equivalent data item that specifies the spooler job form
name.
form-name must not:
•
Start with a number or a space character
•
Contain any special characters or embedded blanks
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 a value of all
spaces. This parameter applies only to spooler collectors.
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.