Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmers Guide522293-003
4-24
SPOOLCONTROL Procedure
SPOOLCONTROL Procedure
The SPOOLCONTROL procedure is used to perform device-dependent I/O operations
when the application process is spooling at level 3.
If a level-3 buffer is specified in a call to SPOOLSTART, the SPOOLCONTROL
procedure must be used in place of the CONTROL procedure.
error-code returned value
INT
returns one of the following spooler error codes:
level-3-buff input, output
INT:ref:512
is the level-3-buff specified in the SPOOLSTART procedure.
operation input
INT:value
is a CONTROL operation value (see the CONTROL procedure in the Guardian
Procedure Calls Reference Manual for information about CONTROL operations).
param input
INT:value
is a parameter for the specified CONTROL operation (see the Guardian
Procedure Calls Reference Manual for more information on CONTROL
operations).
error-code := SPOOLCONTROL ( level-3-buff ! i,o
,operation ! i
,param ! i
,[ bytes-written-to-buff ] ) ! o
,[ extended-level-3-buff ] ); ! i,o
0 Successful operation
%1000-%1377 Error on file to collector (bits <8:15> contain a file-system error
number; see Considerations on page 4-25)
%10000 Missing parameter
%10001 Parameter is present, but its content is wrong
%11000 Checkpoint exit
%11001 Attempted to write to the collector without first opening the file