HP 3000 Manuals HP 3000 Manuals
SPOOLER
The SPOOLER command enables you to do the following:
* Show the status of the spooling process
* Enable or disable spooling for a specified logical device, device
name, or all devices of a device class
* Start, stop, suspend, and resume spooler printing processes
* Release files from the spooler process
Syntax
{ldev }
SPOOLER [DEV=]{devclass}
{devname }
Plus one of the following options:
Status option:
{;SHOW}
Enable/Disable option:
{;OPENQ}[;SHOW]
{;SHUTQ}
Start option:
{;START}[;OPENQ][;SHOW]
[;SHUTQ]
Stop option:
{;STOP}[;FINISH][;OPENQ][;SHOW]
[;NOW ][;SHUTQ]
Suspend option:
{;SUSPEND}[;KEEP ][;FINISH][;OPENQ][;SHOW]
[;NOKEEP][;NOW ][;SHUTQ]
Resume option:
{;RESUME}[;OPENQ][;SHOW]
[;SHUTQ]
Release option:
{;RELEASE}[;OPENQ][;SHOW]
[;SHUTQ]
Parameters
DEV Specifies the spooler device in one of the
following forms:
ldev Specifies the logical device
number of the spooled device.
devclass Specifies the device class
name of the spooled devices.
The devclass must begin with
a letter and consist of eight
or fewer alphanumeric
characters.
devname Specifies the device name of
the spooled device. The
devname must begin with a
letter and consist of eight
or fewer alphanumeric
characters. A device class
name and a device name cannot
be the same. If you enter an
alphanumeric character
string, the command searches
the device class list first,
then the device name list.
Status option:
SHOW Displays the status of the spooling process(es)
associated with the specified device(s). This
parameter reflects the updated state of the
process(es) when the command finishes executing.
Enable/Disable option:
OPENQ Enables spooling for ldev, devclass, or devname.
This enables users to generate spool files on the
device(s). This parameter is the default for the
START option.
SHUTQ Disables spooling for ldev, devclass, or devname.
This prevents users from generating spool files on
the device(s). This parameter is the default for
the STOP option.
SHOW For information about this parameter, refer to SHOW
for the STATUS option.
Start option:
START Creates and activates a new spooler process to own
and manage the device and print spool files
destined for the device. If a class is specified,
a spooling process is created and activated for
each device in the class. If you do not specify
either the OPENQ or SHUTQ option, OPENQ is the
default.
OPENQ For information about this parameter, refer to
OPENQ for the Enable/Disable option.
SHUTQ For information about this parameter, refer to
SHUTQ for the Enable/Disable option.
SHOW For information about this parameter, refer to SHOW
for the Status option.
Stop option:
STOP Terminates the spooling process associated with the
specified device. If you specify a class, spooling
processes terminate for all devices in the
specified class. When you specify this parameter,
the following message appears:
Output spooler, LDEV #ldev: Stopped.
If you do not specify either the FINISH or NOW
parameters, NOW is the default. If you do not
specify either the OPENQ or SHUTQ parameter, SHUTQ
is the default.
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 STOP
parameter has not affected printing. This happens
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.
If you stop the spooler while it is printing a
file, the spooler saves the page number of the last
complete page that was printed. Whenever any
spooler subsequently selects the file for printing,
output resumes at the page number following the
saved page number.
FINISH Directs the spooler to finish printing the
currently active spool file and then stop.
NOW Directs the spooler to immediately stop printing
the currently active spool file. This is the
default for the STOP option.
OPENQ For information about this parameter, refer to
OPENQ for the Enable/Disable option.
SHUTQ For information about this parameter, refer to
SHUTQ for the Enable/Disable option.
SHOW For information about this parameter, refer to SHOW
for the Status option.
Suspend option:
SUSPEND Suspends output to one or more spooled devices so
that the spooler devices become inactive. When you
specify this parameter, the following message
appears:
Output spooler, LDEV #ldev: Suspended.
If you do not specify either the FINISH or NOW
parameters, NOW is the default. If you do not
specify either the KEEP or NOKEEP parameter, KEEP
is the default.
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 SUSPEND
parameter 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.
If you suspend the spooler while it is printing a
file and the spooler does not retain the file, the
spooler saves the page number of the last complete
page that was printed. Whenever any spooler
subsequently selects the file for printing, output
resumes at the page number following the saved page
number.
KEEP Directs the device to retain ownership of the spool
file that it is currently processing. This is the
default. This parameter is valid only under the
following conditions:
* The spooler is actively processing a file or
is suspending.
* You do not specify the FINISH parameter.
NOKEEP Directs the spooler to close the spool file that it
is currently processing. This parameter is valid
only under the following conditions:
* The spooler is actively processing a file or
is suspending.
* You do not specify the FINISH parameter.
The spooler does the following when you include the
NOKEEP parameter:
* stops sending data after the current record
* ejects a page
* saves the last completely printed page
* prints a trailer with (INCOMPLETE) on it if
trailers are enabled
* returns the file to the ready state
Whenever any spooler subsequently selects the file
for printing, output resumes at the page number
following the saved page number. The file's header
and trailer include (RESUMED) if printing starts
anywhere other than the first page.
FINISH For information about this parameter, refer to
FINISH for the STOP option.
NOW For information about this parameter, refer to NOW
for the STOP option.
OPENQ For information about this parameter, refer to
OPENQ for the Enable/Disable option.
SHUTQ For information about this parameter, refer to
SHUTQ for the Enable/Disable option.
SHOW For information about this parameter, refer to SHOW
for the Status option.
Resume option:
RESUME Resumes a suspended spooler process. In order for
this parameter to function, the spooler must be in
the SUSPEND state. Output resumes where it was
suspended.
OPENQ For information about this parameter, refer to
OPENQ for the Enable/Disable option.
SHUTQ For information about this parameter, refer to
SHUTQ for the Enable/Disable option.
SHOW For information about this parameter, refer to SHOW
for the Status option.
Release option:
RELEASE Directs a suspended output spooler to close
(release) a currently retained spool file. The
spool file was retained because you previously
specified the SUSPEND;KEEP parameters.
When the spooler releases the file, the spooler
saves the page number of the last complete page
that was printed. Whenever any spooler
subsequently selects the file for printing, output
resumes at the page number following the saved page
number.
OPENQ For information about this parameter, refer to
OPENQ for the Enable/Disable option.
SHUTQ For information about this parameter, refer to
SHUTQ for the Enable/Disable option.
SHOW For information about this parameter, refer to SHOW
for the Status option.
Operation Notes
* Usage
You can enter this command from a session, a job, a program, or in
break mode. Except for the status option, pressing Break does not
affect this command.
You can only enter this command from the console; however, you can
enter this command from your terminal if your system administrator
has used the ALLOW command to enable you to enter the command.
Anyone can use the status option; however, all other options are
only available to console users or allowed users.
* Selective device errors
This command affects more than one process if applied to all
devices in a class. Consequently, errors can occur for some of
the devices, but not others.
For example, class LP consists of LDEVs 6, 11, and 19, and a
spooler process already owns LDEV 11. The command SPOOLER
LP;START would create and activate spooler processes for LDEVs 6
and 19, but would also generate the message DEVICE 11 IS ALREADY
SPOOLED.
Example
* To show the status of device name LP, enter:
:SPOOLER LP;SHOW
LDEV DEV SPSTATE QSTATE OWNERSHIP SPOOLID
6 LDEV6 IDLE OPENED OUT SPOOLER
14 LDEV14 *SUSPEND OPENED OUT SPOOLER #0237
15 LDEV15 ACTIVE OPENED OUT SPOOLER #O264
19 LDEV19 OPENED NO SPOOLER
The asterisk beside LDEV14 indicates that the SUSPEND state is
pending.
Related Commands
LISTSPF
OPENQ
SHOWDEV
SHUTQ
SPOOLF