Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmer’s Guide—522293-003
4-64
Considerations
is a parameter for the specified SETMODE function (see the Guardian Procedure
Calls Reference Manual).
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 SPOOLSETMODE procedure:

If flags.<11> of SPOOLSTART is set to 1, a return of %11000 from
SPOOLSETMODE indicates that the level-3-buff is about to be written to the
collector. The buffer should be checkpointed, and SPOOLSETMODE should be
called again.

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],
OPEN, or FILE_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 := SPOOLSETMODE ( COLL^BUFF , 68 , 2 ); ! select expanded
! print.