ADDTRCFTR

Ajouter filtre de trace

Add Trace Filter

En bref

La commande Ajout de filtre de trace (ADDTRCFTR) ajoute un nouveau filtre de trace au système. The Add Trace Filter (ADDTRCFTR) command adds a new trace filter to the system.

ADDTRCFTR se lit ADD (Ajouter) + TRCFTR. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDTRCFTR FTR(…)

Paramètres

FTR Filtre obligatoire
PGMTRG Déclencheur de programme Program trigger
JVATRG Déclencheur Java Java trigger
PGMFTR Filtre de programme Program filter
JVAFTR Filtre de méthode Java Java method filter

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

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Ajout de filtre de trace (ADDTRCFTR) ajoute un nouveau filtre de trace au système. Un filtre de trace identifie les données de flux de trace (appel/retour) à collecter pendant une session de trace ; il sert à limiter la quantité de données collectées en indiquant une valeur de comparaison. Si les données de l'enregistrement de trace correspondent à la valeur de comparaison, elles sont collectées. Sinon, elles sont ignorées. Le filtre est indiqué dans la commande STRTRC (Démarrage de trace). The Add Trace Filter (ADDTRCFTR) command adds a new trace filter to the system. A trace filter identifies the trace flow (call/return) data that is to be collected during a trace session, and is meant to limit the amount of data collected by specifying a compare value. If the data in the trace record matches the compare value, then the data will be collected. If not, the data is discarded. The filter is specified on the STRTRC (Start Trace) command.

Restrictions:

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 Modification de l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, permet également de modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. 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.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FTR	Filtre	Nom	Obligatoire, positionnel 1
PGMTRG	Déclencheur de programmeProgram trigger	Liste d'éléments	Facultatif
	Élément 1: Filter entry	Nom d'objet qualifié
	Qualificatif 1 : Entrée de filtreQualificatif 1: Filter entry	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
	Élément 2: Module	Nom
	Élément 3: Procedure	Valeur caractère
	Élément 4: Type	PGM, SRVPGM
	Élément 5: Trigger option	ENTRYEXIT, ENTRY
JVATRG	Déclencheur JavaJava trigger	Liste d'éléments	Facultatif
	Élément 1: Java package	Valeur caractère, *NONE
	Élément 2: Java class	Valeur caractère, *ALL
	Élément 3: Java method	Valeur caractère, *ALL
	Élément 4: Trigger option	ENTRYEXIT, ENTRY, ENTRYEXITNOPGM, ENTRYNOPGM
PGMFTR	Filtre de programmeProgram filter	Liste d'éléments	Facultatif
	Élément 1: Opérateur relationnel	EQ, NE
	Élément 2:	Values (jusqu'à 16 répétitions): Liste d'éléments
	Élément 1: Filter entry	Nom d'objet qualifié
	Qualificatif 1 : Entrée de filtreQualificatif 1: Filter entry	Nom
	Qualificatif 2: Biblio	Nom, *LIBL
	Élément 2: Module	Nom, *ALL
	Élément 3: Procedure	Valeur caractère, *ALL
	Élément 4: Type	PGM, SRVPGM
JVAFTR	Filtre de méthode JavaJava method filter	Liste d'éléments	Facultatif
	Élément 1: Opérateur relationnel	EQ, NE
	Élément 2:	Values (jusqu'à 5 répétitions): Liste d'éléments
	Élément 1: Java package	Valeur caractère
	Élément 2: Java class	Valeur caractère, *ALL
	Élément 3: Java method	Valeur caractère, *ALL

Filtre (FTR)

Indique le filtre de trace à ajouter. Si le filtre indiqué existe déjà, un message d'erreur est émis. Un filtre de trace existant peut être supprimé avec la commande Retrait de filtre de trace (RMVTRCFTR). Specifies the trace filter to be added. If the specified filter already exists, an error message is issued. An existing trace filter can be removed by using the Remove Trace Filter (RMVTRCFTR) command.

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

nom: Indiquez le nom du nouveau filtre de trace. Specify the name of the new trace filter.

Déclencheur de programme (PGMTRG)Program trigger (PGMTRG)

Si une procédure correspondant à cette spécification de déclencheur est appelée, STRTRC commence à collecter les enregistrements de trace de flux pour cette session STRTRC. Les enregistrements de trace de flux ne sont collectés que pour l'unité d'exécution où le déclencheur se produit. If a procedure is called that matches this trigger specification, then STRTRC will begin collecting flow trace records for this STRTRC session. The flow trace records will be collected only for the thread where the trigger occurs.

Lorsque la procédure retourne et qu'elle correspond à la spécification de déclencheur, STRTRC cesse de collecter les enregistrements de trace de flux. When the procedure returns and it matches the trigger specification, STRTRC will stop collecting the flow trace records.

Élément 1: Filter entry

Qualificatif 1: Filter entry

nom: Indiquez le nom du programme qui, s'il est appelé, déclenche le début de la collecte des enregistrements de trace de flux. Specify the name of the program which, if called, will cause trace flow records to start being collected.

Qualificatif 2: Biblio

*LIBL: La liste de bibliothèques du travail qui émet la commande STRTRC est parcourue pour trouver le programme ou le programme de service indiqué. The library list of the job that issues the STRTRC command is searched to find the specified program or service program.
nom: Indiquez le nom de la bibliothèque qui contient le programme ou le programme de service. Specify the name of the library which contains the program or service program.

Élément 2: Module

nom: Indiquez le nom du module, dans le programme ou le programme de service, qui contient la procédure servant de déclencheur. Specify the name of the module within the program or service program that contains the procedure that is to be the trigger.

Élément 3: Procedure

valeur-caractère: Indiquez le nom d'une procédure spécifique, dans le module indiqué, qui sert de déclencheur. Indiquez le nom de la procédure entre apostrophes s'il contient des minuscules. Specify the name of a specific procedure within the specified module that is to be the trigger. Specify the procedure name within single quotes if the procedure name contains lower case characters.

Élément 4: Type

*PGM: Le programme indiqué est un objet programme (*PGM). The program being specified is a program (*PGM) object.
*SRVPGM: Le programme indiqué est un objet programme de service (*SRVPGM). The program being specified is a service program (*SRVPGM) object.

Élément 5: Trigger option

*ENTRYEXIT: La procédure de déclenchement indiquée active la collecte des enregistrements de trace de flux à l'entrée de la procédure. À la sortie de la procédure, la collecte des enregistrements de trace de flux est désactivée. The specified trigger procedure enables the collection of flow trace records at procedure entry time. At procedure exit, the collection of flow trace records is disabled.
*ENTRY: La procédure de déclenchement indiquée active la collecte des enregistrements de trace de flux à l'entrée de la procédure. La collecte des enregistrements de trace de flux se poursuit pendant toute la durée de la session de trace. The specified trigger procedure enables the collection of flow trace records at procedure entry time. The collection of flow trace records continues for the duration of the trace session.

Déclencheur Java (JVATRG)Java trigger (JVATRG)

Si un événement d'entrée de méthode Java (*JVAENTRY) correspondant à cette spécification de déclencheur se produit, STRTRC commence à collecter tous les événements pour cette session STRTRC. Les événements ne sont collectés que pour l'unité d'exécution où le déclencheur se produit. Lorsque l'événement de sortie de méthode Java (*JVAEXIT) correspondant à la spécification de déclencheur se produit, STRTRC cesse de collecter les événements. If a Java method entry event (*JVAENTRY) occurs that matches this trigger specification, then STRTRC will begin collecting all events for this STRTRC session. The events will be collected only for the thread where the trigger occurs. When the Java method exit event (*JVAEXIT) occurs that matches the trigger specification, STRTRC will stop collecting the events.

Les points d'ancrage *JVAENTRY et *JVAEXIT sont toujours activés dans Java interprété. Vous pouvez également les activer en mode JIT en indiquant la propriété 'os400.enbpfrcol=1'. The *JVAENTRY and *JVAEXIT hooks are always enabled in interpreted Java. You can also enable these hooks when running in JIT mode by specifying the property 'os400.enbpfrcol=1'.

Pour le code compilé pour une exécution directe, indiquez ENBPFRCOL(*ENTRYEXIT) dans la commande CL Création de programme Java (CRTJVAPGM). For code compiled for direct execution, specify ENBPFRCOL(*ENTRYEXIT) on the Create Java Program (CRTJVAPGM) CL command.

Élément 1: Java package

package-name: Indiquez le nom du package Java qui contient la méthode à utiliser comme déclencheur. Specify the name of the Java package that contains the method to use as the trigger.

Élément 2: Java class

class-name: Indiquez une classe, dans le package, qui contient la méthode à utiliser comme déclencheur. Specify a class within the package that contains the method to use as the trigger.

Élément 3: Java method

method-name: Indiquez une méthode à utiliser comme déclencheur. Specify a method to use as the trigger.

Élément 4: Trigger option

*ENTRYEXIT: La méthode de déclenchement indiquée active la collecte des événements à l'entrée de la méthode Java. À la sortie de la méthode Java, la collecte des événements est désactivée. The specified trigger method enables the collection of events at Java method entry time. At Java method exit, the collection of events is disabled.
*ENTRY: La méthode de déclenchement indiquée active la collecte des événements à l'entrée de la méthode Java. La collecte des événements est activée pendant toute la durée de la session STRTRC. The specified trigger method enables the collection of events at Java method entry time. The collection of events is enabled for the duration of the STRTRC session.
*ENTRYEXITNOPGM: La méthode de déclenchement indiquée active la collecte des événements (à l'exception des événements de programme) à l'entrée de la méthode. À la sortie de la méthode, la collecte des événements est désactivée. Cette option n'est pas valide pour le mode STATS. The specified trigger method enables the collection of events (except program events) at method entry time. At method exit, the collection of events is disabled. This option is not valid for STATS mode.
*ENTRYNOPGM: La méthode de déclenchement indiquée active la collecte des événements (à l'exception des événements de programme) à l'entrée de la méthode. La collecte des événements est activée pendant toute la durée de la session STRTRC. Cette option n'est pas valide pour le mode STATS. The specified trigger method enables the collection of events (except program events) at method entry time. The collection of events is enabled for the duration of the STRTRC session. This option is not valid for STATS mode.

Filtre de programme (PGMFTR)Program filter (PGMFTR)

Indique les comparaisons de programmes à utiliser pour ce filtre. Specifies the program comparisons to use for this filter.

Élément 1: Opérateur relationnel

*EQ: Les enregistrements de trace de flux dont les données de programme correspondent au programme indiqué sont inclus dans les données collectées. Flow trace records having program data that matches the specified program are included in the data collected.
*NE: Les enregistrements de trace de flux dont les données de programme correspondent au programme indiqué sont exclus des données collectées. Ces enregistrements de trace n'apparaissent pas. Flow trace records having program data that matches the specified program are excluded from the data collected. These trace records will not show up.

Élément 2:

Vous pouvez indiquer jusqu'à 16 valeurs pour cet ensemble d'éléments. You can specify up to 16 values for this element set.

Élément 1: Filter entry

Qualificatif 1 : Entrée de filtre Qualificatif 1: Filter entry

nom: Indiquez le nom du programme à utiliser comme valeur de comparaison pour le filtre de programme. Specify the name of the program to be used as a compare value for the program filter.

Qualificatif 2: Biblio

*LIBL: La liste de bibliothèques du travail qui émet la commande STRTRC est parcourue pour trouver le programme ou le programme de service indiqué. The library list of the job that issues the STRTRC command is searched to find the specified program or service program.
nom: Indiquez le nom de la bibliothèque qui contient le programme ou le programme de service. Specify the name of the library which contains the program or service program.

Élément 2: Module

*ALL: Tous les modules du programme ou du programme de service passent le filtre. Si vous filtrez un programme OPM (Original Program Model), indiquez *ALL pour cet élément. All modules in the program or service program will pass the filter. If filtering an OPM (Original Program Model) program, specify *ALL for this element.
nom: Indiquez un module spécifique du programme ou du programme de service à utiliser comme valeur de comparaison pour le filtre de programme. Specify a specific module within the program or service program to be used as a compare value for the program filter.

Élément 3: Procedure

*ALL: Toutes les procédures du module indiqué sont utilisées comme valeur de comparaison pour le filtre de programme. All procedures in the specified module are used as a compare value for the program filter.
valeur-caractère: Indiquez une procédure à utiliser comme valeur de comparaison du filtre. Indiquez le nom de la procédure entre apostrophes s'il contient des minuscules. Specify a procedure to use as the filter compare value. Specify the procedure name within single quotes if the procedure name contains lower case characters.

Élément 4: Type

*PGM: Le programme indiqué est un objet programme (*PGM). The program being specified is a program (*PGM) object.
*SRVPGM: Le programme indiqué est un objet programme de service (*SRVPGM). The program being specified is a service program (*SRVPGM) object.

Filtre de méthode Java (JVAFTR)Java method filter (JVAFTR)

Indique le package, la classe et les méthodes Java à utiliser comme valeurs de comparaison pour le filtre Java. Specifies the Java package, class, and methods to be used as compare values for the Java filter.

Élément 1: Opérateur relationnel

*EQ: Les enregistrements de trace de flux dont les données Java correspondent aux packages, classes et méthodes indiqués sont inclus dans les données collectées. Flow trace records having Java data that match the specified packages, classes, and methods are included in the data collected.
*NE: Les enregistrements de trace de flux dont les données Java correspondent aux packages, classes et méthodes indiqués sont exclus de la collecte et n'apparaissent pas. Flow trace records having Java data that matches the specified packages, classes, and methods are excluded from the collection and will not show up.

Élément 2:

Vous pouvez indiquer jusqu'à 5 valeurs pour cet ensemble d'éléments. You can specify up to 5 values for this element set.

Élément 1: Java package

valeur-caractère: Indiquez le nom du package Java à utiliser comme valeur de comparaison pour le filtre. Specify the name of the Java package to be used as a compare value for the filter.

Élément 2: Java class

*ALL: Toutes les classes du package indiqué passent le filtre Java. All classes in the specified package will pass the Java filter.
valeur-caractère: Indiquez le nom d'une classe du package à utiliser comme valeur de comparaison pour le filtre. Specify the name of a class within the package to be used as a compare value for the filter.

Élément 3: Java method

*ALL: Toutes les méthodes de la classe et du package indiqués passent le filtre. All methods in the specified class and package will pass the filter.
valeur-caractère: Indiquez le nom d'une méthode à utiliser comme valeur de comparaison pour le filtre. Specify the name of a method to use as the filter compare value.

Exemples

Exemple 1 : Ajout d'un filtre de trace pour un déclencheur de programme Example 1: Adding a Trace Filter for a Program Trigger

ADDTRCFTR   FTR(PGMFTR)
            PGMTRG(MYLIB/MYPGM MYMODL *PEP *PGM *ENTRY)

Cette commande ajoute un nouveau filtre de trace nommé PGMFTR. Si ce filtre est utilisé dans la commande Démarrage de trace (STRTRC), la collecte des données commence lorsque l'entrée de programme du module MYMODL de MYPGM est appelée. This command adds a new trace filter named PGMFTR. If this filter is used in the Start Trace (STRTRC) command, the collection of data will begin when the program entry of MYMODL module of MYPGM is called.

Messages d'erreur

Unknown