Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte aktivieren > SYS_STATE_ACTIVE

SYS_STATE_ACTIVE

Script-Funktion: Prüft, ob ein Objekt bereits aktiv ist.

Syntax

SYS_STATE_ACTIVE([Objekttyp], [Objektname])

Syntax

Beschreibung/Format

Objekttyp

Kurzbezeichnung eines aktivierbaren Objektes
Format: AE-Name, Script-Literal oder Script-Variable

Objektname

Name des Objektes
Format: AE-Name, Script-Literal oder Script-Variable


Rückgabewerte

"Y" - Das Objekt ist in einem Status mit System-Returncode < 1699 oder gleich 1701.
"N" - Das Objekt ist in einem Status mit System-Returncode > 1699 und ungleich 1701.

Anmerkungen

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.

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:

Script-Sprachmittel Beschreibung

SYS_STATE_JOB_ACTIVE

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