Spooler Programmer's Guide

Spooler Procedure Calls
Spooler Programmer’s Guide—522287-002
4-67
Considerations
file-name input, output
INT:ref:12
specifies the file name of the spooler collector or spooler job file to be opened for
the spooling session.
filenum input, output
INT:ref:1
is an alternative parameter to filenum-of-collector. See Considerations on
page 4-67 for more information.
extended-level-3-buff output
INT:.EXT.ref.*
indicates that the spooler interface procedures are used to send data to the
collector. The data is put into a buffer. The address of this buffer is returned by the
SPOOLSTART procedure and must be passed to other interface procedures. The
buffer is initialized and its address returned as a result of this call. The buffer is
allocated in an extended data segment.
Use either level-3-buff or extended-level-3-buff, but not both.
Considerations
The following considerations apply to the use of the SPOOLSTART procedure:

Only level-3 spooler data can be directed to a spooler job file, an unstructured disk
file with a file code of 129. Use file-name to specify the spooler job file. If
file-name does not exist, a spooler job file is created with primary and
secondary extent sizes of 50 pages (2048 bytes per page) and maximum extents
of 1000.

If a blank-filled volume name is passed in file-name, a temporary spooler job file
is created. The complete file-name is returned in file-name. If file-name
exists, new data is appended to the data already in the file unless flags.<12> is
equal to 1, in which case an error message is generated.

If SPOOLSTART is appending data to a previously written spooler job file and
either max-lines or max-pages is specified, the current number of lines or
pages already in the file is added to the maximums so that the maximums then
refer to the total amount of data the file can hold. If either maximum value is
greater than 65,534, the value is reset to 0 (no maximum enforced).

The filenum-of-collector and filenum parameters are two different
parameters for the file number of the collector or spooler job file. The filenum-
of-collector is a value parameter and the filenum is a reference parameter.
You should pass one or the other of these parameters to SPOOLSTART if you use
them, but not both.