ADDALRD

Ajouter description d'alerte

En bref

La commande ADDALRD (Ajouter une description d'alerte) permet d'ajouter une description d'alerte à la table d'alertes précisée.

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

Syntaxe minimale

ADDALRD MSGID(…) ALRTBL(…)

Paramètres

MSGID Identificateur de message obligatoire
ALRTBL Table d'alertes obligatoire
ALRTYPE Type d'alerte
ALRD Point de code descr d'alerte
PBLCAUSE Point de code cause probable
CAUSE Cause
ACTION Action préconisée

Astuce : dans une session 5250, tapez ADDALRD 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 ADDALRD (Ajouter une description d'alerte) permet d'ajouter une description d'alerte à la table d'alertes précisée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MSGID	Identificateur de message	Nom	Obligatoire, positionnel 1
ALRTBL	Table d'alertes	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Table d'alertes	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
ALRTYPE	Type d'alerte	00-F0, *NONE	Facultatif
ALRD	Point de code descr d'alerte	0000-FFF0, *NONE	Facultatif
PBLCAUSE	Point de code cause probable	Valeurs uniques: *NONE Autres valeurs (jusqu'à 99 répétitions): 0000-FFF0	Facultatif
CAUSE	Cause	Valeurs uniques: NONE Autres valeurs (jusqu'à 99 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Type de cause	USER, INSTALL, *FAILURE
	Élément 2: Point de code cause	Valeur hexadécimale
	Élément 3: ID données détail 1	Valeur hexadécimale, *NONE
	Élément 4: Données détail 1	Valeur caractère, *NODATA
	Élément 5: ID données détail 2	Valeur hexadécimale, *NONE
	Élément 6: Données détail 2	Valeur caractère, *NODATA
	Élément 7: ID données détail 3	Valeur hexadécimale, *NONE
	Élément 8: Données détail 3	Valeur caractère, *NODATA
	Élément 9: Identificateur du produit	NONE, SNDHDW, SNDSFW, RSCHDW
ACTION	Action préconisée	Valeurs uniques: NONE Autres valeurs (jusqu'à 99 répétitions): Liste d'éléments*	Facultatif
	Élément 1: Type d'action	USER, INSTALL, FAILURE, UNKNOWN
	Élément 2: Point de code action	Valeur hexadécimale
	Élément 3: ID données détail 1	Valeur hexadécimale, *NONE
	Élément 4: Données détail 1	Valeur caractère, *NODATA
	Élément 5: ID données détail 2	Valeur hexadécimale, *NONE
	Élément 6: Données détail 2	Valeur caractère, *NODATA
	Élément 7: ID données détail 3	Valeur hexadécimale, *NONE
	Élément 8: Données détail 3	Valeur caractère, *NODATA
	Élément 9: Identificateur du produit	NONE, SNDHDW, SNDSFW, RSCHDW

Identificateur de message (MSGID)

Indique l'ID message auquel cette description d'alerte correspond.

Ce paramètre est obligatoire.

nom: Indiquez l'identificateur de message.

Table d'alertes (ALRTBL)

Indique la table d'alertes dans laquelle est créée cette description d'alerte.

Ce paramètre est obligatoire.

Qualificatif 1 : Table d'alertes

nom: Indiquez le nom de la table d'alertes à utiliser.

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 table d'alertes 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 la bibliothèque contenant la table d'alertes. La recherche s'effectue uniquement dans la bibliothèque mentionnée. L'utilisateur doit disposer des droits d'utilisation *USE sur cette bibliothèque.

Type d'alerte (ALRTYPE)

Indique le point de code associé au type d'alerte.

*NONE: Il n'existe pas de point de code associé au type d'alerte pour cette description d'alerte.
X'00'-X'F0': Indiquez le point de code du type d'alerte.

Point de code descr d'alerte (ALRD)

Indique le point de code associé à la description d'alerte.

*NONE: Il n'existe pas de point de code associé à cette description d'alerte.
X'0000'-X'FFF0': Indiquez le point de code de la description d'alerte à utiliser.

Point de code cause probable (PBLCAUSE)

Indique les points de code (99 au maximum) associés aux causes probables d'incidents, classés par ordre de probabilité décroissante.

Valeurs particulières

*NONE: Il n'existe pas de point de code de cause probable d'incident pour cette description d'alerte.

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

X'0000'-X'FFF0': Indiquez le point de code de la cause probable.

Cause (CAUSE)

Indique s'il s'agit d'une cause utilisateur, installation ou incident. Il est possible de préciser jusqu'à 99 causes probables.

Suivant le point de code spécifié, vous pouvez indiquer jusqu'à trois qualifiants de données détaillées ou un qualifiant d'identificateur de produit. Un qualifiant de données détaillées se compose de l'ID données détaillées et des données détaillées.

Valeurs particulières

*NONE: Il n'existe pas de point de code de cause pour cette description d'alerte.

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

Elément 1 : Type de cause

*USER: Un point de code associé à une cause utilisateur suit.

*INSTALL: Un point de code associé à une cause installation suit.
*FAILURE: Un point de code associé à une cause incident suit.

Elément 2 : Point de code cause

valeur-hexadécimale: Indiquez le point de code de cause.

Elément 3 : ID données détail 1

*NONE: Il n'existe pas de point de code ID données détaillées pour ce point de code.
valeur-hexadécimale: Indiquez le point de code d'identificateur de données détaillées utilisé pour identifier ces données. Vous pouvez indiquer jusqu'à trois identificateurs de données détaillées par session.

Elément 4 : Données détail 1

*NODATA: Il n'existe pas de données détaillées pour ce point de code.
valeur-alphanumérique: Indiquez 40 caractères au maximum. Une variable de substitution provenant de la description de message correspondante peut être précisée. Dans ce cas, les données du message sont transférées dans la description d'alerte lors de la création de cette alerte.

Elément 5 : ID données détail 2

*NONE: Il n'existe pas de point de code ID données détaillées pour ce point de code.
valeur-hexadécimale: Indiquez le point de code d'identificateur de données détaillées utilisé pour identifier ces données. Vous pouvez indiquer jusqu'à trois identificateurs de données détaillées par session.

Elément 6 : Données détail 2

*NODATA: Il n'existe pas de données détaillées pour ce point de code.
valeur-alphanumérique: Indiquez 40 caractères au maximum. Une variable de substitution provenant de la description de message correspondante peut être précisée. Dans ce cas, les données du message sont transférées dans la description d'alerte lors de la création de cette alerte.

Elément 7 : ID données détail 3

*NONE: Il n'existe pas de point de code ID données détaillées pour ce point de code.
valeur-hexadécimale: Indiquez le point de code d'identificateur de données détaillées utilisé pour identifier ces données. Vous pouvez indiquer jusqu'à trois identificateurs de données détaillées par session.

Elément 8 : Données détail 3

*NODATA: Il n'existe pas de données détaillées pour ce point de code.
valeur-alphanumérique: Indiquez 40 caractères au maximum. Une variable de substitution provenant de la description de message correspondante peut être précisée. Dans ce cas, les données du message sont transférées dans la description d'alerte lors de la création de cette alerte.

Elément 9 : Identificateur du produit

*NONE: Il n'existe pas d'identificateur de produit pour ce point de code.
*SNDHDW: Indique le matériel de l'émetteur (toujours System i5).
*SNDSFW: Indique le code logiciel de l'émetteur de l'alerte. Ce code est fourni par la valeur LICPGM de la commande CRTALRTBL (Créer une table d'alertes).
*RSCHDW: Indique le matériel de la ressource défaillante, déterminé par la hiérarchie des ressources dans la description de message.

Action préconisée (ACTION)

Indique une ou plusieurs actions préconisées (99 au maximum) pour une cause utilisateur, installation ou défaillance.

Valeurs particulières

*NONE: Il n'existe pas de point de code associé à une action préconisée pour cette description d'alerte.

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

Elément 1 : Type d'action

*USER: Un point de code associé à une cause utilisateur suit.

*INSTALL: Un point de code associé à une action préconisée pour une cause installation suit.
*FAILURE: Un point de code associé à une action préconisée pour une cause incident suit.
*UNKNOWN: Un point de code associé à une action préconisée pour une cause non déterminée suit.

Elément 2 : Point de code action

valeur-hexadécimale: Indiquez le point de code d'action préconisée.

Elément 3 : ID données détail 1

*NONE: Il n'existe pas de point de code ID données détaillées pour ce point de code.
valeur-hexadécimale: Indiquez le point de code d'identificateur de données détaillées utilisé pour identifier ces données. Vous pouvez indiquer jusqu'à trois identificateurs de données détaillées par session.

Elément 4 : Données détail 1

*NODATA: Il n'existe pas de données détaillées pour ce point de code.
valeur-alphanumérique: Indiquez 40 caractères au maximum. Une variable de substitution provenant de la description de message correspondante peut être précisée. Dans ce cas, les données du message sont transférées dans la description d'alerte lors de la création de cette alerte.

Elément 5 : ID données détail 2

*NONE: Il n'existe pas de point de code ID données détaillées pour ce point de code.
valeur-hexadécimale: Indiquez le point de code d'identificateur de données détaillées utilisé pour identifier ces données. Vous pouvez indiquer jusqu'à trois identificateurs de données détaillées par session.

Elément 6 : Données détail 2

*NODATA: Il n'existe pas de données détaillées pour ce point de code.
valeur-alphanumérique: Indiquez 40 caractères au maximum. Une variable de substitution provenant de la description de message correspondante peut être précisée. Dans ce cas, les données du message sont transférées dans la description d'alerte lors de la création de cette alerte.

Elément 7 : ID données détail 3

*NONE: Il n'existe pas de point de code ID données détaillées pour ce point de code.
valeur-hexadécimale: Indiquez le point de code d'identificateur de données détaillées utilisé pour identifier ces données. Vous pouvez indiquer jusqu'à trois identificateurs de données détaillées par session.

Elément 8 : Données détail 3

*NODATA: Il n'existe pas de données détaillées pour ce point de code.
valeur-alphanumérique: Indiquez 40 caractères au maximum. Une variable de substitution provenant de la description de message correspondante peut être précisée. Dans ce cas, les données du message sont transférées dans la description d'alerte lors de la création de cette alerte.

Elément 9 : Identificateur du produit

*NONE: Il n'existe pas d'identificateur de produit pour ce point de code.
*SNDHDW: Indique le matériel de l'émetteur (toujours System i5).
*SNDSFW: Indique le code logiciel de l'émetteur de l'alerte. Ce code est fourni par la valeur LICPGM de la commande CRTALRTBL (Créer une table d'alertes).
*RSCHDW: Indique le matériel de la ressource défaillante, déterminé par la hiérarchie des ressources dans la description de message.

Exemples

ADDALRD   MSGID(USR1234)  ALRTBL(USER/USRMSGS)
          ALRTYPE(01)  ALRD(3100)  PBLCAUSE(1000 3121)
          CAUSE((*USER 6001)(*FAILURE 1000)(*FAILURE 3121))
          ACTION((*USER 1000)
                 (*FAILURE 00B0 00A5 'DSPMSG QSYSOPR')
                 (*FAILURE F0A0 22 '&5')
                 (*FAILURE 00E1 *NONE *NODATA *NONE
                  *NODATA *NONE *NODATA *SNDHDW))

Cette commande définit trois actions d'incident recommandées :

'00B0', qui requiert un qualificatif détaillé. Un qualificatif de données détaillé est fourni.
Le point de code d'identificateur de données détaillées est '00A5'. Il identifie la commande de texte.
Les données détaillées 'DSPMSG QSYSOPR'.

L'action d'incident recommandée 'F0A0' indique une variable de substitution de message ('&5') comme données détaillées. Lorsque le message 'USR1234' est envoyé, les données de message de la variable '&5' sont intégrées à l'alerte pour les données détaillées.

L'action d'incident X'00E1' référence un identificateur de produit. Le cas échéant, il s'agit du serveur d'envoi matériel System i5. Des marques de réservation sont nécessaires pour les qualificatifs de données détaillées.

Messages d'erreur

Messages *ESCAPE

CPF1A01: La table d'alertes &1 de &2 ne peut pas être étendue. Alert table &1 in &2 cannot be extended.
CPF1A02: Le code d'alerte &1 figure déjà dans la table d'alertes &2. Alert code &1 already in alert table &2.
CPF1A03: L'identificateur d'alerte &1 figure déjà dans la table d'alertes &2. Alert identifier &1 already in alert table &2.
CPF1A05: La table d'alertes &1 de &2 est endommagée. Alert table &1 in &2 damaged.
CPF2499: L'identificateur de message &1 n'est pas valide.
CPF7BB0: La description d'alerte existe déjà.
CPF7BB5: Description d'alerte &1 non ajoutée à la table d'alertes &2 de &3.
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
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.
CPF9810: Bibliothèque &1 non trouvée.
CPF9811: Programme &1 non trouvé dans la bibliothèque &2.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9814: Unité &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9821: Non autorisé au programme &1 de &2.
CPF9822: Non autorisé au fichier &1 de &2.
CPF9825: Accès non autorisé à l'unité &1.
CPF9830: Allocation de la bibliothèque &1 impossible.
CPF9831: Allocation de l'unité &1 impossible.
CPF9899: Erreur lors du traitement de la commande.