Aller au contenu

ADDPRBACNE

Ajouter poste action incident

En bref

La commande ADDPRBACNE permet d'ajouter un poste au filtre d'incident indiqué.

ADDPRBACNE se lit ADD (Ajouter) + PRBACNE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDPRBACNE FILTER(…) GROUP(…)

Paramètres

  • FILTER Filtre obligatoire
  • GROUP Groupe obligatoire
  • ASNUSER Attribué à l'utilisateur
  • SNDDTAQ Envoyer à file attente données

Astuce : dans une session 5250, tapez ADDPRBACNE 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 ADDPRBACNE permet d'ajouter un poste au filtre d'incident indiqué. Ce poste décrit les actions requises pour remédier à un incident. Un poste d'incident est attribué au groupe indiqué par un poste de sélection contenu dans le filtre d'incident.

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
GROUP Groupe Nom Obligatoire, positionnel 2
ASNUSER Attribué à l'utilisateur Nom simple, *NOCHG, *NONE Facultatif
SNDDTAQ Envoyer à file attente données Valeurs uniques: *NONE
Autres valeurs (jusqu'à 5 répétitions): Liste d'éléments
Facultatif
Élément 1: File d'attente de données Nom d'objet qualifié
Qualificatif 1: File d'attente de données Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
Élément 2: Clé file d'attente de données Valeur caractère, *NONE, X''

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.

Groupe (GROUP)

Groupe pour lequel les actions sont appliquées. Le nom du groupe est attribué en fonction des critères de sélection indiqués dans un poste de sélection contenu dans le filtre. Les postes de sélection sont ajoutés au filtre à l'aide de la commande ADDPRBSLTE.

Ce paramètre est obligatoire.

Attribué à l'utilisateur (ASNUSER)

Utilisateur attribué au poste de l'historique des incidents.

*NOCHG
Aucune nouvelle valeur n'est attribuée au poste de l'historique des incidents.
*NONE
Aucun utilisateur n'est attribué au poste de l'historique des incidents.
utilisateur-attribué
Indiquez un nom d'utilisateur.

Envoyer à file attente données (SNDDTAQ)

File d'attente de données associée à l'enregistrement de notification d'incident. Les files d'attente de données par clé sont acceptées.

Valeurs uniques

*NONE
Aucune file d'attente de données n'est utilisée.

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

Elément 1 : File d'attente de données

Qualificatif 1 : File d'attente de données

nom
Indiquez le nom de la file d'attente de données.

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
La file d'attente de données est recherchée 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 contenant la file d'attente de données.

Elément 2 : Clé file d'attente de données

*NONE
Aucune clé n'est utilisée pour la file d'attente de données.
valeur-alphanumérique
Indiquez la clé de la file d'attente de données.

REMARQUES :

  1. Lorsqu'un filtre est appliqué et qu'aucune correspondance exacte n'est trouvée pour le nom de groupe, les actions sont attribuées à l'aide du poste d'action par défaut. Ce poste est ajouté automatiquement au filtre lors de sa création. Les valeurs par défaut sont ASNUSER(*NONE) et SNDDTAQ(*NONE).
  2. Une file d'attente de données par clé est une file d'attente dans laquelle une clé est attribuée à chacun des postes qu'elle contient. L'indication d'une clé lors de l'extraction des postes permet de traiter tous les postes comportant cette clé dans l'ordre FIFO (Premier entré, premier sorti). La clé indiquée au paramètre *SNDDTAQ est attribuée à l'enregistrement de notification d'incident lorsque ce dernier est placé dans une file d'attente de données par clé.

Un enregistrement de 80 octets est mis dans la file d'attente de données indiquée par l'utilisateur. Cet enregistrement est reçu lorsque le programme QRCVDTAQ est appelé. La file d'attente de données ne doit pas être utilisée uniquement pour les incidents ; les alertes et les incidents peuvent partager la même file d'attente de données.

Si une clé est indiquée, celle-ci est utilisée lors de la mise en file d'attente de l'enregistrement. S'il ne s'agit pas d'une file d'attente de données par clé, l'enregistrement est mis en file d'attente sans clé.

Remarque :L'horodatage standard du système est utilisé. Il est déjà stocké dans l'enregistrement d'incidents.

Format d'enregistrement

Position  Type  Valeur                Description
--------  ----  -------------  --------------------------------
1-10      CHAR  *PRBFTR               Incident de filtrage de notif.
11-11     CHAR  Fonction              Fonction exécutée
                                1 - Incident créé
                                2 - Incident modifié
                                3 - Incident supprimé
12-19     CHAR  Fonct. tps réel       Horod. tps réel pour la fonct.
20-29     CHAR  Groupe                Incident de groupe filtré
30-39     CHAR  ID incident           Numéro ID de l'incident
40-59     CHAR  Système d'origine     Sys où l'incident s'est déclaré
60-60     CHAR  Dernier événement     Dernier événement validé dans
                               l'historique du sys (voir note)
61-68     CHAR  Evén tps réel         Horod. tps réel pour dern. évén.
69-80     CHAR  Réservé               Réservé à une utilisation future

Remarque :Les valeurs admises du dernier événement sont les suivantes :

    '01'X   Poste d'incident ouvert
    '02'X   Demande reçue
    '03'X   Ouvert par alerte
    '04'X   Signalé par HMC
    '05'X   Signalé par Service Partition
    '06'X   Signalé par la partition i5/OS actuelle
    '10'X   Incident identifié
    '11'X   Test de vérification lancé
    '12'X   Procédure de rétablissement lancée
    '20'X   Prêt à signaler
    '21'X   Demande de maintenance envoyée
    '22'X   Réponse à l'incident
    '23'X   Réponse envoyée
    '24'X   Signalé oralement
    '25'X   Corrections transmises
    '30'X   Correction vérifiée
    '41'X   Identifié à distance
    '42'X   Vérification à distance lancée
    '43'X   Rétablissement à distance lancé
    '50'X   Alerte créée
    '51'X   APAR créé
    '52'X   Données APAR sauvegardées
    '54'X   Données APAR restaurées
    '55'X   Données APAR supprimées
    '60'X   Incident modifié par la commande CHGPRB
    '61'X   Incident supprimé par la commande DLTPRB
    '99'X   Poste d'incident clos

Exemples

ADDPRBACNE   FILTER(MYLIB/MYFILTER)  GROUP(IOWA)
             ASNUSER(SYSOPR))  SNDDTAQ(*LIBL/PROBDTAQ)

Les actions définies pour le groupe IOWA sont : mises en file d'attente de l'incident dans la file d'attente de données PROBDTAQ et attribution de l'incident à l'utilisateur SYSOPR.

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é.
CPF91DB
Le groupe &4 existe déjà.
CPF91DE
Taille maximale du filtre &1/&2 atteinte.
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.
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.