PRTJOBTRC

Imprimer trace de travail

Print Job Trace

En bref

La commande Imprimer la trace de travail (PRTJOBTRC) produit des rapports orientés performances qui servent à analyser les données de trace de travail collectées précédemment avec les commandes Démarrer la trace de travail (STRJOBTRC) et Arrêter la trace de travail (ENDJOBTRC). The Print Job Trace (PRTJOBTRC) command produces performance-oriented reports that are used to analyze job trace data collected earlier with the Start Job Trace (STRJOBTRC) and End Job Trace (ENDJOBTRC) commands.

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

Syntaxe minimale

PRTJOBTRC

Paramètres

MBR Membre du fichier de base de données Data base file member
LIB Bibliothèque du fichier de base de données Data base file library
RPTTYPE Type de rapport Report type
TITLE Titre du rapport Report title
STRSEQ Numéro de séquence de début Starting sequence number
ENDSEQ Numéro de séquence de fin Ending sequence number
ENDTNS Programme de fin de transaction Transaction ending program
STRTNS Programme de début de transaction Transaction starting program
JOB Nom du travail Job name
JOBD Description de travail Job description

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

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MBR	Membre du fichier de base de donnéesData base file member	Nom, QAJOBTRC	Facultatif, positionnel 1
LIB	Bibliothèque du fichier de base de donnéesData base file library	Nom, QPFRDATA	Facultatif, positionnel 2
RPTTYPE	Type de rapportReport type	BOTH, DETAIL, *SUMMARY	Facultatif, positionnel 3
TITLE	Titre du rapportReport title	Valeur caractère, *BLANK	Facultatif, positionnel 4
STRSEQ	Numéro de séquence de débutStarting sequence number	1-999999, *FIRST	Facultatif
ENDSEQ	Numéro de séquence de finEnding sequence number	Nombre décimal, *LAST	Facultatif
ENDTNS	Programme de fin de transactionTransaction ending program	Nom, QT3REQIO, *BATCH	Facultatif
STRTNS	Programme de début de transactionTransaction starting program	Nom, QWSGET	Facultatif
JOB	Nom du travailJob name	Nom, PRTJOBTRC, *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 du fichier de base de données (MBR)Data base file member (MBR)

Indique le membre du fichier QAPTTRCJ dans lequel les données de trace sont sauvegardées par la commande Arrêter la trace de travail (ENDJOBTRC). Specifies the member in file QAPTTRCJ in which the trace data is saved by the End Job Trace (ENDJOBTRC) command.

QAJOBTRC: Le nom de membre standard, QAJOBTRC, est utilisé. The standard member name, QAJOBTRC, is used.
nom: Indiquez le nom du membre dans lequel les données sont sauvegardées. Specify the name of the member in which the data is saved.

Bibliothèque du fichier de base de données (LIB)Data base file library (LIB)

Indique la bibliothèque dans laquelle les données de trace de travail sont sauvegardées par la commande Arrêter la trace de travail (ENDJOBTRC). Specifies the library in which the job trace data is saved by the End Job Trace (ENDJOBTRC) command.

QPFRDATA: Les données de trace sont sauvegardées dans la bibliothèque de données de performance fournie par IBM, QPFRDATA. The trace data is saved in the IBM-supplied performance data library, QPFRDATA.
nom: Indiquez le nom de la bibliothèque dans laquelle les données de trace sont sauvegardées. Specify the name of the library in which the trace data is saved.

Type de rapport (RPTTYPE)Report type (RPTTYPE)

Indique le ou les types de rapport à produire. Specifies the type of report(s) to produce.

Remarque :Si des rapports récapitulatifs sont sélectionnés (en indiquant *BOTH ou *SUMMARY pour ce paramètre), ils ne contiennent des informations que si des paires de programme de fin de transaction et de programme de début de transaction sont trouvées dans les données collectées. Remarque :If summary reports are selected (by specifying *BOTH or *SUMMARY for this parameter), the summary reports contain information only when transaction ending program and transaction starting program pairs are found in the collected data.

*BOTH: Les rapports détaillé et récapitulatifs sont tous deux produits (trois rapports au total). Both the detail and summary reports are produced (three reports total).
*DETAIL: Un rapport détaillant les enregistrements individuels de trace de travail est produit. La sortie est dirigée vers le fichier d'imprimante QPPTTRCD. L'en-tête de chaque page comprend le texte 'Job Trace Information'. A report is produced detailing the individual job trace records. The output is directed to the printer file QPPTTRCD. Each page heading includes the text 'Job Trace Information'.
*SUMMARY: Deux rapports récapitulant les données de trace de travail par transaction sont produits. L'un présente principalement l'activité des disques physiques ; son fichier d'imprimante est QPPTTRC1 et l'en-tête de ses pages comprend le texte 'Trace Analysis Summary'. L'autre se concentre sur les activités de plus haut niveau, telles que les entrées-sorties de base de données et les transferts de contrôle entre programmes ; son fichier d'imprimante est QPPTTRC2 et l'en-tête de ses pages comprend le texte 'Trace Analysis I/O Summary'. Two reports are produced summarizing the job trace data by transaction. One report shows primarily physical disk activity; its printer file is QPPTTRC1, and its page heading includes the text 'Trace Analysis Summary'. The other report concentrates on higher level activities such as database I/O and inter-program transfers of control; its printer file is QPPTTRC2, and its page heading includes the text 'Trace Analysis I/O Summary'.

Titre du rapport (TITLE)Report title (TITLE)

Indique un titre imprimé dans l'en-tête de page de chaque rapport. Specifies a title that is printed on the page heading of each report.

*BLANK: Aucun titre n'est indiqué. No title is specified.
valeur-caractère: Indiquez un titre de 50 caractères au maximum, entre apostrophes. Il peut servir, par exemple, à distinguer des rapports portant sur des jeux de données de trace différents ou sur différentes sections des mêmes données. Specify title of up to 50 characters enclosed in apostrophes. This may be used, for example, to distinguish between reports on different sets of trace data or different sections of the same data.

Numéro de séquence de début (STRSEQ)Starting sequence number (STRSEQ)

Indique le numéro de séquence du premier enregistrement de trace de travail inclus dans les rapports. Aucun enregistrement qui précède celui-ci n'est répertorié dans le rapport détaillé ni comptabilisé dans l'un des rapports récapitulatifs. Specifies the sequence number of the first job trace record that is included in any reports. No records preceding this one are listed in the detail report or counted in either summary report.

*FIRST: Les enregistrements de trace à partir du premier enregistrement de trace de travail (numéro de séquence 1) sont inclus. Trace records starting from the first job trace record (sequence number 1) are included.
1-999999: Indiquez la séquence du premier enregistrement de trace à inclure. Une valeur appropriée peut être déterminée en prévisualisant les rapports produits à partir de toutes les données de trace de travail. Cela permet de délimiter un ensemble particulier de transactions sur lequel établir le rapport. Specify the sequence of the first trace record that is included. An appropriate value can be determined by previewing reports produced from all the job trace data. This can be used to bracket a particular set of transactions on which to report.

Numéro de séquence de fin (ENDSEQ)Ending sequence number (ENDSEQ)

Indique le numéro de séquence du dernier enregistrement de trace de travail inclus dans les rapports. Aucun enregistrement qui suit celui-ci n'est répertorié dans le rapport détaillé ni comptabilisé dans l'un des rapports récapitulatifs. Specifies the sequence number of the last job trace record that is included in any reports. No records following this one are listed in the detail report or counted in either summary report.

*LAST: Les enregistrements de trace jusqu'au dernier enregistrement de trace sont inclus. Trace records through the last trace record are included.
1-999999: Indiquez le numéro de séquence du dernier enregistrement de trace à inclure. Une valeur appropriée peut être choisie par prévisualisation afin de délimiter un ensemble particulier de transactions. Specify the sequence number of the last trace record that is included. An appropriate value can be chosen through a preview process so as to bracket a particular set of transactions.

Programme de fin de transaction (ENDTNS)Transaction ending program (ENDTNS)

Indique le programme qui signale la fin d'une transaction. Un nom de programme doit également être indiqué dans le paramètre Programme de début de transaction (STRTNS). Specifies the program that signifies the end of a transaction. A program name must also be specified for the Transaction starting program (STRTNS) parameter.

QT3REQIO: Le programme d'entrée-sortie de poste de travail, QT3REQIO, est utilisé. Cette valeur sert à découper les données de trace en transactions de poste de travail. The work station I/O program, QT3REQIO, is used. This value is used to break the trace data into work station transactions.
nom: Indiquez le nom du programme qui termine une transaction. Cela permet d'établir des rapports sur des transactions autres que celles de poste de travail, telles que les lignes de communication. Specify the name of the program that ends a transaction. This allows reporting on non-work station transactions, such as communications lines.

Programme de début de transaction (STRTNS)Transaction starting program (STRTNS)

Indique le programme qui signale le début d'une transaction. Un nom de programme doit également être indiqué dans le paramètre Programme de fin de transaction (ENDTNS). Specifies the program that signifies the start of a transaction. A program name must also be specified for the Transaction ending program (ENDTNS) parameter.

QWSGET: Le programme d'entrée de poste de travail, QWSGET, est utilisé. Cette valeur sert à découper les données de trace en transactions de poste de travail. The work station input program, QWSGET, is used. This value is used to break the trace data into work station transactions.
nom: Indiquez le nom du programme qui démarre une transaction. Specify the name of the program that starts a transaction.

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.

PRTJOBTRC: 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

PRTJOBTRC   LIB(MYLIB)  RPTTYPE(*DETAIL)

Cette commande produit un rapport détaillé à partir des données sauvegardées dans le membre QAJOBTRC du fichier QAPTTRCJ de la bibliothèque MYLIB. This command produces a detail report using data saved in member QAJOBTRC of file QAPTTRCJ in library MYLIB.

Messages d'erreur

Aucun None