PRTPEXRPT
Imprimer rapport PEX
Print PEX Report
En bref
La commande Imprimer le rapport PEX (PRTPEXRPT) imprime une liste formatée des données collectées par le performance explorer et sauvegardées dans un ensemble de fichiers physiques d'une bibliothèque donnée. The Print PEX Report (PRTPEXRPT) command prints a formatted listing of the data that was collected by the performance explorer and saved across a set of physical files in a particular library.
PRTPEXRPT se lit PRT
(Imprimer) + PEXRPT.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
PRTPEXRPT MBR(…)
Paramètres
-
MBRMembre obligatoire -
LIBBiblio -
TYPEType -
OUTPUTSortie -
OUTFILEFichier recevant la sortie -
OUTMBROptions pour membre de sortie -
TRACEOPTOptions de trace Trace options -
TRCTYPESélectionner le type de trace Select trace type -
PERIODPériode du rapport Time period for report -
SLTJOBSélection des travaux -
OMTJOBOmettre des travaux Omit jobs -
STATSOPTOptions de statistiques Stats options -
PROFILEOPTOptions de profil Profile options -
ORDERCommande -
NBRTHDNombre d'unités d'exécution Number of threads -
TASKINFInformations sur les tâches Task information
Astuce : dans une session 5250, tapez PRTPEXRPT 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 Imprimer le rapport PEX (PRTPEXRPT) imprime une liste formatée des données collectées par le performance explorer et sauvegardées dans un ensemble de fichiers physiques d'une bibliothèque donnée. The Print PEX Report (PRTPEXRPT) command prints a formatted listing of the data that was collected by the performance explorer and saved across a set of physical files in a particular library.
Restrictions:
- Cette commande est livrée avec le droit PUBLIC *EXCLUDE. This command is shipped with PUBLIC *EXCLUDE authority.
- Vous devez posséder les droits de lecture (*READ) et d'exécution (*EXECUTE) sur la bibliothèque indiquée. You must have read (*READ) and execute (*EXECUTE) authority to the specified library.
- Pour utiliser cette commande, vous devez posséder le droit spécial *SERVICE ou être autorisé à la fonction Service Trace du système d'exploitation. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, permet de modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of the operating system. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can be used to change the list of users that are allowed to perform trace operations.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| MBR | Membre | Nom | Obligatoire, positionnel 1 |
| LIB | Biblio | Nom, QPEXDATA | Facultatif, positionnel 2 |
| TYPE | Type | *STATS, *TRACE, *PROFILE, *BASIC | Facultatif, positionnel 3 |
| OUTPUT | Sortie | *PRINT, *OUTFILE | Facultatif |
| OUTFILE | Fichier recevant la sortie | Nom d'objet qualifié | Facultatif |
| Qualificatif 1: Fichier recevant la sortie | Nom | ||
| Qualificatif 2: Biblio | Nom, *LIBL, *CURLIB | ||
| OUTMBR | Options pour membre de sortie | Liste d'éléments | Facultatif |
| Élément 1: Membre recevant la sortie | Nom, *FIRST | ||
| Élément 2: Remplacement ou ajout enregs | *REPLACE, *ADD | ||
| TRACEOPT | Options de traceTrace options | Liste d'éléments | Facultatif |
| Élément 1: Mode de tri | *TIMESTAMP, *TASK | ||
| Élément 2: Omit completion records | *NO, *YES | ||
| Élément 3: Omit Category |
Valeurs uniques: *NONE Autres valeurs (jusqu'à 17 répétitions): *PGM, *LICPGM, *ASM, *BASE, *DISK, *DSKSVR, *FAULT, *JOB, *LOCK, *SAR, *MIBRKT, *LICBRKT, *DASD, *DASDSRVR, *PAGEFLT, *RMPR, *RMSL |
||
| TRCTYPE | Sélectionner le type de traceSelect trace type | Valeurs uniques: *ALL Autres valeurs (jusqu'à 11 répétitions): *CALLRTN, *BASIC, *DSKIO1, *DSKIO2, *DSKSVR, *DSKSTG, *VRTADR, *PGMACT, *FILEOPEN, *PRFDTA, *TASKSWT |
Facultatif |
| PERIOD | Période du rapportTime period for report | 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 | ||
| SLTJOB | Sélection des travaux | Valeurs uniques: *ALL Autres valeurs (jusqu'à 10 répétitions): Nom de travail qualifié |
Facultatif |
| Qualificatif 1: Sélection des travaux | Nom générique, nom | ||
| Qualificatif 2: Utilisat | Nom générique, nom, *ALL | ||
| Qualificatif 3: Numéro | 000001-999999, *ALL | ||
| OMTJOB | Omettre des travauxOmit jobs | Valeurs uniques: *NONE Autres valeurs (jusqu'à 10 répétitions): Nom de travail qualifié |
Facultatif |
| Qualificatif 1: Omettre des travauxQualificatif 1: Omit jobs | Nom générique, nom | ||
| Qualificatif 2: Utilisat | Nom générique, nom, *ALL | ||
| Qualificatif 3: Numéro | 000001-999999, *ALL | ||
| STATSOPT | Options de statistiquesStats options | Liste d'éléments | Facultatif |
| Élément 1: Mode de tri | Entier, *CPU, *PGMNAME, *INVCNT, *DBSYNCIO, *DBASYNCIO, *NDBSYNCIO, *NDBASYNCIO, *MICALLS, *MIINST, *CUMLCPU, *CUMLDBSYNCIO, *CUMLDBASYNCIO, *CUMLNDBSYNCIO, *CUMLNDBASYNCIO | ||
| Élément 2: Summarize by | *PROGRAM, *MODULE, *BLANK | ||
| PROFILEOPT | Options de profilProfile options | Liste d'éléments | Facultatif |
| Élément 1: Mode de tri | *SAMPLECOUNT, *ADDRESS | ||
| Élément 2: Summarize by | *PROGRAM, *MODULE, *PROCEDURE, *STATEMENT, *BLANK | ||
| Élément 3: Filter percentage | 0-99, 0 | ||
| ORDER | Commande | *DESCENDING, *ASCENDING | Facultatif |
| NBRTHD | Nombre d'unités d'exécutionNumber of threads | 1-64, 1, *CALC | Facultatif |
| TASKINF | Informations sur les tâchesTask information | *ALL, *NONE | Facultatif |
Membre (MBR)
Indique l'emplacement des données du rapport. Il s'agit de la valeur indiquée pour le paramètre SSNID ou DTAMBR lors de la sauvegarde des données à l'aide de la commande Arrêter le performance explorer (ENDPEX). Chaque fichier de base de données utilisé par le performance explorer pour sauvegarder les données de performances collectées doit comporter un membre portant le nom indiqué. Specifies where the data is located for the report. This is the value that was specified for the SSNID or DTAMBR parameter when the data was saved using the End Performance Explorer (ENDPEX) command. Each database file used by performance explorer when it saved the collected performance data should have a member with the name specified.
Ce paramètre est obligatoire. This is a required parameter.
- nom
- Indiquez le nom du membre. Specify the member name.
Biblio (LIB)
Indique la bibliothèque dans laquelle les données se trouvent. Specifies the library where the data will be found.
- QPEXDATA
- Les données collectées existent dans des fichiers de base de données de la bibliothèque QPEXDATA. The collected data exists in database files in library QPEXDATA.
- nom
- Indiquez le nom de la bibliothèque qui contient les fichiers de base de données renfermant les données de performances collectées. Specify the library name which contains the database files that hold the collected performance data.
Type (TYPE)
Indique le type de rapport à produire. Le type de rapport demandé doit correspondre au type de données collectées. En cas de non-concordance, un message d'erreur est émis. Le type de données de performances collectées est déterminé par la définition du performance explorer indiquée dans la commande Démarrer le performance explorer (STRPEX). Pour plus d'informations, voir la commande Ajouter une définition PEX (ADDPEXDFN). Specifies the type of report to produce. The type of report requested must match the type of data that was collected. If there is a mismatch, an error message is issued. The type of performance data collected is determined by the performance explorer definition that was specified on the Start Performance Explorer (STRPEX) command. Refer to the Add PEX Definition (ADDPEXDFN) command for more information.
Remarque :Une exception à la concordance des types se produit lorsque vous collectez des données avec une définition TYPE(*TRACE) INTERVAL(nn) BASEVT(*PMCO). Lorsque vous collectez ces données de trace, vous pouvez indiquer un type de rapport *PROFILE. Ce type de rapport est appelé collecte *TRACE et rapport *PROFILE. Remarque :An exception to the matching of types occurs when you collect data with a definition of TYPE(*TRACE) INTERVAL(nn) BASEVT(*PMCO). When you collect this trace data, you are allowed to specify a report type of *PROFILE. This type of report is known as a *TRACE collection and a *PROFILE report.
- *STATS
- A statistics report is produced.
Remarque :Ce paramètre n'est valide que pour les données collectées par des définitions en mode *STATS. Remarque :This parameter is valid only for data collected by *STATS mode definitions.
- *TRACE
- A trace report is produced.
Remarque :Ce paramètre n'est valide que pour les données collectées par des définitions en mode *TRACE ou *PROFILE PRFTYPE(*JOB). Remarque :This parameter is valid only for data collected by *TRACE mode or *PROFILE PRFTYPE(*JOB) definitions.
- *PROFILE
- A profile report is produced.
Remarque :Ce paramètre n'est valide que pour les données collectées par des définitions en mode *PROFILE ou *TRACE TRCTYPE(*PROFILE). Remarque :This parameter is valid only for data collected by *PROFILE mode definitions or *TRACE TRCTYPE(*PROFILE) definitions.
- *BASIC
- A basic report is produced that includes the definition, run, and task information sections.
Remarque :Ce paramètre est valide pour les données collectées par n'importe quelle définition. Remarque :This parameter is valid for data collected by any definition.
Sortie (OUTPUT)
Indique si la sortie de la commande est imprimée avec la sortie spoulée du travail ou dirigée vers un fichier de base de données. Specifies whether the output from the command is printed with the job's spooled output or directed to a database file.
Remarque :Ce paramètre n'est valide que si TYPE(*TRACE) est indiqué. Remarque :This parameter is valid only if TYPE(*TRACE) is specified.
- La sortie est imprimée avec la sortie spoule du travail. The output is printed with the job's spooled output.
- *OUTFILE
- La sortie est dirigée vers le fichier de base de données indiqué dans le paramètre Fichier recevant la sortie (OUTFILE). The output is directed to the database file specified in the Fichier recevant la sortie (OUTFILE) parameter.
Fichier recevant la sortie (OUTFILE)
Indique le nom du fichier de base de données vers lequel la sortie de la commande est dirigée. Si ce fichier n'existe pas, la commande crée un fichier de base de données dans la bibliothèque indiquée. Le droit public est identique au droit de création indiqué pour la bibliothèque dans laquelle le fichier est créé. Specifies the name of the database file to which the output of the command is directed. If this file does not exist, this command creates a database file in the specified library. The public authority is the same as the create authority specified for the library in which the file is created.
Remarques : Notes:
- Le fichier indiqué ici ne peut pas être un fichier DDM. The file specified here cannot be a DDM file
- Le fichier modèle QAVPETRCI se trouve dans la bibliothèque QSYS. The model file QAVPETRCI resides in library QSYS.
Qualificatif 1: Fichier recevant la sortie
- nom
- Indiquez le nom du fichier de sortie qui reçoit la sortie de la commande. Specify the name of the output file that receives the output of the command.
Qualificatif 2: Biblio
- *LIBL
- La liste de bibliothèques est utilisée pour localiser le fichier de sortie. Si le fichier de sortie est introuvable, il est créé dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier de sortie est créé dans la bibliothèque QGPL. The library list is used to locate the output file. If the output file is not found, one is created in the current library. If no current library exists, the output file is created in the QGPL library.
- *CURLIB
- La bibliothèque en cours du travail est utilisée pour localiser le fichier de sortie indiqué. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours du travail, la bibliothèque QGPL est utilisée. The current library for the job is used to locate the specified output file. If no library is specified as the current library for the job, the library QGPL is used.
- nom
- Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier de sortie. Specify the name of the library where the output file is located.
Options pour membre de sortie (OUTMBR)
Indique le nom du membre du fichier de base de données vers lequel la sortie est dirigée. Specifies the name of the database file member to which the output is directed.
Élément 1: Membre recevant la sortie
- *FIRST
- Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué dans le paramètre Fichier recevant la sortie (OUTFILE). Si le membre existe déjà, l'utilisateur a la possibilité d'ajouter les nouveaux enregistrements à la fin du membre existant ou de vider le membre puis d'y ajouter les nouveaux enregistrements. The first member in the file receives the output. If OUTMBR(*FIRST) is specified and the member does not exist, the system creates a member with the name of the file specified on the Fichier recevant la sortie (OUTFILE) parameter. If the member already exists, the user has the option to add new records to the end of the existing member or clear the member and then add the new records.
- nom
- Indiquez le membre du fichier qui reçoit la sortie. Si OUTMBR(nom-membre) est indiqué et que le membre n'existe pas, le système le crée. Si le membre existe déjà, vous avez la possibilité d'ajouter les nouveaux enregistrements à la fin du membre existant ou de vider le membre puis d'y ajouter les nouveaux enregistrements. Specify the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it. If the member already exists, you have the option to add new records to the end of the existing member or clear the member and then add the new records.
Élément 2: Remplacement ou ajout enregs
- *REPLACE
- Le système efface le membre existant et ajoute les nouveaux enregistrements. The system clears the existing member and adds the new records.
- *ADD
- Le système ajoute les nouveaux enregistrements à la fin des enregistrements existants. The system adds the new records to the end of the existing records.
Options de trace (TRACEOPT)Trace options (TRACEOPT)
Indique comment organiser un rapport de trace (*TRACE). Les enregistrements sont ordonnés selon la valeur indiquée pour le paramètre Commande (ORDER). Specifies how to organize a trace (*TRACE) report. Records are ordered based on the value specified for the Commande (ORDER) parameter.
Élément 1: Mode de tri
- *TIMESTAMP
- Les enregistrements sont listés par ordre d'horodatage. The records are listed in time stamp order.
- *TASK
- Les enregistrements sont listés par ordre d'horodatage au sein de chaque travail/tâche. The records are listed in time stamp order within each job/task.
Élément 2: Omit completion records
- *NO
- Tous les enregistrements associés à cette session de collecte de données de performances sont inclus dans le rapport. All records associated with this performance data collection session are included in the report.
- *YES
- Tous les enregistrements de fin sont exclus du rapport. Cela est utile lorsque le volume de données à examiner est important. All completion records are excluded from the report. This is helpful if there is a large amount of data to review.
Élément 3: Omit Category
Valeurs uniques
- *NONE
- Aucune catégorie n'est omise. No categories are omitted.
Autres valeurs (jusqu'à 17 répétitions)
- *PGM
- Exclure la catégorie des événements de flux d'appel de programme. Exclude the category for the program call flow events.
- *LICPGM
- Exclure la catégorie des événements de flux d'appel du code interne sous licence. Exclude the category for the Licensed Internal Code call flow events.
- *ASM
- Exclure la catégorie des événements de gestion de la mémoire secondaire. Exclude the category for the auxiliary storage management events.
- *BASE
- Exclure la catégorie des événements de base, qui comprend les événements de gestion des tâches. Exclude the category for the base events, which includes tasking events.
- *DISK
- Exclure la catégorie des événements d'unité de stockage à accès direct. Exclude the category for the direct access storage device events.
- *DSKSVR
- Exclure la catégorie des événements de serveur de disques. Exclude the category for the disk server events.
- *FAULT
- Exclure la catégorie des événements de défaut de page. Exclude the category for the page fault events.
- *JOB
- Exclure la catégorie des événements de gestion des travaux ou des processus. Exclude the category for the job or process management events.
- *LOCK
- Exclure la catégorie des événements de verrouillage par saisie. Exclude the category for the seize lock events.
- *SAR
- Exclure la catégorie des événements de registre d'adresse de segment. Exclude the category for the segment address register events.
- *MIBRKT
- Exclure la catégorie des événements d'encadrement des programmes d'interface machine. Exclude the category for the machine interface program bracketing events.
- *LICBRKT
- Exclure la catégorie des événements d'encadrement du code interne sous licence. Exclude the category for the Licensed Internal Code bracketing events.
- *DASD
- Exclure la catégorie des événements d'unité de stockage à accès direct. Exclude the category for the direct access storage device events.
- *DASDSRVR
- Exclure la catégorie des événements de serveur de disques. Exclude the category for the disk server events.
- *PAGEFLT
- Exclure la catégorie des événements de défaut de page. Exclude the category for the page fault events.
- *RMPR
- Exclure la catégorie des événements de gestion des processus de la gestion des ressources. Exclude the category for the resource management process management events.
- *RMSL
- Exclure la catégorie des événements de verrouillage par saisie de la gestion des ressources. Exclude the category for the resource management seize lock events.
Sélectionner le type de trace (TRCTYPE)Select trace type (TRCTYPE)
Indique les événements de trace à inclure dans la sortie. Les options possibles sont les mêmes que celles de la commande Ajouter une définition PEX (ADDPEXDFN). Specifies which trace events to include in the output. The options possible are the same options found on the Add PEX Definition (ADDPEXDFN) command.
Valeurs uniques
- *ALL
- Inclure tous les événements de trace dans la sortie. Include all trace events in the output.
Autres valeurs (jusqu'à 11 répétitions)
- *CALLRTN
- Indique que les événements de retour d'appel sont inclus dans la sortie. Les événements de retour d'appel se produisent lorsqu'un programme est appelé et quitté, ainsi que lorsque certaines instructions machine sont démarrées et terminées. Specifies that call return events are included in the output. Call return events occur when a program is entered and exited as well as when certain machine instructions are started and completed.
- *BASIC
- Indique que les événements relatifs à l'analyse générale des performances sont inclus dans la sortie. Specifies that events relative to general performance analysis are included in the output.
- *DSKIO1
- Indique que les événements associés aux opérations d'entrée-sortie disque sont inclus dans la sortie. Specifies that events associated with disk input/output operations are included in the output.
- *DSKIO2
- Indique que les événements associés aux opérations d'entrée-sortie disque ainsi que les demandes de niveau supérieur d'exécution d'opérations d'entrée-sortie sont inclus dans la sortie. Specifies that events associated with the disk input/output operations plus higher level requests to do input/output operations are included in the output.
- *DSKSVR
- Indique que les événements associés aux opérations du serveur de disques sont inclus dans la sortie. Specifies that events associated with disk server operations are included in the output.
- *DSKSTG
- Indique que les événements associés à la consommation de mémoire disque sont inclus dans la sortie. Specifies that events associated with disk storage consumption are included in the output.
- *VRTADR
- Indique que les événements associés à l'affectation d'adresses virtuelles sont inclus dans la sortie. Specifies that events associated with virtual address assignment are included in the output.
- *PGMACT
- Indique que les événements associés aux activations et désactivations de programme sont inclus dans la sortie. Specifies that events associated with program activations and deactivations are included in the output.
- *FILEOPEN
- Indique que les événements associés aux ouvertures de fichier sont inclus dans la sortie. Specifies that events associated with file opens are included in the output.
- *PRFDTA
- Specifies that events associated with CPU instruction profiling are included in the output.
Remarque :La valeur *PFRDTA fournit une liste détaillée des fichiers. Pour obtenir une liste au format récapitulatif, vous pouvez indiquer à la place PRTPEXRPT TYPE(*PROFILE). Remarque :The *PFRDTA value provides you with a detailed list of files. To receive a list in a summary format, as an alternative, you can specify PRTPEXRPT TYPE(*PROFILE).
- *TASKSWT
- Indique que les événements associés à la gestion des tâches sont inclus dans la sortie. Specifies that events associated with tasking are included in the output.
Période du rapport (PERIOD)Time period for report (PERIOD)
Indique la période sur laquelle porte le rapport. Le paramètre se compose de deux listes de deux éléments chacune. Les données collectées avant l'heure de début à la date de début et après l'heure de fin à la date de fin ne sont pas incluses dans le rapport. Specifies the period of time on which to report. The parameter consists of two lists of two elements each. Data collected prior to the starting time on the starting date and after the ending time on the ending date is not included in the report.
Élément 1: Heure et date de début
-
Élément 1: Heure de début
- *AVAIL
- Les données enregistrées disponibles pour la date de début indiquée sont affichées. The recorded data that is available for the specified starting date is shown.
- time
- Specify the starting time on the specified starting date that indicates the recorded data to be shown. The time is specified in 24-hour format with or without a time separator:
- Sans séparateur d'heure, indiquez une chaîne de 4 ou 6 chiffres (hhmm ou hhmmss), où hh = heures, mm = minutes et ss = secondes. Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
- Avec un séparateur d'heure, indiquez une chaîne de 5 ou 8 caractères où le séparateur d'heure défini pour votre travail sépare les heures, les minutes et les secondes. Si vous entrez cette commande depuis la ligne de commande, la chaîne doit être placée entre apostrophes. Si un séparateur d'heure autre que celui défini pour votre travail est utilisé, cette commande échoue. With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
Toutes les entrées d'heure et de date doivent comporter 2 chiffres, ce qui signifie que les zéros doivent être inclus. All time and date entries must be 2-digits in length, meaning zeros must be included.
-
Élément 2: Date de début
- *BEGIN
- Les données enregistrées depuis le début du journal sont affichées. The recorded data from the beginning of the log is shown.
- *CURRENT
- Les données enregistrées pour le jour en cours et comprises entre les heures de début et de fin indiquées (le cas échéant) sont affichées. The recorded data for the current day and between the specified starting and ending times (if specified) is shown.
- date
- Indiquez la date imprimée. La date doit être saisie au format indiqué par la valeur système QDATFMT et, si des séparateurs sont utilisés, comme indiqué par la valeur système QDATSEP. Specify the date printed. The date must be entered in the format specified by the system value QDATFMT, and if separators are used, as specified by the system value QDATSEP.
Élément 2: Heure et date de fin
-
Élément 1: Heure de fin
- *AVAIL
- Les données enregistrées disponibles pour la date de fin indiquée sont affichées. The recorded data that is available for the specified ending date is shown.
- time
- Indiquez l'heure de fin pour la date de fin indiquée, qui détermine les données enregistrées imprimées. Specify the ending time for the specified ending date that determines the recorded date that is printed.
-
Élément 2: Date de fin
- *END
- Le dernier jour pour lequel des données ont été consignées est affiché. Si PERIOD(*END) est indiqué, une valeur d'heure de fin autre que *AVAIL est ignorée. The last day on which data was logged is shown. If PERIOD(*END) is specified, a time value other than *AVAIL for end time is ignored.
- *CURRENT
- Le jour en cours est le dernier jour pour lequel les données enregistrées sont affichées. The current day is the last day for which recorded data is shown.
- date
- Indiquez la date de fin jusqu'à laquelle les données enregistrées doivent être imprimées. La date doit être saisie au format indiqué par la valeur système QDATFMT et, si des séparateurs sont utilisés, comme indiqué par la valeur système QDATSEP. Specify the ending date for which recorded data is to be printed. The date must be entered in the format specified by the system value QDATFMT, and if separators are used, as specified by the system value QDATSEP.
Sélection des travaux (SLTJOB)
Indique les travaux à inclure dans le rapport. Cela permet à l'utilisateur de restreindre la portée du rapport du performance explorer en sélectionnant des travaux précis. Specifies which jobs to include from the report. This allows the user to narrow the scope of the performance explorer report by selecting specific jobs.
Les paramètres SLTJOB et OMTJOB s'excluent mutuellement. The SLTJOB and OMTJOB parameters are mutually exclusive.
Valeurs uniques
- *ALL
- Tous les travaux de la base de données du performance explorer sont inclus. All jobs in the performance explorer database are included.
Autres valeurs (jusqu'à 10 répétitions)
Qualificatif 1: Sélection des travaux
- nom
- Indiquez le nom du travail à inclure dans le rapport du performance explorer. Specify the name of the job to be included in the performance explorer report.
- nom-générique
- Specify the generic name of the job to be included in the performance explorer report.
Remarque :Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*). Un nom générique désigne tous les éléments dont le nom commence par le même préfixe que le nom générique. Remarque :A generic name is a character string of one or more characters followed by an asterisk (*). A generic name specifies all items that have names with the same prefix as the generic name.
Qualificatif 2: Utilisat
- *ALL
- Tous les travaux correspondant au nom de travail indiqué sont inclus. All jobs that match the specified job name are included.
- nom
- Indiquez le nom de l'utilisateur du travail à inclure. Specify the name of the user of the job to be included.
- nom-générique
- Indiquez le nom d'utilisateur générique des travaux à inclure. Specify the generic user name of the jobs to be included.
Qualificatif 3: Numéro
- *ALL
- Tous les travaux correspondant au nom de travail et au nom d'utilisateur indiqués sont inclus. All jobs that match the specified job name and user name are included.
- 000001-999999
- Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Specify the job number to further qualify the job name and user name.
Omettre des travaux (OMTJOB)Omit jobs (OMTJOB)
Indique les travaux à omettre du rapport. Cela permet à l'utilisateur de restreindre la portée du rapport du performance explorer en omettant des travaux précis. Specifies which jobs are omitted from the report. This allows the user to narrow the scope of the performance explorer report by omitting specific jobs.
Les paramètres SLTJOB et OMTJOB s'excluent mutuellement. Vous devez utiliser la valeur par défaut de l'un de ces paramètres. The SLTJOB and OMTJOB parameters are mutually exclusive. You must use the default for one of these parameters.
Valeurs uniques
- *NONE
- Aucun travail de la base de données du performance explorer n'est omis. No jobs in the performance explorer database are omitted.
Autres valeurs (jusqu'à 10 répétitions)
Qualificatif 1 : Omettre des travaux Qualificatif 1: Omit jobs
- nom
- Indiquez le nom du travail à omettre du rapport du performance explorer. Specify the name of the job to be omitted in the performance explorer report.
- nom-générique
- Specify the generic name of the job to be omitted in the performance explorer report.
Remarque :Un nom générique est une chaîne de caractères composée d'un ou plusieurs caractères suivis d'un astérisque (*). Un nom générique désigne tous les éléments dont le nom commence par le même préfixe que le nom générique. Remarque :A generic name is a character string of one or more characters followed by an asterisk (*). A generic name specifies all items that have names with the same prefix as the generic name.
Qualificatif 2: Utilisat
- *ALL
- Tous les travaux correspondant au nom de travail indiqué seront omis. All jobs that match the specified job name will be omitted.
- nom
- Indiquez le nom de l'utilisateur du travail à omettre. Specify the name of the user of the job to be omitted.
- nom-générique
- Indiquez le nom d'utilisateur générique des travaux à omettre. Specify the generic user name of the jobs to be omitted.
Qualificatif 3: Numéro
- *ALL
- Tous les travaux correspondant au nom de travail et au nom d'utilisateur indiqués seront omis. All jobs that match the specified job name and user name will be omitted.
- 000001-999999
- Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Specify the job number to further qualify the job name and user name.
Options de statistiques (STATSOPT)Stats options (STATSOPT)
Indique comment organiser un rapport de statistiques (*STATS). Les enregistrements sont ordonnés selon la valeur indiquée pour le paramètre Commande (ORDER). Specifies how to organize a statistics (*STATS) report. Records are ordered based on the value specified for the Commande (ORDER) parameter.
Remarque :Ce paramètre est ignoré si, dans la commande Ajouter une définition PEX (ADDPEXDFN), vous avez indiqué TYPE(*STATS) et DTAORG(*HIER). Il est ignoré afin de conserver la relation parent-enfant collectée pour cette définition. Remarque :This parameter is ignored if, on the Add PEX Definition (ADDPEXDFN) command, you specified TYPE(*STATS) and DTAORG(*HIER). The parameter is ignored to retain the parent-child relationship that was collected for this definition.
Élément 1: Mode de tri
- *CPU
- Classer la sortie par temps UC. Arrange the output by amount of CPU time.
- *PGMNAME
- Classer la sortie par nom de programme. Arrange the output by program name.
- *INVCNT
- Classer la sortie par nombre d'appels du programme ou de la procédure. Arrange the output by number of times program or procedure is called.
- *DBSYNCIO
- Classer la sortie par volume d'E/S synchrones physiques de base de données. Arrange the output by amount of physical database synchronous I/O.
- *DBASYNCIO
- Classer la sortie par volume d'E/S asynchrones physiques de base de données. Arrange the output by amount of physical database asynchronous I/O.
- *NDBSYNCIO
- Classer la sortie par volume d'E/S synchrones physiques hors base de données. Arrange the output by amount of physical non-database synchronous I/O.
- *NDBASYNCIO
- Classer la sortie par volume d'E/S asynchrones physiques hors base de données. Arrange the output by amount of physical non-database asynchronous I/O.
- *MICALLS
- Classer la sortie par nombre d'appels MI. Arrange the output by number of MI calls.
- *MIINST
- Classer la sortie par nom d'instruction MI. Arrange the output by MI instruction name.
- *CUMLCPU
- Classer la sortie par valeur UC cumulée. Arrange the output by cumulative CPU value.
- *CUMLDBSYNCIO
- Classer la sortie par volume cumulé d'E/S synchrones physiques de base de données. Arrange the output by cumulative amount of physical database synchronous I/O.
- *CUMLDBASYNCIO
- Classer la sortie par volume cumulé d'E/S asynchrones physiques de base de données. Arrange the output by cumulative amount of physical database asynchronous I/O.
- *CUMLNDBSYNCIO
- Classer la sortie par volume cumulé d'E/S synchrones physiques hors base de données. Arrange the output by cumulative amount of physical non-database synchronous I/O.
- *CUMLNDBASYNCIO
- Classer la sortie par volume cumulé d'E/S asynchrones physiques hors base de données. Arrange the output by cumulative amount of physical non-database asynchronous I/O.
Élément 2: Summarize by
- *PROGRAM
- Les données sont récapitulées au niveau du programme. The data is summarized at the program level.
- *MODULE
- Les données sont récapitulées au niveau du module. The data is summarized at the module level.
- *BLANK
- Les données ne sont pas récapitulées. The data is not summarized.
Options de profil (PROFILEOPT)Profile options (PROFILEOPT)
Indique comment organiser un rapport de profil (*PROFILE). Les enregistrements sont ordonnés selon la valeur indiquée pour le paramètre Commande (ORDER). Specifies how to organize a profile (*PROFILE) report. Records are ordered based on the value specified for the Commande (ORDER) parameter.
Élément 1: Mode de tri
- *SAMPLECOUNT
- Classer la sortie en fonction du nombre d'échantillons. Arrange the output relative to the sample count.
- *ADDRESS
- Classer la sortie en fonction de l'adresse échantillonnée. Arrange the output relative to the sampled address.
Élément 2: Summarize by
- *PROGRAM
- Récapituler les données au niveau du programme. Summarize the data at the program level.
- *MODULE
- Récapituler les données au niveau du module. Summarize the data at the module level.
- *PROCEDURE
- Récapituler les données au niveau de la procédure. Summarize the data at the procedure level.
- *STATEMENT
- Récapituler les données au niveau de l'instruction. Summarize the data at the statement level.
- *BLANK
- Aucun enregistrement récapitulatif n'est fourni. No summary records are provided.
Élément 3: Filter percentage
- 0
- Aucun enregistrement n'est omis du rapport. No records are omitted from the report.
- 0-99
- Specify a number in the range of 0 to 100.
Remarque :Cela fournit un filtre qui élimine les enregistrements non significatifs. Par exemple, une entrée de 10 omettrait tous les enregistrements qui contiennent moins de 10 % des échantillons prélevés pendant la collecte. Remarque :This provides a filter to eliminate the insignificant records. For example, an entry of 10 would omit all the records that contain less than 10% of the samples taken during the collection.
Commande (ORDER)
Indique comment les données doivent être ordonnées dans le rapport. Specifies how the data should be ordered in the report.
- *DESCENDING
- Les enregistrements de données sont ordonnés par ordre décroissant. Si les enregistrements sont triés selon une zone numérique, ils sont ordonnés du plus grand au plus petit. S'ils sont triés selon une zone de nom, ils sont dans l'ordre alphabétique inverse, par exemple de Z à A. The data records are ordered in descending order. If records are sorted by a numeric field, records are ordered from largest to smallest. If records are sorted by a name field, records are in reverse alphabetical order, for example, from Z to A.
- *ASCENDING
- Les enregistrements de données sont ordonnés par ordre croissant. Si les enregistrements sont triés selon une zone numérique, ils sont ordonnés du plus petit au plus grand. S'ils sont triés selon une zone de nom, ils sont dans l'ordre alphabétique, par exemple de A à Z. The data records are in ascending order. If records are sorted by a numeric field, records will be ordered from smallest to largest. If records are sorted by a name field, records are in alphabetical order, for example, from A to Z).
Nombre d'unités d'exécution (NBRTHD)Number of threads (NBRTHD)
Indique le nombre d'unités d'exécution simultanées que la commande PRTPEXRPT utilise pour imprimer les données. Indiquer un nombre supérieur à 1 permet à la commande PRTPEXRPT de tirer parti des cycles UC disponibles, notamment sur un système multiprocesseur. Cela peut accélérer le traitement de la commande, mais peut aussi dégrader les performances des autres travaux du système. Vous pouvez réduire cet impact en attribuant au travail qui exécute la commande PRTPEXRPT un numéro de priorité plus élevé. Vous devez également vérifier que le sous-système de disques peut gérer les unités d'exécution supplémentaires. En général, la commande PRTPEXRPT nécessite un bras de disque pour chaque unité d'exécution active. Specifies the number of concurrent threads that the PRTPEXRPT command uses to print the data. Specifying a number greater than 1 allows the PRTPEXRPT command to take advantage of available CPU cycles, especially on a multi-processor system. While this may speed up the command processing, it may also degrade the performance of other jobs on the system. You can minimize this impact by changing the priority of the job that runs the PRTPEXRPT command to a higher number. You should also verify that the disk subsystem can handle the additional threads. Typically, the PRTPEXRPT command requires one disk arm for each active thread.
Remarque :Si vous indiquez OUTPUT (*PRINT), le nombre de fichiers spoulés est égal à NBRTHD (un fichier spoulé par unité d'exécution). Remarque :If you specify OUTPUT (*PRINT), the number of spooled files is equal to NBRTHD (one spooled file per thread).
- 1
- Une seule unité d'exécution de la commande PRTPEXRPT est utilisée pour traiter les données collectées. Only one thread for the PRTPEXRPT command is used to process the collected data.
- *CALC
- Le système calcule un nombre raisonnable d'unités d'exécution pour traiter la commande sans utiliser de ressources système excessives. Il s'agit généralement d'une ou deux unités d'exécution par processeur disponible. Si cette commande est exécutée dans un travail interactif, *CALC n'utilise qu'une seule unité d'exécution. The system calculates a reasonable number of threads to do the command processing which does not use excessive system resources. Usually this is one or two threads for each available processor. If this command is run in an interactive job, *CALC uses only one thread.
- 1-64
- Indiquez le nombre d'unités d'exécution que la commande PRTPEXRPT doit utiliser pour traiter les données collectées. Specify the number of threads for the PRTPEXRPT command to use to process the collected data.
Informations sur les tâches (TASKINF)Task information (TASKINF)
Indique si la section des informations sur les tâches doit être imprimée ou non. Specifies whether the task information section is to be printed or not.
- *ALL
- La section des informations sur les tâches sera imprimée et comprendra les détails de tous les travaux et tâches disponibles dans les données collectées. Si ADDPEXDFN LSTALLJOB(*YES) a été indiqué dans la définition utilisée pour collecter ces données, les détails de tous les travaux et tâches présents sur le système pendant la collecte seront imprimés. The task information section will be printed and will include details for all jobs and tasks available in the collected data. If ADDPEXDFN LSTALLJOB(*YES) was specified in the definition used to collect this data, then details for all jobs and tasks on the system during the time of the collection will be printed.
- *NONE
- La section des informations sur les tâches ne sera pas imprimée. The task information section will not be printed.
Exemples
Exemple 1 : Impression d'un rapport de statistiques Example 1: Printing a Statistics Report
PRTPEXRPT MBR(SAMPLE) LIBRARY(SAMPLELIB)
TYPE(*STATS) STATSOPT(*INVCNT *MODULE)
Cette commande imprime un rapport basé sur les membres de données nommés SAMPLE de la bibliothèque SAMPLELIB. Les données sont classées par ordre décroissant selon le nombre d'appels et sont récapitulées au niveau du module. This command prints a report based on data members named SAMPLE in library SAMPLELIB. The data is arranged in descending order based on invocation counts and is summarized at the module level.
Exemple 2 : Impression d'un rapport de profil Example 2: Printing a Profile Report
PRTPEXRPT MBR(SAMPLE2) TYPE(*PROFILE)
PROFILEOPT(*SAMPLECOUNT *PROGRAM)
ORDER(*DESCENDING)
Cette commande imprime un rapport basé sur les membres de données nommés SAMPLE2 de la bibliothèque par défaut, QPEXDATA. Les données sont classées par ordre décroissant selon le nombre d'échantillons et sont récapitulées au niveau du programme. This command prints a report based on data members named SAMPLE2 in the default library, QPEXDATA. The data is arranged in descending order based on the sample count and is summarized at the program level.
Messages d'erreur
Messages *ESCAPE *ESCAPE Messages
- CPFAF0A
- Collecte &1 introuvable Collection &1 was not found
- CPFAF09
- Bibliothèque &1 introuvable. Library &1 not found.
- CPF4102
- Membre &4 du fichier &2 de &3 non trouvé.
- CPFAF14
- Les données du membre indiqué ne correspondent pas au type de rapport demandé. The data in the member specified does not match the type of report requested.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.