Spooler Programmer's Guide

Spooler Procedure Calls
Spooler Programmer’s Guide—522287-002
4-57
Obtaining the Spooler Statistics and Status
Obtaining a Cross-Reference (Command Codes 10, 11, and
12)
To obtain a cross-reference of locations, devices, or print processes, set the
command-code parameter of SPOOLERSTATUS2 for the type of cross-reference you
want and pass either a 64-word cross-reference buffer to SPOOLERSTATUS or a 128-
word cross-reference buffer to SPOOLERSTATUS2. The command codes are as
follows:
The following STRUCT shows the fields of the buffer:
STRUCT xref^buffer;
BEGIN
STRUCT location;
BEGIN
STRING group[0:7], ! group name, blank-filled
destination[0:7]; ! destination, blank-filled
END;
INT device^name[0:15]; ! device name (internal
! file-name format)
!
STRING process^name[0:5]; ! print process name,
! blank-filled
INT marker; ! must be initialized to 0
END;
If you want a complete cross-reference, initialize the field to zero, set all other fields to
blanks, and use a scan-type of 1.
If you want a cross-reference for a particular item, assign that field, initialize marker to
zero and the other fields to blanks, and use a scan-type of 0.
In both cases, keep calling SPOOLERSTATUS2 until it returns error %14006 (end of
entries).
Because device and print process cross-references can tie up the spooler supervisor
for extended periods, SPOOLERSTATUS2 can return error %14016 (request in
progress). When this error code is returned, the information in the buffer is invalid.
Call SPOOLERSTATUS2 again until %14006 is returned (end of entries).
Obtaining the Status of a Font (Command Code 13)
To obtain the status of a font, set the command-code parameter of
SPOOLERSTATUS2 to 13 and pass either a 64-word status buffer to
10 = by location
11 = by device
12 = by print process
Note. Do not change any of the fields in the buffer between calls. Unexpected results can
occur.