OPENQ



OPENQ

     Opens the spool queue(s) for a specified logical device, or
     device name, or all device members of a device class.

SYNTAX


OPENQ {[DEV={ldev [;SHOW]}
{devclass [;SHOW]}
{devname [;SHOW]}
{ @ }

PARAMETERS



ldev The logical device number of the spooled device.

devclass The device class name of the spooled device;
DEVCLASS must begin with a letter and consist of
eight or fewer alphanumeric characters. Device
classes are treated as a group of related devices.
When a device class name is used, the command is
applied to all devices that belong to that device class.

devname The device name of the spooled device. DEVNAME must
begin with a letter and consist of eight or fewer
alphanumeric characters. Users should note that it
is not possible to have a device class name and a
device name which are the same. If you enter an
alphanumeric character string, the command will
search the device class list first, and then the
device name list.

SHOW The SHOW parameter displays the current queue state
(enable or disabled) of the devices specified with
the OPENQ command.

@ The "@" parameter globally reenables all
currently open spooling queues that were
disabled because the system ran out of
system domain disk space, a file limit was
encountered on the HPSPOOL account or it groups,
or the SHUTQ @ command entered.

If the spooling queues are disabled globally
because the system is out of disk space or a file
limit is encountered on the HPSPOOL account or
it groups, the problem should be resolved before
globally enabling spooling queues with the
OPENQ @ command.

Refer to the Native Mode Spooler Reference
Manual (32650-90166) for more discussion on
globally enabling and disabling spooling queues.

Use the @ option without any other parameter.
The SHOW option entered with the @ option returns
an error.

OPERATION


OPENQ enables spooling for a specified logical device,
device name, or all devices belonging to a device class.
It allows users to generate spoolfile(s) destined for the
specified device(s) or class. It does not enable those
files to print -- that functionality is controlled by the
SPOOLER command.

The use of the OPENQ command does not affect the operation
of any spooler process.

Spoolfiles can often be created faster than they are processed.
You may want to issue a SHUTQ command, to clear the backlog
of files in the queue, and then reopen it with an OPENQ
command when the queue is clear.

OPENQ also serves as an option to the STOPSPOOL command.
The STOPSPOOL and the SHUTQ commands, are documented in
this section.

This command may be issued from a session, job, in BREAK, or
from a program. Pressing [Break] has no effect on this
command. It may be executed only from the console, unless
distributed to users with the ALLOW or ASSOCIATE commands.

EXAMPLE(S)

     To open the spool queue for logical device 6, enter

     OPENQ 6

     To open the spool queue for device name LDEV6, enter:

     OPENQ LDEV6

     To open spool queues for all the devices in device class
     EPOC, enter:

     OPENQ EPOC

     To open spool queues and show the state of queues and
     other information about the specified device(s), enter:

     OPENQ 6;SHOW

     This will result in the following screen information:

     LDEV    DEV      SPSTATE     QSTATE   OWNERSHIP    SPOOLID

        6    LDEV6    ACTIVE      OPENED   SPOOLED OUT  #O679

     To enable all spooling queues currently open, enter:

     OPENQ @

NOTE

Classes are collections of devices, so operations (such as OPENQ)
on a device class are applied to all devices in the class.  Thus,
if class LP consists of LDEVs 6, 11, and 19:

      OPENQ 6      opens spool queues for LDEV 6
      OPENQ LP     opens spool queues for LDEVs 6, 11 and 19

ADDITIONAL INFORMATION

Commands:   STOPSPOOL, SHUTQ, STARTSPOOL