Commande CL IBM i (AS/400)

ENDJOBTRC

Arrêter trace de travail

End Job Trace

En bref

ENDJOBTRC se lit END (Arrêter) + JOBTRC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ENDJOBTRC

Paramètres

MBR Membre du fichier de sortie Output file member
LIB Bibliothèque du fichier de sortie Output 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 ENDJOBTRC 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 Arrêter la trace de travail (ENDJOBTRC) désactive la fonction de trace de travail démarrée par la commande Démarrer la trace de travail (STRJOBTRC), sauvegarde tous les enregistrements de trace collectés dans un fichier de base de données et produit facultativement des rapports servant à analyser les données pour obtenir des informations sur les performances. La commande Imprimer la trace de travail (PRTJOBTRC) peut également servir à produire des rapports à partir des mêmes données sources. The End Job Trace (ENDJOBTRC) command turns off the job tracing function that was started by the Start Job Trace (STRJOBTRC) command, saves all collected trace records in a database file, and optionally produces reports that are used to analyze the data for information about performance. The Print Job Trace (PRTJOBTRC) command may also be used to produce reports from the same source data.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
MBR	Membre du fichier de sortieOutput file member	Nom, QAJOBTRC	Facultatif, positionnel 1
LIB	Bibliothèque du fichier de sortieOutput file library	Nom, QPFRDATA	Facultatif, positionnel 2
RPTTYPE	Type de rapportReport type	NONE, DETAIL, SUMMARY, BOTH	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, ENDJOBTRC, *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 sortie (MBR)Output file member (MBR)

Indique le membre du fichier QAPTTRCJ dans lequel sauvegarder les données de trace. Si le membre n'existe pas, il est ajouté au fichier. Si le membre existe, les nouvelles données remplacent l'ancien contenu. Specifies the member in file QAPTTRCJ in which to save the trace data. If the member does not exist, it is added to the file. If the member exists, the new data replaces the old contents.

QAJOBTRC: Le nom de membre standard, QAJOBTRC, est utilisé. The standard member name, QAJOBTRC, is used.
nom: Indiquez le nom d'un autre membre dans lequel sauvegarder les données. Cela permet de conserver plusieurs jeux de données de trace de travail. Specify the name of an alternate member in which to save the data. This allows several sets of job trace data to be kept.

Bibliothèque du fichier de sortie (LIB)Output file library (LIB)

Indique la bibliothèque dans laquelle les données de trace sont sauvegardées. Si la bibliothèque ne contient pas de fichier nommé QAPTTRCJ, il en est créé un. Specifies the library where the trace data is saved. If the library does not contain a file named QAPTTRCJ, one is created.

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 d'une autre bibliothèque dans laquelle les données de trace sont sauvegardées. Cela est nécessaire si l'accès à la bibliothèque par défaut n'est pas autorisé. Specify the name of an alternate library where the trace data is saved. This is necessary if access to the default library is not allowed.

Type de rapport (RPTTYPE)Report type (RPTTYPE)

Indique le type de rapports produits. Specifies the type of reports being produced.

*NONE: Aucun rapport n'est produit ; toutefois, la commande Imprimer la trace de travail (PRTJOBTRC) peut être utilisée ultérieurement pour établir un rapport sur les données sauvegardées. Aucun des autres paramètres ne s'applique si cette valeur est sélectionnée. No reports are produced; however, the Print Job Trace (PRTJOBTRC) command may be used later to report on the saved data. None of the remaining parameters are applicable if this value is selected.
*DETAIL: Un rapport est produit, présentant en détail chacun des enregistrements de trace de travail. 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 that shows the individual job trace records in detail. The output is directed to the printer file QPPTTRCD. Each page heading includes the text 'Job Trace Information'.
*SUMMARY: Deux rapports sont produits, récapitulant les données de trace de travail par transaction de poste de travail. Un rapport 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 rapport 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 work station 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'.
*BOTH: Le rapport détaillé et les deux rapports récapitulatifs sont produits (trois rapports au total). Both the detail report and the two summary reports are produced (three reports total).

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 (numéro de séquence 1) sont inclus. Trace records starting from the first trace record (sequence number 1) are included.
1-999999: Indiquez la séquence du premier enregistrement de trace à inclure. Une valeur appropriée est déterminée en prévisualisant les rapports produits à partir des 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 is determined by previewing reports that are produced from 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 d'affichage. The work station I/O program, QT3REQIO, is used. This value is used to break the trace data into display station transactions.
nom: Indiquez le nom du programme qui termine une transaction. Cela permet d'établir des rapports sur des transactions ne provenant pas de postes d'affichage, telles que les lignes de communication. Specify the name of the program that ends a transaction. This allows reporting on non-display 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 d'affichage. The work station input program, QWSGET, is used. This value is used to break the trace data into display 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.

ENDJOBTRC: 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 : Arrêt de la trace de travail Example 1: Stopping Job Tracing

ENDJOBTRC

Cette commande arrête la trace et sauvegarde les enregistrements de trace créés dans QPFRDATA/QAPTTRCJ, membre QAJOBTRC. Aucun rapport n'est produit. This command stops tracing and saves the created trace records in QPFRDATA/QAPTTRCJ, member QAJOBTRC. No reports are produced.

Exemple 2 : Production d'un rapport d'enregistrements de travail Example 2: Producing a Report of Job Records

ENDJOBTRC   LIB(MYLIB)  RPTTYPE(*DETAIL)

Cette commande arrête la trace de travail, sauvegarde les enregistrements de trace créés dans le membre QAJOBTRC de MYLIB/QAPTTRCJ et produit un rapport détaillé. L'utilisation d'une bibliothèque privée permet à plusieurs utilisateurs de tracer des travaux en même temps. This command stops job tracing, saves the created trace records in member QAJOBTRC of MYLIB/QAPTTRCJ, and produces a detail report. The use of a private library allows several users to trace jobs at the same time.

Messages d'erreur

Aucun None