JobControl (Befehl)

obj -> JobControl(int1[, int2]) : int

Job kontrollieren

Details

• obj: Deskriptor des JobControl-Objekts
• int1:
  • Durchzuführende Funktion:
  • _JobWakeup
  • _JobStop
  • _JobTerminate
  • _JobMsxTimeoutRead
  • _JobEventReceiver
• int2: neuer Wert des Timeouts / Frame-Deskriptor
• Resultat: int Ergebnis der Abfrage (siehe Text)
• Siehe: Verwandte Befehle , JobOpen () , Inter-Thread-Kommunikation (Blog)

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:

• _ErrHdlInvalid: Der in (obj) angegebene Deskriptor ist ungültig.
• _ErrValueInvalid: Der in (int1) oder (int2) übergebene Wert ist nicht gültig.