Spooler Programmer's Guide

Spooler Procedure Calls
Spooler Programmer’s Guide—522287-002
4-43
Considerations
print-control-buffer output
returns a “start job” message suitable for passing to the PRINTREADCOMMAND
procedure.
Considerations
The following considerations apply to the use of the SPOOLEREQUEST[2] procedure:

Before calling the SPOOLEREQUEST[2] procedure, you must open a file to the
spooler supervisor. You must specify waited I/O.

The PRINTCOMPLETE[2], PRINTINFO, PRINTINIT[2], and PRINTSTATUS[2]
spooler print procedures cannot be used by a perusal process.

SPOOLEREQUEST[2] must be used with the spooler print procedures
(PRINTREADCOMMAND Procedure on page 4-12, PRINTREAD Procedure on
page 4-9, and PRINTSTART[2] Procedure on page 4-17).

Because the supervisor does not know that the data file is being accessed, it
allows the job to be deleted. If this occurs, PRINTREAD returns an “invalid data
file” error (%12002) when attempting to read a line of data that is no longer there.

SPOOLEREQUEST[2] returns job information only if the process access ID (PAID)
of the process calling SPOOLEREQUEST[2] (for example, the user executing
SPOOLEREQUEST[2]) matches the job’s owner.

You can use SPOOLEREQUEST to access jobs that reside in the D41 and later
releases of the spooler only if they are in the form of file code 129 job files;
otherwise you must use SPOOLEREQUEST2.
INT:ref:64 (Use with SPOOLEREQUEST)
INT:ref:128 (Use with SPOOLEREQUEST2)