Chapter 8 637
Command Definitions SP-Z
SPOOLF
The default is 1 for the PRINT option and no change for the ALTER option.
SPSAVE The SPSAVE option specifies that the selected spool files are not to be
deleted after their last copy has printed. Instead they are retained in the
HPSPOOL account in the SPSAVE state until deleted manually. Among
other advantages, this option allows documents to be copied to user file
space, to be reprinted without being reformatted, and so on.
Private spool files may not be saved.
When a file enters the SPSAVE state, its priority is set to 8 and its number
of copies is set to 1. This is so that it will have the proper defaults should it
be printed later.
DEFER The DEFER option changes the spool file's state to DEFER. If it is currently
in the PRINT state, its spooler is notified and printing stops at that point.
(See the note about buffer retention under the DELETE option.) The spool
file's priority remains unchanged. If this option is used with the PRINT
option, the spool file is copied to OUT.HPSPOOL and linked to the spooling
system, but the state of the spool file is DEFER. The spool file is not printed
until a subsequent SPOOLF...;UNDEFER is entered.
NOTE If the DEFER option is used on any file in the CREATE state (opened for
original creation), the spool file only enters the DEFER state after it is
completed (closed for the last time).
UNDEFER The UNDEFER option changes a spool file's state from DEFER to READY and
causes a spooler to start printing it if the spool file is qualified for an idle
printer to print. The spool file's priority remains unchanged.
SHOW The SHOW option allows a user to display the results of the SPOOLF
command. All other parameters are processed before the SHOW. Here is an
example:
:SPOOLF O@;SELEQ=[DEV=16];ALTER;PRI=8;SHOW
SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER
#O414 J5 $STDLIST 8 1 00000016 READY ALIX.MKT
#O416 J7 HOTSTUFF 8 2 00000016 READY JACK.SALES
Operation Notes
Input spool file attributes cannot be altered, but input spooled DATA files can be deleted.
Private spool files may be altered in a limited fashion; only the keywords PRI, DEFER,
UNDEFER, and DELETE are allowed. If the user has system manager capability, DEV= is also
allowed.
The SPOOLF...;ALTER command can be used on problem state spool files to alter the
device attribute so that the spool file becomes ready again. Most of the time, the spool file
is in the problem state because the target device of the spool file is invalid.
