ENDTRC

La commande Arrêter la trace (ENDTRC) arrête une session de trace démarrée par une commande STRTRC (Démarrer la trace). The End Trace (ENDTRC) command ends a trace session that was started by a STRTRC (Start Trace) command.

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.
• Si DTAOPT(*LIB) est indiqué, 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. If DTAOPT(*LIB) is specified, you must have execute (*EXECUTE) and add (*ADD) authority to the library where the trace data is stored.
• Si PRTTRC(*YES) est indiqué, vous devez posséder des droits sur la commande PRTTRC (Imprimer la trace). If PRTTRC(*YES) is specified, you must have authority to the PRTTRC (Print Trace) command.

Paramètres

ID de session (SSNID)Session ID (SSNID)

Indique un identificateur de session pour la trace à arrêter. Ce nom doit correspondre à l'identificateur de session d'une trace précédemment démarrée et toujours active. Specifies a session identifier for the trace to be ended. This name must match the session identifier of a trace that had been previously started and is still active.

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

*PRV

La session de trace la plus récemment démarrée par le même utilisateur que celui qui exécute cette commande ENDTRC sera arrêtée. Par exemple, si le travail qui exécute la commande ENDTRC s'exécute sous le profil utilisateur BOB, la dernière session de trace démarrée sous le profil utilisateur BOB est arrêtée. The trace session most recently started by the same user who is running this ENDTRC command will be ended. For example, if the job running the ENDTRC command is running under user profile BOB, the last trace session started under user profile BOB is ended.

nom

Indiquez l'identificateur de session de la trace à arrêter. Specify the session identifier of the trace to be ended.

Option (OPTION)

Indique si les données de trace seront conservées dans les mémoires tampon internes où elles ont été collectées après l'arrêt de la session. Specifies if trace data will be preserved in the internal buffers where it was collected after the session is ended.

*END

The trace data will not be preserved in the internal buffers where it was collected. After session is ended, the session can be:

• Imprimées avec la commande PRTTRC si DTAOPT(*LIB) est indiqué. Printed with PRTTRC command if DTAOPT(*LIB) is specified.

*EXTRACT

The trace data will be preserved in the internal buffers where it was collected. After data is extracted, the session can be:

• Imprimées avec la commande PRTTRC. Printed with PRTTRC command.
• Extraites à nouveau avec la commande ENDTRC OPTION(*EXTRACT). Extracted again with ENDTRC OPTION(*EXTRACT) command.
• Arrêtées avec la commande ENDTRC OPTION(*END). Ended with ENDTRC OPTION(*END) command.

Option de données (DTAOPT)Data option (DTAOPT)

Indique si les données de trace collectées sont stockées dans des fichiers de base de données. Specifies if the trace data that has been collected is stored into database files.

*LIB

Les données de trace seront copiées dans des fichiers de base de données. Le paramètre PRTTRC de cette commande ou la commande Imprimer la trace (PRTTRC) peut être utilisé pour mettre en forme et imprimer les données. The trace data will be copied into database files. The PRTTRC parameter on this command or the Print Trace (PRTTRC) command can be used to format and print the data.

*DLT

The trace data will not be copied into database files and the trace data will be deleted from the internal buffers where it was collected.

Remarque :Cette option n'est valide que si *END a été indiqué dans le paramètre Option (OPTION). Remarque :This option is only valid if *END was specified for the Option (OPTION) parameter.

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

Indique le nom de la bibliothèque dans laquelle les données de trace seront stockées. Un ensemble de fichiers de base de données sera créé dans cette bibliothèque pour contenir les données de trace. Les fichiers seront créés s'ils n'existent pas déjà. Specifies the name of the library in which the trace data will be stored. A set of database files will be created in this library to contain the trace data. The files will be created if they do not already exist.

Remarque :Ce paramètre n'est valide que si *LIB est indiqué dans le paramètre Option de données (DTAOPT). Remarque :This parameter is valid only if *LIB is specified for the Data option (DTAOPT) parameter.

*CURLIB

Les données de trace sont stockées dans des fichiers de la bibliothèque en cours du travail. Si aucune bibliothèque n'est définie comme bibliothèque en cours du travail, QGPL est utilisée. The trace data is stored in 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 devant contenir les fichiers de données de trace. La bibliothèque doit déjà exister lors de l'exécution de la commande ENDTRC. Specify the name of the library to contain the trace data files. The library must already exist when the ENDTRC command is run.

Remplacer les données (RPLDTA)Replace data (RPLDTA)

Indique si les données de trace collectées par une session de trace précédente portant le même identificateur de session sont remplacées par les nouvelles données de trace. Cela est déterminé en vérifiant si l'ensemble de fichiers de base de données dans lequel les données de trace doivent être stockées comporte déjà des membres de fichier portant le même nom que l'identificateur de session de trace indiqué (paramètre SSNID). Specifies whether trace data that was collected by a previous trace session with the same session identifier is replaced with new trace data. This is determined by checking if the set of database files where the trace data is to be stored already have file members with the same name as the specified trace session identifier (SSNID parameter).

Remarque :Ce paramètre n'est valide que si *LIB est indiqué dans le paramètre Option de données (DTAOPT). Remarque :This parameter is valid only if *LIB is specified for the Data option (DTAOPT) parameter.

*YES

Si des données de trace existent déjà avec l'identificateur de session indiqué, les anciennes données de trace sont perdues et remplacées par les nouvelles. If trace data already exists with the specified session identifier, the old trace data is lost and replaced by the new trace data.

*NO

Si des données de trace existent déjà pour la session indiquée, un message d'erreur est envoyé à l'utilisateur. If trace data already exists for the specified session, an error message is sent to the user.

Sélection des travaux (SLTJOB)

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

Remarque :Ce paramètre n'est valide que si *LIB est indiqué dans le paramètre Option de données (DTAOPT). Remarque :This parameter is valid only if *LIB is specified for the Data option (DTAOPT) parameter.

Valeurs uniques

*ALL

Tous les travaux qui faisaient partie de la collecte de données sont inclus. All jobs that were part of the data collection are included.

Autres valeurs (jusqu'à 8 répétitions)

Élément 1: Travail

Qualificatif 1: Travail

nom

Indiquez le nom du travail à inclure dans la collecte de données. Specify the name of the job to be included in the data collection.

Qualificatif 2: Utilisat

nom

Indiquez le nom de l'utilisateur du travail à inclure dans la collecte de données. Specify the name of the user of the job to be included in the data collection.

Qualificatif 3: Numéro

000001-999999

Indiquez le numéro du travail à inclure dans la collecte de données. Specify the number of the job to be included in the data collection.

Élément 2: Thread ID to include

Valeurs uniques

*ALL

Toutes les unités d'exécution du travail indiqué sont incluses. All threads of the specified job are included.

Autres valeurs (jusqu'à 20 répétitions)

*INITIAL

Seule l'unité d'exécution initiale du travail indiqué est incluse. Only the initial thread of the specified job is included.

thread-identifier

Indiquez l'identificateur d'unité d'exécution du travail à inclure. Il s'agit de l'ID d'unité d'exécution affiché par la commande Gestion du travail (WRKJOB). Specify the thread identifier of the job to be included. This is the thread ID as shown by the Work with Job (WRKJOB) command.

Imprimer les données de trace (PRTTRC)Print trace data (PRTTRC)

Indique si les données de trace sont mises en forme et imprimées après leur stockage dans les fichiers de base de données de trace. Specifies whether trace data is formatted and printed after it is stored in the trace database files.

Remarque :Ce paramètre n'est valide que si *LIB est indiqué dans le paramètre Option de données (DTAOPT). Remarque :This parameter is valid only if *LIB is specified for the Data option (DTAOPT) parameter.

*NO

La commande PRTTRC (Imprimer la trace) n'est pas exécutée dans le cadre de cette commande. The PRTTRC (Print Trace) command is not run as part of this command.

*YES

La commande PRTTRC (Imprimer la trace) est exécutée une fois les données de trace stockées dans les fichiers de base de données. The PRTTRC (Print Trace) command is run after the trace data has been stored in the database files.

Exemples

Exemple 1 : Arrêt de la trace démarrée le plus récemment Example 1: End Most Recently Started Trace

ENDTRC   SSNID(*PRV)

Cette commande arrête la session de trace démarrée le plus récemment par le même utilisateur que celui qui exécute la commande ENDTRC. Les données de trace seront stockées dans un ensemble de fichiers de la bibliothèque en cours du travail, ou dans QGPL s'il n'y a pas de bibliothèque en cours pour le travail. This command ends the trace session started most recently by the same user who is running the ENDTRC command. The trace data will be stored in a set of files in the current library of the job, or QGPL if there is no current library for the job.

Exemple 2 : Arrêt d'une trace et suppression des données de trace Example 2: End a Trace and Delete Trace Data

ENDTRC   SSNID(DCG1)
         OPTION(*END)
         DTAOPT(*DLT)

Cette commande arrête la session de trace DCG1 et supprime les données de trace. This command ends the trace session DCG1 and deletes the trace data.

Exemple 3 : Arrêt d'une session de trace avec extraction d'un travail précis à collecter Example 3: End a Trace Session Extracting a Specific Job to be Collected

ENDTRC   SSNID(MYTRACE)
         OPTION(*EXTRACT)
         SLTJOB((123456/MYUSER/MYJOBNAME))

Cette commande arrête la session de trace MYTRACE ; seul le travail 123456/MYUSER/MYJOBNAME est collecté. La session pourra être extraite à nouveau ultérieurement. This command ends the trace session MYTRACE; only the 123456/MYUSER/MYJOBNAME job is collected. The session might be extracted again later.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF39CA

ID de session de trace &1 introuvable. Trace session ID &1 not found.

CPF39CB

L'ID de session de trace &1, dans la bibliothèque &2, contient des données. Indiquez RPLDTA(*YES). Trace session ID &1, in library &2, data exists. Specify RPLDTA(*YES).

CPF98A2

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

CPF39D3

Impossible de démarrer ou d'arrêter la trace. Unable to start/end the trace.