Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmer’s Guide—522293-003
4-27
Considerations
is an array containing the control information to be sent to the print device.
count input
INT:value
is the number of bytes of information contained in the buffer.
bytes-written-to-buff output
INT:ref:1
returns the number of bytes to be checkpointed from the level-3-buff.
This parameter is used by fault-tolerant applications.
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 SPOOLCONTROLBUF procedure:

If flags.<11> of SPOOLSTART is set to 1, a return of %11000 from
SPOOLCONTROLBUF indicates that the level-3-buff is about to be written to
the collector. The buffer should be checkpointed, and SPOOLCONTROLBUF
should be called again.

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
ERROR := SPOOLCONTROLBUF (COLL^BUFF , 1 , CON^BUFF , COUNT );