SYS_ACTIVE_COUNT

Verwenden Sie die Script-Funktion SYS_ACTIVE_COUNT, um die Anzahl aller aktivierten Aufgaben, die derzeit in der Process Monitoring-Perspektive aufgelistet sind, zu erhalten. Mit der Script-Funktion können Sie die Suche auf bestimmte Aufgaben einschränken, indem Sie den Status, den Objekttyp, den Objektnamen, die Gruppe und den Host oder eine Kombination dieser Filter angeben.

Tipp: Verwenden Sie den Host-Parameter, um zu überprüfen, ob ein regelmäßig verarbeiteter Job aktiv ist, um sich überschneidende Ausführungen zu vermeiden. Anschließend können Sie mit :PUT_ATT den Ziel-Host angeben, oder den Quell- und den Ziel-Host für FileTransfer-Jobs.

Syntax

SYS_ACTIVE_COUNT (Status, Objekttyp [,Objekt] [,Gruppe] [,Host])

Parameter

• SYS_ACTIVE_COUNT
  Gibt die Anzahl der aktivierten Aufgaben zurück, die in der Process Monitoring-Perspektive angezeigt werden

• Status
  Filtert nach bestimmten Aufgabenstatus
  weitere Informationen finden Sie unter Aufgabenstatus.
  Format:AE-Name, Script-Literal oder Script-Variable
  Zulässige Werte:

  • ANY_ABEND
    Abgebrochene Aufgaben
  • ANY_ALIVE
    Aufgaben einer Gruppe, die nicht beendet oder abgebrochen sind
  • BLOCKED
    Blockierte Aufgaben
  • PREPARED
    In einer Jobgruppe registrierte Aufgaben
  • RUNNING
    Aktive Jobs
    Hinweis:Alle Jobs, die über einen Systemrückgabewert im Bereich von 1500 bis 1599 verfügen, werden berücksichtigt. Weitere Informationen finden Sie unter System-Rückgabewerte von ausführbaren Objekten.
  • *
    Beliebiger Status

• Objekttyp
  Kurzbezeichnung des Objekttyps
  Format:AE-Name, Script-Literal oder Script-Variable
  Hinweis: Verwenden Sie *, um alle Objekttypen einzubeziehen.

• Objekt
  (Optional) Name eines oder mehrerer Objekte
  Format:AE-Name, Script-Literal oder Script-Variable
  Hinweis: Verwenden Sie das Platzhalterzeichen *, um eine beliebige Anzahl von Zeichen anzugeben, oder ? für ein einzelnes Zeichen.

• Gruppe
  (Optional) Name einer Jobgruppe
  Format:AE-Name, Script-Literal oder Script-Variable
  Hinweis: Verwenden Sie *, um alle Jobgruppen einzubeziehen.

• Host
  (Optional) Name eines oder mehrerer Agenten
  Format:AE-Name, Script-Literal oder Script-Variable
  Hinweise:

  • Verwenden Sie das Platzhalterzeichen *, das für eine beliebige Anzahl von Zeichen steht, oder ? für ein einzelnes Zeichen.
  • Wenn Sie einen Agenten angeben, schließt der Filter alle Objekttypen aus, die keinen Agenten benötigen. Der Host-Parameter ist nur bei Job-, FileTransfer- und Ereignisobjekten sinnvoll, oder wenn Sie alle Objekttypen einschließen.
    Beispiel: Das folgende Script gibt immer 0 zurück.
    :SET &COUNT# = SYS_ACTIVE_COUNT(ANY_ABEND), JOBP,,,"*".
  Wichtig! Das System überprüft nicht, ob der angegebene Agent tatsächlich vorhanden ist.

Hinweise:

• Sie können einen, zwei oder alle optionalen Parameter sowie eine beliebige Kombination verwenden.
• Setzen Sie alle Kommas, wenn Sie die optionalen Parameter verwenden, auch wenn Sie bestimmte Parameter weglassen.
  Beispiel: :SET &COUNT# = SYS_ACTIVE_COUNT("*", JOBS,,"MM.GROUP")

Beispiele

In den folgenden Beispielen wird die Anzahl der in der Process Monitoring-Perspektive aufgeführten aktivierten Objekte mit unterschiedlichen Parametern für bestimmte Aufgaben ausgegeben.

• Anzahl aller blockierten Aufgaben:
  :SET &COUNT# = SYS_ACTIVE_COUNT("BLOCKED", "*")

• Anzahl aller abgebrochenen Aufgaben:
  :SET &COUNT# = SYS_ACTIVE_COUNT(ANY_ABEND, "*")

• Anzahl der Ereignisse:
  :SET &COUNT# = SYS_ACTIVE_COUNT("*", EVNT)

Das folgende Beispiel zählt Aufgaben, die für eine bestimmte Gruppe registriert sind. In den Namen aller Aufgaben muss der String "FILE" vorkommen. 

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

Das folgende Beispiel ermittelt die Anzahl der Jobs, die den Agenten "UNIX01" verwenden.

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

Siehe auch: