SYS_STATE_ACTIVE

Script-Funktion: Prüft, ob ein Objekt bereits aktiviert wurde

Syntax

SYS_STATE_ACTIVE ([[Object Type,] Object Name])

Syntax	Beschreibung/Format
Object Type	Kurzbezeichnung eines aktivierbaren Objektes Format: AE-Name, Script-Literal oder Script-Variable
Object Name	Name des Objektes Format: AE-Name, Script-Literal oder Script-Variable

Rückgabewerte
Y - Das Objekt befindet sich in einem Status mit dem Systemrückgabewert < 1699 oder 1701. N - Das Objekt befindet sich in einem Status mit dem Systemrückgabewert > 1699 und nicht 1701.

Die Script-Funktion prüft, ob sich das angegebene Objekt, das der Objektklasse der aktivierbaren Objekte angehört, in einem Status mit System-Rückgabewert kleiner 1699 befindet oder exakt dem Rückgabewert 1701 entspricht. Wird der Parameter nicht angegeben, kontrolliert die Funktion, das Objekt in dem sie aufgerufen wird.

Die Prüfung erfolgt genau zu dem Zeitpunkt, an dem die Script-Zeile, welche die Funktion enthält, abgearbeitet wird. Ein negatives Ergebnis sagt nichts darüber aus, dass das zu prüfende Objekt nicht später aktiviert werden kann. Mit Hilfe der Funktionen kann daher keine Synchronisation von Abläufen erfolgen. Sie liefert nur eine zeitlich begrenzte Information über den Status von Jobs.

Beispiele

Das Beispiel überprüft, ob das selbe Objekt bereits aktiv ist.

:SET &ACTIVE# = SYS_STATE_ACTIVE()

In diesem Beispiel wird die Funktion verwendet, um eine Bedingung zu formulieren.

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

Siehe auch: