SYS_ACTIVE_COUNT

Script-Funktion: Liefert die Anzahl aller aktivierten Objekte

Syntax

SYS_ACTIVE_COUNT (Status, Object Type [,Object] [,Group] [,Host])

Syntax	Beschreibung/Format
Status	Status aller Objekte, die im Process Monitoring angezeigt werden. Format: AE-Name, Script-Literal oder Script-Variable Erlaubte Werte: * = Aufgaben mit beliebigem 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
Object Type	Kurzbezeichnung des Objekttyps oder "*" für alle Objekttypen Format: AE-Name, Script-Literal oder Script-Variable
Object	Name eines Objekts oder Filters 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. 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. Beispiel :SET &COUNT# = SYS_ACTIVE_COUNT("*", JOBS,,"MM.GROUP")
Group	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 der Perspektive Process Monitoring angeführten Objekte.

Um zu überprüfen, wie viele Objekte sich in der Perspektive Process Monitoring 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 Script-Beispiel 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 folgenden Beispiele zählen die in der Perspektive Process Monitoring angeführten Objekte auf. Dabei wird die Anzahl aller Blockierer, die Anzahl aller abgebrochenen Objekte und die Anzahl 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 Jobanzahl, die den Agenten "UNIX01" eingetragen haben.

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

Siehe auch: