CVTPFRDTA

Convertir données performance

En bref

La commande CVTPFRDTA permet de convertir les données de performances d'une édition précédente au format requis par l'édition en cours des outils IBM Performance Tools for i en vue de leur traitement.

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

Syntaxe minimale

CVTPFRDTA FROMLIB(…) TOLIB(…)

Paramètres

FROMLIB Bibliothèque d'origine obligatoire
TOLIB Bibliothèque de destination obligatoire
JOBD Description de travail

Astuce : dans une session 5250, tapez CVTPFRDTA 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 permet d'abord de déterminer le niveau d'édition auquel les données ont été collectées. Ensuite, les membres de tous les fichiers nécessaires sont convertis.

Les anciennes données demeurent dans la bibliothèque en cours (FROMLIB) et les nouvelles données résident dans la nouvelle bibliothèque (TOLIB). Tous les fichiers sont copiés dans la nouvelle bibliothèque, y compris les fichiers qui n'ont pas besoin d'être convertis.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FROMLIB	Bibliothèque d'origine	Nom	Obligatoire, positionnel 1
TOLIB	Bibliothèque de destination	Nom	Obligatoire, positionnel 2
JOBD	Description de travail	Valeurs uniques: USRPRF, NONE Autres valeurs: Nom d'objet qualifié	Facultatif
	Qualificatif 1: Description de travail	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB

Bibliothèque d'origine (FROMLIB)

Indique la bibliothèque contenant les fichiers à convertir.

Ce paramètre est obligatoire.

nom: Indiquez le nom de la bibliothèque dans laquelle se situent les fichiers à convertir.

Bibliothèque de destination (TOLIB)

Indique la bibliothèque devant recevoir les fichiers convertis.

Ce paramètre est obligatoire.

nom: Indiquez le nom de la bibliothèque dans laquelle se trouvent les fichiers convertis.

Description de travail (JOBD)

Indique le nom de la description de travail utilisée pour soumettre des travaux en traitement par lots.

Valeurs uniques

*USRPRF: La description de travail définie par le profil utilisateur est utilisée.
*NONE: Un traitement par lots n'est pas soumis. En revanche, le traitement se poursuit en interactif pendant que l'utilisateur attend. Le poste de travail de l'utilisateur n'est pas disponible à ce stade, ce qui peut porter à conséquence pour les travaux de longue durée.

Qualificatif 1 : Description de travail

nom: Indiquez le nom de la description de travail à utiliser.

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 description de travail est recherchée dans la bibliothèque en cours du travail. Si aucune entrée de bibliothèque en cours ne figure dans la liste des bibliothèques, la bibliothèque QGPL est utilisée par défaut.
nom: Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Exemples

Exemple 1 : Conversion des données à l'aide d'un travail par lots

CVTPFRDTA   FROMLIB(MIKE)  TOLIB(TERESA)

Cette commande permet de convertir les données de performances de la bibliothèque MIKE et de les placer dans la bibliothèque TERESA. La conversion est effectuée par un travail par lots soumis à l'aide d'une description de travail associée au profil utilisateur de l'utilisateur qui exécute cette commande.

Exemple 2 : Conversion interactive des données de performances

CVTPFRDTA   FROMLIB(MIKE)  TOLIB(TERESA)  JOBD(*NONE)

Cette commande permet de convertir les données de performances de la bibliothèque MIKE et de les placer dans la bibliothèque TERESA. La conversion est exécutée en interactif et l'utilisateur attend la fin de l'opération.

Messages d'erreur

*ESCAPE Messages

CPF0A0B: Fichiers des outils d'analyse des performances non convertis.
CPF22F7: Le nombre de droits doit être compris entre 1 et &1. Number of authorities must be between 1 and &1.
CPF22FA: La valeur de droit &1 n'est pas valide. Authority value &1 not valid.
CPF22FB: Vous devez indiquer *EXCLUDE ou *AUTL comme seule valeur de droit. Must specify *EXCLUDE or *AUTL as only authority value.
CPF2365: Les paramètres FROMLIB et TOLIB ne peuvent désigner une même bibliothèque.
CPF2817: Commande de copie interrompue à la suite d'une erreur.
CPF4102: Membre &4 du fichier &2 de &3 non trouvé.
CPF8122: Dommage &8 sur bibliothèque &4.
CPF9801: Objet &2 non trouvé dans la bibliothèque &3.
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.
CPF9810: Bibliothèque &1 non trouvée.
CPF9811: Programme &1 non trouvé dans la bibliothèque &2.
CPF9812: Fichier &1 non trouvé dans la bibliothèque &2.
CPF9820: Non autorisé à utiliser la bibliothèque &1.
CPF9830: Allocation de la bibliothèque &1 impossible.