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. Printed 5/12/88 1
QCONF(5MDQS) COMMAND REFERENCE QCONF(5MDQS) batch-queue <queue> batch-forms <form> batch-prior <priority> 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 Printed 5/12/88 2
QCONF(5MDQS) COMMAND REFERENCE QCONF(5MDQS) 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 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. Printed 5/12/88 3
QCONF(5MDQS) COMMAND REFERENCE QCONF(5MDQS) SEE ALSO forms(5mdqs), mdqsd(8mdqs), remote.access(5mdqs), lpserver(8mdqs), and sysadmin(8). Printed 5/12/88 4
%%index%% na:360,83; sy:443,206; de:649,3560;4641,3752;8825,2544; fi:11369,221; ca:11590,441; se:12463,340; %%index%%000000000131