Spooler Programmer's Guide

Spooler Procedure Calls
Spooler Programmer’s Guide—522287-002
4-29
Considerations
If this parameter is omitted, the attributes established by the call to SPOOLSTART
are not changed.
extended-level-3-buff input,output
INT:.EXT.ref.*
is the extended-level-3-buff specified in the SPOOLSTART procedure.
Considerations
The following considerations apply to the use of the SPOOLEND procedure:

A call to SPOOLEND causes any existing data in the collection process buffer to
be written to the collector.

Following a call to SPOOLEND, a new job can be started without reopening a file
to the collector.

SPOOLEND must be called to terminate the spooling of any job being spooled at
level 3 (using the spooler interface procedures).

Calling SPOOLEND with the flags cancel job flag bit (bit 8) set to 1 has the same
effect as if you never started the job.

Including flags causes all bit fields to override the values specified in the flags
parameter of SPOOLSTART.

Some file-system errors have special significance to a process sending data to a
collector; these errors are described 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.
Example
SPERRNUM := SPOOLEND ( BUFFER , %B0000000001000100 );
! put job on HOLD and set priority 4.
<10> HOLDAFTER flag: 0 = off
1 = on
<11> Reserved; must be 0
<12> Close the file
<13:15> Job priority