HP 3000 Manuals HP 3000 Manuals
SPOOLF
The SPOOLF command enables you to alter, print, or delete spool files.
Syntax
Alter option:
SPOOLF [IDNAME=]{spoolid }
{(spoolid[,spoolid]...)}
[ {ldev }]
{;ALTER}[;DEV={devclass}][;PRI=outpri][;COPIES=numcopies]
[ {devname }]
[;SPSAVE][;DEFER ][;SHOW]
[;UNDEFER]
Print option:
SPOOLF [IDNAME=]{fileset }
{(fileset[,fileset]...)}
[ {ldev }]
{;PRINT}[;DEV={devclass}][;PRI=outpri][;COPIES=numcopies]
[ {devname }]
[;SPSAVE][;DEFER ][;SHOW]
[;UNDEFER]
Delete option:
SPOOLF [IDNAME=]{spoolid } {;DELETE}[;SHOW]
{(spoolid[,spoolid]...)}
Parameters
Alter Option:
IDNAME Specifies one or more spool file IDs, spoolid, in
the form of #Onnn. The spooling subsystem assigns
the IDs when the spool files are created. The #
and the O are optional and are assumed if you do
not supply them. As a shortcut, you can use O@ to
specify all output spool files.
If you have system manager (SM) or system
supervisor (OP) capability, O@ affects all output
spool files on the system. If you have account
manager (AM) capability, O@ affects all output
spool files created by users in the same account.
If you do not have any of these capabilities, you
are limited to alter only files that you have
created.
ALTER Alters the characteristics of specified spool
files. The DEFER, DEV, and SPSAVE parameters
affect the ALTER option as follows:
* If you use DEFER or DEV for a spool file
currently printing, the spooler process
interrupts the printing. The spooler
process saves the page number of the last
complete page that was printed. The next
time any spooler selects the file for
printing, output resumes at the saved page
number.
* Because large amounts of data are buffered
in the file system and the device, an output
device may continue to print, appearing as
though DEFER and DEV have not affected
printing. This is because the spooler stops
sending data to the device when the command
is received, but must wait until all
buffered data has been printed before
releasing the spool file. Depending on both
the content of the data and the amount of
buffering, this may require a significant
part of a page or even several pages.
* You cannot alter the attributes of spool
files in the SPSAVE state.
DEV Specifies the device, which may have one of the
following values:
ldev Specifies the logical device
number of the spool file's
new destination device. If
the spool file is in the
print state, it returns to
the ready state. It can
immediately enter the print
state on ldev if it meets all
requirements.
The system interrupts spool
file printing only if the
newly specified target ldev
differs from the previous
target ldev.
devclass Specifies the new destination
device class name for the
spool file. If the spool
file is in the print state,
it returns to the ready
state. It can immediately
enter the print state on a
device in devclass if it
meets all requirements.
The devclass parameter must
begin with a letter and
consist of eight or fewer
alphanumeric characters. The
system does not allow the
same name to be configured as
a device class name and a
device name.
The system interrupts spool
file printing only if the
newly specified target
devclass differs from the
previous target devclass.
devname Specifies the device name of
the spool file's new
destination device. If the
spool file is in the print
state, it returns to the
ready state. It can
immediately enter the print
state on devname if it meets
all requirements. This
occurs even if devname is the
same as the device currently
printing the file.
The devclass parameter must
begin with a letter and
consist of eight or fewer
alphanumeric characters. The
system does not allow the
same name to be configured as
a device class name and a
device name.
The system interrupts spool
file printing only if the
newly specified target
devname differs from the
previous target devname.
PRI Specifies the output priority of the designated
spool files, where 0 is the lowest priority and 14
is the highest priority. You can specify an outpri
of 14 only from the console or if you have system
supervisor (OP) capability; otherwise, the highest
priority is 13.
COPIES Specifies the number of copies, numcopies, of the
designated spool files to be printed. The
allowable range is from 1 through 65535.
SPSAVE Specifies that the selected spool files are not to
be deleted after the last copies have printed.
Instead, the spool files are retained in the
HPSPOOL account in the SPSAVE state until you
manually delete them. You cannot, however, save
private spool files.
When a file enters the SPSAVE state, the system
sets the priority to 8 and the number of copies to
1.
DEFER Changes the spool file's state to DEFER. If the
spool file is currently in the print state, its
spooler is notified and printing stops. The spool
file's priority remains unchanged. If you use this
parameter with the PRINT option, the system copies
the spool file to OUT.HPSPOOL and links it to the
spooling system, but the state of the spool file is
DEFER. The spool file does not print until you
enter a subsequent SPOOLF...;UNDEFER.
If you use the DEFER parameter for any file in the
CREATE state (open for original creation), the
spool file only enters the DEFER state after it is
completed (closed for the last time).
UNDEFER Changes a spool file's state from DEFER to READY
and causes a spooler to start printing the spool
file if the spool file is qualified to be printed
by an idle printer. The spool file's priority
remains unchanged.
SHOW Displays the results of the SPOOLF command. When
you enter a SPOOLF command string, all parameters
process before the SHOW parameter.
Print Option:
IDNAME Specifies the set of files, fileset, to be printed.
This parameter has the following form:
filename[/lockword[.groupname[.accountname]]]
If the file name or set is not fully qualified, the
default is the user's current logon group and
account. In batch mode, if any file in the set has
a lockword, you must supply it with the command;
therefore, the file cannot be part of a set that
contains wildcards. This restriction does not
apply in interactive mode, because the system
prompts you for each required lockword. If you do
not provide the correct lockword for either mode,
the print option fails for the file and the command
continues to process the remaining files.
PRINT Copies the specified file sets to the HPSPOOL
account and links the new output spool files into
the spool queues for printing. This parameter is
especially useful for generating additional copies
of a spool file in the SPSAVE state.
You must have nonshareable device (ND) capability
to use the PRINT option. You cannot print private
files using this option.
DEV For information about this parameter, refer to DEV
for the ALTER option.
PRI For information about this parameter, refer to PRI
for the ALTER option.
COPIES For information about this parameter, refer to
COPIES for the ALTER option.
SPSAVE For information about this parameter, refer to
SPSAVE for the ALTER option.
DEFER For information about this parameter, refer to
DEFER for the ALTER option.
UNDEFER For information about this parameter, refer to
UNDEFER for the ALTER option.
SHOW For information about this parameter, refer to SHOW
for the ALTER option.
Delete Option:
IDNAME For information about this parameter, refer to
IDNAME for the Alter option.
DELETE Purges all specified private or nonprivate spool
files that you can access from the system.
If a spool file is not in use (opened by a user, or
being printed or stored), it is purged immediately.
If it is in use, the system places it in the DELPND
state. The printer spooler process is notified,
and printing stops at that point.
Because large amounts of data are buffered in the
file system and the device, an output device may
continue to print, appearing as though the DELETE
option has not affected printing. This is because
the spooler stops sending data to the device when
the command is received, but must wait until all
buffered data has been printed before stopping.
Depending on both the content of the data and the
amount of buffering, this may require a significant
part of a page or even several pages.
The DELETE option can delete all output spool files
in the READY, PRINT, DEFER, SPSAVE, or PROBLM
states. The DELETE option cannot delete $STDIN
files. Use the ABORTJOB command for these files.
SHOW Refer to SHOW for the Alter option for information
about this parameter.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Any user can enter this command; however the user's
capabilities determine which files the user can alter, print, or
delete.
* Altering private spool files
With certain limitations, you can alter private spool files. You
can only use the PRI, DEFER, UNDEFER, and DELETE parameters. If
you have system manager (SM) capability, you can also use the DEV
parameter.
* Problem state spool files
You can use the ALTER option on problem state spool files to alter
the device attribute so that the spool file becomes ready again.
Generally, the spool file is in the problem state because the
target device of the spool file is invalid.
Example
* To change the priority of all output spool files to 8 and show the
results, enter:
:SPOOLF O@;ALTER;PRI=8;SHOW
SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER
#414 J5 $STDLIST 8 1 16 READY ALIX.MKT
#416 J7 HOTSTUFF 8 2 16 READY JACK.SALES
Related Commands
ABORTJOB
ALTSPOOLFILE
DELETESPOOLFILE
LISTFILE
LISTSPF
PRINT
PURGE
SPOOLER