Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmer’s Guide—522293-003
4-69
Considerations
Pass the three parameters filenum-of-collector, file-name, and filenum
in one of the following ways:

If the file is already open, pass the file number as either filenum-of-
collector or filenum. You can pass file-name but it is ignored.

If the file is not open and the caller does not need to know the file number,
pass file-name. The filenum-of-collector and filenum parameters
can be omitted, or one of them can be passed containing the value -1.

If neither the filenum-of-collector nor the filenum is passed, the
file-name must be passed.

If the file is not open and the caller wants to know the file number, pass file-
name and filenum set to -1. Do not pass filenum-of-collector. The
number of the file opened is returned in filenum.. The value -1 is returned if
the file cannot be opened.

Some file-system errors have special significance to a process sending data to a
collector; these errors are listed in the Guardian Procedure Errors and Messages
Manual.
A program using level-1 or level-2 spooling gets these errors from the WRITE[X] or
OPEN procedure, while a program spooling at level 3 obtains these errors in bits
<8:15> of a spooler error code in the %1000 range.

ASCII compression (specified by flags.<1>) is meaningful only when writing to
spooler job files. The compression results in a file-size savings of about 33
percent.