CHGALRTBL

Modifier une table d'alertes

En bref

La commande CHGALRTBL (Modifier une table d'alertes) permet de modifier l'une des valeurs définies par la commande CRTALRTBL (Créer une table d'alertes).

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

Syntaxe minimale

CHGALRTBL ALRTBL(…)

Paramètres

ALRTBL Table d'alertes obligatoire
LICPGM Produit
LICPGMTXT Texte du logiciel
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGALRTBL 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 CHGALRTBL (Modifier une table d'alertes) permet de modifier l'une des valeurs définies par la commande CRTALRTBL (Créer une table d'alertes). Les tables d'alerte définissent des alertes qui sont des notifications d'incident dans un réseau. La commande CHGALRTBL peut être utilisée pour modifier l'identification du produit, son texte ou le texte de l'objet associé à une table d'alertes. En général, c'est le programmeur ou l'opérateur système ou réseau responsable de la gestion du réseau qui utilise cette commande. Pour de plus amples informations sur les alertes, consultez le manuel Alerts Support, SC41-5413.

Remarque :Pour utiliser cette commande, vous devez disposer des droits de modification (*CHANGE) sur la table d'alerte considérée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
ALRTBL	Table d'alertes	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Table d'alertes	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
LICPGM	Produit	Valeur caractère, SAME, NONE	Facultatif
LICPGMTXT	Texte du logiciel	Valeur caractère, SAME, BLANK	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Table d'alertes (ALRTBL)

Indique le nom qualifié de la table d'alertes à modifier. Chaque table contient les descriptions d'alertes utilisées pour créer les alertes.

Ce paramètre est obligatoire.

Pour la bibliothèque, les valeurs possibles sont les suivantes :

*LIBL: La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours 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 celle-ci n'est pas définie dans la liste des bibliothèques, QGPL est prise par défaut.
nom-bibliothèque: Indiquez la bibliothèque contenant la table d'alertes. La recherche s'effectue uniquement dans la bibliothèque désignée. Vous devez disposer du droit de lecture (*READ) sur la bibliothèque indiquée.

Produit (LICPGM)

Indique le logiciel sous licence associé à cette table d'alertes. Ce logiciel est inclus dans l'alerte en tant qu'identification du produit logiciel pour l'émetteur de l'alerte.

*SAME: La valeur du paramètre LICPGM ne change pas.
*NONE: Aucun logiciel sous licence n'est précisé.
logiciel-sous-licence: Indiquez un ID produit de 7 caractères désignant le logiciel sous licence. Le gestionnaire des alertes utilise cet identificateur pour accéder à la base de données de gestion des ressources logicielles afin d'obtenir des renseignements relatifs au niveau d'édition.
Remarque :Ce paramètre ne doit pas nécessairement désigner un logiciel sous licence IBM. Vous pouvez indiquer n'importe quel ID de 7 caractères, significatif pour l'utilisation de la commande Gérer les alertes. Si la valeur donnée pour le paramètre LICPGM est définie, l'ID et le niveau d'édition seront inclus dans l'alerte.

Texte du logiciel (LICPGMTXT)

Indique le texte descriptif à associer au logiciel sous licence dans la table d'alertes (IBM i5/OS, par exemple). Ce texte est inclus dans l'alerte en tant qu'identification de produit pour l'émetteur de l'alerte.

*SAME: Le texte reste inchangé.
*NONE: Aucun texte n'est précisé.
'texte-logiciel-sous-licence': Indiquez un texte de 30 caractères au maximum décrivant le logiciel sous licence.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte reste inchangé.
*BLANK: Aucun texte n'est précisé.
'description': Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

CHGALRTBL   ALRTBL(ALRTBLLIB/ALRTBLNBR1)
            LICPGMTXT('i5/OS--défini par le client')

Cette commande permet de modifier le logiciel sous licence pour la table d'alertes ALRTBLNBR1 dans la bibliothèque ALRTBLLIB.

Messages d'erreur

*ESCAPE Messages

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.
CPF9810: Bibliothèque &1 non trouvée.
CPF9820: Non autorisé à utiliser la bibliothèque &1.