TRCJOB

La commande Tracer un travail (TRCJOB) contrôle les traces des appels et des retours de programmes du modèle de programme d'origine (OPM) et de procédures ILE (Integrated Language Environment) qui se produisent dans le travail en cours ou dans le travail en cours de maintenance à la suite de la commande Démarrer le travail de service (STRSRVJOB) dirigée vers ce travail. La commande, qui active ou désactive une trace, peut tracer le flux des modules, l'acquisition de données du système d'exploitation (y compris les traces de commandes CL), ou les deux. The Trace Job (TRCJOB) command controls traces of original program model (OPM) programs and Integrated Language Environment (ILE) procedure calls and returns that occur in the current job or in the job being serviced as a result of the Start Service Job (STRSRVJOB) command directed to that job. The command, which sets a trace on or off, can trace module flow, operating system data acquisition (including CL command traces), or both.

Si la commande Démarrer le travail de service (STRSRVJOB) est entrée avant la commande TRCJOB, le travail tracé est celui identifié par la commande STRSRVJOB. If the Start Service Job (STRSRVJOB) command is entered before the TRCJOB command, the job that is traced is the one identified by the STRSRVJOB command.

La commande TRCJOB émet en interne la commande STRTRC lorsque SET(*ON) est indiqué ou la commande ENDTRC lorsque SET(*OFF) ou SET(*END) est indiqué. The TRCJOB command issues under the covers the STRTRC command when SET(*ON) is specified or the ENDTRC command when SET(*OFF) or SET(*END) is specified.

Restrictions:

1. Cette commande est livrée avec le droit public exclusion (*EXCLUDE) et les profils utilisateur QPGMR, QSYSOPR, QSRV, QSRVBAS et QRJE sont livrés avec des droits privés d'utilisation de cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QPGMR, QSYSOPR, QSRV, QSRVBAS, and QRJE user profiles are shipped with private authorities to use this command.
2. 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, QATRCJOB. The record format of the database output file must match the record format of the IBM-supplied output file QATRCJOB.
3. Le nombre d'enregistrements de trace traités entre le début et la fin de la trace ne doit pas dépasser un million. The number of trace records processed between the start and end of the trace must not exceed one million.
4. La commande Transférer un travail (TFRJOB) ne doit pas être émise tant que la commande TRCJOB est active. The Transfer Job (TFRJOB) command must not be issued while TRCJOB command is active.

Paramètres

Option de trace (SET)

Indique si la collecte des enregistrements de trace démarre ou s'arrête. Specifies whether the collection of trace records starts or stops.

*ON

La collecte des enregistrements de trace est démarrée. The collection of trace records is started.

*OFF

La collecte des enregistrements de trace est arrêtée et les enregistrements de trace sont écrits dans le fichier d'imprimante spoule ou le fichier de sortie. The collection of trace records is stopped, and the trace records are written to the spooled printer file or output file.

*END

La collecte des enregistrements de trace est arrêtée et tous les enregistrements de trace existants sont supprimés. Aucun fichier d'imprimante spoule n'est créé. The collection of trace records is stopped, and all existing trace records are deleted. No spooled printer file is created.

Type de trace (TRCTYPE)

Indique le type de données de trace à stocker dans un fichier de trace. Specifies the type of trace data to store in a trace file.

*ALL

Toutes les données de trace collectées sont stockées dans des enregistrements de trace. Cela comprend la trace du flux de contrôle et les données de trace elles-mêmes. All the trace data collected is stored in trace records. This includes tracing the flow of control and the trace data itself.

*FLOW

Le flux de contrôle est tracé lorsque des programmes OPM et des procédures ILE sont appelés et lorsqu'ils rendent le contrôle. The flow of control is traced when OPM programs and ILE procedures are called and when they return control.

*DATA

Les données sont fournies à des points de trace prédéfinis à l'intérieur du système d'exploitation et stockées dans des enregistrements de trace. Cela comprend les enregistrements de trace des commandes CL qui ont été exécutées. The data is provided at predefined trace points within the operating system stored in trace records. This includes trace records for the CL commands that have run.

Mémoire maxi à utiliser (MAXSTG)

Indique la quantité maximale de mémoire utilisée pour les enregistrements de trace collectés. Specifies the maximum amount of storage used for collected trace records.

4096

Un maximum de 4096 kilo-octets de mémoire est utilisé. A maximum of 4096 kilobytes of storage is used.

1-16000

Indiquez la quantité maximale de mémoire, en kilo-octets, utilisée pour stocker les enregistrements de trace. (Un kilo-octet équivaut à 1024 octets.) Specify the maximum amount of storage, in kilobytes, used to store trace records. (One kilobyte equals 1024 bytes.)

Trace pleine (TRCFULL)

Indique si les enregistrements de trace doivent se réécrire en boucle (les enregistrements les plus anciens sont remplacés par les nouveaux) ou si la trace doit être désactivée lorsque toute la mémoire a été utilisée. Specifies whether the trace records are to wrap (replace oldest records with new records) or to set trace off when all of the storage has been used.

*WRAP

Lorsque le fichier de trace est plein, la trace reboucle au début. Les enregistrements de trace les plus anciens sont écrasés par les nouveaux au fur et à mesure de leur collecte. When the trace file is full, the trace wraps to the beginning. The oldest trace records are written over by new ones as they are collected.

*STOPTRC

La trace s'arrête lorsque le fichier de trace est plein d'enregistrements de trace. Tracing stops when the trace file is full of trace records.

Pgm à appeler avant la trace (EXITPGM)

Ce paramètre n'est plus utilisé. This parameter is no longer used.

Sélection des procédures à tracer (SLTPRC)Select procedures to trace (SLTPRC)

Ce paramètre n'est plus utilisé. This parameter is no longer used.

ID d'unité d'exécution à inclure (SLTTHD)Thread ID to include (SLTTHD)

Indique une liste d'au plus vingt unités d'exécution dont les appels et retours sont inclus dans la trace. Seuls les enregistrements de trace des identificateurs d'unité d'exécution indiqués sont inclus. Specifies a list of up to twenty threads whose calls and returns are included in the trace. Only trace records for the specified thread identifiers are included.

Valeurs uniques

*ALL

Tous les appels et retours de toutes les unités d'exécution sont inclus dans la trace. All threads calls and returns are included in the trace.

*SELECT

Une liste d'identificateurs d'unités d'exécution est affichée, dans laquelle l'utilisateur peut en sélectionner jusqu'à vingt dont les enregistrements de trace doivent être inclus. A list of thread identifiers is shown from which the user can select up to twenty whose trace records are to be included.

Autres valeurs

hexadecimal-value

Indiquez les identificateurs d'au plus vingt unités d'exécution dont les enregistrements de trace doivent être inclus. Specify the identifiers of up to twenty threads whose trace records are to be included.

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.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier de base de données qui reçoit la sortie de la commande. Specifies the name of the database file member that receives the output of the command.

É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 recevant la sortie (OUTFILE). Si le membre existe déjà, vous avez la possibilité d'ajouter les nouveaux enregistrements à la fin du membre existant ou d'effacer le membre avant d'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 for the File to receive output (OUTFILE) parameter. 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.

nom

Indiquez le nom du membre de fichier qui reçoit la sortie. S'il n'existe pas, le système le crée. Specify the name of the file member that receives the output. If it does not exist, the system creates it.

Élément 2: Replace or add records

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

Exemples

Exemple 1 : Trace du flux de contrôle Example 1: Tracing Flow of Control

TRCJOB   TRCTYPE(*FLOW)  MAXSTG(40)

Cette commande trace le flux du travail en cours. Des enregistrements de trace sont collectés pour chaque appel et retour de programme OPM et de procédure ILE qui se produit dans le travail. Le fichier de trace contient 40 Ko de mémoire et se réécrit en boucle (les enregistrements les plus anciens sont remplacés par les nouveaux) si cette quantité de mémoire est remplie d'enregistrements de trace. This command traces the flow of the current job. Trace records are collected for each OPM program and ILE procedure call and return that occurs in the job. The trace file contains 40K of storage and wraps (oldest records are replaced by new records) if that amount of storage is filled with trace records.

Exemple 2 : Arrêt de l'opération de trace Example 2: Stopping the Trace Operation

TRCJOB   SET(*OFF)  OUTPUT(*OUTFILE)
         OUTFILE(QGPL/TRCJOB)  OUTMBR(TRCDTA)

Cette commande arrête la trace et dirige la sortie vers le fichier de base de données QGPL/TRCJOB. La sortie est dirigée vers le membre TRCDTA. This command stops the trace and directs the output to the database file QGPL/TRCJOB. The output is directed to the member TRCDTA.

Exemple 3 : Trace d'une seule unité d'exécution Example 3: Tracing One Thread

TRCJOB   SET(*ON)  SLTTHD(00000001)

Cette commande ne trace que l'unité d'exécution indiquée du travail en cours. This command traces only the specified thread of the current job.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF2C94

Une erreur s'est produite lors du traitement de OUTFILE. Trace arrêtée.

CPF2C95

La trace est déjà active.

CPF2C96

La trace est déjà arrêtée.

CPF3510

Programme d'exit utilisateur introuvable dans la bibliothèque indiquée. User exit program not found in specified library.

CPF3511

La trace est déjà active. Trace already active.

CPF3512

La trace est déjà désactivée. Trace already off.

CPF3513

Impossible de désactiver la trace, la trace a été démarrée à partir d'un autre travail. Cannot set Trace Off, trace started from another job.

CPF3521

Mémoire insuffisante pour la table de trace. Not enough storage for the trace table.

CPF3530

Entrées en conflit dans l'index QSERVICE. Conflicting entries in index QSERVICE.

CPF3542

Travail non tracé car il est en cours de maintenance. Job not traced because it is being serviced.

CPF3548

L'exécution du travail dont le service est assuré est terminée. Serviced job completed running.

CPF3675

Impossible d'allouer la bibliothèque QSYS. Cannot allocate QSYS library.

CPF3909

La commande de service ne sera pas traitée. Service command will not be processed.

CPF3918

La demande de service a été annulée. Service request canceled.

CPF3925

Impossible d'ouvrir le fichier &1. Cannot open file &1.

CPF3936

Le travail dont le service est assuré s'est terminé avant le démarrage de la trace. Job being serviced ended before trace started.

CPF3950

Le message d'erreur &2 a été reçu pour le fichier &1. La demande a pris fin. Error message &2 received for file &1. Request ended.

CPF3951

Le fichier &1 ne peut pas être remplacé temporairement par le nom de fichier &2. File &1 cannot be overridden by file name &2.

CPF3957

Non autorisé à utiliser la bibliothèque du programme d'exit &2. Not authorized to use exit program library &2.

CPF3969

Erreur lors de la fermeture du fichier &1. La sortie peut être incomplète. Error during close of file &1. Output may not be complete.

CPF6611

Une erreur s'est produite pendant le traitement OUTFILE, la trace est terminée. Error occurred during OUTFILE processing, trace ended.

CPF6801

Invite de commande interrompue par touche &1.

CPF9810

Bibliothèque &1 non trouvée.

CPF98A4

Des restrictions d'unité d'exécution existent pour un autre processus. Thread restrictions exist for some other process.