Syntax für den Planausdruck
Der Planausdruck wird zur Definition des Plans für den auszuführenden Job verwendet. Der Planausdruck wird mithilfe der CRON-Syntax definiert.
Die Syntax für den Jobplaner-Befehl besteht aus den folgenden 5 Pflichtfeldern und einem, durch Leerstelle abgetrennten, optionalen Feld:
Feldname | Zulässige Werte | Zulässige Sonderzeichen |
---|---|---|
Minuten | 0-59 | , - * / |
Stunden | 0-24 | , - * / |
Tag des Monats | 0-31 | , - * ? / L W |
Monat | 0-12 oder JAN-DEZ | , - * / |
Wochentag | 1-7 oder SON-SAM | , - * ? L # |
Jahr (optional) | NULL oder 1970 - 2199 | , - * / |
Die folgenden Sonderzeichen können in der Syntax des Planausdrucks verwendet werden:
Sonderzeichen | Verwendung |
---|---|
Komma (,) | Dieses Zeichen wird zur Angabe zusätzlicher Werte verwendet. Beispiel: Wenn im Feld "Tag der Woche" "MON,MIT,FRE" angegeben ist, sind das entsprechend die Tage Montag, Mittwoch und Freitag. |
Bindestrich (-) | Dieses Zeichen wird zur Angabe eines Bereichs verwendet. Beispiel: Wenn im Stundenfeld "10-12" angegeben ist, sind das entsprechend die Stunden 10, 11 und 12. |
Sternchen (*) | Dieses Zeichen wird zur Angabe aller Werte verwendet. Beispiel: Wenn im Minutenfeld "*" angegeben ist, werden alle Minuten berücksichtigt. |
Schräger (/) | Dieses Zeichen wird zur Angabe von Schritten verwendet. Beispiel: Wenn im Sekundenfeld "0/15" angegeben ist, dann sind die Sekunden 0, 15, 30, 45 und 60 gemeint. Wenn im Sekundenfeld "5/15" angegeben ist, sind entsprechend die Sekunden 5, 20, 35 und 50 gemeint. Die Angabe "*/..." entspricht der Angabe "Erste(r/s)-Letzte(r/s)/...", also einem Schritt über den größtmöglichen Bereich des Feldes. |
Fragezeichen (?) | Dieses Zeichen wird in den Feldern "Tag des Monats" und "Tag der Woche" verwendet. Wird zur Angabe "keines bestimmten Wertes" verwendet, oder wenn eines der beiden Felder belegt werden muss, das andere jedoch nicht. Um beispielsweise die Syntax an einem bestimmten Tag des Monats (dem 10.), aber nicht an einem bestimmten Wochentag auszuführen, geben Sie "10" in das Feld "Tag des Monats" und "?" in das Feld "Tag der Woche" ein. |
L (Letzte(r/s)) | Dieses Zeichen wird in den Feldern "Tag des Monats" und "Tag der Woche" verwendet. Wenn Sie bspw. "L" in das Feld "Tag des Monats" eingeben, wird damit der letzte Tag des Monats festgelegt. Wenn "L" im Feld "Tag der Woche" eingegeben wird, bezeichnet das den Tag "7" bzw. "SAM". Wird dagegen "L" im Feld "Tag der Woche" nach einem anderen Wert eingegeben, dann hat das die Bedeutung "der letzte Tag XXX des Monats. So bedeutet zum Beispiel "6L" "der letzte Freitag im Monat". Wenn Sie "L" verwenden, dürfen Sie keine Listen oder Wertebereiche angeben. |
W | Wird im Feld "Tag des Monats" verwendet, um den Wochentag anzugeben, der dem angegebenen Tag am nächsten liegt. Wenn Sie bspw. "15W" in das Feld "Tag des Monats" eingeben, hat das die Bedeutung "Tag, der dem 15. des Monats am nächsten liegt". Wenn der 15. Tag des Monats ein Samstag ist, bezeichnet dies den 14. Tag des Monats. Wenn der 15. Tag auf einen Sonntag fällt, den 16. Tag des Monats. |