Aller au contenu

PRTTRCRPT

Imprimer rapport trace travail

Print Job Trace Report

En bref

La commande Imprimer le rapport de trace de travail (PRTTRCRPT) génère un rapport présentant les ressources utilisées, les exceptions et les transitions d'état des travaux par lots tracés dans le temps. The Print Job Trace Report (PRTTRCRPT) command generates a report showing resources utilized, exceptions, and state transitions for batch jobs traced through time.

PRTTRCRPT se lit PRT (Imprimer) + TRCRPT. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

PRTTRCRPT MBR(…)

Paramètres

  • MBR Membre Member obligatoire
  • LIB Bibliothèque Library
  • TITLE Titre Title
  • PERIOD Période du rapport Time period for report
  • JOB Nom du travail Job name
  • JOBD Description de travail Job description

Astuce : dans une session 5250, tapez PRTTRCRPT 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 QPFR)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Imprimer le rapport de trace de travail (PRTTRCRPT) génère un rapport présentant les ressources utilisées, les exceptions et les transitions d'état des travaux par lots tracés dans le temps. The Print Job Trace Report (PRTTRCRPT) command generates a report showing resources utilized, exceptions, and state transitions for batch jobs traced through time.

Le rapport est basé sur les données de trace collectées par la commande Démarrer la trace de performances (STRPFRTRC). Ce rapport s'exécute sur le membre indiqué qui a été créé lors de l'exécution de la commande Imprimer le rapport de transactions (PRTTNSRPT) avec l'option *FILE. Le membre se trouve dans le fichier QTRJOBT de la bibliothèque QPFRDATA. The report is based on the trace data collected by the Start Performance Trace (STRPFRTRC) command. This report runs against the specified member that was created when the Print Transaction Report (PRTTNSRPT) command was run with the *FILE option. The member resides in the QTRJOBT file of the QPFRDATA library.

Paramètres

Mot-clé Description Valeurs possibles Remarques
MBR MembreMember Nom Obligatoire, positionnel 1
LIB BibliothèqueLibrary Nom, QPFRDATA Facultatif, positionnel 2
TITLE TitreTitle Valeur caractère, *MBR Facultatif, positionnel 3
PERIOD Période du rapportTime period for report Liste d'éléments Facultatif
Élément 1: Liste d'éléments
Élément 1: Starting time Heure, *FIRST
Élément 2: Starting date Date, *FIRST
Élément 2: Liste d'éléments
Élément 1: Ending time Heure, *LAST
Élément 2: Ending date Date, *LAST
JOB Nom du travailJob name Nom, PRTTRCRPT, *MBR Facultatif
JOBD Description de travailJob description Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié		 Facultatif
Qualificatif 1 : Description de travailQualificatif 1: Job description Nom, QPFRJOBD
Qualificatif 2: BibliothèqueQualificatif 2: Library Nom, *LIBL, *CURLIB

Membre (MBR)Member (MBR)

Indique le membre de données de performances utilisé. Ce nom doit correspondre au nom de membre indiqué lors de l'exécution de la commande Imprimer le rapport de transactions (PRTTNSRPT) avec l'option *FILE. Specifies the performance data member used. This name should correspond to the member name specified when the Print Transaction Report (PRTTNSRPT) command was run with *FILE option.

Ce paramètre est obligatoire. This is a required parameter.

Bibliothèque (LIB)Library (LIB)

Indique la bibliothèque où se trouvent les données de performance. Specifies the library where the performance data is located.

QPFRDATA
Les fichiers de données de performance se trouvent dans la bibliothèque de données de performance fournie par IBM, QPFRDATA. The performance data files are located in the IBM-supplied performance data library, QPFRDATA.
nom
Indiquez le nom de la bibliothèque où se trouvent les fichiers de base de données de performance. Specify the name of the library where the performance database files are located.

Titre du rapport (TITLE)Report title (TITLE)

Indique le titre du rapport créé. Specifies the title for the report that is created.

*MBR
Le texte du membre de base de données, qui contient les données de performances, constitue le titre du rapport. The text of the database member, which contains the performance data, is the report title.
valeur-caractère
Indiquez le titre souhaité pour votre rapport, sur 50 caractères de texte maximum, entre apostrophes. Specify the title you want on your report with up to 50 characters of text, enclosed in apostrophes.

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. Specifies the period of time on which to report. The parameter consists of two lists of two elements each.

Le symbole *N peut être utilisé pour conserver la position dans la séquence des valeurs du paramètre à la place d'un élément qui précède les valeurs indiquées. Par exemple, PERIOD(*N (*N 091290)) indique la date de fin et utilise les valeurs par défaut pour les autres valeurs. The symbol *N can be used to maintain the position in the parameter value sequence in place of an element that precedes the values that are specified. For example, PERIOD(*N (*N 091290)) specifies the ending date and uses the defaults for the other values.

Élément 1: Starting time and date

Élément 1: Starting time

*FIRST
Les enregistrements de données à partir du début de la journée (00:00:00) sont inclus. Data records starting from the beginning of the day (00:00:00) are included.
time
Specify the time of the first data record to include in the report, using the format, hhmm or hhmmss, where hh is the hours, mm is the minutes, and ss is the seconds. Data collected prior to this time is not included in the report.

L'heure peut être indiquée avec ou sans séparateur d'heure : The time can be specified 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.

L'heure est au format 24 heures (13:00 correspond à 1 heure de l'après-midi) ; les valeurs des heures, minutes et secondes doivent comporter 2 chiffres, ce qui signifie que les zéros doivent être inclus. The time is in 24-hour format (13:00 is one p.m.); hours, minutes, and seconds values must be 2-digits in length, meaning zeros must be included.

Élément 2: Starting date

*FIRST
Les enregistrements de données à partir du premier jour de la période de collecte sont inclus dans le rapport. Data records starting from the first day of the collection period are included in the report.
date
Indiquez la date du premier enregistrement de données à inclure dans le rapport. Les données collectées avant l'heure de début à cette date ne sont pas incluses dans le rapport. La date doit être saisie dans le même format que celui indiqué pour le travail. Specify the date of the first data record to include in the report. Data collected prior to the starting time on this date is not included in the report. The date must be entered in the same format as specified for the job.

Élément 2: Ending time and date

Élément 1: Ending time

*LAST
Les enregistrements de données jusqu'à la fin de la journée (23:59:59) sont inclus dans le rapport. Data records through the end of the day (23:59:59) are included in the report.
time
Indiquez l'heure du dernier enregistrement de données à inclure dans le rapport. Utilisez le même format que pour l'heure de début. Les données collectées après cette heure à la date de fin ne sont pas incluses dans le rapport. Specify the time of the last data record to include in the report. Use the same format used for the starting time. Data collected after this time on the ending date is not included in the report.

Élément 2: Ending date

*LAST
Les enregistrements de données jusqu'au dernier jour de la période de collecte sont inclus dans le rapport. Data records through the last day of the collection period are included in the report.
date
Indiquez la date du dernier enregistrement à inclure dans le rapport. La date doit être saisie dans le même format que celui indiqué pour le travail. Specify the date of the last record to include in the report. The date must be entered in the same format as specified for the job.

Nom du travail (JOB)Job name (JOB)

Indique le nom du travail à utiliser si le travail est soumis pour un traitement par lots. Specifies the job name to be used if submitting the job for batch processing.

Toute valeur de ce paramètre est ignorée si *NONE est indiqué pour le paramètre Description de travail (JOBD). Any value for this parameter is ignored if *NONE is specified for the Job description (JOBD) parameter.

Remarque :Si JOBD(*NONE) est indiqué, le traitement du travail est effectué en mode interactif. Remarque :If JOBD(*NONE) is specified, job processing is performed interactively.

PRTTRCRPT
Le nom de la commande est utilisé comme nom du travail. The command name is used for the job name.
*MBR
Le nom sélectionné pour le membre de données de performance dans le paramètre Membre (MBR) est utilisé. The name selected for the performance data member in the Member (MBR) parameter is used.
nom
Indiquez le nom à utiliser pour tous les travaux par lots. Specify the name to be used for any and all batch jobs.

Description de travail (JOBD)Job description (JOBD)

Indique la description de travail utilisée pour soumettre le travail à un traitement par lots. Specifies the job description used to submit the job for batch processing.

Valeurs uniques

*NONE
Aucun travail par lots n'est soumis ; le traitement se poursuit en mode interactif pendant que l'utilisateur attend. La station de travail de l'utilisateur n'est pas disponible pour un autre usage pendant ce temps, ce qui peut être notable pour les travaux longs. A batch job is not submitted; processing continues interactively while the user waits. The user's workstation is not available for other use during this time, which could be significant for long jobs.

Qualificatif 1 : Description de travail Qualificatif 1: Job description

QPFRJOBD
La description de travail fournie par IBM, QPFRJOBD, est utilisée. The IBM-supplied job description, QPFRJOBD, is used.
nom
Indiquez le nom de la description de travail à utiliser. Specify the name of the job description to be used.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL
Toutes les bibliothèques de la liste de bibliothèques du travail sont parcourues jusqu'à la première correspondance. All libraries in the job's library list are searched until the first match is found.
*CURLIB
La bibliothèque en cours du travail est utilisée pour localiser la description de travail. Si aucune entrée de bibliothèque en cours n'existe dans la liste de bibliothèques, QGPL est utilisée. The current library for the job is used to locate the job description. If no current library entry exists in the library list, QGPL is used.
nom
Indiquez la bibliothèque dans laquelle se trouve la description de travail. Specify the library in which the job description is located.

Exemples

Exemple 1 : Impression d'un rapport récapitulatif de trace de travail Example 1: Printing a Job Trace Summary Report 

PRTTRCRPT   MBR(JUNE01)

Cette commande soumet un travail par lots qui génère un rapport récapitulatif de trace de travail à partir des données de performances trouvées dans le membre JUNE01 du fichier QTRJOBT situé dans la bibliothèque par défaut QPFRDATA. Le rapport couvre toute la période de collecte, et le titre du rapport est défini avec le nom du membre du fichier de base de données. This command submits a batch job that generates a Job Trace Summary report using the performance data found in the member JUNE01 of file QTRJOBT located in the default library QPFRDATA. The report covers the entire collection period, and the title of the report is set to the name of the database file member.

Exemple 2 : Indication d'une période de rapport Example 2: Specifying a Report Time Period 

PRTTRCRPT   MBR(NOV15)
            PERIOD(('0800:00' '11/15/99')
                   ('2359:59' '11/15/99'))
            TITLE('Job Trace Reports for November 15')

Cette commande soumet un travail par lots qui génère un rapport récapitulatif de trace de travail. Les données de performances proviennent du membre NOV15 du fichier QTRJOBT de la bibliothèque par défaut QPFRDATA. Le rapport couvre la période de 8h00 du matin à minuit d'un même jour. This command submits a batch job that generates a Job Trace Summary report. The performance data comes from member NOV15 of file QTRJOBT of the default library QPFRDATA. The report covers the time period 8:00 in the morning to midnight of one day.

Remarque : Le format de la date et de l'heure est déterminé par les valeurs système QDATFMT et, comme des séparateurs sont utilisés dans cet exemple, QDATSEP. Note: The format for the date and time is determined by the system values QDATFMT and, because separators are used in this example, QDATSEP.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

PFR5515
Impossible d'accéder aux données de trace. Cannot access trace data.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.