CHGALRSLTE

Modifier poste sélect alerte

En bref

La commande CHGALRSLTE permet à l'utilisateur de modifier un poste de sélection d'alerte précédemment ajouté à l'aide de la commande ADDALRSLTE (Ajouter un poste de sélection d'alerte).

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

Syntaxe minimale

CHGALRSLTE FILTER(…) SEQNBR(…)

Paramètres

FILTER Filtre obligatoire
SEQNBR Numéro de séquence obligatoire
SELECT Données de sélection
GROUP Groupe

Astuce : dans une session 5250, tapez CHGALRSLTE 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 CHGALRSLTE permet à l'utilisateur de modifier un poste de sélection d'alerte précédemment ajouté à l'aide de la commande ADDALRSLTE (Ajouter un poste de sélection 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
FILTER	Filtre	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Filtre	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SEQNBR	Numéro de séquence	1-9999, *LAST	Obligatoire, clé, positionnel 2
SELECT	Données de sélection	Valeurs uniques: SAME, ANY Autres valeurs (jusqu'à 10 répétitions): Liste d'éléments	Facultatif
	Élément 1: Relation	IF, AND, *OR
	Élément 2: Attribut	ORIGIN, RSCNAME, RSCTYPE, HIERNAME, HIERTYPE, MSGID, MSGSEV, ALRID, ALRTYPE, ALRDSC, PBLCSE, USRCSE, INSCSE, FLRCSE, RSCHDW, SNDHDW, RSCSFW, SNDSFW
	Élément 3: Opérateur relationnel	EQ, GT, LT, NE, GE, LE, *CT
	Élément 4: Valeur	Valeur caractère
GROUP	Groupe	Nom, SAME, DEFAULT	Facultatif

Filtre (FILTER)

Indique le nom qualifié du filtre dans lequel le poste de sélection est modifié.

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é.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence du poste de sélection d'alerte. Les postes de sélection sont évalués par ordre de numéro de séquence.

*LAST: Permet à l'utilisateur de modifier la dernière sélection. Ce poste est ajouté automatiquement lors de la création du filtre et correspondra à toutes les alertes.
1-9999: Indiquez le numéro de séquence à utiliser.

Données de sélection (SELECT)

Indique les comparaisons à effectuer pour déterminer si l'alerte appartient au groupe indiqué. Le résultat de la comparaison est positif lorsque les données de l'alerte correspondent aux critères indiqués dans le paramètre SELECT. Jusqu'à dix valeurs d'attribut peuvent être comparées à l'alerte.

Valeurs particulières

*SAME: La valeur reste inchangée.
*ANY: Toutes les alertes répondent à cet enregistrement de sélection.

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

Indiquez les conditions qu'une alerte doit remplir pour correspondre au poste de sélection. Chaque condition doit comporter les quatre éléments suivants :

Un des opérateurs logiques *IF, *AND ou *OR
L'attribut comparé
Un des opérateurs de relation
La valeur d'attribut

Elément 1 : Relation

*IF: Identifie la première condition devant être remplie.
*AND: Les deux conditions reliées par l'opérateur *AND doivent être remplies.
*OR: Une des deux conditions reliées par l'opérateur *OR doit être remplie.
S'il existe un ou plusieurs ensembles de conditions, la valeur *IF doit être indiquée en tant que première valeur dans le premier ensemble de valeurs de comparaison. Si plusieurs ensembles de conditions sont indiqués, *AND ou *OR doit figurer en tant que première valeur dans chaque ensemble, hormis le premier. Chaque condition doit être précisée entre parenthèses. L'opérateur *AND est pris en compte avant *OR.

Elément 2 : Attribut

*ORIGIN

Indique si l'alerte est créée ou reçue. Les valeurs admises pour cet attribut sont L (créé localement) ou R (Reçu).

*RSCNAME

Indique le nom de la ressource défaillante. La valeur de cet attribut doit être un nom de 8 caractères.

*RSCTYPE

Indique le type de la ressource défaillante. La valeur de cet attribut doit être un type de ressource de trois caractères (TAP ou DKT, par exemple).

*HIERNAME

Indique toutes les ressources figurant dans la hiérarchie des ressources de l'alerte. Cette hiérarchie contient la liste des ressources, séparées par des blancs, affichées sur les écrans de données détaillées de la commande WRKALR (Gérer les alertes). La valeur de cet attribut peut être une liste de 5 noms de ressources maximum séparés par un blanc, à moins que la valeur ne soit utilisée avec l'opérateur de relation *CT. Dans ce dernier cas, la relation de sélection peut effectuer un test pour déterminer si le nom de ressource indiqué se trouve dans la hiérarchie. Cet attribut ne contient que les noms de ressources de la hiérarchie.

*HIERTYPE

Indique tous les types de ressources figurant dans la hiérarchie des ressources de l'alerte. Les types de ressource correspondent aux noms de ressources indiqués dans l'attribut *HIERNAME. La valeur de cet attribut peut être une liste de 5 types de ressources maximum, comportant de 1 à 3 caractères et séparés par des blancs, à moins que la valeur ne soit utilisée avec l'opérateur de relation *CT. Dans ce dernier cas, la relation de sélection peut effectuer un test pour déterminer si le type de ressource indiqué se trouve dans la hiérarchie.

*MSGID

Indique l'identificateur de message.

*MSGSEV

Indique la gravité du message. Cette valeur, comprise entre 00 et 99, représente le niveau de gravité du message (99 étant le niveau de gravité le plus élevé).

*ALRID

Indique l'identificateur d'alerte. Cet identificateur est affiché sur l'écran de données détaillées de la commande WRKALR (Gérer les alertes). La valeur de cet attribut doit être un nombre hexadécimal à 8 chiffres, à moins qu'elle ne soit utilisée avec l'opérateur de relation *CT. Si *CT ou un caractère générique est utilisé, l'attribut doit comporter un nombre pair de chiffres (8 au maximum). Il se peut que l'ID alerte ne soit pas un critère de comparaison correct pour les alertes créées après une analyse d'incident.

*ALRTYPE

Indique le point de code de type d'alerte associé à l'alerte. La valeur de cet attribut est un nombre hexadécimal à 2 chiffres.

*ALRDSC

Indique le point de code de description d'alerte associé à l'alerte. La valeur de cet attribut doit être un nombre hexadécimal à 4 chiffres, à moins qu'elle ne soit utilisée avec l'opérateur de relation *CT. Si *CT ou un caractère générique est utilisé, l'attribut doit comporter un nombre pair de chiffres (4 au maximum).

*PBLCSE

Indique le point de code de cause probable associé à l'alerte. La valeur de cet attribut doit être un nombre hexadécimal à 4 chiffres, à moins qu'elle ne soit utilisée avec l'opérateur de relation *CT. Si *CT ou un caractère générique est utilisé, l'attribut doit comporter un nombre pair de chiffres (4 au maximum).

*USRCSE

Indique le premier point de code de cause utilisateur associé à l'alerte. La valeur de cet attribut doit être un nombre hexadécimal à 4 chiffres, à moins qu'elle ne soit utilisée avec l'opérateur de relation *CT. Si *CT ou un caractère générique est utilisé, l'attribut doit comporter un nombre pair de chiffres (4 au maximum).

*INSCSE

Indique le premier point de code de cause installation associé à l'alerte. La valeur de cet attribut doit être un nombre hexadécimal à 4 chiffres, à moins qu'elle ne soit utilisée avec l'opérateur de relation *CT. Si *CT ou un caractère générique est utilisé, l'attribut doit comporter un nombre pair de chiffres (4 au maximum).

*FLRCSE

Indique le premier point de code de cause défaillance associé à l'alerte. La valeur de cet attribut doit être un nombre hexadécimal à 4 chiffres, à moins qu'elle ne soit utilisée avec l'opérateur de relation *CT. Si *CT ou un caractère générique est utilisé, l'attribut doit comporter un nombre pair de chiffres (4 au maximum).

*RSCHDW

Fournit des informations sur les ressources matérielles défaillantes associées à l'alerte. Ces informations sont affichées sur les écrans de données détaillées de la commande WRKALR (Gérer les alertes). Indiquez une valeur pour cet attribut en respectant le format suivant :

'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'

où tttt représente le type de machine, mmm le numéro de modèle et sssssssss le numéro de série. Respectez ce format pour représenter une ressource matérielle spécifique, ou bien indiquez une partie de la valeur avec l'opérateur de relation *CT pour obtenir une correspondance partielle.

*SNDHDW

Fournit des informations sur les ressources matérielles d'émission associées à l'alerte. Ces informations sont affichées sur les écrans de données détaillées de la commande WRKALR (Gérer les alertes). Indiquez une valeur pour cet attribut en respectant le format suivant :

'tttt mmm ss-sssssss'
'tttt mmm ss-sssss'
'tttt mmm sssssss'
'tttt mmm sssss'

*RSCSFW

Fournit des informations sur les ressources logicielles défaillantes. Ces informations sont affichées sur les écrans de données détaillées de la commande WRKALR (Gérer les alertes). Indiquez une valeur pour cet attribut en respectant le format suivant :

'ppppppp vv rr mm'

où ppppppp représente l'identificateur du logiciel sous licence, vv le numéro de version, rr le numéro d'édition et mm le niveau de modification. Respectez ce format pour représenter une ressource logicielle spécifique, ou bien indiquez une partie de la valeur avec l'opérateur de relation *CT pour obtenir une correspondance partielle.

*SNDSFW

Fournit des informations sur les ressources logicielles d'émission associées à l'alerte. Ces informations sont affichées sur les écrans de données détaillées de la commande WRKALR (Gérer les alertes). Indiquez une valeur pour cet attribut en respectant le format suivant :

'ppppppp vv rr mm'

Elément 3 : Opérateur relationnel

*EQ: L'attribut de la zone Attribut doit être égal à la valeur indiquée dans la zone Valeur d'attribut.
*GT: L'attribut de la zone Attribut doit être supérieur à la valeur indiquée dans la zone Valeur d'attribut.
*LT: L'attribut de la zone Attribut doit être inférieur à la valeur indiquée dans la zone Valeur d'attribut.
*NE: L'attribut de la zone Attribut doit être différent de la valeur indiquée dans la zone Valeur d'attribut.
*GE: L'attribut de la zone Attribut doit être supérieur ou égal à la valeur indiquée dans la zone Valeur d'attribut.
*LE: L'attribut de la zone Attribut doit être inférieur ou égal à la valeur indiquée dans la zone Valeur d'attribut.
*CT: L'attribut de la zone Attribut doit contenir la valeur indiquée dans la zone Valeur d'attribut.

Elément 4 : Valeur

valeur-attribut: Indiquez la valeur (60 caractères maximum) à comparer avec le contenu de l'attribut spécifié. Cette valeur doit être entrée entre apostrophes si elle contient des blancs ou des caractères spéciaux, et doit être de type caractère. Si une variable CL est indiquée pour la valeur, ce doit être une variable de type caractère.
valeur-attribut-générique*: Indiquez la valeur générique d'attribut. Une valeur générique est une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*), ABC* par exemple. Si un nom générique est indiqué, tous les attributs commençant par cette valeur seront recherchés. Si aucun astérisque n'est inclus dans la valeur générique (préfixe), le système considère qu'il s'agit de la valeur complète. Les valeurs génériques d'attribut ne sont admises qu'avec les opérateurs *EQ et *NE.

Groupe (GROUP)

Indique le groupe auquel une alerte est attribuée si elle répond aux critères indiqués dans le paramètre SELECT.

*SAME: La valeur reste inchangée.
*DEFAULT: L'alerte est attribuée au groupe *DEFAULT. Ce groupe est ajouté automatiquement lors de la création d'un filtre.
nom: Indiquez un nom de groupe auquel l'alerte est attribuée.

Exemples

CHGALRSLTE   FILTER(MYLIB/MYFILTER)  SEQNBR(10)
             SELECT(*SAME)  GROUP(NEWSTUFF)

Cette commande affecte l'élément NEWSTUFF à GROUP pour l'entrée de sélection 10 du filtre MYFILTER de la bibliothèque MYLIB.

Messages d'erreur

Messages *ESCAPE

CPD91CB: *CT non admis avec des valeurs numériques.
CPF2150: Erreur dans la fonction d'informations sur objet.
CPF2151: Erreur de l'opération sur &2 de &1 type *&3.
CPF812F: Filtre endommagé.
CPF91DC: Poste de sélection, numéro de séquence &4, introuvable.
CPF91DE: Taille maximale du filtre &1/&2 atteinte.
CPF91DF: Le mot clé SELECT ne peut pas être modifié pour le poste *LAST.
CPF91EA: Position de la relation *IF incorrecte.
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.
CPF91E6: Les valeurs génériques ne sont admises qu'avec *EQ ou *NE.
CPF91E7: Le caractère en position &4 est incorrect dans la valeur indiquée.
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.