PREP_PROCESS_AGENTGROUP

Verwenden Sie die Script-Funktion PREP_PROCESS_AGENTGROUP, um die Agenten in einem Objekt der Agentengruppe 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, den Sie zur weiteren Verarbeitung verwenden können.

Syntax

PREP_PROCESS_AGENTGROUP (AgentGroup [, Host] [, Selection option] [, RunID])
PREP_PROCESS_HOSTGROUP (AgentGroup [, Host] [, Selection option] [, RunID])

Parameter

• PREP_PROCESS_AGENTGROUP bzw. PREP_PROCESS_HOSTGROUP
  Ruft Agenten aus einem Objekt der Agentengruppe ab
• AgentGroup
  Name des Objekts der Agentengruppe
  Format: AE-Name, Script-Literal oder Script-Variable
• Host
  (Optional) Filtern nach Agentenname
  Hinweis: Verwenden Sie das Wildcardzeichen *, 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: *
• Selection option
  (Optional) Kriterien für die Auswahl von Agenten aus der Agentengruppe
  Format: AE-Name, Script-Literal oder Script-Variable
  Erlaubte Werte:
  • BY_RULE (Standard)
    Liefert den Agenten, auf dem die nächste Aufgabe ausgeführt wird
    Hinweis: Wenn die Agentengruppe auf -Modus eingestellt ist: Bei allen aktiven und inaktiven , liefern die Optionen BY_RULE und ALL das gleiche Ergebnis. 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 Agentengruppe-Containers angeben.
• RunID
  (Optional) RunID des Agentengruppe-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

Hinweise:

• Setzen Sie alle Kommas, auch wenn Sie die optionalen Parameter nicht verwenden.
• Um die Script-Variable, die die Datensequenzreferenz enthält, wiederzuverwenden, verwerfen Sie die Datensequenz mit der Script-Anweisung :CLOSE_PROCESS, bevor Sie der Script-Variablen einen neuen Wert zuweisen.

Rückgabewert

Diese Script-Funktion gibt einen Verweis auf die Datensequenz des Agentengruppen-Objekts zurück. Zur weiteren Verarbeitung weisen Sie die Datensequenz als Startparameter in den Script-Anweisungen :PROCESS... :TERM_PROCESS... :ENDPROCESS zu. Verwenden Sie die Script-Funktion GET_PROCESS_LINE, um auf einzelne Zeilen in der Datensequenz zuzugreifen. Informationen aus den folgenden beiden Spalten der Datensequenz abrufen:

• Name des Agenten
• Status des Agenten
  Tipp: Der Status ist wichtig 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
    Der Agent ist aktiv
  • N
    Der Agent ist inaktiv

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 in folgendem 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: