Scheduler     Erste Seite

  XML     API     Register

Subprocess

Beispiel  my_system() - Einfache Ausführung eines Kommandos

sub my_system
{
    # Executes the command without processing of shell characters
    
    my $cmd     = shift;
    my $timeout = shift;
    
    my $subprocess = $spooler_task->create_subprocess();
    
    $subprocess->LetProperty( "timeout", $timeout )  if defined $timeout;
    $subprocess->start( $cmd );
    $subprocess->wait_for_termination();            
    return $subprocess->exit_code;
}


sub shell
{
    # Executes the command under the shell (Unix only)
        
    my $cmd     = shift;
    my $timeout = shift;
    my $subprocess = $spooler_task->create_subprocess();
    
    $subprocess->LetProperty( "timeout", $timeout )  if defined $timeout;
    $subprocess->start( [ "/bin/sh", "-c", $cmd ] );
    $subprocess->wait_for_termination();            
    return $subprocess->exit_code;
}

Ein Subprozess ist irgendein Prozess, der mit Task.create_subprocess() oder Subprocess.start() gestartet werden kann.

close

Sollte in Sprachen mit Garbage Collector (Java, JavaScript) gerufen werden, außer die Task beendet sich sofort.

Der Subprocess ist danach unbrauchbar.

env

Beispiel  in javascript

var subprocess = spooler_task.create_subprocess();
subprocess.start( subprocess.env.substitute( "${MY_HOME}/my_program" ) );
subprocess.wait_for_termination();

Liefert ein Variable_set der Umgebungsvariablen.

Anfänglich ist die Umgebung mit den Umgebungsvariablen des startenden Prozesses gefüllt. Umgebungsvariablen können entfernt werden, indem sie auf "" gesetzt werden. Der Aufruf Subprocess.start() übergibt die Umgebungsvariablen dem Subprozess.

Unter Unix werden groß und klein geschriebene Umgebungsvariablen unterschieden.

Nach dem Start des Subprozesses haben Änderungen an den Umgebungsvariablen keine Wirkung. Auch können vom Prozess geänderte Umgebungsvariablen nicht gelesen werden.

Das Objekt lässt sich nicht anderen Objekten übergeben (denn es befindet sich im Prozess der Task, während die meisten anderen Objekte sich im Prozess des Schedulers befinden).

Rückgabe

environment

Beispiel  in javascript

// The following two statements have the same effect
subprocess.environment( "my_variable" ) = "my_value"
subprocess.env.value( "my_variable" ) = "my_value"

Die hier gesetzten Variablen werden zusammen mit den übrigen Umgebungsvariablen des laufenden Prozesses dem neuen Subprozess übergeben.

Unter Unix werden groß und klein geschriebene Umgebungsvariablen unterschieden.

Siehe auch Subprocess.env.

Parameter

exit_code

Erst aufrufen, wenn Subprocess.terminated == true.

ignore_error

Verhindert, dass der Job stoppt, wenn der Subprozess bei Task-Ende mit Subprocess.exit_code != 0 geendet hat.

Wenn das Ende des Subprocesses nicht mit Subprocess.wait_for_termination abgewartet worden ist, tut das der Scheduler bei Task-Ende. Wenn dann der Subprocess mit Subprocess.exit_code != 0 endet, stoppt der Job mit Fehler.

Mit ignore_error kann das verhindert werden.

Parameter

ignore_signal

Wirkt nicht unter Windows, weil es hier keine Signale gibt.

Parameter

kill

Parameter

own_process_group

Nur unter Unix.

Der Default kann mit factory.ini (Abschnitt [spooler], Eintrag subprocess.own_process_group=…) eingestellt werden.

own_process_group lässt den Subprozess in einer eigenen Prozessgruppe starten, indem der Systemaufruf setpgid(0,0) ausgeführt wird. Wenn der Scheduler den Subprozess abbricht, bricht er die ganze Prozessgruppe ab.

Parameter

pid

priority

Beispiel  in javascript

subprocess.priority = +5;    // Unix: Priorität etwas verschlechtern

Unix: Die höchste Priorität ist -20, die niedrigste 20. Üblicherweise kann die Priorität nur gesenkt, nicht erhöht werden.

Windows kennt die Prioritätsklassen 4 "idle", 6 "below_normal", 8 "normal", 10 "above_normal" und 13 "high" (andere Werte werden abgerundet). Siehe auch Task.priority_class.

Wenn die Priorität nicht gesetzt werden kann, führt das nicht zu einem Fehler.

Ein Prozess mit hoher Priorität kann Ihren Rechner blockieren.

Die Priorität kann betriebsystem-unabhängig eingestellt werden mit Subprocess.priority_class. Siehe auch Task.priority.

Parameter

priority_class

Beispiel  in javascript

subprocess.priority_class = "below_normal";

Gesetzt werden können folgende Prioritätsklassen, die verschiedenen Prioritäten unter Windows und Unix entsprechen:

Wenn die Priorität nicht gesetzt werden kann, z.B. wegen mangelndem Recht, führt das nicht zu einem Fehler. Dagegen führt das Setzen einer nicht hier aufgeführten Prioritätsklasse zu einem Fehler.

Ein Prozess mit hoher Priorität kann Ihren Rechner blockieren.

Siehe auch Subprocess.priority, Task.priority_class und Microsoft® Windows® Scheduling Priorities.

Parameter

start

Windows erkennt sofort, wenn das Programm nicht ausführbar ist. Die Methode liefert dann einen Fehler.

Unter Unix wird stattdessen Subprocess.exit_code auf 99 gesetzt. Vorher muss das Ende des Prozesses abgewartet werden mit Subprocess.wait_for_termination().

Shell-Operatoren wie |, && und > werden nicht interpretiert. Verwenden Sie dazu die Programme /bin/sh bzw. c:\windows\system32\cmd.exe (das Verzeichnis ist installations-abhängig).

Der Prozess wird unter Unix mit execvp() und unter Windows mit CreateProcess() gestartet.

Parameter

terminated

Prüft, ob der Prozess geendet hat. Wenn er geendet hat, kann anschließend Subprocess.exit_code und Subprocess.termination_signal gerufen werden.

termination_signal

Erst aufrufen, wenn Subprocess.terminated == true.

timeout

Nach Ablauf der Zeit bricht der Scheduler den Subprozess ab (Unix: mit SIGKILL).

Bei Ausführung auf einem entfernten Rechner mit <process_class remote_scheduler="…"> wirkt die Frist nicht.

Parameter

Meldungen

wait_for_termination

Parameter

Rückgabe

true, wenn der Subprozess geendet hat.
false, wenn der Subprozess nach Ablauf der Wartezeit noch läuft.

Software- und Organisations-Service GmbH

Zuletzt geändert von Joacim Zschimmer, 2007-10-25