QCONF(5MDQS) COMMAND REFERENCE QCONF(5MDQS)
NAME
qconf - MDQS configuration file
SYNOPSIS
/etc/qconf
DESCRIPTION
There are four sections to the Multi-Device Queuing System
configuration file, each separated by a row of hyphens. The
first section specifies MDQS parameter values, the second
specifies devices used, the third specifies queue names, and
the fourth specifies device/queue/server mappings.
The /etc/sysadmin program should be used for all but
exceptional cases of initializing and updating the MDQS
configuration file. The help facilities of this program are
useful for additional explanation of /etc/qconf parameters.
In /etc/qconf, the ``#'' character is a comment character
signifying that the rest of the line is to be ignored.
Extra spaces, tabs and blank lines are ignored, and double-
quoted strings are treated as single tokens.
Entries in the first section have the form "parameter
value". The following parameters are recognized:
print-queue <queue>
print-forms <form>
print-prior <priority>
print-hdr <headerfile>
print-hdrdir <directory>
print-limit <pages>
The above parameters control the default behavior of the lpr
program. The queue must be specified in the third section
of /etc/qconf, and may be directed to a remote queue (in the
fourth section of /etc/qconf) via the netsend server. The
form is used to direct entries from the default queue to the
default device. The form must be associated with the device
via the qdev program; this is handled automatically when
using the sysadmin program. The form must be a valid form
as specified in the MDQS forms file. Priority is in the
range 0-10, with 0 being the highest priority. Print-hdr
specifies the default file to be used as part of the banner
page logo. Print-hdrdir specifies the directory which may
contain header files for shared use (see lpr -H). Print-
limit specifies the maximum number of pages a printing
request may output. A limit of 0 indicates no limit.
batch-queue <queue>
batch-forms <form>
batch-prior <priority>
Printed 10/17/86 1
QCONF(5MDQS) COMMAND REFERENCE QCONF(5MDQS)
These parameters specify defaults for the batch program.
The meanings of queue, form, and priority are similar to the
meanings for the print parameters defined above.
console <filename>
is the file opened by mdqsd as stderr.
scanwait <number>
sets the default time in seconds that mdqsd will sleep if
there are no new requests or finished requests. It is
recommended that number be 60 so that the delayed queue will
be checked once a minute in the absence of new activity.
openwait <number>
specifies the number of seconds the daemon will wait to
retry opening a device if a device open fails.
maxfailures <number>
If this variable is non-zero, the daemon will flag a device
as failed if the server on that device fails number times.
If this happens, the device can be restarted by disabling
and re-enabling the device with the qdev program. If
disabling and re-enabling the device doesn't work, the MDQS
daemon can be killed and restarted via the daemon(8)
program.
sysmgr <address>
Specifies where to mail orphan notices. This address
defaults to mdqs.
netwait <number>
Specifies the amount of time (in minutes) to delay the retry
of a request that failed due to network errors.
Section two contains definitions for devices, where each
line is of the form ``logical-device real-device forms
status''. Logical-device is the parameter used to map
devices to queues in the fourth section of /etc/qconf, and
may be used as a parameter to qdev. The real-device should
be a real device name, i.e., it should begin with /dev/.
Examples of real devices used for printer ports are
/dev/tty1 and /dev/hc*.
The net is a special logical-device which should always map
here to /dev/null and should always map to the netsend
server in the fourth section. The batch program should
always submit to queues mapped to logical devices mapped to
/dev/null. The forms field specifies what forms are
associated with the device. Anyform indicates that this
device can accept requests regardless of what forms were
specified for the request. The status is a set of symbolic
flags used to control the behavior of a device. Skipmsg
Printed 10/17/86 2
QCONF(5MDQS) COMMAND REFERENCE QCONF(5MDQS)
disables the sending of completion messages on successful
completion of a request on the device. Roundrobin causes
the device to use a roundrobin algorithm in selecting
requests from several queues.
The third section simply contains queue names and an
optional status field, one per line. Queue names can be
specified in submit programs such as lpr and in status
programs such as lpq. The status field has one option
form=form which will set the forms field of all requests
submitted to this queue with the form of form if no form was
explicitly designated when the request was submitted.
The fourth section specifies the mapping of queues, devices,
and servers. A line in this section is of the form queue
device server . Queue and device must have been previously
defined in sections three and two respectively. A mapping
specifies that requests from queue are to be serviced by the
device (if the forms match those associated with the device)
and the request is to be processed using the server program.
The server process is run as setuid to the user id of the
user who submitted the request whether the request is run
locally or remotely.
If multiple queues are mapped to one device, a request is
taken from the queue with the first listed queue/device
mapping for this device, and if this queue is empty, the
request is taken from the queue with the next queue/device
mapping for this device, etc. (this can be overridden by
using the roundrobin status flag in section two).
A queue can hold requests directed to several devices, and
these requests can be partitioned by associating forms with
a device.
FILES
/etc/qconf /usr/lib/mdqs/forms
/usr/lib/mdqs/remote.access
CAVEATS
/etc/sysadmin is the normal and preferred way to initialize
and update /etc/qconf. When /etc/qconf is modified,
/etc/mdqsd should be killed and restarted - see
mdqsd(8mdqs). Rsh privileges are required in order to
execute remote requests.
SEE ALSO
forms(5mdqs), mdqsd(8mdqs), remote.access(5mdqs),
lpserver(8mdqs), sysadmin(8).
Printed 10/17/86 3
%%index%%
na:72,67;
sy:139,134;
de:273,3282;3699,3211;7054,2031;
fi:9085,235;
ca:9320,413;
se:9733,262;
%%index%%000000000127