Aller au contenu

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

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 :

  1. 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.
  2. 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.
  3. 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.
  4. 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))
    

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