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:

• Agentengruppen (HOSTG)
• :PROCESS... :TERM_PROCESS... :ENDPROCESS
• GET_PROCESS_LINE

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: