Spooler Programmer's Guide
Using the Spooler Print Procedures, Print
Processes, and Perusal Processes
Spooler Programmer’s Guide—522287-002
3-6
Device Errors
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.
Device Errors
When errors are encountered on a print device during the printing of a job, the print
process should call PRINTSTATUS with the following messages:
For the first occurrence of a device error following any number of successful
operations on the device, the print process should specify a msg-type of 5 and
pass the error number in the error parameter.
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.