SYS_STATE_ACTIVE

Verwenden Sie die Script-Funktion SYS_STATE_ACTIVE, um zu überprüfen, ob eine Aufgabe bereits aktiviert ist. Mit der Script-Funktion können Sie überprüfen, ob sich die Aufgabe in einem Status mit einem Systemrückgabewert kleiner 1699 oder gleich 1701 befindet. Weitere Informationen finden Sie unter System-Rückgabewerte von ausführbaren Objekten.

Hinweise:

• Verwenden Sie diese Script-Funktion nicht, um Prozesse zu synchronisieren. Die Überprüfung wird durchgeführt, wenn die Script-Funktion verarbeitet wird. Der aktuelle Status wird nur zum Zeitpunkt der Verarbeitung zurückgegeben. Die Script-Funktion kann nicht überprüfen, ob die Aufgabe noch zu einem späteren Zeitpunkt aktiviert wird.
• Die Aufgabe muss der Klasse der ausführbaren Objekte angehören.

Syntax

SYS_STATE_ACTIVE ([[Objekttyp,] Objektname])

Parameter

• SYS_STATE_ACTIVE
  Prüft, ob eine Aufgabe aktiv ist

• Objekttyp
  (Optional) Kurzname des Typs des ausführbaren Objekts
  Format:AEName, Script-Literal oder Script-Variable

• Objektname
  (Optional)Name der Aufgabe
  Format:AE-Name, Script-Literal oder Script-Variable

Hinweis: Lassen Sie sowohl den Objekttyp als auch den Objektnamen weg, um den Status der Aufgabe zu überprüfen, die das Script enthält.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Y
  Aufgabe ist aktiv: der Systemrückgabewert ist kleiner als 1699 oder gleich 1701
• N
  Aufgabe ist inaktiv: der Systemrückgabewert ist größer als 1699, aber ungleich 1701

Hinweis: Wenn Sie die Script-Funktion verwenden, um den Status der Aufgabe zu überprüfen, die das Script enthält, gibt das System immer Y zurück.

Beispiele

Im folgenden Beispiel wird getestet, ob die Aufgabe, die das Script enthält, bereits aktiviert wurde.

:SET &ACTIVE# = SYS_STATE_ACTIVE()

Das folgende Beispiel verwendet die Script-Funktion, um eine Bedingung zu definieren.

:IF SYS_STATE_ACTIVE(JOBS, "MM.END.PROCESSING") = "Y" 
!...
:ENDIF
 

Siehe auch: