Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmer’s Guide—522293-003
4-71
Considerations
bytes-written-to-buff output
INT:ref:*
returns the number of bytes in the level-3-buff to be checkpointed.
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 SPOOLWRITE procedure:

Each call to SPOOLWRITE causes print-line to be written to the level-3-
buff. When a call to SPOOLWRITE causes the level-3-buff to overflow, the
buffer is written to the collector.
The blocking and compression of data into the level-3-buff are invisible to the
application process.

If bit 11 of the flags parameter of SPOOLSTART is set to 1, SPOOLWRITE exits
with a spooler error code of %11000 prior to writing the level-3-buff to the
collector. Applications running as a NonStop process pair can then perform a
checkpoint before the buffer is written to the collector. SPOOLWRITE should be
called again after checkpointing.

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 procedures, 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 := CALL SPOOLWRITE ( COLL^BUFFER , PRINT^LINE ,
LENGTH );