COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

Using SPOOLCOM
Although most of your interaction with the spooler is likely to be through PERUSE or another perusal
process, there are a few things you might want to do for which SPOOLCOM can be more helpful
than PERUSE. The main value of SPOOLCOM is that it shows you the date each job was created,
and it also enables you to perform operations on groups of jobs.
SPOOLCOM is intended primarily for system operators (members of the super group). These users
have privileged access to the system. If you do not have privileged access, SPOOLCOM restricts
the variety and complexity of operations available to you.
SPOOLCOM does have the ability to accept commands on the (implicit) RUN command line and
to accept commands from an IN file specified as a RUN option, but the way you are most likely
to use SPOOLCOM is run it like any other process:
104> SPOOLCOM
SPOOLCOM introduces itself with this header:
SPOOLCOM - T9101C00 - (15JUL87) SYSTEM \LEO
)
The right parenthesis is the SPOOLCOM prompt. Table 127 lists some of the commands available
to you, but it is not a complete list of SPOOLCOM commands. For more information, see the
Guardian User’s Guide.
Table 127 SPOOLCOM Operations and Commands (Partial List)
CommandOperation
COLLECTReport the status of a particular collector or all collectors
DEVReport the state of a device in the spooler system
DEVSkip pages on a report that a particular device is printing
DEVRestart a device that has been stopped by a device error
EXIT or Control-YEscape from SPOOLCOM
HELPShow proper syntax of all SPOOLCOM commands
JOBOperate on one or more of your jobs in the spooler, such as reporting their status,
changing their attributes or ownership, deleting them, starting them (shifting them
from HOLD state to READY state), and so on
LOCReport the status of one or more locations (including their destinations)
LOCReport a cross-reference list of locations, devices, and print processes
OPENSpecify a spooler supervisor with which SPOOLCOM is to communicate
PRINTReport the status of the spooler’s print processes
SPOOLERReport the status of the spooler
The subcommands most useful to the application programmer are:
• JOB
• DEV
JOB
The SPOOLCOM command JOB is very powerful and flexible. Suppose that you are user 5,40,
and you give the command:
) JOB (OWNER 5,40)
You get a report like this:
JOB STATE FLAGS OWNER TIME COPY PAGE REPORT LOCATION
1203 HOLD 4 A 5,40 01/28 1 4 DEVELOP QUINN #ANON
Using a Spooler 909