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
Printed 10/17/86 1
QDEV(8MDQS) COMMAND REFERENCE QDEV(8MDQS)
be 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 10/17/86 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), mdqsd(8mdqs).
Printed 10/17/86 3
%%index%%
na:72,86;
sy:158,275;
de:433,691;
op:1124,1599;2867,530;
ex:3397,552;
fi:3949,342;
rv:4291,622;
ca:5057,380;
se:5437,232;
%%index%%000000000155