Spooler Plus Programmer's Guide

Using the Spooler Print Procedures, Print Processes, and
Perusal Processes
Spooler Plus Programmer’s Guide—522293-003
3-6
Communicating With the Spooler Supervisor
completion after every write to the device can respond immediately to a message such
as “skip to page 3,” “send job status,” or “suspend job.”
The supervisor times out any print process that waits more than 10 minutes to respond
to a message. A print process that times out is put into the procerror state by the
supervisor, and any devices controlled by that print process are considered unusable.
The controlnum values returned by PRINTREADCOMMAND, and the action that the
print process should take in response, are
Sending Error Messages to the Spooler Supervisor
The only messages that a print process sends to the supervisor without a supervisor
request are error messages. The print process informs the supervisor of errors by
sending the error to the supervisor using the PRINTSTATUS procedure. A print
process can encounter errors from a print device during a call to WRITE[X] or from a
job during a call to PRINTREAD.
0 Open the device specified in the device parameter of PRINTREADCOMMAND.
1 Close the device specified in the device parameter of PRINTREADCOMMAND.
2 Start the job with attributes as specified in the PRINTREADCOMMAND
parameters.
3 Cancel any incomplete I/O associated with the job on the device specified in
the device parameter of PRINTREADCOMMAND. Then stop the job. After
successfully stopping the job, send an “end of job” status to the supervisor by
calling PRINTSTATUS with a msg-type of 2.
4 Resume the job on the device specified in the device parameter of
PRINTREADCOMMAND.
5 Suspend the job on the device specified in the device parameter of
PRINTREADCOMMAND.
Suspend reading and printing activity on the job pending another instruction; no
new job can be started on the device.
6 Print a form-alignment template on the device specified in the device parameter
of PRINTREADCOMMAND.
7 Start printing on the specified page on the device specified in the device
parameter of PRINTREADCOMMAND.
8 Start printing on the page that is offset from the current page by the specified
number of pages on the device specified in the device parameter of
PRINTREADCOMMAND.
9 Send the status of the job printing on the device specified in the device
parameter of PRINTREADCOMMAND.