Aller au contenu

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

  • MBR Membre obligatoire
  • LIB Biblio
  • TYPE Type
  • OUTPUT Sortie
  • OUTFILE Fichier recevant la sortie
  • OUTMBR Options pour membre de sortie
  • TRACEOPT Options de trace Trace options
  • TRCTYPE Sélectionner le type de trace Select trace type
  • PERIOD Période du rapport Time period for report
  • SLTJOB Sélection des travaux
  • OMTJOB Omettre des travaux Omit jobs
  • STATSOPT Options de statistiques Stats options
  • PROFILEOPT Options de profil Profile options
  • ORDER Commande
  • NBRTHD Nombre d'unités d'exécution Number of threads
  • TASKINF Informations 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.

*PRINT
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:

  1. Le fichier indiqué ici ne peut pas être un fichier DDM. The file specified here cannot be a DDM file
  2. 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.