PREP_PROCESS_AGENTGROUP

La fonction de script PREP_PROCESS_AGENTGROUP vous permet d'extraire les agents d'un objet Groupe d'agents. Cette fonction de script vous permet de définir des critères de sélection d'agents de ce groupe. La fonction de script renvoie une référence à une séquence de données que vous pouvez utiliser pour poursuivre le traitement.

Syntaxe

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

Paramètres

• PREP_PROCESS_AGENTGROUP ou PREP_PROCESS_HOSTGROUP
  Extrait les agents d'un objet Groupe d'agents
• AgentGroup
  Nom de l'objet Groupe d'agents
  Format: Nom AE, littéral de script ou variable de script
• Host
  (Optionnel) Filtre par nom d'agent
  Remarque : Le caractère générique * représente un nombre quelconque de caractères et ? représente un seul caractère.
  Format : littéral de script ou variable de script
  Longueur maximale : 32 caractères
  Par défaut : *
• Selection option
  (Optionnel) Critères de sélection des agents du groupe d'agents
  Format: Nom AE, littéral de script ou variable de script
  Valeurs autorisées :
  • BY_RULE (standard)
    Renvoie l'agent sur lequel la prochaine tâche sera exécutée
    Remarque :si le groupe d'agents est défini avec le Mode : Tous les actifs et inactifs, les options BY_RULE et ALL renvoient le même résultat. Pour plus d'informations, voir Définir les groupes d'agents.
  • ALL
    Renvoie tous les agents du groupe d'agents
  • RUNNR
    Extrait les agents sur lesquels une tâche a été exécutée
    Remarque : Vous devez spécifier le RunID du conteneur de groupe d'agents.
• RunID
  (optionnel) RunID du conteneur du groupe d'agents
  Remarque : Ne spécifiez le RunID que lorsque vous utilisez l'option RUNNR pour sélectionner des agents.
  Format : littéral de script, variable de script ou nombre

Remarques :

• Mettez toutes les virgules, même si vous n'utilisez pas les paramètres optionnels.
• Pour réutiliser la variable de script contenant la référence de séquence de données, supprimez la séquence de données contenant l'instruction de script :CLOSE_PROCESS avant d'affecter une nouvelle valeur à la variable de script.

Code retour

Cette fonction de script renvoie une référence à la séquence de données de l'objet Groupe d'agents. Pour la poursuite du traitement, affectez la séquence de données en tant que paramètre de démarrage dans les instructions de script :PROCESS... :TERM_PROCESS... :ENDPROCESS. Utilisez la fonction de script GET_PROCESS_LINE pour accéder à chaque ligne de la séquence de données. Récupérez les informations des deux colonnes suivantes dans la séquence de données :

• Nom de l'agent
• Statut de l'agent
  Conseil : Le statut est important pour les groupes d'agents avec le paramètre mode : Tous les actifs et inactifs. Pour ces groupes d'agents, la fonction de script renvoie systématiquement tous les agents, quel que soit leur statut. Utilisez les informations de statut pour récupérer les agents sur lesquels des tâches peuvent être actuellement exécutées.
  Valeurs possibles :
  • Y
    L'agent est actif
  • N
    L'agent est inactif

Exemples

L'exemple suivant illustre l'extraction de tous les agents des objets Groupe d'agents dont le nom commence par WIN.

: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#

Dans l'exemple suivant, la fonction de script SYS_ACT_ME_NR renvoie le RunID d'exécution d'une tâche. Le script se sert du RunID de la tâche pour extraire celui du conteneur du Groupe d'agents, puis lit les valeurs des agents sur lesquels la tâche a été exécutée.

: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#

L'exemple suivant illustre l'extraction du statut de tous les agents d'un groupe d'agents :

: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

Voir aussi :