Zschimmer GmbH Impressum und Kontakt

Scheduler     Erste Seite   –   Konfiguration in XML

  XML     API     Register


logo

XML-Element  <period>    (Konfiguration)

<period
absolute_repeat  = "hh:mm[:ss] | seconds"
begin  = "hh:mm[:ss]"
end  = "hh:mm[:ss]"
let_run  = "yes_no"
repeat  = "hh:mm[:ss] oder sekunden"
single_start  = "hh:mm[:ss]"
when_holiday  = "" Umgang mit Feiertagen
/>

 

Eine Periode gibt an, wann ein Job laufen darf. Sie kann einen Zeitraum innerhalb eines Tages umfassen (Attribute begin und end) oder einen Zeitpunkt (Attribut single_start).

Eltern-Elemente

<run_time>  

  – Laufzeiten

Attribute

begin="hh:mm[:ss]"   (Initialwert: 00:00)    

Ab dieser Uhrzeit darf der Job laufen.

end="hh:mm[:ss]"   (Initialwert: 24:00)    

Um diese Zeit endet die Periode. Wenn dann let_run="no" gesetzt ist und keine weitere Periode gilt, beendet der Scheduler laufende Tasks (durch Aufruf von spooler_close()).

repeat="hh:mm[:ss] oder sekunden"  

Der Job wird, wenn er nicht schon läuft, zu Beginn der Periode gestartet. Nach Jobende soll der Scheduler den Job nach ablauf der angegebenen Zeit erneut starten, soweit die <run_time> das zulässt. Die Wiederholung kann im Format hh:mm oder hh:mm:ss oder in Sekunden angegeben werden.

Kann nicht mit dem Attribut single_start= kombiniert werden.

Bei repeat="0" wird der Job nicht wiederholt (default).

absolute_repeat="hh:mm[:ss] | seconds"  

Der Job wird, wenn er nicht schon läuft, zu Beginn der Periode gestartet. Danach wird er zu den Zeitpunkten gestartet, die sich aus den Vielfachen von absolute_repeat nach begin errechnen. Die Wiederholung kann im Format hh:mm oder hh:mm:ss oder in Sekunden angegeben werden.

Kann nicht mit dem Attribut single_start= kombiniert werden.

Beispiel  

<period begin="13:00" end="15:00" absolute_repeat="00:30"/>

lässt den Job um 13:00, 13:30, 14:00 und 14:30 starten.

single_start="hh:mm[:ss]"  

Der Job soll zu der angegebenen Uhrzeit starten.

Nicht zusammen mit den Attributen begin=, end= und repeat= zu verwenden.

let_run="yes_no"  

Das Attribut kann nur für Jobs, nicht für Aufträge angegeben werden. Für auftragsgesteuerte Jobs sollte Einstellung let_run="no" eingestellt werden.

let_run="yes" gibt an, dass der Scheduler die Task weiterlaufen lassen soll, auch wenn die <run_time> das eigentlich nicht mehr zulässt.

Bei let_run="no" beendet der Scheduler die Task (ruft also nicht mehr spooler_process, sondern spooler_close auf), sobald die <run_time> nicht mehr gilt.

when_holiday=""   Umgang mit Feiertagen

Normalerweise wird eine Periode, die auf einen Feiertag <holidays> fällt, unterdrückt. Aber es gibt noch weitere Möglichkeiten.

when_holiday="suppress"

Voreinstellung. Wenn die Periode auf einen Feiertag fällt, wird sie unterdrückt.

when_holiday="ignore_holiday"

Wenn die Periode auf einen Feiertag fällt, wird sie nicht unterdrückt.

when_holiday="previous_non_holiday"

Wenn die Periode auf einen Feiertag fällt, wird sie auf den vorangehenden Nicht-Feiertag verschoben.

when_holiday="next_non_holiday"

Wenn die Periode auf einen Feiertag fällt, wird sie auf den nachfolgenden Nicht-Feiertag verschoben.


Software- und Organisations-Service GmbH

Zuletzt geändert von Joacim Zschimmer, 2008-07-07