ADDPEXFTR

La commande Ajouter un filtre Performance Explorer (ADDPEXFTR) ajoute un nouveau filtre Performance Explorer (PEX) au système. Chaque filtre est stocké en tant que membre dans le fichier QAPEXFTR de la bibliothèque QUSRSYS. Un filtre Performance Explorer identifie les données de performance à collecter pendant une session Performance Explorer et vise à limiter la quantité de données collectées en indiquant une valeur de comparaison pour des événements spécifiques. Si les données de l'événement correspondent à la valeur de comparaison, elles sont collectées. Sinon, elles sont ignorées. Le filtre est indiqué dans la commande STRPEX (Démarrer Performance Explorer). The Add Performance Explorer Filter (ADDPEXFTR) command adds a new Performance Explorer (PEX) filter to the system. Each filter is stored as a member in the QAPEXFTR file in library QUSRSYS. A Performance Explorer filter identifies the performance data that is to be collected during a Performance Explorer session, and is meant to limit the amount of data collected by specifying a compare value for specific events. If the data in the event matches the compare value, then the data will be collected. If not, the data is discarded. The filter is specified on the STRPEX (Start Performance Explorer) command.

Restrictions:

1. Cette commande est livrée avec le droit public *EXCLUDE. This command is shipped with public *EXCLUDE authority.
2. Pour utiliser cette commande, vous devez posséder le droit spécial *SERVICE ou être autorisé à la fonction Service Trace du système d'exploitation. La commande Modifier l'utilisation d'une fonction (CHGFCNUSG), avec l'ID de fonction QIBM_SERVICE_TRACE, permet de modifier la liste des utilisateurs autorisés à effectuer des opérations de trace. To use this command you must have *SERVICE special authority, or be authorized to the Service Trace function of the operating system. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_TRACE, can be used to change the list of users that are allowed to perform trace operations.
3. Vous devez posséder le droit *EXECUTE sur les bibliothèques de PGMTRG, PGMFTR et OBJFTR, ainsi que le droit *X sur les répertoires de JVATRG, JVAFTR, JVACLSFTR et PATHFTR si ces paramètres sont indiqués. You must have *EXECUTE authority to the libraries for PGMTRG, PGMFTR, OBJFTR, and *X authority to the directories for JVATRG, JVAFTR, JVACLSFTR, and PATHFTR if these parameters are specified.
4. The following user profiles have private authorities to use the command:
   • QPGMR
   • QSRV
5. Deux unités d'exécution d'un même travail ne sont pas autorisées à exécuter ADDPEXFTR en même temps. L'unité d'exécution qui a émis ADDPEXFTR en premier exécute la commande jusqu'à son terme pendant que la seconde ADDPEXFTR attend. Two threads within the same job will not be allowed to run ADDPEXFTR at the same time. The thread that issued ADDPEXFTR first will run the command to completion while the second ADDPEXFTR waits.

Paramètres

Filtre (FTR)

Indique le nom du filtre Performance Explorer à ajouter. Si le filtre indiqué existe déjà dans le fichier QAPEXFTR de la bibliothèque QUSRSYS, une condition d'erreur se produit. L'utilisateur peut soit modifier le nom du filtre, soit supprimer le filtre existant à l'aide de la commande Supprimer un filtre Performance Explorer (RMVPEXFTR), puis relancer cette commande. Specifies the name of the Performance Explorer filter to be added. If the specified filter already exists in the QAPEXFTR file in library QUSRSYS, an error condition will occur. The user can either change the filter name or remove the existing filter using the Remove Performance Explorer Filter (RMVPEXFTR) command, and try this command again.

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

nom

Indiquez le nom du nouveau filtre Performance Explorer. Specify the name of the new Performance Explorer filter.

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

Si un événement d'entrée de procédure (*PRCENTRY) ou d'entrée MI (*MIENTRY) correspondant à cette spécification de déclencheur se produit, Performance Explorer commence à collecter tous les événements indiqués dans la définition Performance Explorer utilisée pour la session Performance Explorer active. Les événements sont collectés uniquement pour l'unité d'exécution dans laquelle le déclencheur se produit. Lorsque l'événement de sortie de procédure (*PRCEXIT) ou de sortie MI (*MIEXIT) correspondant à la spécification du déclencheur se produit, Performance Explorer cesse de collecter les événements indiqués dans la définition Performance Explorer. If a procedure entry event (*PRCENTRY) or MI entry event (*MIENTRY) occurs that matches this trigger specification, then Performance Explorer will begin collecting all events specified in the Performance Explorer definition used for the active Performance Explorer session. The events will be collected only for the thread where the trigger occurs. When the procedure exit event (*PRCEXIT) or MI exit event (*MIEXIT) occurs that matches the trigger specification, Performance Explorer will stop collecting the events specified in the Performance Explorer definition.

Remarque : les événements *MIENTRY, *MIEXIT, *PRCENTRY et *PRCEXIT sont toujours disponibles dans les programmes compilés au niveau d'optimisation 30 ou inférieur. Pour le niveau d'optimisation 40, ces événements ne sont disponibles que pour les procédures qui empilent un cadre sur la pile d'appels lorsqu'elles sont appelées (procédures non terminales). Note: The *MIENTRY, *MIEXIT, *PRCENTRY and *PRCEXIT events are always available in programs that have been compiled at optimization level 30 or below. For optimization level 40, these events are available only for the procedures that stack a frame on the invocation stack when called (non-leaf procedures).

Les événements *JVAENTRY et *JVAEXIT sont disponibles dans Java interprété et dans les programmes Java s'exécutant en mode JIT pour lesquels la propriété 'os400.enbpfrcol=1' a été définie. Cela ne concerne que la machine virtuelle classique, pas IBM Technology for Java. The *JVAENTRY and *JVAEXIT are available in interpreted Java and Java programs running in JIT mode where the property 'os400.enbpfrcol=1' has been set. This is only for classic VM, not IBM Technology for Java.

Élément 1: Programme

Qualificatif 1: Programme

nom

Indiquez le nom du programme déclencheur. Specify the name of the trigger program.

Qualificatif 2: Biblio

nom

Indiquez la bibliothèque qui contient le programme ou le programme de service. Specify the library which contains the program or service program.

Élément 2: Module

*ALL

Tous les modules du programme indiqué servent de déclencheur. All modules in the specified program will act as the trigger.

nom

Indiquez le module, dans le programme ou le programme de service, qui contient la procédure devant servir de déclencheur. Cette indication n'est requise que pour les programmes et programmes de service ILE. Specify the module within the program or service program that contains the procedure that is to be the trigger. This is required only for ILE programs and service programs.

Élément 3: Procedure

*PEP

La procédure d'entrée du programme sert de déclencheur. Cette valeur n'est pas valide pour les programmes de type *SRVPGM. The program entry procedure will act as the trigger. This is not valid for programs of type *SRVPGM.

*ALL

Toutes les procédures du module indiqué servent de déclencheur. All procedures in the specified module will act as the trigger.

nom

Indiquez une procédure spécifique, dans le module indiqué, devant servir de déclencheur. Indiquez le nom de la procédure entre apostrophes s'il contient des minuscules. Specify 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

Indiquez le type de programme spécifié. Indicate the type of program being specified.

*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 événements à l'entrée de la procédure. À la sortie de la procédure, la collecte des événements est désactivée. The specified trigger procedure enables the collection of events at procedure entry time. At procedure exit, the collection of events is disabled.

*ENTRY

La procédure de déclenchement indiquée active la collecte des événements à l'entrée de la procédure. La collecte des événements est activée pendant toute la durée de la session Performance Explorer. The specified trigger procedure enables the collection of events at procedure entry time. The collection of events is enabled for the duration of the Performance Explorer session.

*ENTRYEXITNOPGM

La procédure de déclenchement indiquée active la collecte des événements (à l'exception des événements de programme) à l'entrée de la procédure. À la sortie de la procédure, la collecte des événements est désactivée. Cette option n'est pas valide pour le mode STATS. The specified trigger procedure enables the collection of events (except program events) at procedure entry time. At procedure exit, the collection of events is disabled. This option is not valid for STATS mode.

*ENTRYNOPGM

La procédure de déclenchement indiquée active la collecte des événements (à l'exception des événements de programme) à l'entrée de la procédure. La collecte des événements est activée pendant toute la durée de la session Performance Explorer. Cette option n'est pas valide pour le mode STATS. The specified trigger procedure enables the collection of events (except program events) at procedure entry time. The collection of events is enabled for the duration of the Performance Explorer session. This option is not valid for STATS mode.

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, Performance Explorer commence à collecter tous les événements indiqués dans la définition Performance Explorer utilisée pour la session Performance Explorer active. Les événements sont collectés uniquement pour l'unité d'exécution dans laquelle le déclencheur se produit. Lorsque l'événement de sortie de méthode Java (*JVAEXIT) correspondant à la spécification du déclencheur se produit, Performance Explorer cesse de collecter les événements indiqués dans la définition Performance Explorer. If a Java method entry event (*JVAENTRY) occurs that matches this trigger specification, then Performance Explorer will begin collecting all events specified in the Performance Explorer definition used for the active Performance Explorer 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, Performance Explorer will stop collecting the events specified in the Performance Explorer definition.

Les points d'ancrage *JVAENTRY et *JVAEXIT sont toujours activés dans Java interprété. Vous pouvez également activer ces points d'ancrage lors d'une exécution en mode JIT en indiquant la propriété 'os400.enbpfrcol=1'. Cela ne concerne que la machine virtuelle classique, pas IBM Technology for Java. 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'. This is only for classic VM, not IBM Technology for Java.

Élément 1: Java package

nom

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

nom

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

nom

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 Performance Explorer. 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 Performance Explorer 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 Performance Explorer. 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 Performance Explorer 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 événements dont les données de programme correspondent au programme indiqué sont inclus dans les données collectées par Performance Explorer. Events having program data that matches the specified program are included in the data collected by Performance Explorer.

*NE

Les événements dont les données de programme correspondent au programme indiqué sont exclus des données collectées par Performance Explorer. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. Events having program data that matches the specified program are excluded from the data collected by Performance Explorer. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Filter entry

Indiquez les éléments de chaque entrée de filtre. Specify the elements for each filter entry.

Élément 1: Programme

Qualificatif 1: Programme

*ALL

Tous les programmes de la bibliothèque indiquée passent le filtre. All programs in the specified library will pass the filter.

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

nom

Indiquez la bibliothèque qui contient le programme ou le programme de service. Specify 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), specify *ALL for this element.

nom

Indiquez un module spécifique, dans le programme ou le programme de service, à utiliser comme valeur de comparaison pour le filtre de programme. Cette indication n'est requise que pour les programmes et programmes de service ILE. Specify a specific module within the program or service program to be used as a compare value for the program filter. This is required only for ILE programs and service programs.

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

nom

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

Indiquez le type de programme spécifié. Indicate the type of program being specified.

*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 événements dont les données Java correspondent aux packages, classes et méthodes indiqués sont inclus dans les données collectées par Performance Explorer. Events having Java data that match the specified packages,classes, and methods are included in the data collected by Performance Explorer.

*NE

Les événements dont les données Java correspondent aux packages, classes et méthodes indiqués sont exclus de la collecte et n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. Events having Java data that matches the specified packages, classes, and methods are excluded from the collection and will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Filter entry

Indiquez les éléments de chaque entrée de filtre. Specify the elements for each filter entry.

Élément 1: Java package

*NONE

La classe et les méthodes Java ne sont pas dans un package. The Java class and methods are not in a package.

nom

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.

nom

Indiquez une classe, dans le package, à utiliser comme valeur de comparaison pour le filtre. Specify 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.

nom

Indiquez une méthode à utiliser comme valeur de comparaison du filtre. Specify a method to use as the filter compare value.

Filtre de classe Java (JVACLSFTR)Java class filter (JVACLSFTR)

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

Élément 1: Opérateur relationnel

*EQ

Les événements dont les données Java correspondent aux packages et classes indiqués sont inclus dans les données collectées par Performance Explorer. Events having Java data that match the specified packages and classes are included in the data collected by Performance Explorer.

*NE

Les événements dont les données Java correspondent aux packages et classes indiqués sont exclus de la collecte et n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. Events having Java data that matches the specified packages and classes are excluded from the collection and will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Filter entry

Indiquez les éléments de chaque entrée de filtre. Specify the elements for each filter entry.

Élément 1: Java package

*NONE

Les classes Java ne sont pas dans un package. The Java classes are not in a package.

nom

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.

nom

Indiquez une classe, dans le package, à utiliser comme valeur de comparaison pour le filtre. Specify a class within the package to be used as a compare value for the filter.

Élément 3: Array

*NOARRAY

La classe indiquée n'est pas un tableau de classes. The specified class is not an array of classes.

*CLASSARRAY

La classe indiquée est un tableau de classes. The specified class is an array of classes.

*VOIDARRAY

Le tableau de la classe primitive void est utilisé comme valeur de comparaison pour le filtre. The array of void primitive class is to be used as a compare value for the filter.

*BOOLEANARRAY

Le tableau de la classe primitive boolean est utilisé comme valeur de comparaison pour le filtre. The array of boolean primitive class is to be used as a compare value for the filter.

*CHARARRAY

Le tableau de la classe primitive char est utilisé comme valeur de comparaison pour le filtre. The array of char primitive class is to be used as a compare value for the filter.

*FLOATARRAY

Le tableau de la classe primitive float est utilisé comme valeur de comparaison pour le filtre. The array of float primitive class is to be used as a compare value for the filter.

*DOUBLEARRAY

Le tableau de la classe primitive double est utilisé comme valeur de comparaison pour le filtre. The array of double primitive class is to be used as a compare value for the filter.

*BYTEARRAY

Le tableau de la classe primitive byte est utilisé comme valeur de comparaison pour le filtre. The array of byte primitive class is to be used as a compare value for the filter.

*SHORTARRAY

Le tableau de la classe primitive short est utilisé comme valeur de comparaison pour le filtre. The array of short primitive class is to be used as a compare value for the filter.

*INTARRAY

Le tableau de la classe primitive int est utilisé comme valeur de comparaison pour le filtre. The array of int primitive class is to be used as a compare value for the filter.

*LONGARRAY

Le tableau de la classe primitive long est utilisé comme valeur de comparaison pour le filtre. The array of long primitive class is to be used as a compare value for the filter.

Filtre d'objet (OBJFTR)Object filter (OBJFTR)

Indique les comparaisons d'objets à utiliser pour ce filtre. Specifies the object comparisons to use for this filter.

Élément 1: Opérateur relationnel

*EQ

Les événements dont le nom d'objet, le nom de bibliothèque, le membre (s'il s'agit d'un fichier) et le type d'objet correspondent à cette spécification sont inclus dans les données de trace collectées. Events whose object name, library name, member (if a file) and object type matches this specification will be included in the collected trace data.

*NE

Les événements dont le nom d'objet, le nom de bibliothèque, le membre (s'il s'agit d'un fichier) et le type d'objet correspondent à cette spécification sont exclus des données de trace collectées. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. Events whose object name, library name, member (if a file) and object type matches this specification will be excluded from the collected trace data. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Filter entry

Indiquez les éléments de chaque entrée de filtre. Specify the elements for each filter entry.

Élément 1: Objet

Qualificatif 1: Objet

*ALL

Tous les objets de la bibliothèque indiquée passent le filtre. Le type d'objet doit être blanc si *ALL est indiqué pour l'objet. All objects in the specified library will pass the filter. Object type must be blank if *ALL is specified for the object.

nom

Le nom de l'objet à utiliser comme valeur de comparaison dans le filtre d'objet. The name of the object to be used as a compare value in the object filter.

Qualificatif 2: Biblio

nom

La bibliothèque qui contient l'objet à utiliser comme valeur de comparaison. The library which contains the object to use as a compare value.

Élément 2: Membre, si fichier BD

nom

Le nom de membre à utiliser comme valeur de comparaison. Cette valeur n'est valide que pour les objets *FILE physiques ou logiques. Indiquez *N pour les autres objets. The member name to use as the compare value. This value is valid for physical or logical *FILE objects only. Specify *N for other objects.

Élément 3: Type d'objet

*DTAARA

L'objet indiqué est une zone de données. The specified object is a data area.

*DTAQ

L'objet indiqué est une file d'attente de données. The specified object is a data queue.

*FILE

L'objet indiqué est un fichier de base de données physique ou logique. The specified object is a physical or logical database file.

*FLR

L'objet indiqué est un dossier. The specified object is a folder.

*JRN

L'objet indiqué est un journal. The specified object is a journal.

*JRNRCV

L'objet indiqué est un récepteur de journal. The specified object is a journal receiver.

*LIB

L'objet indiqué est une bibliothèque. Remarque : le filtre porte uniquement sur l'objet bibliothèque, pas sur les objets qu'elle contient. Utilisez le nom d'objet *ALL pour filtrer tous les objets contenus dans une bibliothèque. The specified object is a library. Note: this filters on the library object only, not on the objects contained in the library. Use an object name of *ALL to filter on all objects contained in a library.

*MSGQ

L'objet indiqué est une file d'attente de messages. The specified object is a message queue.

*PGM

L'objet indiqué est un programme. The specified object is a program.

*SRVPGM

L'objet indiqué est un programme de service. The specified object is a service program.

*USRPRF

L'objet indiqué est un profil utilisateur. The specified object is a user profile.

*USRIDX

L'objet indiqué est un index utilisateur. The specified object is a user index.

*USRSPC

L'objet indiqué est un espace utilisateur. The specified object is a user space.

*USRQ

L'objet indiqué est une file d'attente utilisateur. The specified object is a user queue.

Filtre de chemin d'accès (PATHFTR)Path filter (PATHFTR)

Indique les comparaisons de chemins d'accès d'objets du système de fichiers intégré à utiliser pour ce filtre. Specifies the Integrated File System object path name comparisons to use for this filter.

Élément 1: Opérateur relationnel

*EQ

Tous les événements dont le chemin d'accès d'objet correspond au chemin d'accès d'objet indiqué sont inclus dans les données collectées par Performance Explorer. All events that have an object path that matches the specified object path are included in the data collected by Performance Explorer.

*NE

Tous les événements dont les données de chemin d'accès d'objet correspondent au chemin d'accès d'objet indiqué sont ignorés. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. All events that have an object path data that matches the specified object path are discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Chemin

object-path

Le chemin d'accès d'objet à utiliser comme valeur de comparaison pour ce filtre. The object path to use as a compare value for this filter.

Filtre de mémoire (MEMFTR)Memory filter (MEMFTR)

Indique les comparaisons de pools de mémoire à utiliser pour ce filtre. Specifies the memory pool comparisons to use for this filter.

Élément 1: Opérateur relationnel

*EQ

Tous les événements dont les données d'identificateur de pool correspondent au pool indiqué sont inclus dans les données collectées par Performance Explorer. All events that have pool identifier data that matches the specified pool are included in the data collected by Performance Explorer.

*NE

Tous les événements dont les données d'identificateur de pool correspondent au pool indiqué sont ignorés. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. All events that have pool identifier data that matches the specified pool are discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Identificateur du pool

pool-identifier

L'ID de pool système à utiliser comme valeur de comparaison pour ce filtre. Cet ID de pool correspond à l'identificateur de pool affiché par la commande WRKACTJOB ou dans la sortie de PRTPEXRPT de type *TRACE. The system pool ID to use as a compare value for this filter. This pool ID corresponds to the pool identifier as shown on the WRKACTJOB command or on the output of PRTPEXRPT of type *TRACE.

Filtre de disque (DSKFTR)Disk filter (DSKFTR)

Indique les comparaisons d'unités de disque à utiliser pour ce filtre. Specifies the disk unit comparisons to use for this filter.

Élément 1: Opérateur relationnel

*EQ

Tous les événements dont les données d'identificateur de disque correspondent au disque indiqué sont inclus dans les données collectées par Performance Explorer. All events that have disk identifier data that matches the specified disk are included in the data collected by Performance Explorer.

*NE

Tous les événements dont les données d'identificateur de disque correspondent au disque indiqué sont ignorés. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. All events that have disk identifier data that matches the specified disk will be discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Disk identifier

disk-identifier

L'identificateur de disque utilisé comme valeur de comparaison pour ce filtre. Cet identificateur de disque correspond à l'unité de disque affichée par la commande WRKDSKSTS ou dans la sortie de PRTPEXRPT de type *TRACE. Si un disque est en miroir, cet identificateur s'applique aux deux disques de la paire en miroir. The disk identifier used as a compare value for this filter. This disk identifier corresponds to the disk unit as shown on the WRKDSKSTS command or the output of PRTPEXRPT of type *TRACE. If a disk is mirrored, this identifier applies to both disks in the mirrored pair.

Filtre de temps disque (DSKTIMFTR)Disk time filter (DSKTIMFTR)

Indique la valeur de comparaison du temps de réponse du disque (en millisecondes) à utiliser pour ce filtre. Specifies the disk response time compare value (in milliseconds) to use for this filter.

Élément 1: Opérateur relationnel

*GT

Tous les événements dont les données de temps de réponse du disque sont supérieures au critère de temps de réponse du disque indiqué sont inclus dans les données collectées par Performance Explorer. All events that have disk response time data that is greater than the specified disk response time criteria are included in the data collected by Performance Explorer.

*LT

Tous les événements dont les données de temps de réponse du disque sont inférieures au critère de temps de réponse du disque indiqué sont inclus dans les données collectées par Performance Explorer. All events that have disk response time data that is less than the specified disk response time criteria are included in the data collected by Performance Explorer.

Élément 2: Disk time

disk-time

Le temps de réponse du disque, en millisecondes, utilisé comme valeur de comparaison pour ce filtre. Ce temps de réponse du disque correspond aux données de temps écoulé total incluses dans chaque événement de disque qui représente la fin d'une fonction, par exemple *READEND, *WRTEND, *PGREADEND, *PGWRTEND, *RMTWRTEND et *RMTPGWRTEND. The disk response time in milliseconds used as a compare value for this filter. This disk response time corresponds to the total elapsed time data that is included in each disk event that represents the end of a function. For example *READEND, *WRTEND, *PGREADEND, *PGWRTEND, *RMTWRTEND, and *RMTPGWRTEND.

Filtre d'ASP (ASPFTR)ASP filter (ASPFTR)

Indique les comparaisons d'ASP (pool de mémoire secondaire) à utiliser pour ce filtre. Specifies the ASP (auxiliary storage pool) comparisons to use for this filter.

Élément 1: Opérateur relationnel

*EQ

Tous les événements dont l'identificateur d'ASP correspond à l'ASP indiqué sont inclus dans les données collectées par Performance Explorer. All events with an ASP identifier that matches the specified ASP will be included in the data collected by Performance Explorer.

*NE

Tous les événements dont l'identificateur d'ASP correspond à l'ASP indiqué sont ignorés. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. All events with an ASP identifier that matches the specified ASP will discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: ASP identifier

ASP-identifier

L'identificateur d'ASP à utiliser comme valeur de comparaison pour ce filtre. Cet identificateur d'ASP peut être défini avec le nom d'un ASP indépendant ou avec le numéro d'ASP correspondant à la valeur d'ASP affichée par la commande WRKDSKSTS ou dans la sortie de PRTPEXRPT de type *TRACE. The ASP identifier to use as a compare value for this filter. This ASP identifier can be set to the name of an independent ASP or to the ASP number that corresponds to the ASP value as shown on the WRKDSKSTS command or in the output of PRTPEXRPT of type *TRACE.

Filtre IP (IPFTR)IP filter (IPFTR)

Indique les informations IP (protocole Internet) à utiliser comme valeur de comparaison pour ce filtre. Specifies the IP (internet protocol) information to use as a compare value for this filter.

Élément 1: Opérateur relationnel

*EQ

Tous les événements dont les données IP correspondent aux valeurs de comparaison du filtre sont inclus dans les données collectées par Performance Explorer. All events with IP data that match the filter compare values will be included in the data collected by Performance Explorer.

*NE

Tous les événements dont les données IP correspondent aux valeurs de comparaison du filtre sont ignorés. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. All events with IP data that match the filter compare values will be discarded. These events will not show up in the *MGTCOL object or the Performance Explorer database.

Élément 2: Filter entry

Indiquez les éléments de chaque entrée de filtre. Specify the elements for each filter entry.

Élément 1: Address family

*INET

Le protocole Internet est utilisé dans la valeur de comparaison. The Internet protocol will be used as part of the compare value.

*INET6

Le protocole Internet version 6 est utilisé dans la valeur de comparaison. The Internet protocol version 6 will be used as part of the compare value.

*UNIX

Le protocole Unix est utilisé dans la valeur de comparaison. The Unix protocol will be used as part of the compare value.

Élément 2: Communication type

*STREAM

Un type de communication SOCK_STREAM est utilisé comme valeur de comparaison. A communication type of SOCK_STREAM will be used as the compare value.

*DGRAM

Un type de communication SOCK_DGRAM est utilisé comme valeur de comparaison. A communication type of SOCK_DGRAM will be used as the compare value.

*RAW

Un type de communication SOCK_RAW est utilisé comme valeur de comparaison. A communication type of SOCK_RAW will be used as the compare value.

*SEQPACKET

Un type de communication SOCK_SEQPACKET est utilisé comme valeur de comparaison. A communication type of SOCK_SEQPACKET will be used as the compare value.

Élément 3: Adresse internet locale

*ALL

Toutes les adresses IP locales passent cette partie du filtre IP. All local IP addresses will pass this part of the IP filter.

local-IP-address

L'adresse IP locale à utiliser dans la valeur de comparaison IP. The local IP address to be used as part of the IP compare value.

Élément 4: Adresse internet éloignée

*ALL

Toutes les adresses IP distantes passent cette partie du filtre IP. All remote IP addresses will pass this part of the IP filter.

remote-IP-address

L'adresse IP distante à utiliser dans la valeur de comparaison IP. The remote IP address to used as part of the IP compare value.

Élément 5: Local port

*ALL

Tous les ports locaux de l'adresse locale indiquée passent cette partie du filtre IP. All local ports for the specified local address will pass this part of the IP filter.

local-port

Le numéro de port local à utiliser comme valeur de comparaison. The local port number to be used as a compare value.

Élément 6: Port éloigné

*ALL

Tous les ports distants de l'adresse indiquée passent cette partie du filtre IP. All remote ports for the specified address will pass this part of the IP filter.

remote-port

Le numéro de port distant à utiliser comme valeur de comparaison. The remote port number to be used as the compare value.

Filtre défini par l'utilisateur (USRDFNFTR)User defined filter (USRDFNFTR)

Indique les comparaisons définies par l'utilisateur à utiliser pour ce filtre. Ce type de filtre nécessite l'aide du service IBM. Specifies user-defined comparisons to use for this filter. This type of filter will require help from IBM service.

Élément 1: Opérateur relationnel

*EQ

Tous les événements du filtre utilisateur indiqué sont collectés si les données de l'événement correspondent à la valeur de comparaison. All events for the specified user filter will be collected if the event data matches the compare value.

*NE

Tous les événements du filtre utilisateur indiqué sont ignorés si les données de l'événement correspondent à la valeur de comparaison. Ces événements n'apparaîtront pas dans l'objet *MGTCOL ni dans la base de données Performance Explorer. All events for the specified user filter will be discarded if the event data matches the compare value. These events will not show up in the *MGTCOL object or the Performance Explorer database.

*GT

Tous les événements du filtre utilisateur indiqué sont collectés si les données de l'événement sont supérieures à la valeur de comparaison. All events for the specified user filter will be collected if the event data is greater than the compare value.

*LT

Tous les événements du filtre utilisateur indiqué sont collectés si les données de l'événement sont inférieures à la valeur de comparaison. All events for the specified user filter will be collected if the event data is less than the compare value.

Élément 2: Event type

event-type

Le type d'événement (1-31) de l'événement à filtrer. The event type (1-31) for the event to filter.

Élément 3: Event subtype

event-subtype

Le sous-type d'événement (1-31) de l'événement à filtrer. The event subtype (1-31) for the event to filter.

Élément 4: Data offset

data-offset

Le décalage dans les données de l'événement à comparer à la valeur de comparaison. The offset into the event data to be compared against the compare value.

Élément 5: Type de données

Indique comment comparer les données de l'événement à la valeur de comparaison. Specifies how to compare the event data to the compare value.

*CHAR

Comparaison sous forme de deux chaînes de caractères, cadrées à gauche et complétées à droite par des blancs. La longueur maximale est de 30 octets. Compare as two character strings, left adjusted and padded on the right with blanks. The maximum length is 30 bytes.

*HEX

Comparaison sous forme de chaînes hexadécimales, cadrées à gauche et complétées à droite par des zéros hexadécimaux. La longueur maximale est de 30 chiffres hexadécimaux. Compare as hexadecimal strings, left adjusted and padded on the right with hexadecimal zeros. The maximum length is 30 hexadecimal digits.

*INT1

Le premier octet des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers signés de 1 octet. The first byte of event data at the specified data offset and the compare value are compared as a signed 1-byte integers.

*INT2

Les deux premiers octets des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers signés de 2 octets. The first two bytes of event data at the specified data offset and the compare value are compared as signed 2-byte integers.

*INT4

Les quatre premiers octets des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers signés de 4 octets. The first four bytes of event data at the specified data offset and the compare value are compared as signed 4-byte integers.

*INT8

Les huit premiers octets des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers signés de 8 octets. The first eight bytes of event data at the specified data offset and the compare value are compared as signed 8-byte integers.

*UINT1

Le premier octet des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers non signés de 1 octet. The first byte of event data at the specified data offset and the compare value are compared as a unsigned 1-byte integers.

*UINT2

Les deux premiers octets des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers non signés de 2 octets. The first two bytes of event data at the specified data offset and the compare value are compared as unsigned 2-byte integers.

*UINT4

Les quatre premiers octets des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers non signés de 4 octets. The first four bytes of event data at the specified data offset and the compare value are compared as unsigned 4-byte integers.

*UINT8

Les huit premiers octets des données de l'événement au décalage indiqué et la valeur de comparaison sont comparés comme des entiers non signés de 8 octets. The first eight bytes of event data at the specified data offset and the compare value are compared as unsigned 8-byte integers.

*SECONDS

Le temps indiqué en secondes est converti en horodatage interne pour être comparé aux données de durée d'horodatage de l'événement au décalage indiqué. The specified time in seconds is converted to an internal timestamp to compare to the timestamp duration event data at the specified data offset.

*MILLISEC

Le temps indiqué en millisecondes est converti en horodatage interne pour être comparé aux données de durée d'horodatage de l'événement au décalage indiqué. The specified time in milliseconds is converted to an internal timestamp to compare to the timestamp duration event data at the specified data offset.

*MICROSEC

Le temps indiqué en microsecondes est converti en horodatage interne pour être comparé aux données de durée d'horodatage de l'événement au décalage indiqué. The specified time in microseconds is converted to an internal timestamp to compare to the timestamp duration event data at the specified data offset.

Élément 6: Valeur de comparaison

compare-value

La valeur utilisée pour la comparaison avec les données de l'événement. Jusqu'à cinq valeurs de comparaison peuvent être indiquées. Si plusieurs valeurs sont indiquées, la comparaison est effectuée avec chaque valeur de comparaison. Si l'une des comparaisons est vraie, l'événement est filtré. The value used to compare against the event data. Up to five compare values can be specified. If multiple values are specified, the comparison will be made with each compare value. If any comparison is true, the event will be filtered.

Élément 7: Trigger option

*NONE

Les informations de ce filtre ne sont pas utilisées comme déclencheur. The information in this filter is not used as a trigger.

*START

Si un événement répondant aux critères des informations du filtre se produit, les événements suivants sont stockés dans la base de données. Auparavant, aucun événement n'est enregistré. Cette option permet de commencer à collecter des événements une fois qu'une certaine condition s'est produite. Cette option n'affecte que la tâche ou le processus dans lequel l'événement déclencheur s'est produit. If an event occurs that meets the criteria in the filter information, subsequent events will be stored to the database. Previous to this, no events will be recorded. This option can be used to start collecting events once a certain condition has occurred. This option affects only the task or process where the trigger event occured.

*END

Si un événement répondant aux critères des informations du filtre se produit, les événements suivants ne sont pas stockés dans la base de données. Cette option permet d'arrêter la collecte de données une fois qu'une certaine condition s'est produite. Cette option n'affecte que la tâche ou le processus dans lequel l'événement déclencheur s'est produit. If an event occurs that meets the criteria in the filter information, subsequent events will not be stored to the database. This can be used to stop collecting data once a certain condition has occurred. This option affects only the task or process where the trigger event occured.

*COLLSTART

Si un événement répondant aux critères des informations du filtre se produit, les événements suivants sont stockés dans la base de données. Auparavant, aucun événement n'est enregistré. Cette option permet de commencer à collecter des événements une fois qu'une certaine condition s'est produite. Cette option affecte toutes les tâches et tous les processus de la collecte. If an event occurs that meets the criteria in the filter information, subsequent events will be stored to the database. Previous to this, no events will be recorded. This option can be used to start collecting events once a certain condition has occurred. This option affects all tasks and processes in the collection.

*COLLEND

Si un événement répondant aux critères des informations du filtre se produit, les événements suivants ne sont pas stockés dans la base de données. Cette option permet d'arrêter la collecte de données une fois qu'une certaine condition s'est produite. Cette option affecte toutes les tâches et tous les processus de la collecte. If an event occurs that meets the criteria in the filter information, subsequent events will not be stored to the database. This can be used to stop collecting data once a certain condition has occurred. This option affects all tasks and processes in the collection.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement la définition Performance Explorer. Specifies the text that briefly describes the Performance Explorer definition.

*BLANK

Aucun texte n'est indiqué. Text is not specified.

'description'

Indiquez 50 caractères de texte au maximum, placés entre apostrophes. Specify no more than 50 characters of text, enclosed in apostrophes.

Exemples

Exemple 1 : Ajout de filtres de disque et de pool de mémoire Example 1: Adding Disk and Memory Pool Filters

ADDPEXFTR   FTR(FILTER1)  DSKFTR(*EQ (1 2))  MEMFTR(*EQ 3)

Cette commande ajoute un nouveau filtre Performance Explorer nommé FILTER1, ce qui entraîne l'ajout d'un membre nommé FILTER1 au fichier QAPEXFTR de la bibliothèque QUSRSYS. Si ce filtre est utilisé lors du démarrage d'une session Performance Explorer (commande STRPEX), les événements sont collectés s'ils contiennent des données d'identificateur d'unité de disque égales à '1' ou '2'. De plus, les données de pool de cet événement doivent contenir '3'. Si les données de disque ou les données de pool de mémoire ne correspondent pas au filtre indiqué, l'événement n'est pas enregistré. This command adds a new performance explorer filter named FILTER1 which will result in a member named FILTER1 being added to file QAPEXFTR in library QUSRSYS. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if they contain disk device identifier data of '1' or '2'. In addition, the pool data for that event must contain '3'. If either the disk data or the memory pool data do not match the specified filter, then that event will not be recorded.

Si un événement ne contient pas de données d'unité de disque ou de pool de mémoire, le filtre ne s'applique pas à cet événement et ces événements sont collectés. Par exemple, l'événement de base *TASKSWTIN ne contient aucune donnée de disque ni de pool de mémoire ; cet événement serait donc toujours collecté. If an event does not contain disk device or memory pool data, then the filter does not apply to that event and those events will be collected. For example, the base event *TASKSWTIN does not contain any disk or memory pool data, so this event would still be collected.

Exemple 2 : Ajout d'un filtre de disque Example 2: Adding a Disk Filter

ADDPEXFTR   FTR(DISKFILTER)  DSKFTR(*NE (1 2))

Cette commande ajoute un nouveau filtre Performance Explorer nommé DISKFILTER. Si ce filtre est utilisé lors du démarrage d'une session Performance Explorer (commande STRPEX), les événements sont collectés si l'événement contient des données de nom d'unité de disque qui ne correspondent ni à '1' ni à '2'. This command adds a new performance explorer filter named DISKFILTER. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if the event contains disk device name data that does not match '1' and does not match '2'.

Si un événement ne contient pas de données de nom d'unité de disque, le filtre ne s'applique pas à cet événement et ces événements sont collectés. Par exemple, l'événement de base *TASKSWTIN ne contient aucune donnée de disque ; cet événement serait donc toujours collecté. If an event does not contain disk device name data, then the filter does not apply to that event and those events will be collected. For example, the base event *TASKSWTIN does not contain any disk data, so this event would still be collected.

Exemple 3 : Ajout d'un filtre IP Example 3: Adding an IP Filter

ADDPEXFTR   FTR(IPFILTER)
            IPFTR(*EQ (*INET *STREAM '1.2.3.4'))

Cette commande ajoute un nouveau filtre Performance Explorer nommé IPFILTER. Si ce filtre est utilisé lors du démarrage d'une session Performance Explorer (commande STRPEX), les événements sont collectés si un événement de communications a une famille d'adresses *INET, un type de communication *STREAM et l'adresse IP locale '1.2.3.4'. This command adds a new performance explorer filter named IPFILTER. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if a communications event has an address family of *INET, the communication type is *STREAM, and the local IP address is '1.2.3.4'.

Exemple 3 : Ajout d'un déclencheur Java Example 3: Adding a Java Trigger

ADDPEXFTR FTR(PERFSTRUTS) JVATRG('org/apache/struts/action'
        'ActionServlet' 'doGet' *ENTRYEXIT)

Cette commande ajoute un nouveau filtre Performance Explorer nommé PERFSTRUTS. Si ce filtre est utilisé lors du démarrage d'une session Performance Explorer (commande STRPEX), les événements commencent à être collectés lorsqu'un événement *JVAENTRY ou *JVAEXIT se produit pour la méthode 'doGet' de la classe 'org.apache.struts.action.ActionServlet'. This command adds a new performance explorer filter named PERFSTRUTS. If this filter is used when starting a performance explorer session (STRPEX command), then events will start being collected when a *JVAENTRY or *JVAEXIT event occurs for the 'doGet' method in the class 'org.apache.struts.action.ActionServlet'.

Exemple 4 : Ajout d'un filtre défini par l'utilisateur Example 4: Adding a User-Defined Filter

ADDPEXFTR   FTR(USERFILTER)
            USRDFNFTR((*EQ 1 2 20 *CHAR ('BOB' 'SAM')))

Cette commande ajoute un nouveau filtre Performance Explorer nommé USERFILTER. Si ce filtre est utilisé lors du démarrage d'une session Performance Explorer (commande STRPEX), les événements sont collectés si le type d'événement est '1', le sous-type d'événement est '2' et les données au décalage 20 sont 'BOB' ou 'SAM'. This command adds a new performance explorer filter named USERFILTER. If this filter is used when starting a performance explorer session (STRPEX command), then events will be collected if the event type is '1', the event subtype is '2' and the data at offset 20 is either 'BOB' or 'SAM'.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFAF10

La définition ou le filtre existe déjà. Definition or filter already exists.