Add DuplicateJobProximity info

[bacula/docs] / docs / manuals / en / main / dirdconf.tex

diff --git a/docs/manuals/en/main/dirdconf.tex b/docs/manuals/en/main/dirdconf.tex
index 0f270da1e7164581baef71133f70942c4e996cd6..7178d79f8e3b788a4326a10fa1e5dc4cc23b8f50 100644 (file)
--- a/docs/manuals/en/main/dirdconf.tex
+++ b/docs/manuals/en/main/dirdconf.tex
@@ -966,8 +966,13 @@ during working hours. We can see it like \texttt{Max Start Delay + Max Run
    when the job starts, ({\bf not} necessarily the same as when the job was
    scheduled). This directive works as expected since bacula 2.3.18.
 
-\addcontentsline{lof}{figure}{Job time control directives}
-\includegraphics{\idir different_time.eps}
+\begin{figure}[htbp]
+  \centering
+  \includegraphics[width=13cm]{\idir different_time.eps}
+  \caption{Job time control directives}
+  \label{fig:differenttime}
+\end{figure}
+
 
 \item [Max Full Interval = \lt{}time\gt{}]
 \index[dir]{Max Full Interval}
@@ -1650,6 +1655,58 @@ RunScript {
    job.  If it is set to zero (the default) the job will be rescheduled an
    indefinite number of times.
 
+\item [Allow Duplicate Jobs = \lt{}yes\vb{}no\gt{}]
+\index[general]{Allow Duplicate Jobs}
+
+\begin{figure}[htbp]
+  \centering
+  \includegraphics[width=13cm]{\idir duplicate-real.eps}
+  \caption{Allow Duplicate Jobs usage}
+  \label{fig:allowduplicatejobs}
+\end{figure}
+
+A duplicate job in the sense we use it here means a second or subsequent job
+with the same name starts.  This happens most frequently when the first job
+runs longer than expected because no tapes are available.
+
+  If this directive is enabled duplicate jobs will be run.  If
+  the directive is set to {\bf no} (default) then only one job of a given name
+  may run at one time, and the action that Bacula takes to ensure only
+  one job runs is determined by the other directives (see below).
+ 
+  If {\bf Allow Duplicate Jobs} is set to {\bf no} and two jobs
+  are present and none of the three directives given below permit
+  cancelling a job, then the current job (the second one started)
+  will be cancelled.
+
+\item [Allow Higher Duplicates = \lt{}yes\vb{}no\gt{}]
+\index[general]{Allow Higher Duplicates}
+  If this directive is set to {\bf yes} (default) the job with a higher
+  priority (lower priority number) will be permitted to run, and
+  the current job will be cancelled.  If the
+  priorities of the two jobs are the same, the outcome is determined by
+  other directives (see below).
+
+\item [Cancel Queued Duplicates = \lt{}yes\vb{}no\gt{}]
+\index[general]{Cancel Queued Duplicates}
+  If {\bf Allow Duplicate Jobs} is set to {\bf no} and
+  if this directive is set to {\bf yes} any job that is
+  already queued to run but not yet running will be canceled.
+  The default is {\bf no}. 
+
+\item[Cancel Running Duplicates = \lt{}yes\vb{}no\gt{}]
+\index[general]{Cancel Running Duplicates}
+  If {\bf Allow Duplicate Jobs} is set to {\bf no} and
+  if this directive is set to {\bf yes} any job that is already running
+  will be canceled.  The default is {\bf no}.
+
+
+\item[DuplicateJobProximity = \lt{}time-specification\gt{}]
+\index[general]{Duplicate Job Proximity}
+  This directive permits to determine if two jobs are really duplicated.
+  If the first one is running for long time, this is probably not a good
+  idea to cancel it.
+
 \item [Run = \lt{}job-name\gt{}]
    \index[dir]{Run}
    \index[dir]{Directive!Run}