qdev(8MDQS) — UTek 4.0



QDEV(8MDQS)             COMMAND REFERENCE             QDEV(8MDQS)



NAME
     qdev - display and modify MDQS local device status

SYNOPSIS
     /etc/qdev [ -d ] [ -e ] [ -f ] [ -l form ] [ -r ] [ -s ] [
     device ...  ]

DESCRIPTION
     The qdev command is used to display or change the status of
     local MDQS devices.  Only one option can be specified at a
     time.  If invoked without an option, qdev will display the
     status of all local mdqs devices.

     Any user may restart or flush a device if his job is active.
     Any user may display device status.  Only the superuser, the
     mdqs user, or a member of the systems group may enable or
     disable a device, or load forms into a device, or flush or
     restart a device with an active request which is not his
     own.

OPTIONS
     -d  disables the specified devices.  Any requests being
         processed by those devices are signaled to restart,
         causing them to be requeued for later processing.  If a
         device has been marked as "Failed", disabling the device
         will clear the "Failed" flag.  Thus, a "Failed" device
         can be restarted by first disabling and then re-enabling
         it.

     -e  enables the specified devices for processing requests

     -f  flushes the current request from the specified devices.
         The request is removed from the queueing system and a
         message is sent to the user who made the request
         indicating that the request was forcibly flushed from
         the device.

     -l form
         changes the queueing systems idea of the current form on
         a given device.  The form argument must reference a
         valid form in the formsfile if the formsfile exists.
         The same form will apply to all listed devices.  Forms
         may be used to direct requests from a single queue to
         appropriate devices so that, for instance, all print
         requests can be submitted to one queue, but requests
         within that queue are directed to either a wide or a
         narrow printer.

     -r  restarts the current request in each of the specified
         devices.  The request is requeued.

     -s  causes the status of each of the specified devices to be



Printed 4/6/89                                                  1



QDEV(8MDQS)             COMMAND REFERENCE             QDEV(8MDQS)



         printed.  If no devices are specified, the status of all
         local devices will be given.  The status information
         will always contain the name of the device and the
         currently loaded forms.  If the device is disabled or
         flagged as having failed too many times, an appropriate
         message will be displayed.  If there is a request being
         processed by that device, the request name and process
         ID of the filecontrol process will also be displayed.

EXAMPLES
     /etc/qdev
         displays the status of all devices

     /etc/qdev -l fanfold vp0 vp1
         loads the devices vp0 and vp1 with the forms "fanfold"

     /etc/qdev -d batch1
         disables device batch1 and restarts the request that may
         have been running on that device.

     /etc/qdev -f net
         flushes the current request being sent over the "net"
         device.  A letter will be generated informing the
         requestor that the request was flushed.

FILES
     /etc/mdqsd       MDQS daemon

     /etc/qconf       configuration information for MDQS

     /usr/lib/mdqs/forms
                      list of available forms

     /usr/spool/q     top of spooling directory tree

RETURN VALUE
     [NO_ERRS]      Command completed without error.

     [USAGE]        Incorrect command line syntax. Execution
                    terminated.

     [NP_WARN]      An error warranting a warning message
                    occurred. Execution continues.

     [NP_ERR]       An error occurred that was not a system
                    error.  Execution terminated.

     [P_ERR]        A system error occurred. Execution
                    terminated.  See intro(2) for more
                    information on system errors.





Printed 4/6/89                                                  2



QDEV(8MDQS)             COMMAND REFERENCE             QDEV(8MDQS)



CAVEATS
     Things can change while qdev is running; the picture it
     gives is only a close approximation of reality.  For
     instance, qdev may produce false error messages if it cannot
     find a particular file or if a data structure it is looking
     at changes underneath it.

SEE ALSO
     qstat(1mdqs), qmod(1mdqs), forms(5mdqs), and mdqsd(8mdqs).














































Printed 4/6/89                                                  3

%%index%%
na:336,102;
sy:438,391;
de:829,767;
op:1596,1653;3657,509;
ex:4166,577;
fi:4743,355;
rv:5098,666;
ca:6172,440;
se:6612,264;
%%index%%000000000157

Museum

Related Articles