Zum Hauptinhalt springen

JobControl (Befehl)

Die Anweisung kann innerhalb einer Ereignisfunktion des SOA-Service, sowie im Standard- oder Advanced-Client ausgeführt werden.

Mit dieser Funktion kann ein JobControl- oder Job-Objekt verschiedene Funktionen durchführen. In (obj) wird der Deskriptor des Objektes (siehe ``JobOpen()) übergeben. In (int1) steht der Typ der durchzuführenden Funktion.

Für JobControl-Objekte sind folgende Optionen verwendbar:

  • _JobWakeup

    Mit dieser Option wird der Job aktiviert, wenn er sich in der eigenen Ereignisfunktion mit der Anweisung ``JobSleep() suspendiert hat. Der Rückgabewert ist _ErrTerminated, wenn der Job bereits beendet ist. Ansonsten ist das Resultat _ErrOk.

  • _JobStop

    Diese Funktion setzt die Eigenschaft StopRequest für den Job ohne auf das Ende des Jobs zu warten. Der Rückgabewert ist immer _ErrOk.

  • _JobTerminate

    Diese Funktion setzt die Eigenschaft StopRequest für den Job und wartet darauf, das sich der Job beendet. Der Rückgabewert ist immer _ErrOk.

  • _JobMsxTimeoutRead

    Mit dieser Option kann der Timeout für ``MsxRead() auf die Message-Pipeline abgefragt (zwei Argumente) oder gesetzt werden (drei Argumente, der neue Wert steht in (int2)). Das Resultat ist der aktuelle bzw. neue Wert des Timeouts in Millisekunden (siehe Verarbeitungshinweise zum SOA-Service).

Für Job-Objekte sind folgende Optionen verwendbar:

  • _JobMsxTimeoutRead

    Mit dieser Option kann der Timeout für ``MsxRead() auf die Message-Pipeline abgefragt (zwei Argumente) oder gesetzt werden (drei Argumente, der neue Wert steht in (int2)). Das Resultat ist der aktuelle bzw. neue Wert des Timeouts in Millisekunden (siehe Verarbeitungshinweise zum SOA-Service).

  • _JobEventReceiver

    Mit dieser Option kann ein Frame-Deskriptor gesetzt werden (drei Argumente, der Deskriptor steht in (int2)), der durch ``JobEvent() ausgelöste EvtJob-Ereignisse empfängt. Bei Übergabe von nur zwei Argumenten wird ein zuvor gesetzter Deskriptor wieder entfernt.

Mögliche Laufzeitfehler: