Zschimmer GmbH Impressum und Kontakt

Job Scheduler     Erste Seite

  XML     API     Register


logo

Job_impl - Programmschnittstelle (API)

JavaJavaScriptVBScriptPerl Javadoc
   

Job_impl  –  Oberklasse für einen Job oder das Scheduler-Skript

 

Spooler   spooler Das allgemeine Objekt des Schedulers
 
spooler_close() Task-Ende
 
spooler_exit() Destruktor
 
bool   spooler_init() Initialisierung
 
Job   spooler_job Das Objekt des Jobs
 
Log   spooler_log Zum Protokollieren
 
spooler_on_error() Bei Task-Ende im Fehlerfall
 
spooler_on_success() Bei Task-Ende im Erfolgsfall
 
bool   spooler_open() Task-Beginn
 
bool   spooler_process() Jobschritt oder Ausführung eines Auftrags
 
Task   spooler_task Das Objekt der Task

 

Der Methoden eines Jobs werden in folgender Reihenfolge aufgerufen.

spooler_init()
    spooler_open()
        spooler_process()
        spooler_process()
        ...
    spooler_close()
    spooler_on_success() oder spooler_on_error()
spooler_exit()

Keine dieser Methoden muss implementiert werden. In der Regel wird wenigstens spooler_process() implementiert.

Ein Fehler beim Ausführen des Job-Skripts während des Ladens oder in spooler_init() führt zum Aufruf von spooler_on_error(). Der Job wird gestoppt. spooler_exit() wird gerufen (obwohl spooler_init() nicht gerufen worden ist!) und das Skript entladen.

spooler_on_error() muss also auch mit Fehlern umgehen, die beim Laden oder in spooler_init() auftreten.

spooler_exit() wird gerufen, auch wenn spooler_init() nicht gerufen worden ist.

 

spooler

Das allgemeine Objekt des Schedulers

 

Spooler   spooler

Beispiel  

spooler_log.debug( "The working directory of the Scheduler is " + spooler.directory );

Rückgabe

Spooler  

spooler_close

Task-Ende

 

spooler_close()

 

Wird am Ende eines Joblaufs gerufen. Gegenstück zu spooler_open().

spooler_exit

Destruktor

 

spooler_exit()

 

Wird als allerletzte Methode gerufen, bevor das Skript entladen wird. Hier kann z.B. eine Datenbank-Verbindung geschlossen werden.

spooler_init

Initialisierung

 

bool   spooler_init()

 

Der Scheduler ruft diese Methode nach dem Konstruktor und vor spooler_open() genau einmal auf. Gegenstück ist spooler_exit(). Die Methode ist geeignet, um die Task zu initialisieren (z.B. um eine Datenbank-Verbindung aufzubauen).

Rückgabe

bool  

false beendet die Task. Der Scheduler setzt mit spooler_exit() fort. Wenn die Task einen Auftrag verarbeiten soll, wird die Task mit Fehler beendet, was den Job stoppt (wenn nicht Job.delay_after_error gesetzt ist).

spooler_job

Das Objekt des Jobs

 

Job   spooler_job

Beispiel  

spooler_log.info( "The name of this job is " + spooler_job.name );

Rückgabe

Job  

spooler_log

Zum Protokollieren

 

Log   spooler_log

Beispiel  in java

spooler_log.info( "Something has happend" );

Rückgabe

Log  

spooler_on_error

Bei Task-Ende im Fehlerfall

 

spooler_on_error()

 

Wird als letzte Funktion eines Joblaufs gerufen, wenn ein Fehler aufgetreten ist (nach spooler_close() und vor spooler_exit()).

spooler_on_success

Bei Task-Ende im Erfolgsfall

 

spooler_on_success()

 

Wird nach spooler_close(), vor spooler_exit() aufgerufen, wenn kein Fehler aufgetreten ist.

spooler_open

Task-Beginn

 

bool   spooler_open()

 

Wird zu Beginn einer Task gerufen. Die Methode wird direkt nach spooler_init() gerufen, es gibt derzeit keinen Unterschied. Gegenstück ist spooler_close().

spooler_process

Jobschritt oder Ausführung eines Auftrags

 

bool   spooler_process()

 

Führt einen Jobschritt aus.

Ein Auftragsjob erhält in Task.order den auszuführenden Auftrag.

Die Default-Implementierung gibt false zurück. Ein Auftragsjob versetzt aber einen Auftrag in den Folgezustand.

Rückgabe

bool  

Bei <job order="no">: false beendet den Joblauf.

Bei <job order="yes">: false versetzt den Auftrag in den Fehlerzustand (s. Job_chain_node und <job_chain_node>). Das gilt nicht, wenn der Zustand während der Ausführung mit Order.state verändert worden ist.

spooler_task

Das Objekt der Task

 

Task   spooler_task

Beispiel  

spooler_log.info( "The task id is " + spooler_task.id );

Rückgabe

Task  

Software- und Organisations-Service GmbH

Zuletzt geändert von Joacim Zschimmer, 2007-07-05