Was ist ein Job?

Konfiguration

Die XML-Konfiguration eines Jobs kann in der zentralen Startkonfigurationsdatei (meist ./config/scheduler.xml) oder in Form einer separaten Datei in dem vom Job Scheduler überwachten Konfigurationsverzeichnis (meist ./config/live) vorgenommen werden, siehe Konfiguration aus Hot Folders

Implementierung

Der Job Scheduler startet ausführbare Programme und kann Jobs mit individuellen Implementierungen starten, die das API des Job Schedulers nutzen.

Ausführbare Programme

<job name="simple_shell">
  <script language="shell"><![CDATA[
    echo hello world
    call my_script.cmd
    my_prog.exe
  ]]></script>
</job>  

<job name="simple_command">
  <script language="shell">
    <include file="my_script.cmd"/>
  </script>
</job>

<job name="simple_java">
  <script language   = "java" 
          java_class = "sos.scheduler.ftp.JobSchedulerFTPReceive"/>
</job>

<job name="simple_job">
  <process file="c:\my_prog.exe"/>
</job>

<job name="interpreter_job">
  <process file="c:\php\php.exe"
           param="-f 'c:\test\phpinfo.php'"/>
</job>

Implementierungen mit dem Job Scheduler API

Zustand eines Jobs

Ein Job ist in einem der folgenden Zustände.

Zustand des Jobs ändern

Mit dem Kommando <modify_job> können Sie den Zustand des Jobs ändern. Die eingebaute HTML-Oberfläche des Job Schedulers bietet hierfür die entsprechenden Operationen an.

Eine Task starten

In der Konfiguration können Sie mit <run_time> einstellen, dass eine Task einmal oder periodisch gestartet werden soll.

Das Kommando <start_job> startet eine Task, ebenso die API-Methode Job.start().

Eine Task wird automatisch gestartet, wenn noch keine Task läuft und eine der folgenden Bedingungen gilt.

• Zu Beginn einer <period>, wenn in ihr repeat= oder single_start= angegeben ist.
• Wenn ein vorangehender Lauf Task.repeat gesetzt hat und die Zeit erreicht ist.
• Wenn ein vorangehender Lauf fehlerhaft war und Job.delay_after_error abgelaufen ist.
• Wenn das mit <period repeat="…"> angegebene Intervall nach dem Ende der zuletzt gelaufenen Task abgelaufen ist.
• Wenn die Verzeichnisüberwachung aktiv ist und das überwachte Verzeichnis geändert worden ist.

Außerdem startet eine Task

• wenn ein Auftrag für den Job vorliegt, und noch nicht soviele Tasks laufen, wie mit <job tasks="…"> zugelassen.

Eine Task läuft aber nur an, wenn sie eine Startzeit (at) hat oder

• der Job nicht gestoppt ist,
• es eine Periode für die aktuelle Zeit gibt,
• und die Verzögerung nach Fehler (Job.delay_after_error) nicht wirkt.

Sperren

Jobs können mit Sperren versehen werden, um den gleichzeitigen Lauf zweier Tasks zu verhindern. Siehe »Sperren«.

Verzeichnisüberwachung

Der Job Scheduler kann einen Job bei Änderungen in einem Dateiverzeichnis starten. Näheres im Kapitel Verzeichnisüberwachung.

Monitor

Für einen Job kann ein Monitor Script konfiguriert werden. Der Job Scheduler ruft Funktionen des Monitor Scripts bei Start und Ende der Task auf sowie vor und nach der Methode spooler_process().

Den Monitor bestimmen Sie mit <monitor>.

Beispiel:

        
<job name  = "simple_ftp"
  <params>
    <param name = "ftp_host"            value = "localhost"/>
    <param name = "ftp_user"            value = "anonymous"/>
    <param name = "ftp_password"        value = "anonymous"/>
  </params>

  <script language   = "java" 
          java_class = "sos.scheduler.ftp.JobSchedulerFTPReceive"/>

  <monitor>
    <script language="javascript"><![CDATA[
      function spooler_task_before() { 
        var today = yy = mm = dd = "";
        today = new Date();
        yy = today.getYear() + 1900;
        mm = today.getMonth() + 1;
        dd = today.getDate();
        if (parseInt(mm) < 10) mm = "0" + mm;
        if (parseInt(dd) < 10) dd = "0" + dd;
        spooler_task.params.set_var("ftp_file_path", "^test_" + yy + "-" + mm + "-" + dd + "\.csv$" );
        return true;
      } 
    ]]></script>
  </monitor>
</job>