Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

at(1)

cron(8)

crontab(1)

nice(1)

queuedefs(4)  —  File Formats

NAME

queuedefs − Queue description file for at, batch, and cron commands

DESCRIPTION

The queuedefs file describes the characteristics of the queues managed by cron or specifies other characteristics for cron.  Each noncomment line in this file describes either one queue or a cron characteristic.  Each uncommented line should be in one of the following formats. 

q.[njobj][nicen][nwaitw]
max_jobs=mjobs
log=lcode

The fields in these lines are as follows:

qThe name of the queue.  Defined queues are as follows:

aThe default queue for jobs started by at

bThe default queue for jobs started by batch

cThe default queue for jobs run from a crontab file

Queues d to z are also available for local use. 

njobThe maximum number of jobs that can be run simultaneously in the queue; if more than njob jobs are ready to run, only the first njob jobs will be run.  The others will be initiated as currently running jobs terminate. 

niceThe nice(1) value to give to all jobs in the queue that are not run with a user ID of superuser. 

nwait
The number of seconds to wait before rescheduling a job that was deferred because more than njob jobs were running in that queue, or because the system-wide limit of jobs executing (max_jobs) has been reached. 

mjobs
The maximum number of active jobs from all queues that may run at any one time.  The default is 25 jobs.

lcode
Logging level of messages sent to a log file. The default is 4.  Defined levels are as follows:

level-code level
0 None
1 Low
2 Medium
3 High
4 Full

Lines beginning with # are comments, and are ignored. 

EXAMPLES

The following  file specifies that the b queue, for batch jobs, can have up to 50 jobs running simultaneously; that those jobs will be run with a nice value of 20.  If a job cannot be run because too many other jobs are running, cron will wait 60 seconds before trying again to run it.  All other queues can have up to 100 jobs running simultaneously;  they will be run with a nice value of 2.  If a job cannot be run because too many other jobs are running cron will wait 60 seconds before trying again to run it. 

b.50j20n60w

The following file specifies that a total of 25 active jobs will be allowed by cron over all the queues at any one time, and cron will log all messages to the log file. The last two lines are comments that are ignored. 

max_jobs=25
log=4
# This is a comment
# And so is this

FILES

/var/adm/cron
Main cron directory

/var/adm/cron/queuedefs
The default location for the queue description file.

SEE ALSO

Commands: at(1), cron(8), crontab(1), nice(1)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026