CHGALRD

Modifier description d'alerte

En bref

La commande CHGALRD (Modifier une description d'alerte) permet de modifier une description d'alerte ajoutée par la commande ADDALRD (Ajouter une description d'alerte).

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

Syntaxe minimale

CHGALRD 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 CHGALRD 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 CHGALRD (Modifier une description d'alerte) permet de modifier une description d'alerte ajoutée par la commande ADDALRD (Ajouter une description d'alerte). Pour plus de détails sur les alertes, reportez-vous au manuel Alerts Support, SC41-5413.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MSGID	Identificateur de message	Nom	Obligatoire, clé, positionnel 1
ALRTBL	Table d'alertes	Nom d'objet qualifié	Obligatoire, clé, positionnel 2
	Qualificatif 1: Table d'alertes	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
ALRTYPE	Type d'alerte	00-F0, SAME, NONE	Facultatif
ALRD	Point de code descr d'alerte	0000-FFF0, SAME, NONE	Facultatif
PBLCAUSE	Point de code cause probable	Valeurs uniques: SAME, NONE Autres valeurs (jusqu'à 99 répétitions): 0000-FFF0	Facultatif
CAUSE	Cause	Valeurs uniques: SAME, 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: SAME, 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 qui contient 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 le nom de la bibliothèque dans laquelle la table d'alertes doit être recherchée.

Type d'alerte (ALRTYPE)

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

*SAME: Le point de code du type d'alerte reste le même.
*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.

*SAME: Le point de code de la description d'alerte reste le même.
*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.

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

*SAME: Le point de code associé à la cause probable reste le même.
*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 défaillance. 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

*SAME: Le point de code de cause reste le même.
*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

*SAME: Le point de code associé à une action préconisée ne change pas.
*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

CHGALRD   MSGID(USR1234)  ALRTBL(USER/USRMSGS)
          ALRTYPE(*SAME)  ALRD(*SAME)  PBLCAUSE(1000 3121 6302)
          CAUSE(*SAME)  ACTION(*SAME)

Cette commande ajoute une cause probable 6302 à la description d'alerte illustrée dans l'exemple de commande ADDALRD (Ajouter description d'alerte).

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.
CPF7BB1: Description d'alerte non trouvée.
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.