JobScheduler - Quickstart - Sos-berlin.com

JobScheduler - Job Execution and Scheduling System 

JobScheduler - Quickstart 

Einstieg in das Job Scheduling 

März 2013 

März 2013 JobScheduler - Quickstart Seite: 1 

Software Open Source

JobScheduler - Quickstart - Impressum 

Impressum 

Software- und Organisations-Service GmbH 

Giesebrechtstr. 15 

D-10629 Berlin 

Germany 

Telefon +49 (0)30 86 47 90-0 

Telefax +49 (0)30 8 61 33 35 

Mail info@sos-berlin.com 

Web http://www.sos-berlin.com 

Letzte Aktualisierung: 03/15/2013 12:03 PM 

Diese Dokumentation basiert auf der JobScheduler Version 1.3.12.3072. 

Copyright © 2005-2013 SOS GmbH Berlin. 


Software Open Source 

All rights reserved. All trademarks or registered trademarks are the property of their respective holders. Alle 

Informationen in diesem Dokument können ohne vorherige Ankündigung verändert werden. 

This product includes software developed by the Apache Software Foundation (http://apache.org/) 

We would appreciate any feedback you have, or suggestions for changes and improvements; please forward your 

comments to info@sos-berlin.com.

JobScheduler - Quickstart - Inhaltsverzeichnis 

Inhaltsverzeichnis 


1 Einleitung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

1.1 Grundlagen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 

2 Wie werden Jobs, Job-Ketten oder Aufträge konfiguriert? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5 

3 Vorbereitungen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 

4 JobScheduler Objekte einrichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

4.1 Einen Job einrichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

4.1.1 Einen Standalone-Job einrichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 

4.1.2 Einen Auftrags-Job einrichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 

4.2 Eine Job-Kette einrichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 

4.3 Einen Auftrag einrichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18 

5 Zeitgesteuertes Starten eines Jobs oder eines Auftrags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22 

6 Verzeichnis-Überwachung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 

6.1 Starten einer Job-Kette per Verzeichnis-Überwachung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 

6.2 Starten eines Standalone-Jobs per Verzeichnis-Überwachung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 

7 Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 

7.1 Parameter am Job bzw. am Auftrag setzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27 

7.2 Parameter in einem Shell-Skript lesen und setzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 

8 Fehler-Behandlung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 

8.1 Verhalten gestoppter Auftrags-Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 

8.2 Verhalten gestoppter Standalone-Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 

8.3 Fehler-Behandlung in Job-Ketten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 

8.3.1 Auftrag erreicht sofort das Ende der Job-Kette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31 

8.3.2 Auftrag startet bestimmten Folge-Job der Job-Ketten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 

8.3.3 Automatisches Wiederholen eines fehlerhaft verarbeiteten Auftrags (setback) . . . . . . . . . . . . . . . . . . . . . . . . .32 

8.3.4 Verarbeitung des Auftrags wird ausgesetzt (suspend) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35 

8.4 Fehler-Behandlung bei Standalone-Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 

8.4.1 Automatisches Wiederholen eines fehlerhaften Standalone-Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 

9 Überblick der Dokumentationen des JobScheduler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 

9.1 Installation und Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 

9.2 Implementierung von Jobs mit der JobScheduler API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

9.3 Fortgeschrittene Themen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40 

10 Glossar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 

11 Stichwortverzeichnis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 

März 2013 JobScheduler - Quickstart Seite: 3

JobScheduler - Quickstart - Einleitung 

1 Einleitung 

Der JobScheduler ist installiert und konnte gestartet werden. Was nun? 


Die folgenden Beispiele sollen einen kompakten und schnellen Einstieg in die Anwendung des JobScheduler 

liefern. 

1.1 Grundlagen 

Bevor Sie mit den Beispiele dieses Dokuments beginnen, sollten Sie Kenntnisse der anderen JobScheduler 

Dokumentationen haben, insbesondere die Installations- und Konfigurationsbeschreibung (scheduler_installation). 

Eine kurze Übersicht der JobScheduler Dokumentationen (Seite 40) finden Sie am Ende dieses Dokuments. 


JobScheduler - Quickstart - Wie werden Jobs, Job-Ketten oder Aufträge konfiguriert? 

2 Wie werden Jobs, Job-Ketten oder Aufträge konfiguriert? 



Ein JobScheduler Objekt (Jobs, Job-Ketten, Aufträge, Schedules, Prozess-Klassen, Sperren) wird durch eine 

Datei im XML-Format konfiguriert. Die JobScheduler Objekte werden im Hot Folder (per Voreinstellung das 

Verzeichnis ./config/live) gespeichert. In diesem Verzeichnis wird jedes JobScheduler Objekt durch genau 

eine einzelne Datei repräsentiert. Die Datei enthält die Konfiguration dieses Objekts. 

Änderungen der Konfigurationsdateien werden ohne Neustart des JobScheduler wirksam, wenn gleich es unter 

Unix mitunter eine Minute dauern kann, bis die Änderungen wirksam werden. 

Ein Objekt kann mit JOE (JobScheduler Object Editor) angelegt und bearbeitet werden. Hierzu wird eine 

bestehende Konfigurationsdatei in JOE geöffnet, oder es wird eine neue Konfigurationsdatei angelegt. 

Sie können aber auch jeden beliebigen Text-Editor benutzen, um ein Objekt anzulegen oder zu bearbeiten, jedoch 

muss man hierbei die XML-Struktur der JobScheduler Objekte genau kennen (siehe Referenzdokumentation).

JobScheduler - Quickstart - Vorbereitungen 

3 Vorbereitungen 



1. Legen Sie unterhalb des Hot Folder ( ./config/live ) das Verzeichnis quickstart an. Hier werden im 

folgenden die Jobs und Job-Ketten angelegt. 

2. Starten Sie JOE (JobScheduler Object Editor) mit dem Skript: 

• %SCHEDULER_HOME% \bin\jobeditor.cmd ( Windows ) 

• $SCHEDULER_HOME /bin/jobeditor.sh ( Unix ) 

3. Nutzen Sie die Tastenkombination ctrl+D , um den Hot Folder in JOE zu öffnen. Sie öffnen diesen Dialog 

auch über das Menü Datei->Open Hot Folder oder mit dem roten Ordner-Symbol. Der Hot Folder sollte 

bereits ausgewählt sein, anderenfalls navigieren Sie bitte nach ./config/live . Wählen Sie unterhalb davon 

den Ordner quickstart aus. Gegebenenfalls können Sie auch in diesem Dialog das Unterverzeichnis 

quickstart anlegen. 

4. Öffnen Sie JOC (JobScheduler Operations Center) . In JOC können Sie gleichzeitig die Änderungen 

verfolgen. Sie öffnen JOC im Browser mit http://[scheduler_host]:[scheduler_port] , wobei 

[scheduler_host] und [scheduler_port] der Hostname und die Nummer des TCP Ports des 

JobScheduler sind (z.B. http://localhost:4444 ). Der JobScheduler muss hierfür gestartet sein.

JobScheduler - Quickstart - JobScheduler Objekte einrichten 

4 JobScheduler Objekte einrichten 

4.1 Einen Job einrichten 

Es gibt Standalone-Jobs und Auftrags-Jobs. 

Die Vorbereitungen (Seite 6) sind abgeschlossen? Dann kann es ja weitergehen. 


• Standalone-Jobs können unabhängig von anderen Jobs gestartet werden, dürfen aber nicht in einer 

Job-Kette eingesetzt werden. 

• Auftrags-Jobs werden einer Job-Kette verwendet und in ihr durch Aufträge der Job-Kette gestartet. 

Standalone- und Auftrags-Jobs unterscheiden sich in ihrer Konfiguration durch das Attribut order= "yes|no". 

4.1.1 Einen Standalone-Job einrichten 

Klicken Sie links im Baum der JobScheduler Objekte auf Jobs und dann rechts auf New Standalone Job . Ein neuer 

Job taucht in der Liste der Jobs und linken Baum auf. Klicken Sie diesen an. 

Es wird ein leeres Job-Konfigurationselement geöffnet. Tragen Sie im Feld Job Name zum Beispiel firstJob ein. 

Man beachte, dass bei einem Standalone-Job der Radiobutton Order Job (rechts neben dem Namen) auf No 

gesetzt ist. Diese Einstellung unterscheidet einen Standalone-Job von einem Auftrags-Job hinsichtlich der 

Konfiguration. Überdies ist die Checkbox Stop On Error aktiviert (siehe auch Fehler-Behandlung (Seite 31)). 

Geben Sie in dem Source Code-Textfeld zum Beispiel folgendes Shell-Skript ein: 



@echo off 

echo %SCHEDULER_JOB_NAME% is running echo Current Timestamp: %DATE% %TIME% 

exit %ERRORLEVEL% 

Beispiel: für Windows: 

#!/bin/sh 

echo "$SCHEDULER_JOB_NAME is running" 

echo "Current Timestamp: `date`" 

exit $? 

Beispiel: für Unix: 


Dem Job könnte noch eine feste Startzeit (Seite 22) oder Parameter (Seite 27) zugewiesen werden. 

Speichern Sie jetzt die Konfiguration, indem sie die Tastenkombination ctrl+S nutzen oder auf Datei->Save 

klicken. _JOE legt die Datei ./config/live/quickstart/firstJob.job.xml an. 





Aktualisieren Sie JOC mit dem oben befindlichen Update -Button. In der Registerkarte Jobs sehen Sie jetzt den Job 

quickstart/firstJob. Klicken Sie auf den Job, um im rechten Frame des Browsers eine Detail-Ansicht des Jobs 

zu erhalten. Starten sie eine Task des Jobs, indem Sie auf Job menu ->Start task immediately klicken. 

Jetzt startet die Task. Sehen Sie sich das Task-Protokoll in der Task Historie an, indem Sie auf Show log klicken.


Die Vorbereitungen (Seite 6) sind fertig? Dann kann es ja weitergehen. 


Es öffnet sich ein weiteres Browser-Fenster mit der Protokoll-Ausgabe. Hier sehen Sie unter anderem die Ausgabe 

des Skripts. 

Herzlichen Glückwunsch! 

Sie haben einen Standalone-Job erfolgreich eingerichtet und ausgeführt. 

4.1.2 Einen Auftrags-Job einrichten 

Klicken Sie links im Baum der JobScheduler Objekte auf Jobs und dann rechts auf New Order Job . Ein neuer Job 

taucht in der Liste der Jobs und im linken Baum auf. Klicken Sie diesen an. 

Es wird ein leeres Job-Konfigurationselement geöffnet. Tragen Sie im Feld Job Name zum Beispiel firstOrderJob 

ein. Man beachte, dass bei einem Auftrags-Job der Radiobutton Order Job (rechts neben dem Namen) auf Yes 

gesetzt ist. Diese Einstellung unterscheidet einen Auftrags-Job von einem Standalone-Job hinsichtlich der 

Konfiguration. Überdies ist die Checkbox Stop On Error deaktiviert (siehe auch Fehler-Behandlung (Seite 31)). 

Geben Sie in dem Source Code-Textfeld zum Beispiel folgendes Shell-Skript ein: 



@echo off 

echo %SCHEDULER_JOB_NAME% processed %SCHEDULER_ORDER_ID% 

echo Current Timestamp: %DATE% %TIME% 



#!/bin/sh 

echo "$SCHEDULER_JOB_NAME processed $SCHEDULER_ORDER_ID" 


exit $? 


Dem Job könnte noch ein Startzeitraum (Seite 22) oder Parameter (Seite 27) zugewiesen werden. 




klicken. _JOE legt die Datei ./config/live/quickstart/firstOrderJob.job.xml an.



Aktualisieren Sie JOC mit dem oben befindlichen Update -Button. In der Registerkarte Jobs sehen Sie jetzt den Job 

quickstart/firstOrderJob. Klicken Sie auf den Job, um im rechten Frame des Browsers eine Detail-Ansicht des 

Jobs zu erhalten. Im Job menu ist die Funktion Start task immediately deaktiviert, da Auftrags-Jobs nur durch 

Aufträge innerhalb einer Job-Kette gestartet werden können. 


Sie haben einen Auftrags-Job erfolgreich eingerichtet. 

4.2 Eine Job-Kette einrichten 

Job-Ketten definieren eine Abfolge von Jobs, deren Ausführung durch einen Auftrag ausgelöst wird. Sie definieren 

Job-Abhängigkeiten für die erfolgreiche und fehlerhafte Ausführung. Die der Job-Ketten zugewiesenen Jobs 

müssen Auftrags-Jobs sein. Genau genommen besitzt eine Kette Knoten, denen Jobs zugewiesen werden können. 

Am Ketten-Knoten wird bestimmt, welcher Folge-Knoten den Auftrag weitergereicht bekommt, wenn der aktuelle 

Job erfolgreich beziehungsweise fehlerhaft beendet wurde. Hat dieser Folge-Knoten einen Job, dann wird dieser 

Job gestartet, anderenfalls hat der Auftrag das Ende der Kette erreicht. Bei einem fehlerhaften Job kann überdies 

konfiguriert werden, dass der Auftrag am dem aktuellen Knoten stehen bleibt oder den Job erneut (verzögert) 

startet. Auftrags-Jobs sollten mit deaktiviertem Stop On Error (Seite 10) konfiguriert sein, damit weitere Aufträge 

trotz fehlerhaften Laufs verarbeitet werden können. 

Sie haben obigen Auftrags-Job (Seite 10) bereits angelegt? Wiederholen Sie bitte den Vorgang für einen zweiten 

Auftrags-Job, damit wir der Job-Kette zwei verschiedene Jobs übergeben können. Der zweite Auftrags-Job soll den 

Namen secondOrderJob und die folgende Implementierung haben. 



@echo off 


dir .\config\live\quickstart 



#!/bin/sh 


ls -l ./config/live/quickstart 

exit $? 


Dann kann es jetzt weitergehen. 



Klicken Sie links in der Liste der JobScheduler Objekte auf Job Chains und dann rechts auf New Job Chain . Eine 

neue Job-Kette taucht in der Liste der Job-Ketten und im linken Baum auf. Klicken Sie diese an. 

Es wird ein leeres Job-Ketten-Konfigurationselement geöffnet. Tragen Sie im Feld Chain Name zum Beispiel 

firstJobChain ein.




Wechseln Sie im linken Baum unterhalb der Job-Kette auf Nodes. Durch New Chain Node werden der Kette Knoten 

hinzugefügt, denen Auftrags-Jobs zugewiesen werden können. Wir wollen der Kette zwei Knoten hinzufügen. 

Jeder Knoten braucht innerhalb der Kette einen eindeutigen State. Dieser sei für den ersten Knoten step1. An dem 

Knoten soll der Job firstOrderJob ausgeführt werden. Next State und Error State bestimmen, an welchen Knoten 

der Auftrag weitergereicht wird, wenn der Job erfolgreich beziehungsweise fehlerhaft beendet wurde. Setzen Sie 

hier für den ersten Knoten zum Beispiel step2 und error. 

Fügen Sie einen zweiten Knoten mit step2 als State, secondOrderJob als Job, success als Next State und error 

als Error State hinzu.




Zu jeden Wert von Next State oder Error State muss es in der Kette einen Knoten geben. Zur Zeit fehlen demnach 

noch die Knoten success und error. Fehlende Knoten werden gelb dargestellt. Diese lassen sich leicht durch 

Klicken auf den Button Add Missing Nodes ergänzen. Selektieren Sie zuvor den Knoten in der Liste, dessen fehlende 

Knoten Sie ergänzt haben wollen. In unserem Beipiel wählen Sie bitte den Knoten mit dem State step2.


Die so erzeugten Knoten besitzen keinen Job. Hier endet die Kette. 




klicken. _JOE legt die Datei ./config/live/quickstart/firstJobChain.job_chain.xml an. 

Ein Auftrag der Kette startet den Job quickstart/firstOrderJob, dann den Job quickstart/secondOrderJob 

und endet im Knoten success, falls die Jobs erfolgreich gelaufen sind. Sobald ein Job fehlerhaft ist, endet der 

Auftrag im Knoten error.




Aktualisieren Sie JOC mit dem oben befindlichen Update -Button. In der Registerkarte Job Chains sehen Sie jetzt 

die Job-Kette quickstart/firstJobChain. Klicken Sie auf die Job-Kette, um im rechten Frame des Browsers 

eine Detail-Ansicht der Job-Kette zu erhalten. Fügen Sie der Job-Kette einen Auftrag hinzu, indem Sie auf 

Job chain menu ->Add order klicken. Wenn Sie dem Auftrag keine Order Id vergeben, dann vergibt der 

JobScheduler dem Auftrag selbstständig eine Zahl als Id. 

Während der Auftrag noch durch die Kette wandert, können Sie sich das Protokoll durch Order menu ->Show log 

oder in der Auftrags-Historie (Checkbox Show order history muss aktiviert sein) ansehen.


Sie haben obige Job-Kette (Seite 12) angelegt? Dann kann es ja weitergehen. 


Es öffnet sich ein neues Browser-Fenster mit dem Protokoll. Hier sehen Sie unter anderem die Ausgabe der 

Skripte. 


Sie haben eine Job-Kette erfolgreich eingerichtet und einen Auftrag hinzugefügt. 

4.3 Einen Auftrag einrichten 

Sie können einer Job-Kette jederzeit manuell Aufträge hinzufügen. Diese Aufträge sind aber nicht persistent. 

Wollen Sie einem Auftrag zum Beispiel eine Zeitsteuerung zuweisen, so müssen Sie einen persistenten Auftrag 

anlegen. Überdies kann ein Auftrag gegebenenfalls Parameter (Seite 27) enthalten. 





Klicken Sie links in der Liste der JobScheduler Objekte auf Orders und dann rechts auf New Order . Ein neuer 

Auftrag taucht in der Liste der Aufträge und im linken Baum auf. Klicken Sie diese an.




Es wird ein leeres Auftrags-Konfigurationselement geöffnet. Tragen Sie im Feld Order ID zum Beispiel firstOrder 

ein und weisen Sie ihm im Feld Job Chain die Job-Kette firstJobChain zu. 


klicken. _JOE legt die Datei ./config/live/quickstart/firstJobChain,firstOrder.order.xml an.




Aktualisieren Sie JOC mit dem oben befindlichen Update -Button. Navigieren Sie zur Detail-Ansicht der Job-Kette 

quickstart/firstJobChain wie oben beschrieben. Hier sehen Sie jetzt den Auftrag, welchen Sie über Order menu 

->Start order now starten können. Überdies finden Sie den Auftrag auch in der Registerkarte Orders. 

Das Protokoll wird gegenüber obigen Hinzufügens eines Auftrags nichts neues liefern. 


Sie haben einen Auftrag erfolgreich eingerichtet und gestartet.

JobScheduler - Quickstart - Zeitgesteuertes Starten eines Jobs oder eines Auftrags 

5 Zeitgesteuertes Starten eines Jobs oder eines Auftrags 


Da Auftrags-Jobs durch Aufträge der Job-Kette gestartet werden, ist es nicht sinnvoll, für Auftrags-Jobs Startzeiten 

festzulegen. Die Startzeiten legt man in diesem Fall am Auftrag fest. 

Man kann jedoch Auftrags-Jobs ein Zeitfenster zuweisen. Wenn ein Auftrag außerhalb dieses Zeitfensters den 

Auftrags-Job starten möchte, wird dieser Auftrag eingereiht und erst zu Beginn des Zeitfensters ausgeführt. 

In diesem Beispiel soll ein Standalone-Job oder Auftrag täglich um 12:00 Uhr und um 14:00 Uhr gestartet werden. 

In JOE finden Sie im linken Baum unterhalb jedes Jobs und Auftrags die Funktion Run Time->Everyday. Mit dem 

Button New Period fügen Sie eine neue Zeitsteuerung hinzu, die Sie mit dem Button Apply Period speichern, nach 

dem Sie Single Start 12:00:00 im Feld Start Time gesetzt haben. Wiederholen Sie den Vorgang mit Single 

Start 14:00:00. 

Neben festen Startzeiten (Single Start) können auch Wiederholintervalle (Intervall end/start, Intervall 

start/start) angegeben werden. 

Standalone-Jobs und Aufträge können trotz einer Zeitsteuerung jederzeit manuell gestartet werden. Bei 

Standalone-Jobs kann die Zeitsteuerung mit einer Verzeichnis-Überwachung (Seite 26) kombiniert werden. 


JobScheduler - Quickstart - Verzeichnis-Überwachung 

6 Verzeichnis-Überwachung 

6.1 Starten einer Job-Kette per Verzeichnis-Überwachung 


Wann immer in einem überwachten Verzeichnis eine Datei hinzugefügt wird, wird für die entsprechende Job-Kette 

ein Auftrag erzeugt. Die Auftrags-ID ist der Dateiname der hinzugefügten Datei. Es kann ein Filter angegeben 

werden, der die Überwachung auf bestimmte Dateinamen einschränkt. 

In diesem Beispiel wird das Verzeichnis ./notification_dir überwacht. Es sollen ausschließlich Dateien mit der 

Dateierweiterung txt berücksichtigt werden. 

Zunächst wollen wir in JOE die oben eingerichtete Job-Kette (Seite 12) kopieren. Hierzu gibt es Copy und Paste 

Funktionen im Kontextmenu der Objekte im linken Baum. 

Wählen Sie die neue Kette im Baum aus und benennen Sie sie im Feld Chain Name um (z.B. fileOrderJobChain 

). 





Wechseln Sie im linken Baum unterhalb der Job-Kette auf Nodes. Im Bereich File Order Sources können Sie mit 

dem Button New File Order Source ein zu überwachendes Verzeichnis hinzufügen, das Sie mit dem Button 

Apply File Order Source der Kette übergeben, nachdem Sie in den Feldern Directory und Regex die Werte 

notification_dir und \.txt$ eingegeben haben. Wiederholen Sie den Vorgang, falls Sie weitere Verzeichnisse 

oder Muster hinzufügen wollen.




Wenn die auftragserzeugende Datei am Ende der Job-Ketten-Verarbeitung noch immer im überwachten 

Verzeichnis vorhanden ist, dann merkt sich der JobScheduler das in einer Blacklist, um sicherzustellen, dass 

diese Datei keinen weiteren Auftrag erzeugt. 

Sie sollten entweder durch einen Job der Kette die Datei aus dem überwachten Verzeichnis entfernen oder der 

Kette eine Datei-Senke hinzufügen. Datei-Senken löschen oder verschieben die auftragserzeugende Datei. Im 

folgenden Beispiel soll die Datei am success-Knoten gelöscht und am error-Knoten verschoben werden. Klicken 

Sie in der Knotenliste auf den success-Knoten, aktivieren Sie den File Sink Radiobutton und aktivieren Sie die 

Checkbox Remove File. Übernehmen Sie die Änderungen mit Apply Chain Node . Wiederholen Sie den Vorgang für 

den error-Knoten, jedoch geben Sie hier im Feld Move to das Verzeichnis an, in das die Datei verschoben werden 

soll. 

Legen Sie das Verzeichnis ./notification_dir an. Kopieren Sie nun eine Datei mit txt-Dateierweiterung in das 

Verzeichnis und sehen Sie sich in JOC das Protokoll in der Auftrags-Historie der Job-Kette 

quickstart/fileOrderJobChain an.


6.2 Starten eines Standalone-Jobs per Verzeichnis-Überwachung 


Wann immer in einem überwachten Verzeichnis eine Datei hinzugefügt oder gelöscht wird, wird der entsprechende 

Standalone-Job automatisch gestartet. Es kann ein Filter angegeben werden, der die Überwachung auf bestimmte 

Dateinamen einschränkt. 

In diesem Beispiel wird das Verzeichnis ./notification_dir überwacht. Es sollen ausschließlich Dateien mit der 

Dateierweiterung txt berücksichtigt werden. 

Verzeichnis überwachende Standalone-Jobs können auch jederzeit manuell gestartet werden. Die 

Verzeichnis-Überwachung ist auch mit einer Zeitsteuerung (Seite 22) kombinierbar. 

In JOE finden Sie im linken Baum unterhalb jedes Jobs die Funktion Run Options. Im Bereich Start When Directory 

Changed können Sie mit dem Button New Dir ein zu überwachendes Verzeichnis hinzufügen, das Sie mit dem 

Button Apply Dir speichern, nachdem Sie in den Feldern Watch Directory und File Regex die Werte 

notification_dir und \.txt$ eingegeben haben. Wiederholen Sie den Vorgang, falls Sie weitere Verzeichnisse 

oder Muster hinzufügen wollen. 

Auftrags-Jobs mit Verzeichnis-Überwachung machen keinen Sinn, jedoch gibt es auch für Job-Ketten eine 

Verzeichnis-Überwachung (Seite 23). 


JobScheduler - Quickstart - Parameter 

7 Parameter 

Parameter können am Job, am Auftrag und am Job-Ketten-Knoten formuliert werden. 


Wenn Sie Jobs mit der JobScheduler API programmieren, dann sind Job-Parameter und Auftrags-Parameter 

unterschiedliche Objekte. Knoten-Parameter und Auftrags-Parameter bilden das gleiche Objekt. Hierbei haben 

Knoten-Parameter Vorrang gegenüber etwaigen gleichnamigen Auftrags-Parametern. 

In Shell-Skripten gibt es diese Unterscheidung nicht. Hier überschreiben Knoten-Parameter gleichnamige Auftrags 

-Parameter und Auftrags-Parameter überschreiben gleichnamige Job-Parameter. 

Auftrags-Parameter stehen allen Jobs einer Job-Kette zur Verfügung. Wenn Sie in der Kette den Wert eines 

Auftrags-Parameters ändern, dann ist diese Änderung auch für den nächsten Start des (persistenten) Auftrags 

gültig. 

7.1 Parameter am Job bzw. am Auftrag setzen 

In JOE finden Sie im linken Baum unterhalb jedes Jobs und Auftrags die Funktion Parameter. Jeder Parameter 

besteht aus einem Namen und einem Wert. Hier können Sie Name-Werte-Paare in den Feldern Name und Value 

setzen und mit dem Apply speichern. Am oben erzeugten Standalone-Job (Seite 7) quickstart/firstJob und 

am oben erzeugten Auftrags-Job (Seite 10) quickstart/firstOrderJob soll der Parameter testParam mit dem 

Wert Hello World! hinzugefügt werden. Am oben erzeugten Auftrag (Seite 18) quickstart/firstOrder soll der 

Parameter testParam mit dem Wert Goodbye! hinzugefügt werden. 



7.2 Parameter in einem Shell-Skript lesen und setzen 

Im Shell-Skript kann jeder Parameter über eine Umgebungsvariable der Form 

• $SCHEDULER_PARAM_[PARAM-NAME] (Unix) 

• %SCHEDULER_PARAM_[PARAM-NAME]% (Windows) 

gelesen werden. 

Im Shell-Skript wird ein Parameter erzeugt bzw. verändert durch 

• echo "[PARAM-NAME]=[PARAM-VALUE]" >> $SCHEDULER_RETURN_VALUES (Unix) 

• echo [PARAM-NAME]=[PARAM-VALUE] >> %SCHEDULER_RETURN_VALUES% (Windows) 


Der Parameter testParam ist, wie letzten Kapitel (Seite 27) beschrieben, gesetzt? Um nun das Schreiben und 

Lesen von Parametern zu testen, werden die Skripte der 

quickstart/secondOrderJob wie folgt, ergänzt: 

Jobs quickstart/firstOrderJob und 



@echo off 


echo Current Timestamp: %DATE% %TIME% 

echo Parameter testParam = "%SCHEDULER_PARAM_TESTPARAM%" 

echo Parameter testParam is modified to "123456789" 

echo testParam=123456789 >> %SCHEDULER_RETURN_VALUES% 


Beispiel: firstOrderJob für Windows: 

#!/bin/sh 



echo "Parameter testParam = \"$SCHEDULER_PARAM_TESTPARAM\"" 

echo "Parameter testParam is modified to \"123456789\"" 

echo "testParam=123456789" >> $SCHEDULER_RETURN_VALUES 

exit $? 

Beispiel: firstOrderJob für Unix: 

@echo off 


echo Parameter testParam = "%SCHEDULER_PARAM_TESTPARAM%" 

dir .\config\live\quickstart 


Beispiel: secondOrderJob für Windows: 

#!/bin/sh 


echo "Parameter testParam = \"$SCHEDULER_PARAM_TESTPARAM\"" 

ls -l ./config/live/quickstart 

exit $? 

Beispiel: secondOrderJob für Unix: 



Beide Jobs lesen nunmehr den Parameter testParam, während der erste Job quickstart/firstOrderJob 

überdies den Wert des Parameters verändert. Am Job quickstart/firstOrderJob ist der Parameter 

testParam=Hello World! gesetzt. Dieser Wert wird vom Auftrag überschrieben.




Starten Sie den Auftrag der Kette quickstart/firstJobChain in JOC und sehen Sie sich das Protokoll an.

JobScheduler - Quickstart - Fehler-Behandlung 

8 Fehler-Behandlung 


Ein Job endet fehlerhaft, sobald das ihm zugewiesene Skript oder Programm einen Exitcode ungleich 0 liefert. Der 

Job wird gestoppt, es sei denn, Stop On Error (Seite 10) ist deaktiviert. Gestoppte Jobs werden in JOC rot 

markiert. 

Zum Testen ändern Sie bitte die Skripte der Jobs firstJob und firstOrderJob, so dass diese fehlerhaft enden. 

... exit 5 

Beispiel: Fehler forcieren durch exit != 0 

8.1 Verhalten gestoppter Auftrags-Jobs 

Bei Auftrags-Jobs sollte Stop On Error unbedingt deaktiviert sein, damit auch nach einem fehlerhaften Lauf weitere 

Aufträge verarbeitet werden können oder gegebenenfalls ein automatisches Wiederholen (Seite 32) des Auftrags 

gewährleistet werden kann. Anderenfalls muss der Job zuvor mit der Funktion Job menu->Unstop in JOC entstoppt 

werden. 

8.2 Verhalten gestoppter Standalone-Jobs 

Gestoppte Standalone-Jobs können weiterhin mit der Funktion Job menu->Start job immediately in JOC manuell 

gestartet werden, jedoch starten diese nicht per Zeitsteuerung oder Verzeichnis-Überwachung. Um einen Job zu 

entstoppen, nutzen Sie bitte die Funktion Job menu->Unstop in JOC. 

8.3 Fehler-Behandlung in Job-Ketten 

In einer Job-Kette hat man mehrere Möglichkeiten auf fehlerhafte Jobs zu reagieren. 

• Die Job-Kette beenden 

• Einen weiteren Job der Job-Kette starten 

• Den fehlerhaften Job wiederholt starten 

• Den Auftrag anhalten 

Für jeden Knoten der Kette kann eine unterschiedliche Fehlerbehandlung konfiguriert sein. 

Wann immer der Job des aktuellen Job-Ketten-Knotens fehlerhaft endet, wird der Auftrag jenem Knoten 

übergeben, der im Error State konfiguriert ist, angehalten oder automatisch wiederholt. 

8.3.1 Auftrag erreicht sofort das Ende der Job-Kette 

Diese Art der Fehler-Behandlung ist die oben (Seite 12) als Beispiel verwendete. Hier ist im ersten Knoten step1 

als Error State ein Endknoten (Knoten ohne Job ) zugewiesen. 

Starten Sie in JOC den Auftrag quickstart/firstOrder und sehen Sie sich das Auftrags-Protokoll an. Sie 

werden sehen, dass der zweite Job quickstart/secondOrderJob nicht gelaufen ist. 



8.3.2 Auftrag startet bestimmten Folge-Job der Job-Ketten 



Sie können im Error State eine Knoten angeben, der wiederum einen Job enthält. Dann wird die Kette mit diesem 

Job fortgesetzt. 

8.3.3 Automatisches Wiederholen eines fehlerhaft verarbeiteten Auftrags (setback) 

Sie können erreichen, dass ein fehlerhafter Auftrags-Job automatisch wiederholt wird. Hierzu müssen Sie am 

entsprechenden Knoten der Kette und am entsprechenden Job Einstellungen vornehmen. 

Wechseln Sie in JOE im linken Baum unterhalb der Job-Kette firstJobChain auf Nodes. Wählen Sie den Knoten 

step1 in der Liste der Knoten aus. Selektieren Sie setback im Feld On Error und speichern Sie die Änderung mit 

Apply Chain Node .




Öffnen Sie in JOE die Run Options im linken Baum unterhalb des Jobs firstOrderJob. Im Bereich Delay Order 

After Setback können Sie mit dem Button New Delay einen (verzögerten) automatischen Neustart des Auftrags 

hinzufügen. Setzen Sie beispielsweise für Set Back Count und Delay die Werte 2 und 00:00:10. Mit dem Button 

Apply Delay speichern Sie die Einstellungen. Wiederholen Sie den Vorgang, wobei Sie im Set Back Count eine 5 

und die Checkbox Max aktivieren. 

Wenn sich der Job fehlerhaft beendet, wird dieser sofort erneut gestartet. Sofern der Job noch immer fehlerhaft ist, 

wird ab dem 2. Versuch der erneute Start um 10 Sekunden verzögert und nach dem 5. Versuch wandert der 

Auftrag zum Knoten, der in Error State angegeben ist.




Starten Sie in JOC den Auftrag quickstart/firstOrder und sehen Sie sich das Auftrags-Protokoll an.


8.3.4 Verarbeitung des Auftrags wird ausgesetzt (suspend) 



Wechseln Sie in JOE im linken Baum unterhalb der Job-Kette firstJobChain auf Nodes. Wählen Sie den Knoten 

step1 in der Liste der Knoten aus. Selektieren Sie suspend im Feld On Error und speichern Sie die Änderung mit 

Apply Chain Node .




Mit dieser Einstellung können Sie erreichen, dass der Auftrag an einem fehlerhaften Auftrags-Job anhält. Nachdem 

die Fehlerursache beseitigt wurde, kann der Auftrag in JOC fortgesetzt werden. Hierzu finden Sie im Order menu die 

Funktion Resume order. Der zuvor fehlerhafte Job wird noch einmal ausgeführt. 

8.4 Fehler-Behandlung bei Standalone-Jobs 

Bei Standalone-Jobs kann man nach einem fehlerhaften Lauf bestimmen, dass der Job wiederholt wird.


8.4.1 Automatisches Wiederholen eines fehlerhaften Standalone-Jobs 






In JOE finden Sie im linken Baum unterhalb jedes Jobs die Funktion Run Options. Im Bereich Delay After Error 

können Sie mit dem Button New Delay einen (verzögerten) automatischen Neustart des Jobs hinzufügen. Setzen 

Sie beispielsweise für Error Count und Delay die Werte 2 und 00:00:10. Mit dem Button Apply Delay speichern Sie 

die Einstellungen. Wiederholen Sie den Vorgang, wobei Sie im Error Count eine 5 und den Radiobutton stop 

setzen. 

Wenn sich der Job fehlerhaft beendet, wird dieser sofort erneut gestartet. Sofern der Job noch immer fehlerhaft ist, 

wird ab dem 2. Versuch der erneute Start um 10 Sekunden verzögert und beim 5. Versuch der Job gestoppt.




Starten Sie den Job in JOC. Sie sehen in der Task Historie die wiederholten Starts mit der angegebenen 

Verzögerung.

JobScheduler - Quickstart - Überblick der Dokumentationen des JobScheduler. 

9 Überblick der Dokumentationen des JobScheduler. 

Die Dokumentationen befinden sich in $SCHEDULER_HOME/doc/de. 

9.1 Installation und Konfiguration 

Installation und Konfiguration (scheduler_installation) 

Wir empfehlen die Durchsicht bevor Sie den JobScheduler installieren und konfigurieren. 

Quickstart zur Einrichtung von Jobs (scheduler_quickstart) 

Dieses Dokument 

Referenzdokumentation (scheduler, reference) 

Das Handbuch beschreibt Job-Konfiguration und Schnittstellen 

9.2 Implementierung von Jobs mit der JobScheduler API 



Diese Dokumentationen richten sich an Entwickler von Jobs. Sie sind nicht erforderlich zum Einrichten 

automatisierter Starts von Programmen und Skripten. 

API Dokumentation (reference/api) 

Die Dokumentation der Programmschnittstelle des JobScheduler. 

Tutorial für API-Job-Implementierung (JobScheduler_API-Jobs-Implementation) 

Einführung in die Verwendung der Programmschnittstelle des JobScheduler. 

9.3 Fortgeschrittene Themen 

Diese Dokumentationen beschreiben komplexere Szenarien des Job Schedulings. 

Tutorial Web Service Implementierung (scheduler_webservices) 

Erläutert die Konfiguration und Implementierung von Web Services für Ihre Jobs 

MySQL Job Scheduling (scheduler_managed_user_jobs) 

Erklärt die SQL-Schnittstelle des JobScheduler für Statements und Prozeduren, die in der Datenbank 

analog zum Oracle Job Scheduler verwendet werden.

JobScheduler - Quickstart - Glossar 

Glossar 

Auftrag 

Job 

Job-Kette 

JOC (JobScheduler Operations Center) 

JOE (JobScheduler Object Editor) 



Ein Auftrag aktiviert die Verarbeitung einer Job-Kette. Der Auftrag enthält die Parameter für die Jobs einer 

Job-Kette. Jeder Job der Job-Kette hat Zugriff auf die Parameter eines Auftrags. Auftrag-Parameter 

überschreiben gleichnamige Job-Parameter. Ein Auftrag kann eine Zeitsteuerung enthalten. 

Ein Auftrag durchläuft nacheinander die Jobs einer Job-Kette. Tritt ein Verarbeitungsfehler in einem Job auf, 

dann kann konfiguriert werden, dass der Auftrag... 

• aus der Job-Kette entfernt wird. 

• von einem weiteren Job der Kette ausgeführt wird. 

• vom fehlerhaften Job wiederholt ausgeführt wird. 

• in der Kette am fehlerhaften Job stehen bleibt, dass heißt die Verarbeitung des Auftrag wird 

ausgesetzt, bis dieser wieder manuell fortgesetzt wird. 

Programme und Skripte, die vom JobScheduler ausgeführt werden sollen, müssen in Jobs eingebettet 

werden. Jobs können beliebige ausführbare Dateien starten oder Job-Skripte enthalten, die die 

Programmschnittstelle des JobScheduler verwenden. Jobs können in mehreren Instanzen (Tasks) 

ablaufen, wenn dies zur Skalierung der Leistung gewünscht ist. 

Es wird zwischen Standalone-Jobs und Auftrags-Jobs unterschieden. Während Auftrags-Jobs durch 

Aufträge innerhalb einer Job-Kette gestartet werden, können Standalone-Jobs davon unabhängig gestartet 

werden, dass heißt manuell, durch eine Zeitsteuerung oder per Verzeichnis-Überwachung. Standalone-Jobs 

können nicht in Job-Ketten eingereiht werden. 

Eine Reihe von Jobs, die nacheinander Aufträge verarbeiten. Der JobScheduler startet die Jobs einer 

Job-Kette automatisch, wenn ein Auftrag eintrifft. Job-Ketten bieten die Möglichkeit mehrere Aufträge parallel 

zu verarbeiten, indem die Jobs in mehreren Instanzen (Tasks) gestartet werden. 

JOC (JobScheduler Operations Center) ist die Oberfläche des JobScheduler zur Überwachung und 

Steuerung der JobScheduler Objekte, also zum Beispiel Jobs, Job-Ketten und Aufträge. 

_JOC öffnen Sie im Browser mit http://[scheduler_host]:[scheduler_port], wobei 

[scheduler_host] und [scheduler_port] der Hostname und die Nummer des TCP Ports des 

JobScheduler sind (z.B. http://localhost:4444). 

JOE ist der JobScheduler Object Editor. Mit ihm können die JobScheduler Objekte (Jobs, Job-Ketten, 

Aufträge, Schedules, Prozess-Klassen, Sperren) konfiguriert werden. 

Gestartet wird JOE mit dem Skript: 

• $SCHEDULER_HOME \bin\jobeditor.cmd (Windows) 

• $SCHEDULER_HOME /bin/jobeditor.sh (Unix)

JobScheduler - Quickstart - Glossar 

Schedule 



Die Zeitsteuerung eines Jobs oder Auftrags kann direkt am Job oder Auftrag angegeben oder in einem 

Schedule ausgelagert werden. Dem Job oder Auftrag wird dann lediglich der Schedule zugewiesen. Falls 

mehrere Jobs oder Aufträge die gleiche Zeitsteuerung haben sollen, braucht man diese so nur einmal zu 

formulieren. Überdies können Schedules für einen bestimmten Zeitraum andere Schedules ersetzen. So 

erreicht man in der Verwendung von Schedules noch mehr Flexibilität bei der Zeitsteuerung.

JobScheduler - Quickstart - Stichwortverzeichnis 

Stichwortverzeichnis 

A 

Auftrag 5, 7, 12, 12, 14 

Auftrags-Job 7, 7, 10, 11, 12, 12, 12, 12 

H 

J 

Hot Folder 5, 6, 6 

Job 5, 7, 10, 22, 27, 27, 27, 27, 31, 31, 

38 

Job chain 5, 6, 7, 7, 12, 12, 12, 13, 13, 

14, 15, 16, 16, 17, 17, 18, 18, 20, 21, 22, 23, 

23, 24, 25, 25, 26, 27, 30, 31, 31, 32, 32, 32, 

35 

O 

Order 16, 17, 18, 18, 19, 20, 21, 21, 21, 22, 

22, 22, 22, 22, 23, 25, 27, 27, 27, 27, 27, 29, 

30, 31, 31, 31, 33, 33, 34, 36 

Order job 14, 16, 16, 22, 22, 25, 26, 27, 28, 

29, 31, 31, 31, 31, 32, 32, 33, 36 

P 

S 

Prozess-Klasse 5 

Schedule 5 

Sperre 5 

Standalone-Job 7, 7, 8, 9, 10, 10, 22, 22, 

31, 36, 38, 38, 39

JobScheduler - Quickstart - Sos-berlin.com

Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.

Template löschen?

Als Template speichern?