Spooler Plus Programmer's Guide

Spooler Procedure Calls
Spooler Plus Programmer’s Guide—522293-003
4-52
Obtaining the Spooler Statistics and Status
Obtaining the Status of a Collector (Command Code 18)
To obtain the status of a collector, set the command-code parameter of
SPOOLERSTATUS2 to 18 and pass a 128-word status buffer to SPOOLERSTATUS2.
The following STRUCT shows the fields of the buffer:
STRUCT collector;
BEGIN
STRING name [0:5]; ! collector process name, in
! local form, blank-filled
INT state, ! collector state:
! 1 = Active
! 2 = Dormant
! 3 = Procerror
! 4 = Drain
reserved, ! reserved for use by HP
last^error; ! last error recorded on collector
STRUCT program^file; ! file name of collector
BEGIN ! program
INT volume [0:3], ! $volume, blank-filled
subvolume [0:3], ! subvolume, blank-filled
filename [0:3]; ! file name, blank-filled
END;
INT cpus, ! CPUs executing the
! collector program
! cpus.<0:7> = primary
! cpus.<8:15> = backup
priority; ! execution priority of
! the collector process
STRUCT data^file; ! file name of collector
BEGIN ! output file
INT volume [0:3], ! $volume, blank-filled
subvolume [0:3], ! subvolume, blank-filled
filename [0:3]; ! file name, blank-filled
END;
INT unit^size; ! number of blocks reserved
! for when it needs more
! disk space
INT (32) units^allocated; ! number of blocks already
! allocated
INT (32) total^units; ! total number of units
! available in data file
INT pagesize; ! default page size
END;
If you want the status of all collectors in the spooler subsystem, fill the
collector.name field with blanks and set bit 15 of the scan-type parameter to
1.The first call will return the status of the device whose name comes first
alphabetically. Continue calling SPOOLERSTATUS2 until it returns error %14006 (end
of entries).
If you want the status of a particular collector, fill the collector.name field with the
name of the collector whose status you want (blank-fill the right side of the field). Then
call SPOOLERSTATUS2 with bit 15 of the scan-type parameter set to 0.