usr/src/man/man4/queuedefs.4

   1 '\" te
   2 .\" Copyright (c) 1994, Sun Microsystems, Inc.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH QUEUEDEFS 4 "Mar 1, 1994"
   7 .SH NAME
   8 queuedefs \- queue description file for at, batch, and cron
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/etc/cron.d/queuedefs\fR
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fBqueuedefs\fR file describes the characteristics of the queues managed by
  19 \fBcron\fR(1M). Each non-comment line in this file describes one queue. The
  20 format of the lines are as follows:
  21 .sp
  22 .LP
  23 \fIq\fR\fB\&.\fR[\fInjob\fR\fBj\fR][\fBnice\fR\fBn\fR][\fInwait\fR\fBw\fR]
  24 .sp
  25 .LP
  26 The fields in this line are:
  27 .sp
  28 .ne 2
  29 .na
  30 \fB\fIq\fR\fR
  31 .ad
  32 .RS 9n
  33 The name of the queue. \fBa\fR is the default queue for jobs started by
  34 \fBat\fR(1); \fBb\fR is the default queue for jobs started by \fBbatch\fR (see
  35 \fBat\fR(1)); \fBc\fR is the default queue for jobs run from a \fBcrontab\fR(1)
  36 file.
  37 .RE
  38
  39 .sp
  40 .ne 2
  41 .na
  42 \fB\fInjob\fR\fR
  43 .ad
  44 .RS 9n
  45 The maximum number of jobs that can be run simultaneously in that queue; if
  46 more than \fInjob\fR jobs are ready to run, only the first \fInjob\fR jobs will
  47 be run, and the others will be run as jobs that are currently running
  48 terminate.  The default value is  \fB100\fR.
  49 .RE
  50
  51 .sp
  52 .ne 2
  53 .na
  54 \fB\fBnice\fR\fR
  55 .ad
  56 .RS 9n
  57 The \fBnice\fR(1) value to give to all jobs in that queue that are not run with
  58 a user \fBID\fR of super-user.  The default value is \fB2\fR.
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fInwait\fR\fR
  65 .ad
  66 .RS 9n
  67 The number of seconds to wait before rescheduling a job that was deferred
  68 because more than \fInjob\fR jobs were running in that job's queue, or because
  69 the system-wide limit of jobs executing has been reached.  The default value is
  70 \fB60\fR.
  71 .RE
  72
  73 .sp
  74 .LP
  75 Lines beginning with \fB#\fR are comments, and are ignored.
  76 .SH EXAMPLES
  77 .LP
  78 \fBExample 1 \fRA sample file.
  79 .sp
  80 .in +2
  81 .nf
  82 \fB#
  83 #
  84 a.4j1n
  85 b.2j2n90w\fR
  86 .fi
  87 .in -2
  88 .sp
  89
  90 .sp
  91 .LP
  92 This file specifies that the \fBa\fR queue, for \fBat\fR jobs, can have up to 4
  93 jobs running simultaneously; those jobs will be run with a \fBnice\fR value of
  94 1.  As no \fInwait\fR value was given, if a job cannot be run because too many
  95 other jobs are running \fBcron\fR will wait 60 seconds before trying again to
  96 run it.
  97
  98 .sp
  99 .LP
 100 The \fBb\fR queue, for \fBbatch\fR(1) jobs, can have up to 2 jobs running
 101 simultaneously; those jobs will be run with a \fBnice\fR(1) value of 2.  If a
 102 job cannot be run because too many other jobs are running, \fBcron\fR(1M) will
 103 wait 90 seconds before trying again to run it. All other queues can have up to
 104 100 jobs running simultaneously; they will be run with a \fBnice\fR value of 2,
 105 and if a job cannot be run because too many other jobs are running \fBcron\fR
 106 will wait 60 seconds before trying again to run it.
 107
 108 .SH FILES
 109 .sp
 110 .ne 2
 111 .na
 112 \fB\fB/etc/cron.d/queuedefs\fR\fR
 113 .ad
 114 .RS 25n
 115 queue description file for  \fBat\fR, \fBbatch\fR, and  \fBcron\fR.
 116 .RE
 117
 118 .SH SEE ALSO
 119 .sp
 120 .LP
 121 \fBat\fR(1), \fBcrontab\fR(1), \fBnice\fR(1), \fBcron\fR(1M)