ADDALRACNE

Ajouter poste action alerte

En bref

La commande ADDALRACNE permet à l'utilisateur d'ajouter un poste d'action au filtre d'alerte indiqué.

ADDALRACNE se lit ADD (Ajouter) + ALRACNE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDALRACNE FILTER(…) GROUP(…)

Paramètres

FILTER Filtre obligatoire
GROUP Groupe obligatoire
LOG Consigner alerte
ASNUSER Attribué à l'utilisateur
SEND Envoyer au système
SNDDTAQ Envoyer à file attente données
GENTRAP Générer interruption SNMP

Astuce : dans une session 5250, tapez ADDALRACNE puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande ADDALRACNE permet à l'utilisateur d'ajouter un poste d'action au filtre d'alerte indiqué. Ce poste décrit les actions à entreprendre pour une alerte qui a été attribuée au groupe indiqué. Pour plus de détails sur les alertes, reportez-vous au manuel Alerts Support, SC41-5413.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILTER	Filtre	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Filtre	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
GROUP	Groupe	Nom	Obligatoire, positionnel 2
LOG	Consigner alerte	YES, NO, *NETATR	Facultatif
ASNUSER	Attribué à l'utilisateur	Valeur caractère, *NONE	Facultatif
SEND	Envoyer au système	Valeurs uniques: NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Identificateur réseau	Nom de communication, NETATR, FOCALPT
	Élément 2: Point de contrôle	Nom de communication
SNDDTAQ	Envoyer à file attente données	Valeurs uniques: NONE Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments*	Facultatif
	Élément 1: File d'attente de données	Nom d'objet qualifié
	Qualificatif 1: File d'attente de données	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
	Élément 2: Clé file d'attente de données	Valeur caractère, *NONE, X''
GENTRAP	Générer interruption SNMP	NO, YES	Facultatif

Filtre (FILTER)

Indique le filtre auquel le poste d'action est ajouté.

Ce paramètre est obligatoire.

Qualificatif 1 : Filtre

nom: Indiquez le nom du filtre.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: Le filtre est recherché dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée pour ce travail, c'est QGPL qui est prise en compte.
nom: Indiquez le nom de la bibliothèque dans laquelle le filtre est recherché.

Groupe (GROUP)

Indique le nom du groupe auquel les actions définies doivent être appliquées. Le nom du groupe est attribué à partir des critères de sélection indiqués dans le filtre.

Ce paramètre est obligatoire.

nom: Indiquez le nom du groupe.

Consigner alerte (LOG)

Indique si l'alerte est consignée.

*NETATR: L'attribut de réseau ALRLOGSTS contrôle la consignation de cette alerte.
*YES: L'alerte est consignée.
*NO: L'alerte n'est pas consignée.

Attribué à l'utilisateur (ASNUSER)

Indique l'utilisateur à attribuer à l'alerte.

*NONE: Aucun utilisateur n'est indiqué.
valeur-alphanumérique: Indiquez un nom d'utilisateur.

Envoyer au système (SEND)

Indique la destination de l'alerte. Une alerte ne peut pas être envoyée au système local. Le système vérifie cette action lorsque l'alerte est envoyée.

Valeurs particulières

*NONE: L'alerte n'est pas envoyée.

Autres valeurs (jusqu'à 5 répétitions)

Elément 1 : Identificateur réseau

*FOCALPT: Envoie l'alerte au point focal du système. Le point focal est déterminé au moment de l'envoi.
*NETATR: La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
nom-communications: Indiquez l'ID réseau du noeud de destination.

Elément 2 : Point de contrôle

nom-communications: Indiquez le nom du point de contrôle du système de destination.

Envoyer à file attente données (SNDDTAQ)

Indique la file d'attente de données dans laquelle l'enregistrement de notification d'alerte est placé. Les files d'attente de données par clé sont supportées.

Le nom de la file d'attente de données peut être qualifié par l'une des valeurs de bibliothèque suivantes :

Valeurs particulières

*NONE: Aucune file d'attente de données n'est utilisée.

Autres valeurs (jusqu'à 5 répétitions)

Elément 1 : File d'attente de données

Qualificatif 1 : File d'attente de données

nom: Indiquez le nom de la file d'attente de données.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques du travail jusqu'à ce que la première occurrence soit trouvée.

*CURLIB: La file d'attente de données est recherchée dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée pour ce travail, c'est QGPL qui est prise en compte.
nom: Indiquez le nom de la bibliothèque dans laquelle la file d'attente de données est recherchée.

Elément 2 : Clé file d'attente de données

*NONE: Aucune clé n'est utilisée pour la file d'attente de données.
valeur-alphanumérique: Indiquez la clé de la file d'attente de données.

Générer interruption SNMP (GENTRAP)

Indique si l'alerte génère une interruption SNMP.

*NO: Aucune interruption SNMP n'est générée à partir de cette alerte.
*YES: Une interruption SNMP est générée à partir de cette alerte.

Exemples

ADDALRACNE   FILTER(MYLIB/MYFILTER)  GROUP(CHICAGO)
             LOG(*NETATR)  ASNUSER(CHICAGOOPR)
             SEND((*FOCALPT) (*NETATR.MILWKEE))
             SNDDTAQ(*LIBL/ALERTDTAQ)

Cette commande définit les actions suivantes pour le groupe CHICAGO :

Consignez l'alerte basée sur l'attribut de réseau ALRLOGSTS.
Envoyez l'alerte au point focal du système.
Envoyez l'alerte au système avec un nom du point de contrôle MILWKEE et un ID réseau basé sur la valeur LCLNETID spécifiée dans les attributs de réseau du système.
Insérez une notification d'alerte dans la file d'attente ALERTDTAQ.
Attribuez l'alerte à l'utilisateur CHICAGOOPR.

Messages d'erreur

Messages *ESCAPE

CPF2150: Erreur dans la fonction d'informations sur objet.
CPF2151: Erreur de l'opération sur &2 de &1 type *&3.
CPF812F: Filtre endommagé.
CPF91DB: Le groupe &4 existe déjà.
CPF91DE: Taille maximale du filtre &1/&2 atteinte.
CPF91EB: Le type de filtre &3 n'est pas correct pour cette opération. Filter type &3 not correct for this operation.
CPF91EC: Une erreur interne de traitement s'est produite.
CPF91E8: Une erreur interne de traitement s'est produite.
CPF9802: Non autorisé à l'objet &2 de &3.
CPF9803: Impossible d'allouer l'objet &2 de la bibliothèque &3.
CPF9807: Une ou plusieurs bibliothèques de la liste ont été supprimées.
CPF9808: Allocation impossible pour une ou plusieurs bibliothèques de la liste.
CPF9830: Allocation de la bibliothèque &1 impossible.