ADDALRSLTE
Ajouter poste sélection alerte
En bref
La commande ADDALRSLTE permet à l'utilisateur d'ajouter un poste de sélection d'alerte à un filtre d'alerte.
ADDALRSLTE se lit ADD
(Ajouter) + ALRSLTE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
ADDALRSLTE FILTER(…) SELECT(…)
Paramètres
-
FILTERFiltre obligatoire -
SELECTDonnées de sélection obligatoire -
SEQNBRNuméro de séquence -
GROUPGroupe
Astuce : dans une session 5250, tapez ADDALRSLTE 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 ADDALRSLTE permet à l'utilisateur d'ajouter un poste de sélection d'alerte à un filtre d'alerte. Les postes de sélection sont les critères qui classent par catégorie un groupe d'alertes. 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 | ||
| SELECT | Données de sélection | Valeurs uniques: *ANY Autres valeurs (jusqu'à 10 répétitions): Liste d'éléments |
Obligatoire, positionnel 2 |
| É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 | ||
| SEQNBR | Numéro de séquence | 1-9999, *GEN | Facultatif |
| GROUP | Groupe | Nom, *DEFAULT | Facultatif |
Filtre (FILTER)
Indique le filtre à ajouter.
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é.
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.
Ce paramètre est obligatoire.
Valeurs particulières
- *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'
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.
- *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'
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.
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.
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.
- *GEN
- Permet au système de générer le numéro de séquence. Ce numéro sera supérieur à tous les postes de sélection précédents.
- 1-9999
- Indiquez le numéro de séquence à utiliser.
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.
- *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
ADDALRSLTE FILTER(MYLIB/MYFILTER)
SELECT((*IF *RSCNAME *EQ CHICAGO1)
(*AND *RSCTYPE *EQ CP))
SEQNBR(*GEN) GROUP(CHICAGO)
Cette commande ajoute un poste de sélection 0010 au filtre MYFILTER dans la bibliothèque MYLIB (une entrée 0010 est générée car aucun poste n'a été ajouté au filtre). Toute alerte associée à un nom de ressource de 'CHICAGO1' et à un type de ressource de 'CP' (point de contrôle) est affectée au groupe CHICAGO.
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é.
- CPF91DA
- Le numéro de séquence &4 existe déjà.
- CPF91DE
- Taille maximale du filtre &1/&2 atteinte.
- CPF91D9
- Création automatique de numéro de séquence impossible.
- 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.
- CPF9830
- Allocation de la bibliothèque &1 impossible.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.