Die Datei factory.ini, Abschnitt [job]
[job
job_path]
|
|
|
Für jeden Job kann ein Abschnitt in der factory.ini eingerichtet werden. Die Einträge hier haben Vorrang vor den gleichnamigen Einträgen im Abschnitt [spooler].
Der Pfad des Jobs muss ohne beginnenden Schrägstrich geschrieben werden, z.B. [job my_job] oder [job my_folder/my_job].
|
history |
= yes|no
|
Historie schreiben? |
history_archive |
= yes|no|gzip
|
Historiendateien archivieren? |
history_columns |
= name, name, ...
|
Zusätzliche Spalten in der Historie |
history_file |
= dateiname
|
Dateiname der Historie (für datenbanklosen Betrieb) |
history_on_process |
= yes|no|zahl
|
Nach spooler_process() Historiensatz schreiben? |
history_with_log |
= yes|no|gzip
|
Protokoll in die Historie schreiben? |
log_level |
= log_level
|
Protokollausgaben beschränken |
log_mail_bcc |
= email_address
|
Bcc-Empfänger der eMails |
log_mail_cc |
= email_address
|
Cc-Empfänger der eMails |
log_mail_from |
= email_address
|
Absender der eMails |
log_mail_subject |
= text
|
Betreff der eMails |
log_mail_to |
= email_address
|
To-Empfänger der eMails |
mail_on_delay_after_error |
=
|
Unterdrückung der eMail bei <delay_after_error> |
mail_on_error |
= yes|no
|
Mit Fehler beendete Task verschickt eMail |
mail_on_process |
= yes|no|zahl
|
Task mit spooler_process() verschickt eMail |
mail_on_success |
= yes|no
|
Erfolgreich gelaufende Task verschickt eMail |
mail_queue_dir |
= verzeichnis
|
Verzeichnis der zeitweilig nicht versendbaren eMails |
smtp |
= host_address
|
Hostname oder IP-Nummer des SMTP-Servers für eMail Versand |
Die Einträge
history_file=dateiname
|
Dateiname der Historie (für datenbanklosen Betrieb) |
Der Job Scheduler nimmt einen eigenen Namen, wenn diese Option fehlt. Die Option -log-dir muss gesetzt sein - andernfalls schreibt der Job Scheduler die Datei nicht. In diese Datei wird, wenn die Option history=yes gesetzt ist und der Job Scheduler keine Datenbank verwendet, für jede abgelaufene Task ein Satz geschrieben.
history=yes|no
|
(Initialwert: yes) Historie schreiben?
|
Gibt an, ob eine Task-Historie geschrieben werden soll. Der Job Scheduler schreibt dann für jede Task einen Satz in die Datenbank, oder, wenn der Job Scheduler ohne Datenbank arbeitet, in eine Datei im mit -log-dir angegebenen Verzeichnis.
history_on_process=yes|no|zahl
|
(Initialwert: 0) Nach spooler_process() Historiensatz schreiben?
|
Bei history_on_process=no oder =0 schreibt der Job Scheduler beim Start der Task einen Satz in die Historie, wenn eine geführt wird.
Bei history_on_process=yes oder =1 schreibt der Job Scheduler erst beim ersten Aufruf von spooler_process() den Satz. Damit wird kein Satz geschrieben, wenn spooler_open() false liefert.
Wenn eine Zahl angegeben ist, schreibt der Job Scheduler erst vor der angegebenen Anzahl von Aufrufen von spooler_process() einen Satz in die Historie.
Meldungen
[ERROR] |
SCHEDULER-335 |
Only "yes", "no" and a number are allowed with (1) ="(2) ": error(3)
|
history_with_log=yes|no|gzip
|
(Initialwert: no) Protokoll in die Historie schreiben?
|
Der Job Scheduler kann das Task-Protokoll in die Historie in der Datenbank schreiben, auch mit gzip komprimiert.
Siehe Kommando <show_task what="log">.
history_columns=name, name, ...
|
Zusätzliche Spalten in der Historie |
Eine Task kann mit der Methode Task.set_history_field() die hier angegebenen Felder der Datenbanktabelle für die Task-Historie setzen.
history_archive=yes|no|gzip
|
(Initialwert: no) Historiendateien archivieren?
|
Wenn die Historie in einer Datei, d.h. nicht in einer Datenbank, geführt wird, kann der Job Scheduler die Historien des letzten Job Scheduler Laufs archivieren und mit gzip komprimieren.
log_level=log_level
|
(Initialwert: info) Protokollausgaben beschränken
|
Legt fest, ab welcher Stufe der Job Scheduler Protokollzeilen ausgibt. Jede Protokollzeile ist auf einer der folgenden Stufen: error, warn, info, debug1 bis debug9 (debug1 ist dasselbe wie debug).
mail_on_error=yes|no
|
(Initialwert: no) Mit Fehler beendete Task verschickt eMail
|
mail_on_process=yes|no|zahl
|
(Initialwert: 0) Task mit spooler_process() verschickt eMail
|
Veranlasst den Versand des Task-Protokolls, wenn die Task wenigstens die angegebene Anzahl Schritte, also Aufrufe von spooler_process(), ausgeführt hat. Weil Nicht-API-Tasks keine Schritte haben, zählt der Scheduler für sie immer einen Schritt.
yes entspricht 1, no entspricht 0.
mail_on_success=yes|no
|
(Initialwert: no) Erfolgreich gelaufende Task verschickt eMail
|
mail_on_delay_after_error=
|
(Initialwert: first_and_last_only) Unterdrückung der eMail bei <delay_after_error>
|
Voraussetzung: mail_on_error=yes oder mail_on_warning=yes
Wenn ein Job wegen <delay_after_error> erneut startet, werden mit dieser Einstellungen die zahlreichen eMails reduziert.
-
mail_on_delay_after_error=all - Nach jedem fehlerhaften Job-Lauf wird eine eMail verschickt.
-
mail_on_delay_after_error=first_only - Nur der erste fehlerhafte Lauf veranlasst eine eMail, nicht aber die Wiederholungen.
-
mail_on_delay_after_error=last_only - Nur der letzte fehlerhafte Lauf, der also den Job stoppen lässt, veranlasst eine eMail.
-
mail_on_delay_after_error=first_and_last_only - Nur der erste und der letzte fehlerhafte Lauf veranlassen je eine eMail.
Die Einstellung wirkt nicht, wenn für den Job kein <delay_after_error> angegeben ist (dann gilt mail_on_delay_after_error=all).
mail_queue_dir=verzeichnis
|
Verzeichnis der zeitweilig nicht versendbaren eMails |
eMails, die der Job Scheduler nicht verschicken kann (weil z.B. der SMTP-Server nicht erreichbar ist), werden hier abgelegt.
Um diese eMails später zu verschicken, muss ein Job geschrieben werden, der die Methode Mail.dequeue() aufruft.
Der allgemeine Platz für diese Einstellung ist sos.ini (Abschnitt [mail], Eintrag queue_dir=…).
Umgebungsvariablen (z.B. $HOME) werden ersetzt (siehe hier).
log_mail_subject=text
|
Betreff der eMails |
log_mail_from=email_address
|
Absender der eMails |
log_mail_to=email_address
|
To-Empfänger der eMails |
log_mail_cc=email_address
|
Cc-Empfänger der eMails |
log_mail_bcc=email_address
|
Bcc-Empfänger der eMails |
smtp=host_address
|
Hostname oder IP-Nummer des SMTP-Servers für eMail Versand |
