OPENQ

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


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

Back to Main Index