CVTPFRTHD

Convertir données perf exéc

En bref

La commande CVTPFRTHD convertit les enregistrements de données de performance de travail.

CVTPFRTHD se lit CVT (Convertir) + PFRTHD. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CVTPFRTHD MBR(…)

Paramètres

MBR Membre obligatoire
LIB Bibliothèque
REPLACE Remplacement

Astuce : dans une session 5250, tapez CVTPFRTHD 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 CVTPFRTHD convertit les enregistrements de données de performance de travail. Elle prend en charge les données collectées par la commande STRPFRMON (Démarrer le moniteur de performances) ou celles générées par la commande CRTPFRDTA (Créer données de performance).

Le membre spécifié (paramètre MBR) du fichier QAPMJOBS ou QAPMJOBL contient des enregistrements comportant des données de performance au niveau de l'unité d'exécution. Vous pouvez utiliser CVTPFRTHD pour convertir ces données et écrire les enregistrements qui en résultent dans un membre de même nom (paramètre MBR) du fichier QAPMTJOB. Le membre du fichier de sortie contiendra des enregistrements comportant des données de performance au niveau du travail représentant le total des données de performance pour toutes les unités d'exécution actives dans ce travail.

Le fichier en entrée (QAPMJOBS ou QAPMJOBL) doit se trouver dans la bibliothèque spécifiée au paramètre LIB. Si tel n'est pas le cas, ce fichier sera créé automatiquement. Un membre de fichier du nom spécifié (paramètre MBR) sera automatiquement ajouté au fichier QAPMTJOB, s'il n'existe pas déjà.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MBR	Membre	Nom	Obligatoire, positionnel 1
LIB	Bibliothèque	Nom, QPFRDATA	Facultatif
REPLACE	Remplacement	YES, NO	Facultatif

Membre (MBR)

Indique le membre du fichier QAPMJOBS ou du fichier QAPMJOBL contenant les collectes à traiter. Ce membre sera créé, s'il n'existe pas déjà, ou sera remplacé dans le fichier QAPMTJOB.

nom: Indiquez le nom du membre contenant les données de performance au niveau de l'unité d'exécution.

Bibliothèque (LIB)

Indique la bibliothèque contenant le fichier d'entrée et dans laquelle le fichier QAPMTJOB réside ou va être créé.

QPFRDATA: La bibliothèque de données de performances fournie par IBM, QPFRDATA, doit être utilisée pour localiser le fichier d'entrée de base de données.
nom: Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier de base de données d'entrée.

Remplacement (REPLACE)

Indique si le membre indiqué du fichier QAPMTJOB va être remplacé.

*YES: Si le membre n'existe pas déjà, il est créé. S'il existe, les données qu'il contient sont remplacées.
*NO: Si le membre n'existe pas déjà, il est créé. S'il existe, les données qu'il contient ne sont pas remplacées et un message d'erreur est envoyé.

Exemples

CVTPFRTHD   MBR(MYDATA)

Cette commande permet de convertir les enregistrements de données de performances. Le membre MYDATA du fichier QAPMJOBL ou APMJOBS dans la bibliothèque QPFRDATA contient les collectes à traiter.

Messages d'erreur

*ESCAPE Messages

CPF0A83: Données de performances d'unités d'exécutions non converties.
CPF0A84: Le membre existe déjà.
CPF0A85: Le profil utilisateur &1 n'est pas autorisé à utiliser la bibliothèque &2.
CPF2110: Bibliothèque &1 non trouvée.
CPF2817: Commande de copie interrompue à la suite d'une erreur.
CPF5030: Membre &4 partiellement endommagé.
CPF9810: Bibliothèque &1 non trouvée.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9845: Erreur lors de l'ouverture du fichier &1.
CPF9846: Erreur lors du traitement du fichier &1 de &2.