Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmer’s Guide—522293-003
4-21
Considerations
line input
INT:value
if present, is the current line number (from PRINTINFO).
lines-printed input
INT:value
is the number of lines printed.
Considerations
The following considerations apply to the use of the PRINTSTATUS[2] procedure:

PRINTSTATUS[2] should not be used by a perusal process. A print process
operates with, and under the control of, the supervisor, while a perusal process
operates on its own.

The file number to supervisor, print control buffer, message type, and device
parameters are required parameters and must always be present in a call to
PRINTSTATUS[2]. The remaining parameters are optional; PRINTSTATUS[2]
might need these parameters, however, depending on the message type.
Table 4-2 shows which parameters are needed for each message type.

PRINTSTATUS[2] is a nowait operation and must be completed with a call to
AWAITIO[X].

Message types 1 and 5 inform the supervisor of an error occurring on a print
device.

Message type 5 is sent if the previous operation on the device was successful.
When it receives the message, the supervisor can instruct the print process to retry
the operation. If the operation fails again, the print process sends message type 1,
which indicates to the supervisor that a retry of an operation failed.
Message type 5 causes the supervisor to reset its retry count for that device.
Table 4-2. PRINTSTATUS[2] Message Type and Parameters
Message
Type Error
Number of
Copies
Pag
e Lines Printed
0XXX
1X
2
3
4X
5X