PREP_PROCESS_AGENTGROUP

Verwenden Sie die Script-Funktion PREP_PROCESS_AGENTGROUP, um die Agenten in einem Agentengruppen-Objekt abzurufen. Mit der Script-Funktion können Sie Kriterien definieren, nach denen Sie Agenten aus der Gruppe auswählen können. Die Script-Funktion gibt einen Verweis auf eine Datensequenz zurück, die Sie zur weiteren Verarbeitung verwenden können, indem Sie den Rückgabewert der Script-Anweisung :PROCESS zuweisen. Verwenden Sie die Script-Funktion GET_PROCESS_LINE, um auf jeden Kommentar in der Aufgabe zuzugreifen.

Die Datensequenz umfasst zwei Spalten:

  • Name des Agenten
  • Status des Agenten

    Tipp: Der Status ist für Agentengruppen mit der Einstellung Modus: Alle aktiven und inaktiven. Für diese Agentengruppen gibt die Script-Funktion immer alle Agenten zurück, unabhängig von ihrem Status. Verwenden Sie die Statusinformationen, um Agenten abzurufen, für die Aufgaben tatsächlich bearbeitet werden können.

    Mögliche Werte:
    • Y

      Agent ist aktiv
    • N
      Agent ist inaktiv

Hinweis: Der Script-Variablen, die die Datensequenz-Referenz enthält, kann kein neuer Wert zugewiesen werden. Verwenden Sie :CLOSE_PROCESS, um die vorhandene Datensequenz zu verwerfen und einen neuen Wert zuzuweisen.

Mehr Informationen:

Syntax

PREP_PROCESS_AGENTGROUP (Agentengruppe [, Host] [, Auswahloption] [, RunID])
PREP_PROCESS_HOSTGROUP (Agentengruppe [, Host] [, Auswahloption] [, RunID])

Parameter

  • PREP_PROCESS_AGENTGROUP oder PREP_PROCESS_HOSTGROUP
    Ruft Agenten von einem Agentengruppen-Objekt ab

  • Agentengruppe
    Name des Agentengruppen-Objekts
    Format: AE-Name, Script-Literal oder Script-Variable

  • Host
    (Optional) Filtert nach Agentenname
    Hinweis: Verwenden Sie das Platzhalterzeichen *, das für eine beliebige Anzahl von Zeichen steht, oder ? für ein einzelnes Zeichen.
    Format: Script-Literal oder Script-Variable
    Maximale Länge: 32 Zeichen
    Standard: *

  • Auswahloption
    (Optional) Kriterien für die Auswahl von Agenten aus der Agentengruppe
    Format: AE-Name, Script-Literal oder Script-Variable:
    Zulässige Werte:

    • BY_RULE (Standard)
      Gibt den Agenten zurück, auf dem die nächste Aufgabe ausgeführt wird
      Hinweis:Wenn die Agentengruppe auf Modus: Alle aktiven und inaktiven gesetzt ist, geben die Optionen BY_RULE und ALL dasselbe Ergebnis zurück. Weitere Informationen finden Sie unter Agentengruppen definieren.
    • ALL
      Liefert alle Agenten in der Agentengruppe
    • RUNNR
      Ruft Agenten ab, auf denen eine bestimmte Aufgabe ausgeführt wurde
      Hinweis: Sie müssen die RunID des Agentengruppen-Containers angeben.

  • RunID
    (Optional) RunID des Agentengruppen-Containers
    Hinweis: Geben Sie die RunID nur an, wenn Sie die Option RUNNR verwenden, um Agenten auszuwählen.
    Format:  Script-Literal, Script-Variable oder Zahl

Hinweis: Setzen Sie alle Kommas, auch wenn Sie die optionalen Parameter nicht verwenden.

Beispiele

Das folgende Beispiel ruft alle Agenten in Agentengruppen-Objekten ab, deren Name mit WIN beginnt.

: SET &HND# = PREP_PROCESS_AGENTGROUP ( "AGENTGROUP_WINDOWS" , "WIN*" ,ALL)

: PROCESS &HND#
:    SET &AGENT# = GET_PROCESS_LINE ( &HND# ,1)
:    SET &STATUS# = GET_PROCESS_LINE ( &HND# ,2)
:    PRINT "Agent: &AGENT#"
:    PRINT "Status: &STATUS#"
: ENDPROCESS

: CLOSE_PROCESS   &HND#

Die Script-Funktion SYS_ACT_ME_NR gibt im folgenden Beispiel die RunID des Objekts zurück: Das Script verwendet die Task RunID, um die RunID des Agentengruppen-Containers abzurufen und die Werte der Agenten zu lesen, auf denen die Aufgabe ausgeführt wurde.

: SET &T_RUNNR# = SYS_ACT_ME_NR ()
: SET &P_RUNNR# = GET_PARENT_NR ( &T_RUNNR# )
: SET &HND# = PREP_PROCESS_AGENTGROUP ( "AGENTGROUP_DB" ,,RUNNR, &P_RUNNR# )

: PROCESS &HND#
:    SET &AGENT# = GET_PROCESS_LINE ( &HND# ,1)
:    SET &STATUS# = GET_PROCESS_LINE ( &HND# ,2)
:    PRINT "Agent: &AGENT#"
:    PRINT "Status: &STATUS#"
: ENDPROCESS

: CLOSE_PROCESS   &HND#

Das folgende Beispiel ruft den Status aller Agenten in einer Agentengruppe ab:

:SET &HND# = PREP_PROCESS_AGENTGROUP("AGENTGROUP",,ALL)

:PROCESS &HND#

:SET &AGENT# = GET_PROCESS_LINE(&HND#,1)

:SET &STATUS# = GET_PROCESS_LINE(&HND#,2)

:ENDPROCESS

:CLOSE_PROCESS

Siehe auch:

seealso

Script-Elemente für Datensequenzen