ADDPRBSLTE
Ajouter poste sélect incident
En bref
La commande ADDPRBSLTE vous permet de définir des critères de sélection destinés à classer des groupes de postes de l'historique des incidents.
ADDPRBSLTE se lit ADD
(Ajouter) + PRBSLTE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
ADDPRBSLTE FILTER(…) SELECT(…)
Paramètres
-
FILTERFiltre obligatoire -
SELECTDonnées de sélection obligatoire -
SEQNBRNuméro de séquence -
GROUPGroupe
Astuce : dans une session 5250, tapez ADDPRBSLTE 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 ADDPRBSLTE vous permet de définir des critères de sélection destinés à classer des groupes de postes de l'historique des incidents. Vous pouvez ajouter un poste de sélection de l'historique des incidents à un filtre de l'historique des incidents précédemment créé à l'aide de la commande CRTFTR.
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 | *EVENT, *ORIGIN, *ORGNETID, *ORGCPNAM, *RCVNETID, *RCVCPNAM, *PROBTYPE, *SEV, *MSGID, *ORGHDW, *RSCHDW, *RSCSFW | ||
| É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)
Nom du filtre.
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 de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
- *CURLIB
- Le filtre est recherché dans la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque qui contient le filtre.
Données de sélection (SELECT)
Permet d'indiquer si un poste de l'historique des incidents est sélectionné ou non, selon que les informations contenues dans ce poste répondent ou non à une relation indiquée.
Vous pouvez indiquer une valeur unique (*ANY) ou bien les quatre éléments qui définissent une relation. Dans ce dernier cas, l'attribut et la valeur d'attribut sont comparés dans le cadre de la relation définie par l'opérateur relationnel.
Ce paramètre est obligatoire.
Valeurs uniques
- *ANY
- Tout poste de l'historique des incidents est sélectionné.
Autres valeurs (10 répétitions max.)
Elément 1 : Relation
- *IF
- Pour être sélectionné, un poste de l'historique des incidents doit répondre à la relation indiquée.
- *AND
- Pour être sélectionné, un poste de l'historique des incidents doit répondre à la relation de type *IF et à la relation indiquée.
- *OR
- Pour être sélectionné, un poste de l'historique des incidents doit répondre à la relation indiquée et/ou à la relation de type *IF.
Elément 2 : Attribut
- *EVENT
- Le filtre est appliqué lorsque le poste de l'historique des incidents est créé (valeur 1), modifié (valeur 2) ou supprimé (valeur 3). Si le poste a été créé et est modifié avant d'être validé, utilisez la valeur 1.
- *ORIGIN
- Le poste de l'historique des incidents a été créé en local (valeur L) ou provient d'un autre système (valeur R).
- *ORGNETID
- ID réseau du système d'où provient le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'rrrrrrrrrr'
- *ORGCPNAM
- Nom du point de contrôle du système d'où provient le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'cccccccccc'
- *RCVNETID
- ID réseau du système éloigné d'où provient le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'rrrrrrrrrr'
- *RCVCPNAM
- Nom du point de contrôle du système éloigné d'où provient le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'cccccccccc'
- *PROBTYPE
- Type de poste d'incident créé. Il peut s'agir d'un incident détecté par la machine (valeur 1), l'utilisateur (valeur 2), l'application (valeur 4), la machine client (valeur 5) ou l'utilisateur client (valeur 6). Il peut également s'agir d'une demande de PTF (valeur 3).
Remarque :Les incidents de matériel éloigné détectés par l'utilisateur sont regroupés dans la catégorie "Incidents détectés par l'utilisateur - 2".
- *SEV
- Gravité du poste de l'historique des incidents créé. Les choix possibles sont les suivants : élevée (valeur 1), moyenne (valeur 2), basse (valeur 3), aucune (valeur 4) ou non attribuée (valeur 5).
Remarque :Aucun niveau de gravité n'est attribué aux incidents générés en local.
- *MSGID
- ID message contenu dans le poste de l'historique des incidents. Il s'agit en général d'un identificateur de message i5/OS.
- *ORGHDW
- Informations sur la ressource matériel d'origine contenues dans le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'tttt mmm ss-sssssss' 'tttt mmm ss-sssss' 'tttt mmm sssssss' 'tttt mmm sssss'
où tttt, mmm et sssssssss désignent respectivement le type de machine, le numéro de modèle et le numéro de série. Respectez ce format pour obtenir une correspondance exacte de ressource matériel. Utilisez une partie de la valeur de la ressource matériel dans le cadre de la relation de type *CT (Inclus) pour obtenir une correspondance partielle.
- *RSCHDW
- Informations sur la ressource matériel défectueuse contenues dans le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'tttt mmm ss-sssssss' 'tttt mmm ss-sssss' 'tttt mmm sssssss' 'tttt mmm sssss'
où tttt, mmm et sssssssss désignent respectivement le type de machine, le numéro de modèle et le numéro de série. Respectez ce format pour obtenir une correspondance exacte de ressource matériel. Utilisez une partie de la valeur de la ressource matériel dans le cadre de la relation de type *CT (Inclus) pour obtenir une correspondance partielle.
- *RSCSFW
- Informations sur la ressource logiciel défectueuse contenues dans le poste de l'historique des incidents. Ces informations sont affichées à l'aide de la commande WRKPRB (Gérer les incidents) qui présente les détails relatifs à un incident. Indiquez la valeur de cet attribut en respectant le format suivant :
'lllllll vv ee mm'
où lllllll, vv, ee et mm désignent respectivement l'ID logiciel sous licence, le numéro de version, le numéro d'édition et le niveau de modification. Respectez ce format pour obtenir une correspondance exacte de ressource logiciel. Utilisez une partie de la valeur de la ressource logiciel dans le cadre de la relation de type *CT (Inclus) pour obtenir une correspondance partielle.
Elément 3 : Opérateur relationnel
La valeur indiquée pour l'élément 2 (Attribut) doit avoir la relation suivante à la valeur indiquée pour l'élément 4 (Valeur) de ce paramètre.
- *EQ
- Egal à
- *GT
- Supérieur à
- *LT
- Inférieur à
- *NE
- Différent de
- *GE
- Supérieur ou égal à
- *LE
- Inférieur ou égal à
- *CT
- Inclus
Elément 4 : Valeur
- valeur-attribut
- Indiquez une valeur de 30 caractères au maximum destinée à être comparée avec le contenu de l'attribut indiqué pour l'élément 2 de ce paramètre. Cette valeur doit être indiquée en respectant le format de type alphanumérique et être placée entre apostrophes si elle contient des blancs ou des caractères spéciaux. S'il s'agit d'une variable CL, elle doit être alphanumérique.
- valeur-attribut-générique
- Indiquez une valeur d'attribut générique. Une valeur générique est une chaîne de caractères composée de un ou plusieurs caractères, suivis d'un astérisque (*) ; par exemple, ABC*. Si vous indiquez un nom générique, toutes les valeurs commençant par la valeur générique sont sélectionnées. Si vous n'indiquez pas d'astérisque avec la valeur générique (préfixe), le système considère que vous avez entré la totalité de la valeur.
Numéro de séquence (SEQNBR)
Numéro de séquence du poste de sélection de l'historique des incidents. Les postes de sélection contenus dans un filtre sont classés par numéro de séquence. Lors de l'application d'un filtre, les essais sur les postes de sélection ont lieu par ordre croissant de numéro de séquence.
- *GEN
- Le numéro de séquence est créé par le système.
- 1-9999
- Indiquez un numéro de séquence.
Groupe (GROUP)
Groupe auquel est attribué un poste de l'historique des incidents s'il répond aux critères de sélection indiqués au paramètre SELECT.
- *DEFAULT
- Le poste de l'historique des incidents est attribué au groupe par défaut.
- nom
- Indiquez le nom du groupe.
Exemples
Exemple 1 : ajout d'un poste sélect
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *EVENT *EQ 1) (*AND *SEV *EQ 1))
SEQNBR(*GEN) GROUP(HIGHPROB)
Cette commande permet d'ajouter un poste au filtre PROBFILTER dans la bibliothèque PROBLIB. Tout incident créé et de niveau de gravité 1 est attribué au groupe HIGHPROB.
Exemple 2 : attribution de postes par ID réseau de système d'origine
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *ORGNETID *EQ 'IOWA')) SEQNBR(*GEN)
GROUP(IOWA)
Cette commande attribue à tout incident l'ID réseau de système d'origine IOWA au groupe IOWA.
Exemple 3 : attribution de postes par incidents de messages
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *MSGID *EQ 'CPF89*')) SEQNBR(*GEN)
GROUP(MSGCPF89)
Cette commande permet d'attribuer tout incident de message CPF8901, CPF8902, etc., au groupe MSGCPF89.
Exemple 4 : attribution de postes par incidents matériels
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCHDW *CT 9404)
(*OR *RSCHDW *CT 9406)
(*OR *RSCHDW *CT 9402))
SEQNBR(*GEN) GROUP(AS400USER)
Tous les incidents relatifs au matériel System i5 (informations sur le matériel incluant le type de machine 9402, 9404 ou 9406) sont attribués au groupe AS400USER.
Les opérations de contenu doivent être mises en oeuvre avec la plus grande attention. Dans cet exemple, si la machine émettrice portait un numéro de série contenant 9402, 9404 ou 9406, cette dernière ferait également référence au poste sélect correspondant, même si le type de machine n'est pas 9402, 9404 ou 9406. Voir l'exemple ci-après.
Exemple 5 : attribution de postes par incidents matériels
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCHDW *EQ 9404*)
(*OR *RSCHDW *EQ 9406*)
(*OR *RSCHDW *EQ 9402*))
SEQNBR(*GEN) GROUP(AS400USER)
Cette commande attribue tous les incidents du matériel System i5 (informations sur le matériel égales au type de machine 9402, 9404 ou 9406) au groupe AS400USER.
Il s'agit d'un moyen plus aisé de sélectionner le type de machine du matériel émetteur. Seules les machines de type 9402, 9404 ou 9406 correspondront.
Exemple 6 : attribution de postes par incidents détectés par la machine
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *PROBTYPE *EQ 1))
SEQNBR(*GEN) GROUP(MACHDETECT)
Cette commande permet d'attribuer tout incident détecté par la machine au groupe MACHDETECT.
Exemple 7 : attribution de postes par incidents spécifiques à un produit
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCSFW *EQ '5716SS1 03 06 00'))
SEQNBR(15) GROUP(OS400V3R6)
Cette commande permet d'attribuer tout incident spécifique au système d'exploitation en version 3 édition 6 modification 0 au groupe OS400V3R6. Remarque : ce poste est placé après le numéro de poste 10 dans le filtre, car la valeur 15 est définie en tant que numéro de séquence.
Exemple 8 : attribution de postes par produits correspondants
ADDPRBSLTE FILTER(PROBLIB/PROBFILTER)
SELECT((*IF *RSCSFW *EQ '5716SS1*'))
SEQNBR(25) GROUP(OS400)
Ce poste sélect correspond à la version 3 édition 6 du logiciel sous licence du système d'exploitation.
Remarques :
- L'ordre des postes sélect dans un filtre joue un rôle important. Lorsque le filtre est appliqué au poste de l'historique des incidents, les postes sélect sont examinés du premier jusqu'au dernier poste, par ordre croissant. Le premier poste sélect qui correspond à un incident est utilisé. Afin de garantir un fonctionnement correct, les postes sélect les plus spécifiques doivent apparaître en premier, et les postes sélect les moins spécifiques doivent apparaître en dernier.
- Si les postes sélect ne correspondent pas à un ordre particulier (c'est à dire que chaque poste sélect correspond uniquement à un incident), le poste sélect le plus probable ou le plus courant doit être placé en premier. Cette procédure garantit une performance maximum, car un nombre moins important de postes sélect devra être soumis à une vérification.
- Si aucun poste sélect n'a de correspondance lorsqu'un filtre est appliqué, le poste sélect *LAST est utilisé pour procéder à l'attribution d'un groupe. Le poste sélect *LAST est ajouté automatiquement au filtre lors de sa création. Le paramètre SELECT du poste sélect (*LAST) est (*ANY), et entraîne toujours une correspondance.
- L'opérateur logique *AND a la priorité sur l'opérateur logique *OR dans un poste sélect. Par conséquent, la spécification SELECT :
((*IF *PROBTYPE *EQ 1) (*AND *SEV *EQ 1) (*OR *PROBTYPE *EQ 2) (*AND *SEV *EQ 1))
est équivalente à l'expression booléenne suivante :
if ((*PROBTYPE = 1) and (*SEV = 1)) or ((*PROBTYPE = 2) and (*SEV = 1))
- Toutes les valeurs d'attribut sont interprétées en tant que données de type caractère, y compris les nombres. Lorsque le filtre d'incident est appliqué à un incident, le système convertit toutes les données du filtre en données du type défini dans le modèle d'incident, puis ces dernières sont comparées. Les ID message sont considérés comme des données de type caractère et sont classés en conséquence.
Messages d'erreur
Messages *ESCAPE
- CPF2150
- Erreur dans la fonction d'informations sur objet.
- CPF2151
- Erreur de l'opération sur &2 de &1 type *&3.
- CPF7A82
- Une erreur s'est produite lors de l'application du filtre d'incident.
- 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.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.