PRTTRC

La commande Imprimer la trace (PRTTRC) formate les enregistrements de trace et les écrit dans le fichier de sortie sélectionné. Les enregistrements de trace ont été écrits dans un ensemble de fichiers de base de données par la commande ENDTRC (Arrêter la trace) ; PRTTRC sert à formater ces enregistrements de trace vers un fichier de sortie spoulé ou un fichier de sortie de base de données. Si les enregistrements de trace sont écrits dans un fichier de sortie spoulé, le fichier d'imprimante QPSRVTRCJ est utilisé. Les données utilisateur du fichier spoulé seront identiques à la valeur indiquée pour le paramètre DTAMBR (Membre de données). The Print Trace (PRTTRC) command formats and writes the trace records to the selected output file. The trace records were written to a set of database files by the ENDTRC (End Trace) command and PRTTRC is used to format these trace records to a spooled output file or to a database output file. If the trace records are written to a spooled output file, printer file QPSRVTRCJ is used. The user data for the spooled file will be the same as the value specified for the DTAMBR (Data member) parameter.

Restrictions:

• Cette commande est livrée avec le droit public d'exclusion (*EXCLUDE) et les profils utilisateur QSRV et QSRVBAS sont livrés avec des droits privés pour utiliser cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QSRV and QSRVBAS user profiles are shipped with private authorities to use this command.
• Pour utiliser cette commande, vous devez posséder le droit spécial de service (*SERVICE), ou être autorisé à la fonction de trace de service d'IBM i via la prise en charge de l'administration des applications de System i Navigator. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, peut également servir à modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service trace function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can also be used to change the list of users that are allowed to perform trace operations.
• Vous devez posséder les droits d'exécution (*EXECUTE) et d'ajout (*ADD) sur la bibliothèque dans laquelle les données de trace sont stockées. You must have execute (*EXECUTE) and add (*ADD) authority to the library where the trace data is stored.
• Vous devez posséder des droits sur les fichiers de base de données de la bibliothèque dans laquelle les données de trace sont stockées. You must have authority to the database files within the library where the trace data is stored.
• Si DLTTRC(*YES) est indiqué, vous devez posséder le droit d'utilisation (*USE) sur la commande DLTTRC (Supprimer les données de trace) et le droit de suppression (*DLT) sur la bibliothèque dans laquelle les données de trace sont stockées. If DLTTRC(*YES) is specified, you must have use (*USE) authority to the DLTTRC (Delete Trace Data) command and delete (*DLT) authority to the library where the trace data is stored.
• Le format d'enregistrement du fichier de sortie de base de données doit correspondre au format d'enregistrement du fichier de sortie fourni par IBM, QASCTJFL. The record format of the database output file must match the record format of the IBM-supplied output file QASCTJFL.
• La commande ENDTRC qui a produit les données de trace et la commande PRTTRC qui traite et formate ces données doivent être exécutées sur la même édition du système d'exploitation. The ENDTRC command that produced the trace data and the PRTTRC command that processes and formats the trace data must be run on the same release of Operating System.

Paramètres

Membre de données (DTAMBR)Data member (DTAMBR)

Indique le nom du membre des données de trace que vous souhaitez imprimer. Le nom du membre sera identique à l'identificateur de session de trace indiqué dans les commandes Démarrer la trace (STRTRC) et Arrêter la trace (ENDTRC). Le nom du membre est le même pour chacun des fichiers physiques qui contiennent les données de trace. Specifies the member name for the trace data that you want to print. The member name will be the same as the trace session identifier specified on the Start Trace (STRTRC) and End Trace (ENDTRC) commands. The member name is the same for each of the physical files that contain the trace data.

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

nom

Indiquez le nom du membre de fichier de base de données qui contient les données de trace. Specify the name of the database file member that contains the trace data.

Bibliothèque de données (DTALIB)Data library (DTALIB)

Indique la bibliothèque qui contient l'ensemble de fichiers de base de données dans lequel les données de trace collectées sont stockées. Specifies the library that contains the set of database files where the collected trace data is stored.

*CURLIB

Les données de trace sont imprimées à partir des fichiers de la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours du travail, QGPL est utilisée. The trace data is printed from files in the current library for the job. If no library is specified as the current library for the job, QGPL is used.

nom

Indiquez le nom de la bibliothèque qui contient les fichiers de données de trace. Specify the name of the library that contains the trace data files.

Sélection des travaux (SLTJOB)

Indique les travaux à inclure dans la liste de trace. Cela permet à l'utilisateur de réduire la taille de la liste de trace en sélectionnant seulement un sous-ensemble des travaux qui faisaient partie de la trace. Dix noms de travail qualifiés au maximum peuvent être indiqués. Specifies which jobs to include in the trace listing. This allows the user to reduce the size of the trace listing by selecting only a subset of the jobs that were part of the trace. Up to ten qualified job names can be specified.

Valeurs uniques

*ALLJOBS

Tous les travaux qui faisaient partie de la trace sont inclus. All jobs that were part of the trace are included.

Qualificatif 1: Sélection des travaux

*ALL

Tous les travaux correspondant à l'utilisateur de travail indiqué sont inclus. All jobs that match the specified job user are included.

nom-générique

Indiquez le nom générique des travaux à inclure dans la liste de trace. 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 (*) ; par exemple, ABC*. L'astérisque remplace tout caractère valide. Un nom de travail générique désigne tous les travaux dont le nom commence par le préfixe générique. Specify the generic name of the jobs to be included in the trace listing. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic job name specifies all jobs with job names that begin with the generic prefix.

nom

Indiquez le nom du travail à inclure dans la liste de trace. Specify the name of the job to be included in the trace listing.

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-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.

nom

Indiquez le nom de l'utilisateur du travail à inclure. Specify the name of the user of the job 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.

Supprimer la trace (DLTTRC)Delete trace (DLTTRC)

Indique si les données de trace sont supprimées après leur impression. Specifies whether trace data is deleted after is has been printed.

*YES

Les données de trace des fichiers de base de données sont supprimées une fois l'impression terminée. The trace data in the database files is deleted after the print has completed.

*NO

Les données de trace des fichiers de base de données sont conservées. La commande DLTTRC (Supprimer la trace) peut servir à supprimer les données lorsqu'elles ne sont plus nécessaires. The trace data in the database files is saved. The DLTTRC (Delete Trace) command can be used to delete the data when it is no longer needed.

Mode de tri (SORT)

Indique comment les données de trace de chaque travail sont triées dans le fichier de sortie indiqué. Specifies how the trace data for each job is sorted in the specified output file.

*THREAD

Les données de trace de chaque travail sont triées par unité d'exécution. Si un travail comporte plusieurs unités d'exécution, les données de trace de chaque unité d'exécution sont triées par heure. The trace data for each job is sorted by thread. If a job has multiple threads, the trace data for each thread is sorted by time.

*TIME

Les données de trace de chaque travail sont triées par heure. Si un travail comporte plusieurs unités d'exécution, les données de trace de toutes les unités d'exécution du travail sont triées par heure. Cela peut avoir pour effet d'entremêler la sortie de trace de plusieurs unités d'exécution. The trace data for each job is sorted by time. If a job has multiple threads, the trace data for all threads in the job is sorted by time. This can result in the trace output for multiple threads to be intermingled.

Sortie (OUTPUT)

Indique si la sortie de la commande est imprimée avec la sortie spoule du travail ou envoyé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 sent to a database file.

*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é pour le paramètre Fichier devant recevoir la sortie (OUTFILE). The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

Fichier recevant la sortie (OUTFILE)

Indique le fichier de base de données vers lequel la sortie de la commande est dirigée. Si le fichier n'existe pas, cette commande crée un fichier de base de données dans la bibliothèque indiquée. Si le fichier est créé, les droits publics sur le fichier sont identiques aux droits de création indiqués pour la bibliothèque dans laquelle le fichier est créé. Utilisez la commande Afficher la description de bibliothèque (DSPLIBD) pour afficher les droits de création de la bibliothèque. Specifies the database file to which the output of the command is directed. If the file does not exist, this command creates a database file in the specified library. If the file is created, the public authority for the file is the same as the create authority specified for the library in which the file is created. Use the Display Library Description (DSPLIBD) command to show the library's create authority.

Qualificatif 1: Fichier devant recevoir la sortie Qualificatif 1: File to receive output

nom

Indiquez le nom du fichier de base de données vers lequel la sortie de la commande est dirigée. Specify the name of the database file to which the command output is directed.

Qualificatif 2 : Bibliothèque Qualificatif 2: Library

*LIBL

La liste de bibliothèques est utilisée pour localiser le fichier. Si le fichier est introuvable, un fichier est créé dans la bibliothèque en cours. S'il n'existe pas de bibliothèque en cours, le fichier est créé dans la bibliothèque QGPL. The library list is used to locate the file. If the file is not found, one is created in the current library. If no current library exists, the file will be created in the QGPL library.

*CURLIB

La bibliothèque en cours de l'unité d'exécution est utilisée pour localiser le fichier. Si aucune bibliothèque n'est indiquée comme bibliothèque en cours de l'unité d'exécution, la bibliothèque QGPL est utilisée. The current library for the thread is used to locate the file. If no library is specified as the current library for the thread, the QGPL library is used.

nom

Indiquez le nom de la bibliothèque à rechercher. Specify the name of the library to be searched.

Remarque :Si cette commande crée le fichier, le texte est "OUTFILE created by PRTTRC command" et le droit public est *EXCLUDE. Remarque :If this command creates the file, the text is "OUTFILE created by PRTTRC command" and the public authority is *EXCLUDE.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base de données vers lequel la sortie est dirigée lorsque *OUTFILE est indiqué pour le paramètre Sortie (OUTPUT). Specifies the name of the database file member to which the output is directed when *OUTFILE is specified for the Output (OUTPUT) parameter.

Élément 1: Member to receive output

*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é pour le paramètre Fichier devant recevoir la sortie (OUTFILE). 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 for the File to receive output (OUTFILE) parameter.

nom

Specify the name of the file member that receives the output. If OUTMBR(member-name) is specified and the member does not exist, the system creates it.

Si le membre existe, vous pouvez ajouter des enregistrements à la fin du membre existant ou effacer le membre existant et y ajouter les enregistrements. If the member exists, you can add records to the end of the existing member or clear the existing member and add the records.

Élément 2: Replace or add records

*REPLACE

Les enregistrements existants du membre de fichier de base de données indiqué sont remplacés par les nouveaux enregistrements. The existing records in the specified database file member are replaced by the new records.

*ADD

Les nouveaux enregistrements sont ajoutés aux informations existantes du membre de fichier de base de données indiqué. The new records are added to the existing information in the specified database file member.

Exemples

Exemple 1 : Impression et suppression de la trace Example 1: Print and Delete Trace

PRTTRC   DTAMBR(TRACE8)  DTALIB(TRCLIB1)  DLTTRC(*YES)

Cette commande formate et imprime les données de trace contenues dans les membres de fichier de base de données nommés TRACE8 de la bibliothèque TRCLIB1. Les membres de données de trace sont supprimés une fois le fichier spoulé de données de trace écrit. Tous les travaux qui faisaient partie de la trace feront partie de la liste de trace. This command formats and prints the trace data contained in database file members named TRACE8 in library TRCLIB1. The trace data members are removed after the trace data spooled file has been written. All jobs which were part of the trace will be part of the trace listing.

Exemple 2 : Impression d'un sous-ensemble de la trace Example 2: Print Subset Trace

PRTTRC   DTAMBR(T123456789)  DTALIB(QGPL)
         SLTJOB(*ALL/QSYS/QCMN*)  DLTTRC(*YES)

Cette commande formate et imprime les données de trace contenues dans les membres de fichier de base de données nommés T123456789 de la bibliothèque QGPL. Les membres de données de trace sont supprimés une fois le fichier spoulé de données de trace écrit. Seuls les travaux tracés qui ont été démarrés sous le profil utilisateur QSYS et dont le nom de travail commençait par "QCMN" feront partie de la liste de trace. This command formats and prints the trace data contained in database file members named T123456789 in library QGPL. The trace data members are removed after the trace data spooled file has been written. Only those traced jobs that were started under user profile QSYS and had job names that started with "QCMN" will be part of the trace listing.

Exemple 3 : Impression de la trace triée par heure Example 3: Print Trace and Sort by Time

PRTTRC   DTAMBR(MYTRACE)  DTALIB(MYTRCLIB)
         DLTTRC(*YES)  SORT(*TIME)

Cette commande formate et imprime les données de trace contenues dans les membres de fichier de base de données nommés MYTRACE de la bibliothèque MYTRCLIB. Les membres de données de trace sont supprimés une fois le fichier spoulé de données de trace écrit. Les enregistrements de trace sont triés selon l'heure à laquelle l'enregistrement a été collecté. Si les travaux tracés étaient multitâches, la sortie de trace est triée par travail, toutes les unités d'exécution de ce travail étant triées par heure. La sortie obtenue peut comporter des informations de trace de plusieurs unités d'exécution entremêlées. This command formats and prints the trace data contained in database file members named MYTRACE in library MYTRCLIB. The trace data members are removed after the trace data spooled file has been written. The trace records are sorted by the time the record was collected. If the traced jobs were multithreaded, the trace output is sorted by job, with all threads in that job sorted by time. The resulting output may have trace information for multiple threads intermingled.

Exemple 4 : Impression de la trace vers un fichier de sortie Example 4: Print Trace to an Output File

PRTTRC   DTAMBR(BIGTRACE)  DTALIB(TRACELIB)  DLTTRC(*YES)
         OUTPUT(*OUTFILE)  OUTFILE(MYLIB/MYFILE)

Cette commande stocke les données de trace contenues dans les membres de fichier de base de données nommés BIGTRACE de la bibliothèque TRACELIB dans un fichier de sortie de base de données nommé MYFILE de la bibliothèque MYLIB. Les membres de données de trace nommés BIGTRACE sont supprimés une fois les données de trace écrites dans le fichier de sortie de base de données. This command stores the trace data contained in database file members named BIGTRACE in library TRACELIB into a database output file named MYFILE in library MYLIB. The trace data members named BIGTRACE are removed after the trace data has been written to the database output file.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF39CD

Une erreur s'est produite lors du traitement de la commande PRTTRC. Error occurred during processing of the PRTTRC command.

CPF98A2

Vous n'avez pas les droits sur la commande ou l'API &1. Not authorized to &1 command or API.