Script-Funktion: Prüft, ob ein Objekt bereits aktiv ist.
SYS_STATE_ACTIVE([Objekttyp], [Objektname])
Syntax |
Beschreibung/Format |
---|---|
Objekttyp |
Kurzbezeichnung eines aktivierbaren Objektes |
Objektname |
Name des Objektes |
Rückgabewerte |
---|
"Y" - Das Objekt ist in einem Status mit System-Returncode < 1699 oder gleich 1701.
|
Die Script-Funktion prüft, ob sich das angegebene Objekt, das der Objektklasse der aktivierbaren Objekte angehört, in einem Status mit System-Returncode kleiner 1699 befindet oder exakt dem Returncode 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 Objekten.
Wird der Name des eigenen Objektes angegeben (= Objekt, über welches das Sprachmittel ausgeführt wird), so wird dies auch berücksichtigt und immer der Rückgabewert "Y" zurückgegeben.
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:
Script-Sprachmittel | Beschreibung |
---|---|
Prüft, ob ein Job bereits aktiv ist. | |
SYS_STATE_JOBS_IN_GROUP | Ermittelt die Anzahl von Jobs, die in Gruppen vorgemerkt sind. |
SYS_STATE_JP_ACTIVE | Prüft, ob ein Workflow bereits aktiv ist. |
Script-Sprachmittel - Objekte aktivieren
Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |