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

SYS_ACTIVE_COUNT

Script-Funktion: Gibt die Anzahl der in den Aktivitäten stehenden Objekte zurück.

Syntax

SYS_ACTIVE_COUNT(Status, Object Type, [Objekt], [Gruppe], [Host])

Syntax	Beschreibung/Format
Status	Status der in den Aktivitäten befindlichen Objekte. Format: AE-Name, Script-Literal oder Script-Variable. Erlaubte Werte: "", "ANY_ABEND", "BLOCKED", "ANY_ALIVE", "PREPARED" und "RUNNING" "" = Aufgaben mit jedem Status "ANY_ABEND" = Abgebrochene Aufgaben "ANY_ALIVE" = Aufgaben einer Gruppe, die nicht beendet oder abgebrochen sind "BLOCKED" = Blockierte Aufgaben "PREPARED" = Für eine Gruppe vorgemerkte Aufgaben "RUNNING" = Jobs, die aktiv sind
Objekttyp	Kurzbezeichnung des Objekttyps oder "*" für alle Objekttypen. Format: AE-Name, Script-Literal oder Script-Variable
Bei den folgenden Parametern handelt es sich um optionale Filterkriterien. Sie können einen, zwei oder alle drei in beliebiger Kombination verwenden. Beachten Sie hierbei, dass die Kommata von übersprungenen Parametern trotzdem gesetzt werden müssen. Example: :SET &COUNT# = SYS_ACTIVE_COUNT("*", JOBS,,"MM.GROUP")
Objekt	Name eines Objekts oder Filter für mehrere Objekte. Format: AE-Name, Script-Literal oder Script-Variable Die Verwendung von Wildcardzeichen ist möglich. "*" steht dabei für beliebige, "?" für genau ein Zeichen.
Gruppe	Name einer Gruppe oder "*" für alle Gruppen Format: AE-Name, Script-Literal oder Script-Variable
Host	Name eines Agenten oder Filter für mehrere Agenten. Format: AE-Name, Script-Literal oder Script-Variable Die Verwendung von Wildcardzeichen ist möglich. "*" steht dabei für beliebige, "?" für genau ein Zeichen.

Rückgabewert
Anzahl der in den Aktivitäten stehenden Objekte.

Anmerkungen

Um zu überprüfen, wie viele Objekte sich im Aktivitätsfenster befinden, kann die Script-Funktion SYS_ACTIVE_COUNT verwendet werden. Mit Parametern können Sie die Ermittlung auf bestimmte Aufgaben einschränken. Die Filterung auf Status, Objekttyp, Objektname, Gruppe sowie Host ist in beliebiger Kombination möglich.

Der Parameter Host ermöglicht es unter anderem auch die Parallelität eines Jobs auf einem bestimmten Rechner zu steuern. Wird ein Job in regelmäßigen Abständen ausgeführt, ist eine Überschneidung ausschließbar, wenn Sie zuvor mit SYS_ACTIVE_COUNT prüfen, ob dieser noch aktiv ist. Der Zielhost kann nämlich auch per Script-Anweisung :PUT_ATT nachträglich gesetzt werden. Bei FileTransfers werden sowohl Quell- als auch Zielhost miteinbezogen.

Die Verwendung des Parameters Host ist natürlich nur dann sinnvoll, wenn Sie beim Objekttyp "JOBS", "JOBF", "EVNT" oder "*" angegeben haben. Die Filterung nach Hosts schließt alle anderen Objekttypen aus, da diese keinen Agenten für die Durchführung benötigen. Das folgende Scriptbeispiel liefert daher immer "0".

:SET &COUNT# = SYS_ACTIVE_COUNT(ANY_ABEND,JOBP,,,"*")

Beachten Sie, dass nicht überprüft wird, ob der angegebene Host existiert.

Bei der Filterung nach aktiven Jobs mit dem Parameter "RUNNING", werden alle jene berücksichtigt, die einen System-Rückgabewert im Bereich von 1500 bis 1599 aufweisen.

Beispiele

Die Beispiele zählen die in den Aktivitäten stehenden Objekte. Dabei wird die Anzahl aller blockierten und abgebrochenen Objekte sowie aller Ereignisse ermittelt.

:SET &COUNT# = SYS_ACTIVE_COUNT("BLOCKED", "*")

:SET &COUNT# = SYS_ACTIVE_COUNT(ANY_ABEND, "*")

:SET &COUNT# = SYS_ACTIVE_COUNT("*", EVNT)

Das Beispiel zählt Aufgaben, welche für eine Gruppe vorgemerkt sind. Im Namen der Aufgaben muss der String "FILE" vorkommen.

:SET &COUNT# = SYS_ACTIVE_COUNT("PREPARED", "*", "*FILE*","GRP7")

Das nächste Beispiel ermittelt die Anzahl an Jobs, bei denen der Agent "UNIX01" eingetragen ist.

:SET &COUNT# = SYS_ACTIVE_COUNT("*", "JOBS", "*",,"UNIX01")

Siehe auch:

Script-Sprachmittel	Beschreibung
SYS_STATE_JOBS_IN_GROUP	Gibt die Anzahl von Jobs, die in Gruppen vorgemerkt sind, zurück.

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