HP 3000 Manuals

Opening and Closing the Spooler Queue [ Controlling System Activity ] MPE/iX 5.0 Documentation


Controlling System Activity

Opening and Closing the Spooler Queue 

The OPENQ command enables the operator to control the spool queue of a
specified logical device, device name, or all devices belonging to a
device class.  It also gives the operator access to spool queues for
which no spooler or physical device exists.

The SHUTQ command closes the spool queue for a logical device or device
class configured in the system.  The spooler process, however, does not
need to be running for the device.  If the spooler process is running, it
is unaffected by shutting the queue.

Since spoolfiles can be created faster than they are processed, you may
want to issue one or more SHUTQ commands to allow spooler processes to
clear the backlog of spoolfiles waiting to be processed.  When the number
of spoolfiles have been reduced to an acceptable level, you re-open
queues with the OPENQ command.

Both commands may be issued only from the console unless distributed to
users with the ALLOW or ASSOCIATE command.

Both commands use the parameters ldev (logical device number), devclass 
(device class) and devname (device name).  This gives the system operator
control over access to queues by specific device, device class (such as
the class LP) or device name.

Both OPENQ and SHUTQ commands are used by themselves and as parameters to
(respectively) the SPOOLER;STOP and SPOOLER;START commands.  When used by
themselves, neither OPENQ or SHUTQ have any effect on the status of an
output spooler process.  When used as parameters to the SPOOLER;STOP and
SPOOLER;START commands, they affect the status of the queue.

OPENQ Syntax 

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

          Table 5-10.  OPENQ Parameters 

--------------------------------------------------------------------------------------------
|                       |                                                                  |
|       Parameter       |                           Description                            |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| ldev                  | The logical device number of an output spoolable device.         |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| devclass              | A device class containing at least one output spoolable device.  |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| devname               | The spooled device name.  Devname must begin with a letter and   |
|                       | consist of eight or fewer alphanumeric characters.  It is not    |
|                       | possible to have a device class name and device name which are   |
|                       | the same.  If you enter an alphanumeric character string, the    |
|                       | command searches the device class list 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 globalloy enables all currently open spool       |
|                       | queues that were disabled.                                       |
|                       |                                                                  |
--------------------------------------------------------------------------------------------

SHUTQ Syntax 

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

          Table 5-11.  SHUTQ Parameters 

--------------------------------------------------------------------------------------------
|                       |                                                                  |
|       Parameter       |                           Description                            |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| ldev                  | The logical device number of an output spoolable device.         |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| devclass              | A device class containing at least one output spoolable device.  |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| devname               | The spooled device name.  Devname must begin with a letter and   |
|                       | consist of eight or fewer alphanumeric characters.  It is not    |
|                       | possible to have a device class name and device name which are   |
|                       | the same.  If you enter an alphanumeric character string, the    |
|                       | command searches the device class list first, and then the       |
|                       | device name list.                                                |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| SHOW                  | The SHOW parameter displays the current queue state (enabled or  |
|                       | disabled) of the devices with the OPENQ command.                 |
|                       |                                                                  |
--------------------------------------------------------------------------------------------
|                       |                                                                  |
| @                     | The @ parameter globally disables all currently open spool       |
|                       | queues.                                                          |
|                       |                                                                  |
--------------------------------------------------------------------------------------------

Opening and Closing the Queue with OPENQ and SHUTQ 

To open the spool queue for or enable spooling of files output to ldev 6
and display current state of specified devices, enter:

     OPENQ ldev 6;SHOW 

To open the spool queue for device class LP, enter:

     OPENQ LP 


NOTE The use of OPENQ 6 and OPENQ LP do not produce the same results, although ldev 6 is a member of the device class LP. An OPENQ 6 causes output to ldev 6 to be spooled, including the $STDLIST of jobs that have specified OUTCLASS=6 with the JOB command.
To shut the spool queue for or disable spooling of files output to ldev 6, enter: SHUTQ ldev 6 To shut the spool queue for device class LP, enter: SHUTQ LP


MPE/iX 5.0 Documentation