SHUTQ

Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004

Back to Main Index


SHUTQ


     Closes the spool queue for the specified logical device or
     all devices in a device class.

SYNTAX


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


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 first, and then the device name
                    list.

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

@                   The "@" parameter is used to globally disable
                    all spooling queues which are currently open.
                    When the spooling queues are globally
                    disabled, this will inhibit the creation of
                    output spoolfiles.

NOTE: If the "@" option is used, it is the only parameter allowed.  The
SHOW option enterered with the @ options will return the following
error:

     CANNOT USE THE 'SHOW' OPTION WITH 'SHUTQ @'.  (CIERR 4815)"


OPERATION


     SHUTQ closes the spool queue for a logical device, device
     name, or all devices belonging to a specified device class
     configured in the system.  A spooler process, however,
     does not need to be running for any device.  If a spooler
     process is running, it is unaffected by shutting the
     queue.

     This command also serves as an option to the STARTSPOOL
     command.

     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 issued only from the console, unless
     distributed to users with the ALLOW or ASSOCIATE command.


EXAMPLE(S)


     To shut the spool queue for logical device 6, enter:

     SHUTQ 6

     To shut the spool queue for device LDEV6 enter:

     SHUTQ LDEV6

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

     SHUTQ EPOC

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

     SHUTQ 6;SHOW

     LDEV   DEV        SPSTATE    QSTATE   OWNERSHIP    SPOOLID

       6    LDEV6      ACTIVE     CLOSED   SPOOLED OUT  #O679

     To disable all spooling queues which are currently open, enter:

     SHUTQ @

ADDITIONAL INFORMATION


Commands:   OPENQ, STARTSPOOL

Manuals :   Performing System Operation Tasks (32650-90137)

Back to Main Index