Aller au contenu

WRKPRB

Gérer les incidents

En bref

La commande WRKPRB (Gérer les incidents) affiche les postes d'historique des incidents correspondant aux incidents détectés par le système ou l'utilisateur.

WRKPRB se lit WRK (Gérer) + PRB. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKPRB

Paramètres

Astuce : dans une session 5250, tapez WRKPRB 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande WRKPRB (Gérer les incidents) affiche les postes d'historique des incidents correspondant aux incidents détectés par le système ou l'utilisateur.

Les incidents peuvent être supprimés de l'historique à l'aide de la commande DLTPRB (Supprimer enregistrement d'incident).

Restriction : Cette commande est fournie avec le droit public *EXCLUDE et les profils utilisateurs QPGMR, QSYSOPR, QSRV et QSRVBAS disposent des droits privés permettant de l'utiliser.

Paramètres

Mot-clé Description Valeurs possibles Remarques
PRBID Identificateur de l'incident Valeur caractère, *ALL Facultatif, positionnel 1
STATUS Type d'état Valeurs uniques: *ALL
Autres valeurs (jusqu'à 6 répétitions): *OPENED, *READY, *PREPARED, *SENT, *ANSWERED, *VERIFIED, *CLOSED
Facultatif
SEV Filtre de gravité Valeurs uniques: *ALL
Autres valeurs (jusqu'à 3 répétitions): 1, 2, 3, 4
Facultatif
PERIOD Période Liste d'éléments Facultatif
Élément 1: Heure et date de début Liste d'éléments
Élément 1: Heure de début Heure, *AVAIL
Élément 2: Date de début Date, *BEGIN, *CURRENT
Élément 2: Heure et date de fin Liste d'éléments
Élément 1: Heure de fin Heure, *AVAIL
Élément 2: Date de fin Date, *END, *CURRENT
HARDWARE Matériel Liste d'éléments Facultatif
Élément 1: Type d'unité Valeur caractère, *ALL
Élément 2: Numéro de modèle Valeur caractère, *ALL
Élément 3: Numéro de série Valeur caractère, *ALL
RESOURCE Nom de ressource Nom, *ALL Facultatif
LICPGM Produit Liste d'éléments Facultatif
Élément 1: Identificateur du logiciel Valeur caractère, *ALL
Élément 2: Edition Valeur caractère, *ALL
Élément 3: Niveau de modification Valeur caractère, *ALL
FUNCTION Fonction Valeur caractère, *ALL Facultatif
PGM Programme Nom générique, nom, *ALL Facultatif
MSGID Identificateur de message Nom générique, nom, *ALL Facultatif
ORIGIN Origine Liste d'éléments Facultatif
Élément 1: Identificateur réseau Nom de communication, *ALL, *NETATR
Élément 2: Nom de point de contrôle Nom de communication, *ALL, *NETATR
SRVID Numéro maintenance Valeur caractère, *ALL Facultatif
BRANCH Numéro de branche Valeur caractère, *ALL Facultatif
COUNTRY Numéro de Pays ou Région. Valeur caractère, *ALL Facultatif
ASNUSER Attribué à l'utilisateur Nom simple, *ALL Facultatif
GROUP Attribué au groupe Valeur caractère, *ALL Facultatif
PRBTYPE Type de l'incident *ALL, 1, 2, 3, 4, 5, 6 Facultatif
PRBCGY Catégorie de l'incident *ALL, *REPORT, *CRITICAL, *LOGONLY Facultatif

Identificateur de l'incident (PRBID)

Indique l'identificateur de l'incident choisi. Des incidents système de diverses origines peuvent avoir le même identificateur. Vous pouvez utiliser ce paramètre avec ORIGIN pour sélectionner un seul incident ayant une origine système donnée.

*ALL
Tous les identificateurs d'incidents sont sélectionnés.
identificateur-incident
Indiquez l'identificateur de l'incident sélectionné (10 caractères).

Type d'état (STATUS)

Indique l'état des postes de l'historique des incidents. Les sept types d'état possibles sont les suivants :

*OPENED
L'incident est à l'état détecté. Il a été identifié et un enregistrement a été créé.
*READY
L'incident est à l'état prêt. Des informations sur l'identification de l'incident ont été ajoutées à l'enregistrement.
*PREPARED
L'incident est à l'état préparé. Un rapport d'incident va être établi.
*SENT
L'incident est à l'état envoyé. Il a été transmis à un prestataire de maintenance, mais aucune réponse n'a été reçue.
*ANSWERED
L'incident est à l'état réponse. Une réponse a été envoyée par le prestataire de maintenance ou ajoutée par un opérateur système.
*VERIFIED
L'incident est à l'état vérifié. Il a été résolu et l'opérateur système a vérifié que la solution apportée était correcte.
*CLOSED
L'incident a été classé.

Valeurs uniques

*ALL
Affiche tous les postes de l'historique des incidents, quel que soit leur état.

Autres valeurs (6 répétitions max.)

type-d'état
Indiquez le type d'état à afficher.

Filtre de gravité (SEV)

Indique le niveau de gravité de l'incident, déterminé par l'utilisateur lors de la préparation du rapport d'incident. Les niveaux de gravité sont au nombre de quatre :

1
Elevé
2
Moyen
3
Faible
4
Aucune

Valeurs uniques

*ALL
Affiche tous les postes de l'historique des incidents.

Autres valeurs (3 répétitions max.)

gravité
Indiquez le niveau de gravité des postes de l'historique des incidents à afficher.

Période (PERIOD)

Indique la période sur laquelle est basée la sélection des postes de l'historique des incidents. Les dates et heures précisées (début et fin) indiquent les date et heure de création des postes.

Elément 1 : Heure et date de début

Elément 1 : Heure de début

*AVAIL
Affiche les postes consignés le jour correspondant à la date de début indiquée.
heure
Entrez l'heure de création (pour la date indiquée) du premier poste à afficher.

L'heure est indiquée dans un format 24 heures, avec ou sans séparateurs :

  • Si vous n'utilisez pas de séparateur, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss) où hh = heures, mm = minutes et ss = secondes. Ces trois éléments doivent comporter deux chiffres (au besoin, utilisez des zéros à gauche).
  • Si vous utilisez un séparateur, indiquez une chaîne de 5 ou 8 chiffres. Le séparateur défini pour votre travail doit être inséré entre les heures, les minutes et les secondes. Lorsque vous entrez cette commande à partir de la ligne de commande, la chaîne doit être placée entre apostrophes. Si vous utilisez un autre séparateur que celui défini pour votre travail, cette commande n'aboutira pas.

Elément 2 : Date de début

*BEGIN
Affiche les postes depuis le début de l'historique.

Remarque :Si *BEGIN est indiqué, les valeurs autres que *AVAIL ne sont pas prises en compte pour l'heure de début.

*CURRENT
Affiche les postes créés le jour même, dans la tranche horaire indiquée le cas échéant.
date
Indiquez la date de début à partir de laquelle les données consignées sont affichées. Cette date doit être conforme au format de date du travail.

Elément 2 : Heure et date de fin

Elément 1 : Heure de fin

*AVAIL
Affiche le poste correspondant à la date de fin indiquée.
heure
Entrez l'heure de création (pour la date indiquée) du dernier poste à afficher. Pour savoir comme entrer celle-ci, reportez-vous à la description de l'élément 1 dans cette description de paramètre.

Elément 2 : Date de fin

*END
Affiche les postes jusqu'à la fin de l'historique.

Remarque :Si *END est indiqué, les valeurs autres que *AVAIL ne sont pas prises en compte pour l'heure de fin.

*CURRENT
Affiche les postes créés le jour même, dans la tranche horaire indiquée le cas échéant.
date
Indiquez la date de fin jusqu'à laquelle les données consignées doivent être affichées. Vous devez utiliser le format de date du travail.

Matériel (HARDWARE)

Indique le matériel sur lequel est basée la sélection des postes de l'historique des incidents.

Elément 1 : Type d'unité

*ALL
Affiche tous les postes, quelle que soit l'unité signalée comme défaillante.

Remarque :Si *ALL est indiqué, les valeurs autres que *ALL pour le numéro de modèle et le numéro de série ne sont pas prises en compte.

type
Indiquez le code du type de matériel (4 caractères).

Elément 2 : Numéro de modèle

*ALL
Affiche tous les postes identifiant les unités matérielles défaillantes du type indiqué.

Remarque :Si *ALL est indiqué, les valeurs autres que *ALL pour le numéro de série ne sont pas prises en compte.

modèle
Indiquez le numéro de modèle de l'unité matérielle (3 caractères).

Elément 3 : Numéro de série

*ALL
Affiche tous les postes identifiant les unités matérielles défaillantes du type et du modèle indiqués.
série
Indiquez le numéro de série de l'unité matérielle, en respectant l'un des formats suivants, où "n" représente un caractère ou un chiffre.
  • nnnnn
  • nnnnnnn
  • nn-nnnnn
  • nn-nnnnnnn
  • nnnnnnnnnnnn

Nom de ressource (RESOURCE)

Indique le nom de ressource sur lequel est basée la sélection des postes de l'historique des incidents.

*ALL
Affiche tous les postes, quelle que soit, le cas échéant, la ressource identifiée.
nom
Indiquez le nom de ressource.

Produit (LICPGM)

Indique le logiciel sous licence sur lequel est basée la sélection des postes de l'historique des incidents.

Elément 1 : Identificateur du logiciel

*ALL
Affiche tous les postes, quel que soit le logiciel signalé comme défaillant.

Remarque :Si *ALL est indiqué, les valeurs autres que *ALL pour l'édition et le niveau de modification ne sont pas prises en compte.

valeur-alphanumérique
Indiquez le numéro d'identification du logiciel sous licence.

Elément 2 : Edition

*ALL
Affiche tous les postes qui signalent comme défaillant un composant du logiciel sous licence indiqué.

Remarque :Si *ALL est indiqué, les valeurs autres que *ALL pour le niveau de modification ne sont pas prises en compte.

valeur-alphanumérique
Indiquez le niveau d'édition à deux chiffres du logiciel sous licence, y compris les zéros à gauche. Le niveau d'édition est un nombre compris entre 00 et 35.

Elément 3 : Niveau de modification

*ALL
Affiche tous les postes qui signalent comme défaillant un composant du logiciel sous licence et de l'édition indiqués.
valeur-alphanumérique
Indiquez le numéro de modification à deux chiffres du logiciel sous licence, y compris les zéros à gauche. Le numéro de modification est un nombre compris entre 00 et 09 ou entre 0A et 0Z.

Fonction (FUNCTION)

Indique la fonction sur laquelle est basée la sélection des postes de l'historique des incidents. Cette fonction n'existe que pour les postes signalant des incidents détectés par l'utilisateur. Elle représente un domaine fonctionnel ou un logiciel majeur.

*ALL
Affiche tous les postes, quel que soit, le cas échéant, l'ID fonction précisé.
identificateur-fonction-générique
Indiquez un ID fonction générique. Un ID générique est une chaîne formée d'un ou plusieurs caractères suivis d'un astérisque (*). Si cette chaîne comporte des blancs, elle doit être indiquée entre apostrophes (').
identificateur-fonction
Indiquez l'ID fonction complet. Si cette chaîne comporte des blancs, elle doit être indiquée entre apostrophes (').

Les valeurs possibles d'identificateur de fonction sont les suivantes :

ID
Description
ALRT
Alertes
APF
Fonctions évoluées d'impression
APPC
Communications évoluées de programme à programme
APPN
Fonction Gestion de réseau paritaire
APS
Advanced DBCS Printer Support program
ASYNC
Communication asynchrone
BAS
Compilateur BASIC
BGU
BGU (Utilitaire de graphiques de gestion)
BSC
Transmission binaire synchrone
CBL
Compilateur COBOL
CGU
Character generator utility
CL
Langage de contrôle
CSM
Télégestion de systèmes distribués
C400
Compilateur C
DDM
Gestion de fichiers éloignés
DFU
Utilitaire de création-maintenance de fichier
DHCF
Logiciel tributaire de télécontrôle
DICT
Dictionnaires de langue
DSNX
Logiciel relais d'échange d'informations
ECS
Téléservices
FINANCE
Communications bancaires
FTN
Compilateur FORTRAN
FTS
File transfer support
GDDM
Gestionnaire d'affichage de données graphiques
ICF
Intersystem Communication Facility (ICF OS/400)
IDU
Fonction de définition de fichier (IDDU)
INTRA
Communications INTRA
IPDS
Flot IPDS
ITF
Interactive terminal facility
LPDA
Aide au diagnostic de la liaison
MIA
MI Assembler
MIGR
Migration
OBJD
Distribution d'objets
OCL
S/36 OCL (operator control language)
OFC
OfficeVision
OSP
IBM i
PAS
Compilateur Pascal
PASSTHRU
Passe-système
PC400
Client Access pour Windows
PDM
Gestionnaire de développement (PDM)
PL1
Compilateur PL/I
POSCOM
Utilitaire de communications point de vente
QRY
Requête
RETAIL
Communications point de vente
REXX
Interpréteur REXX
RJE
Télésoumission de travaux
RLU
Utilitaire de maquette d'état
RPFT
Outils de performances
RPG
Compilateur RPG
RSCS
Sous-système de communications de spoule éloigné
RWS
Poste de travail éloigné
SDA
Aide à la conception d'images-écran
SDLC
Commande de transmission synchrone de liaison de données
SEU
Editeur de source
SMU
IBM System Manager for i
SNADS
Services de distribution SNA
SNUF
SNA upline facility
SORT
Utilitaire de tri
SQL
SQL
SUU
System upgrade utility
TCPIP
Utilitaires de connectivité TCP/IP
TRLAN
Réseau en anneau à jeton
TXT38
Editeur de texte compatible System/38
VMC
Microcode sous licence i5/OS
VNET
RSCS/PROFS
WRD
Traitement de texte
X21
Réseau public de transmission de données X.21
X25
Réseau à commutation de paquets X.25
3270EM
Emulation 3270
802.3
Ethernet

Programme (PGM)

Indique le programme défaillant sur lequel est basée la sélection des postes de l'historique des incidents. Pour les incidents détectés par le système, le programme éventuellement défaillant est identifié par sa cause la plus probable.

*ALL
Affiche tous les postes, qu'un programme soit précisé ou non.
nom-générique
Indiquez un nom de programme générique. Un nom générique est une chaîne formée d'un ou plusieurs caractères suivis d'un astérisque (*).
nom
Indiquez le nom du programme.

Identificateur de message (MSGID)

Indique l'identificateur de message sur lequel est basée la sélection des postes de l'historique des incidents.

*ALL
Affiche tous les postes, quel que soit l'ID message associé à l'incident.
nom-générique
Indiquez un identificateur de message générique. Un ID générique est une chaîne formée d'un ou plusieurs caractères suivis d'un astérisque (*).
nom
Indiquez l'identificateur de message.

Origine (ORIGIN)

Indique le système sur lequel est basée la sélection des postes de l'historique des incidents.

Elément 1 : Identificateur réseau

*ALL
Affiche tous les postes, quel que soit l'ID réseau du système d'origine.
*NETATR
Affiche uniquement les postes provenant de systèmes dont l'ID local du réseau correspond à celui indiqué dans les attributs de réseau de votre système.
nom-communications
Indiquez un ID réseau. Seuls les postes provenant de systèmes dont l'ID local du réseau correspond à la valeur indiquée seront affichés.

Elément 2 : Nom de point de contrôle

*ALL
Affiche tous les postes provenant de systèmes dont l'ID local du réseau indiqué correspond à la valeur indiquée.
*NETATR
Affiche uniquement les postes provenant de systèmes dont le nom de point de contrôle local correspond à celui indiqué dans les attributs du réseau de votre système.
nom-communications
Indiquez un nom de point de contrôle.

Numéro maintenance (SRVID)

Indique le numéro de maintenance sur lequel est basée la sélection des postes de l'historique des incidents. Ce numéro a été affecté lorsque l'incident a été signalé au centre de maintenance IBM.

*ALL
Affiche tous les postes, quel que soit le numéro de maintenance éventuellement attribué.
valeur-alphanumérique
Indiquez le numéro de maintenance affecté.

Numéro de branche (BRANCH)

Indique si seuls les postes d'historique des incidents avec le numéro de branche indiqué s'affichent ou non. Ce numéro a été affecté lorsque l'incident a été signalé au centre de maintenance IBM.

*ALL
Affiche tous les postes, quel que soit le numéro de branche éventuellement attribué.
valeur-alphanumérique
Indiquez le numéro de branche à trois chiffres pour le poste d'historique des incidents. Les trois chiffres sont requis.

Numéro de Pays ou Région. (COUNTRY)

Indique si seuls les postes d'historique des incidents avec le numéro de pays ou de région indiqué s'affichent ou non. Ce numéro a été affecté lorsque l'incident a été signalé au centre de maintenance IBM.

*ALL
Affiche tous les postes, quel que soit le numéro de pays ou de région éventuellement attribué.
valeur-alphanumérique
Indiquez le numéro de pays ou de région à trois chiffres pour le poste d'historique des incidents. Les trois chiffres sont requis.

Attribué à l'utilisateur (ASNUSER)

Attribué à l'utilisateur (ASNUSER)

Indique si seuls les postes d'incident affectés à cet utilisateur sont affichés.

*ALL
Affiche tous les postes de l'historique des incidents.
nom-utilisateur
Indiquez l'ID utilisateur attribué aux incidents à afficher.

Attribué au groupe (GROUP)

Groupe du filtre auquel est attribué l'incident.

*ALL
Tous les postes de l'historique du programme sont affichés, quel que soit le groupe qui leur est attribué.
valeur-alphanumérique
Indiquez le groupe de filtre d'incident attribué au poste (10 caractères).

Remarque :La zone est à blanc si la fonction de filtre n'est pas utilisée.

Type de l'incident (PRBTYPE)

Indique le type d'incident à gérer.

*ALL
Tous les postes de l'historique des incidents s'affichent, quel que soit le type de l'incident.
1
Seuls les incidents détectés par la machine s'affichent.
2
Seuls les incidents détectés par l'utilisateur s'affichent.
3
Seuls les incidents liés à une de demande de PTF s'affichent.
4
Seuls les incidents détectés par l'application s'affichent.
5
Seuls les incidents détectés par la machine client s'affichent.
6
Seuls les incidents détectés par l'utilisateur client s'affichent.

Catégorie de l'incident (PRBCGY)

Indique la catégorie d'incidents à afficher.

*ALL
Tous les incidents s'affichent.
*REPORT
Les incidents consignés puis signalés au prestataire de maintenance s'affichent.
*CRITICAL
Les incidents graves s'affichent.
*LOGONLY
Les incidents qui sont consignés mais qui ne sont pas signalés au prestataire de maintenance s'affichent.

Exemples

Exemple 1 : affichage des postes portant l'état DETECTE ou PRET

WRKPRB   STATUS(*OPENED *READY) HDW(9347)

Cette commande permet d'afficher l'écran Gestion des incidents en ne montrant que les postes d'incident portant l'état DETECTE ou PRET et identifiant une unité défectueuse de type 9347.

Exemple 2 : affichage des postes d'incident de ce jour

WRKPRB   PERIOD((*AVAIL *CURRENT))

Cette commande permet d'afficher l'écran Gestion des incidents en montrant tous les postes d'incident créés dans l'historique de ce jour.

Exemple 3 : affichage d'une liste des incidents matériels

WRKPRB   SEV(1 2)  HARDWARE(9347 001 '10-7523489')

Cette commande permet d'afficher une liste contenant les incidents relatifs au matériel défini par l'utilisateur. L'utilisateur a demandé que la commande analyse les niveaux de gravité moyens à élevés.

Exemple 4 : affichage des incidents détectés

WRKPRB   STATUS(*OPENED)
         PERIOD((*AVAIL  *CURRENT) (120000  *CURRENT))
         LICPGM(5722SS1  03  00)  PGM(QNOPGM)

Cette commande permet d'afficher une liste contenant les incidents ouverts lors d'une période commençant à minuit et finissant à midi ce jour, et qui n'ont pas encore été analysés. Cette commande permet également de déterminer l'identificateur et le nom du logiciel sous licence comme cause probable de la défaillance.

Exemple 5 : affichage d'une liste d'incidents détectés par la machine

WRKPRB   RESOURCE(TAP01)  MSGID(CPF6788)

Cette commande permet d'afficher une liste des incidents détectés par la machine par l'intermédiaire du message CPF6788 envoyé dans la file d'attente de messages de l'opérateur système, et sur lesquels une analyse d'incident a été effectuée. L'analyse d'incident a été effectuée afin de déterminer le nom de la ressource de l'unité suspectée de défaillance. Il s'agit ici de l'unité TAP01. La liste d'incidents comprend les incidents détectés par l'utilisateur. Pour extraire les incidents détectés par l'utilisateur, ce dernier a spécifié le nom de ressource et l'identificateur de message via la commande ANZPRB (Analyser les incidents).

Exemple 6 : affichage d'une liste des incidents signalés

WRKPRB   SRVID(12345)

Cette commande permet d'afficher une liste des incidents signalés à un identificateur de maintenance IBM.

Messages d'erreur

Messages *ESCAPE

CPF7A9C
Historique des incidents inutilisable pour l'instant.
CPF7D41
Erreur lors de la consignation de la demande d'assistance pour commande.
CPF7D42
Erreur lors de l'exécution d'une opération de base de données.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9871
Erreur lors du traitement.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.