QRYPRBSTS

Interroger l'état d'incident

En bref

La commande QRYPRBSTS permet d'extraire les informations concernant l'état d'un incident à partir de *IBMSRV ou de tout autre système répertorié comme prestataire de maintenance.

QRYPRBSTS se lit QRY (Interroger) + PRBSTS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

QRYPRBSTS PRBID(…)

Paramètres

PRBID Identificateur de l'incident obligatoire
ORIGIN Origine
RMTCPNAME Point de contrôle éloigné
RMTNETID ID éloigné réseau
SRVID Numéro maintenance
BRANCH Numéro de branche
COUNTRY Numéro de Pays ou Région.
AUTOPRBCRT Création automatique incident

Astuce : dans une session 5250, tapez QRYPRBSTS 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 QRYPRBSTS permet d'extraire les informations concernant l'état d'un incident à partir de *IBMSRV ou de tout autre système répertorié comme prestataire de maintenance.

Restriction : Cette commande est livrée avec le droit public *EXCLUDE et les profils utilisateur QPGMR, QSYSOPR, QSRV et QSRVBAS disposent d'un droit privé d'utilisation sur celle-ci.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PRBID	Identificateur de l'incident	Valeur caractère, *PMR	Obligatoire, positionnel 1
ORIGIN	Origine	Liste d'éléments	Facultatif
	Élément 1: Identificateur réseau	Nom de communication, *NETATR
	Élément 2: Nom de point de contrôle	Nom de communication, *NETATR
RMTCPNAME	Point de contrôle éloigné	Nom de communication, IBMSRV, SELECT	Facultatif
RMTNETID	ID éloigné réseau	Nom de communication, *NETATR	Facultatif
SRVID	Numéro maintenance	Valeur caractère	Facultatif
BRANCH	Numéro de branche	Valeur caractère, *SRVID	Facultatif
COUNTRY	Numéro de Pays ou Région.	Valeur caractère, *SRVID	Facultatif
AUTOPRBCRT	Création automatique incident	YES, NO	Facultatif

Identificateur de l'incident (PRBID)

Indique l'identificateur d'incident du poste de l'historique des incidents. 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 sur un système donné.

*PMR: La demande de maintenance est adressée au service de maintenance IBM.
Remarque :Une valeur doit être indiquée pour le paramètre Numéro maintenance (SRVID) lorsque PRBID est *PMR.
valeur-alphanumérique: Indiquez un identificateur d'incident.

Ce paramètre est obligatoire.

Origine (ORIGIN)

Indique le noeud du système d'où provient le poste de l'historique des incidents. Ce paramètre est utilisé avec PRBID pour identifier uniquement cet incident.

Elément 1 : Identificateur réseau

*NETATR: La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
nom-communications: Indiquez un identificateur de réseau.

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

*NETATR: La valeur LCLNETID indiquée dans les attributs de réseau du système est utilisée.
nom-communications: Indiquez un nom de point de contrôle.

Point de contrôle éloigné (RMTCPNAME)

Indique la destination du prestataire de maintenance auquel la demande de maintenance est envoyée.

*IBMSRV: La demande de maintenance est adressée au service de maintenance IBM.
*SELECT: La liste des prestataires de maintenance s'affiche. L'utilisateur peut choisir la destination de sa demande de maintenance.
nom-communications: Indiquez le nom du point de contrôle destiné à recevoir la demande.

ID éloigné réseau (RMTNETID)

Indique le nom éloigné du réseau des prestataires de maintenance.

*NETATR: Le prestataire de maintenance est présent sur le réseau local.
nom-communications: Indiquez le nom du réseau du prestataire de maintenance auquel la demande est envoyée.

Numéro maintenance (SRVID)

Indique le numéro de maintenance associé au poste d'historique des incidents. Ce numéro a été affecté lorsque l'incident a été signalé au centre de maintenance IBM.

valeur-alphanumérique: Indiquez le numéro attribué par le service de maintenance pour le poste d'historique des incidents.

Numéro de branche (BRANCH)

Indique le numéro de branche pour le poste d'historique des incidents. Ce numéro a été affecté lorsque l'incident a été signalé au centre de maintenance IBM.

*SRVID: Le numéro de branche d'un poste d'historique des incidents existant dans le système actuel contenant le numéro de maintenance indiqué (paramètre SRVID) sera utilisé. Si aucun poste de l'historique des incidents du numéro de maintenance indiqué n'existe, un numéro de branche valide doit être indiqué.

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 le numéro de pays ou de région pour le poste d'historique des incidents. Ce numéro a été affecté lorsque l'incident a été signalé au centre de maintenance IBM.

*SRVID: Le numéro de pays ou de région d'un poste d'historique des incidents existant dans le système actuel contenant le numéro de maintenance indiqué (paramètre SRVID) sera utilisé. Si aucun poste de l'historique des incidents du numéro de maintenance indiqué n'existe, un numéro de pays ou de région valide doit être indiqué.

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.

Création automatique incident (AUTOPRBCRT)

Indique si un incident doit être créé automatiquement s'il n'existe pas sur le système.

*YES: Un incident est créé.
*NO: Ne créez pas d'incident.

Exemples

Exemple 1 : interrogation de l'état d'incident sur un autre système

QRYPRBSTS   PRBID(1234567890)  RMTCPNAME(SYSTEM99)
            RMTNETID(IBMNETID)  AUTOPRBCRT(*YES)

Cette commande permet de rechercher l'état d'un incident spécifique sur un autre système (SYSTEM99).

Exemple 2 : interrogation de la maintenance IBM

QRYPRBSTS   PRBID(*PMR)  RMTCPNAME(*IBMSRV)  RMTNETID(*NETATR)
            SRVID(23774) AUTOPRBCRT(*YES)

Cette commande permet de rechercher l'état de PMR 23774 dans la base de données de maintenance IBM.

Messages d'erreur

Messages *ESCAPE

CPF7AA7: Incident &1 non trouvé ou en cours d'utilisation.
CPF7AD4: Le format de l'ID réseau &1 est incorrect.
CPF7A84: La demande d'interrogation d'état a été dirigée vers un autre système.
CPF7A88: Erreur indiquée dans la réponse à la demande.
CPF7A9A: Nom de point de contrôle éloigné et ID réseau incorrects.
CPF7A9B: Impossible d'émettre une interrogation pour l'incident &1.
CPF7A97: Identificateur de maintenance incorrect.
CPF7A98: Identificateur de maintenance non admis.
CPF7A99: La demande doit être envoyée à *IBMSRV.
CPF7B18: Format de point de contrôle &1 incorrect.
CPF8C08: La valeur *SELECT est incorrecte comme nom de point de contrôle.
CPF8C09: &1 n'est pas défini comme prestataire de maintenance.
CPF8C24: Erreur lors du traitement de la demande.
CPFC680: Numéro de branche non admis.
CPFC681: Numéro de Pays ou Région non admis.
CPFC682: Numéro de branche incorrect.
CPFC683: Numéro de Pays ou région incorrect.

Messages *STATUS

CPZ7A80: Envoi d'une demande d'état à &1.