ENDPEX

La commande Arrêter Performance Explorer (ENDPEX) demande à l'outil Performance Explorer d'arrêter la collecte de données. La commande attend un nom de session accompagnant la demande, qui identifie l'instance de session Performance Explorer à arrêter. The End Performance Explorer (ENDPEX) command instructs the Performance Explorer tool to stop collecting data. The command expects a session name to accompany the request which identifies which instance of the Performance Explorer session to end.

L'utilisateur peut soit arrêter la session de collecte de données, soit la suspendre. S'il choisit d'arrêter la session, les données collectées sont placées dans un objet de type *MGTCOL ou dans un ensemble de fichiers de base de données, ou sont supprimées, selon la valeur indiquée dans le paramètre DTAOPT. The user can either end the data collection session or suspend the data collection session. If the user chooses to end the session, the collected data is put into an object of type *MGTCOL or into a set of database files, or it is deleted, based on the value specified for the DTAOPT parameter.

Si l'utilisateur choisit de suspendre la collecte des données de performance, la session reste active. Pour reprendre la collecte de données d'une session suspendue, l'utilisateur peut indiquer OPTION(*RESUME) lors d'un appel ultérieur de la commande STRPEX (Démarrer Performance Explorer). If the user chooses to suspend the collection of performance data, the session remains active. To resume data collection for a suspended session, the user can specify OPTION(*RESUME) on a subsequent call of 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. L'utilisateur doit posséder les droits *ADD et *EXECUTE sur les bibliothèques DTALIB et MGTCOL indiquées. The user must have *ADD and *EXECUTE authority to the specified DTALIB and MGTCOL libraries.
3. L'utilisateur doit posséder les droits *OBJMGMT, *OBJEXIST et d'utilisation sur l'objet de collecte de gestion s'il remplace un objet de collecte de gestion existant. The user must have *OBJMGMT, *OBJEXIST, and use authorities to the managment collection object if replacing an existing management collecton object.
4. 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.
5. The following user profiles have private authorities to use the command:
   • QPGMR
   • QSRV
6. Si ENDPEX est exécutée à partir d'une unité d'exécution secondaire, les fichiers QAYPE* doivent déjà exister dans la bibliothèque DTALIB. Ces fichiers doivent être créés dans l'unité d'exécution principale en exécutant ENDPEX DTAOPT(*LIB). If running ENDPEX from a secondary thread, the QAYPE* files must already exist in the DTALIB library. These files must be created in the primary thread by running ENDPEX DTAOPT(*LIB).
7. Si ENDPEX est exécutée à partir d'une unité d'exécution secondaire, l'objet DTAOPT(*MGTCOL) ne peut pas être indiqué. If running ENDPEX from a secondary thread, DTAOPT(*MGTCOL) object cannot be specified.
8. Deux unités d'exécution d'un même travail ne sont pas autorisées à exécuter ENDPEX en même temps. L'unité d'exécution qui a émis ENDPEX en premier exécute la commande jusqu'à son terme pendant que la seconde ENDPEX attend. Two threads within the same job will not be allowed to run ENDPEX at the same time. The thread that issued ENDPEX first will run the command to completion while the second ENDPEX waits.

Paramètres

ID de session (SSNID)Session ID (SSNID)

Indique la session Performance Explorer à arrêter. Il s'agit de l'identificateur de session qui a été indiqué dans la commande STRPEX (Démarrer Performance Explorer). Specifies which Performance Explorer session to end. This is the session identifier that was specified on the STRPEX (Start Performance Explorer) command.

*SELECT

Un panneau de liste de toutes les sessions actives de collecte de données Performance Explorer est affiché, avec une option permettant de sélectionner la session à arrêter. *SELECT n'est valide que si la commande ENDPEX est exécutée de manière interactive. Si la commande est exécutée par lots, un identificateur de session doit être indiqué. A list panel of all active Performance Explorer data collection sessions will be displayed with an option to select which session to end. *SELECT is only valid if the ENDPEX command is being run interactively. If the command is being run in batch, a session identifier must be specified.

session-identifier

Indiquez la session de collecte de données Performance Explorer à arrêter. Specify the Performance Explorer data collection session to end.

Option (OPTION)

Indique s'il faut arrêter la session de collecte de données ou simplement suspendre la collecte des données de performance de la session. Specifies whether to end the data collection session or just suspend collection of performance data for the session.

*END

The Performance Explorer session is ended. The user can choose three methods to handle the collected data:

1. Sauvegarde les données collectées dans un ensemble de fichiers de base de données. Save the collected data to a set of database files.
2. Sauvegarde les données dans un fichier unique (utilisé pour envoyer les données à IBM en vue de leur analyse). Save the data to a single file (used for sending data to IBM for analysis).
3. Supprime les données. Discard the data.

*SUSPEND

La session Performance Explorer est suspendue ; elle reste active mais aucune donnée supplémentaire n'est collectée pour cette session. Une fois la session suspendue, l'utilisateur peut utiliser STRPEX avec OPTION(*RESUME) pour reprendre la collecte de données, arrêter la session suspendue en indiquant ENDPEX avec OPTION(*END), extraire des données avec l'option *EXTRACT ou interrompre la session suspendue en indiquant ENDPEX avec OPTION(*STOP). The Performance Explorer session is suspended, and the session remains active but no additional data is collected for this session. Once a session is suspended, the user can use STRPEX with OPTION(*RESUME) to resume data collection, end the suspended session by specifying ENDPEX with OPTION(*END), extract data with the *EXTRACT option, or stop the suspended session by specifying ENDPEX with OPTION(*STOP).

*STOP

La session Performance Explorer est arrêtée et les travaux sont retirés de la collecte. La session ne peut pas être redémarrée. Les adresses ne sont pas résolues en noms d'objets et aucun fichier de base de données n'est créé. Les données d'adresses et les fichiers de base de données peuvent être créés ultérieurement avec les options OPTION(*END) et DTAOPT(*LIB ou *MGTCOL) de ENDPEX. Toutefois, Performance Explorer peut ne pas être en mesure de résoudre certaines adresses si des objets sont supprimés. Plus le délai entre *STOP et *END est long, plus le risque que les données d'adresses résolues soient incomplètes est grand. The Performance Explorer session is ended and the jobs are removed from the collection. The session cannot be started up again. Addresses are not resolved to object names, and no database files are created. The address data and database files can be created at a later time with the OPTION(*END) and DTAOPT(*LIB or *MGTCOL) options of ENDPEX. However, Performance Explorer may not be able to resolve some of the addresses if objects get deleted. The longer the time between *STOP and *END, the greater the chance the resolved address data will be incomplete.

*EXTRACT

Les données sont extraites d'une collecte suspendue et sauvegardées dans un ensemble de fichiers de base de données. Avant l'extraction des données, la session doit être suspendue avec la commande ENDPEX OPTION(*SUSPEND). Après l'extraction des données, la session peut être reprise avec la commande STRPEX OPTION(*RESUME) ou supprimée avec la commande ENDPEX OPTION(*END) DTAOPT(*DLT). Data will be extracted from a suspended collection and saved to a set of database files. Before data is extracted, the session must be suspended with the ENDPEX OPTION(*SUSPEND) command. After data is extracted, the session can be resumed with the STRPEX OPTION(*RESUME) command or deleted with the ENDPEX OPTION(*END) DTAOPT(*DLT) command.

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

Indique comment traiter les données collectées. Les données collectées peuvent être stockées dans un ensemble de fichiers de base de données ou dans un objet de collecte de gestion (*MGTCOL), ou dans les deux. L'objet temporaire de collecte de gestion utilisé pour contenir les données collectées sera supprimé. Pour supprimer l'objet temporaire de collecte de gestion sans stocker les données collectées, indiquez *DLT. Specifies how to handle the collected data. The collected data can be stored in a set of database files or a management collection object (*MGTCOL), or both. The temporary management collection object used to hold the collected data will be deleted. To delete the temporary management collection object without storing the collected data, specify *DLT.

Remarque :Ce paramètre n'est valide que si OPTION(*END) est indiqué. Remarque :This parameter is valid only if OPTION(*END) is specified.

*LIB

Indique de stocker toutes les données de performance collectées pour la session dans un ensemble de fichiers de base de données situés dans la bibliothèque indiquée dans le paramètre DTALIB. L'outil Performance Explorer crée tous les fichiers nécessaires s'il s'agit de la première utilisation de cette bibliothèque pour stocker des données de performance. Le nom de membre de chacun des fichiers dans lesquels les données de session sont stockées peut être contrôlé par le paramètre DTAMBR, mais il est par défaut identique à l'identificateur de session. Indicates to store all of the collected performance data for the session into a set of database files located in the library specified on the DTALIB parameter. The Performance Explorer tool creates all the necessary files if this is the first time that a library is being used to store performance data. The member name for each of the files where the session data is stored can be controlled through the DTAMBR parameter, but defaults to be the same name as the session identifier.

*MGTCOL

Indique de stocker toutes les données collectées dans un objet de collecte de gestion (type *MGTCOL). Aucun fichier de base de données n'est créé. Cette option peut être utilisée si les données doivent être expédiées vers un autre système ou à votre fournisseur de services en vue de leur analyse. Indicates to store all of the collected data in a management collection object (type *MGTCOL). No database files will be created. This option can be used if the data is to be shipped to another system or to your service provider for analysis.

*DLT

Les données de performance collectées pour la session sont supprimées du système. The collected performance data for the session is to be deleted from the system.

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

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

Remarque :Ce paramètre n'est valide que si l'utilisateur a indiqué DTAOPT(*LIB). Remarque :This parameter is valid only if the user specified DTAOPT(*LIB).

QPEXDATA

La bibliothèque QPEXDATA est la bibliothèque recommandée pour stocker les données collectées avec l'outil Performance Explorer. Lors de la première utilisation de l'outil Performance Explorer, cette bibliothèque est créée pour l'utilisateur et un ensemble de fichiers de base de données destinés à stocker les informations y est créé. The QPEXDATA library is the recommended library for storing data collected with the Performance Explorer tool. The first time the Performance Explorer tool is used, this library is created for the user, and a set of database files to store the information is created in that library.

nom

Indique le nom de la bibliothèque dans laquelle stocker les données collectées. Si la bibliothèque n'existe pas, la commande se termine en erreur. Une fois la bibliothèque créée, relancez la commande. Si la bibliothèque indiquée ne contient pas encore les fichiers de base de données de performance, ils sont créés et les données sont stockées. Specifies the name of the library in which to store the collected data. If the library does not exist, the command ends in an error condition. After the library is created, retry the command. If the specified library does not already have the performance database files, they are created and the data is stored.

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

Indique le nom à utiliser pour les membres de fichiers de base de données dans lesquels les données de performance collectées sont stockées. Si aucun membre portant le nom indiqué n'existe, il est créé. Specifies the name to be used for the database file members where the collected performance data is stored. If a member does not exist by the specified name, it is created.

Remarque :Ce paramètre n'est valide que lorsque DTAOPT(*LIB) est indiqué. Remarque :This parameter is valid only when DTAOPT(*LIB) is specified.

*SSNID

Le nom du membre est identique à la valeur indiquée dans le paramètre SSNID. The member name is the same as the value specified for the SSNID parameter.

nom

Indiquez le nom de membre à utiliser pour stocker les données collectées dans les fichiers de base de données Performance Explorer. Specify the member name to use when storing the collected data in Performance Explorer database files.

Collecte de gestion (MGTCOL)

Indique l'objet de collecte de gestion dans lequel les données de performance collectées sont stockées. Specifies the management collection object where the the collected performance data is stored.

Remarque :Ce paramètre n'est valide que si DTAOPT(*MGTCOL) est indiqué. Remarque :This parameter is valid only if DTAOPT(*MGTCOL) is specified.

Qualificatif 1: Collecte de gestion

*SSNID

Le nom indiqué dans le paramètre ID de session (SSNID) est utilisé lors de la création de l'objet de collecte de gestion destiné à contenir les données de performance collectées. The name specified for the Session ID (SSNID) parameter is used when creating the management collection object to contain the collected performance data.

nom

Indiquez le nom à utiliser lors de la création de l'objet de collecte de gestion destiné à contenir les données de performance collectées. Specify the name to use when creating the management collection object to contain the collected performance data.

Qualificatif 2: Biblio

QPEXDATA

La bibliothèque QPEXDATA est la bibliothèque recommandée pour stocker les données collectées par l'outil Performance Explorer. Lors de la première utilisation de l'outil Performance Explorer, cette bibliothèque est créée pour l'utilisateur. The QPEXDATA library is the recommended library for storing data collected by the Performance Explorer tool. The first time the Performance Explorer tool is used, this library is created for the user.

nom

Indiquez le nom de la bibliothèque dans laquelle stocker les données collectées. Si la bibliothèque n'existe pas, la commande se termine en erreur. Une fois la bibliothèque créée, relancez la commande. Specify the name of the library to store the collected data. If the library does not exist, the command ends in an error condition. After the library is created, retry the command.

Travail (JOB)

Indique les données de quel travail sont sauvegardées à partir de la session de collecte de données Performance Explorer. Specifies which job's data is saved from the Performance Explorer data collection session.

Valeurs uniques

*ALL

Les données sont sauvegardées pour tous les travaux de la collecte. Data is saved for all jobs in the collection.

*NONE

Les données d'aucun travail ne sont sauvegardées. Les données sont sauvegardées en fonction du paramètre TASK. No jobs have their data saved. Data is saved based on the TASK parameter.

Élément 1: Travail

Qualificatif 1: Travail

nom

Indiquez le nom du travail à inclure. Les noms génériques ne sont pas autorisés. Specify the name of the job to be included. Generic names are not allowed.

Qualificatif 2: Utilisat

nom

Indiquez le nom d'utilisateur des travaux à inclure. Les noms génériques ne sont pas autorisés. Specify the user name of the jobs to be included. Generic names are not allowed.

Qualificatif 3: Numéro

job-number

Indiquez le numéro de travail pour qualifier plus précisément le nom de travail et le nom d'utilisateur. Specify the job number to further qualify the job name and user name.

Élément 2: Thread identifier

*ALL

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

*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 de l'unité d'exécution du travail à inclure. Il s'agit de l'ID d'unité d'exécution affiché par la commande WRKJOB. Specify the thread identifier of the job to be included. This is the thread ID as shown by the WRKJOB command.

Nom de tâche (TASK)Task name (TASK)

Indique les données de quelle tâche du code interne sous licence (LIC) sont sauvegardées à partir de la session de collecte de données Performance Explorer. Jusqu'à 8 noms de tâche peuvent être indiqués. Specifies which licensed internal code (LIC) task's data is saved from the Performance Explorer data collection session. Up to 8 task names may be specified.

Les tâches LIC peuvent être obtenues à partir des rapports Performance Tools et de la commande WRKSYSACT. Rien ne garantit que les noms de tâches LIC resteront identiques ou existeront d'un système à l'autre ou d'une version à l'autre. LIC tasks can be obtained from the Performance Tools reports and WRKSYSACT command. There is no guarantee that LIC task names will remain the same or exist from system to system or release to release.

Remarque :Si le nom de la tâche contient un trait d'union, placez-le entre guillemets. Par exemple, pour la tâche SK-ASC040, vous indiqueriez TASK("SK-ASC040"). Remarque :If the task name contains a hyphen, enclose the task name in quotation marks. For example, for task SK-ASC040, you would specify TASK("SK-ASC040").

Valeurs uniques

*ALL

Les données de toutes les tâches LIC de la collecte sont incluses. Data from all LIC tasks in the collection is included.

*NONE

Aucune donnée des tâches LIC de la collecte n'est incluse. Les données sont incluses en fonction du paramètre JOBS. No data from LIC tasks in the collection is included. Data is includede based on the JOBS parameter.

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

nom

Indiquez le nom de la tâche à inclure. Specify the name of the task to be included.

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

Indique s'il faut remplacer les données d'un membre de fichier ou d'un objet de collecte de gestion existant par les nouvelles données de performance. Si DTAMBR a été indiqué et qu'un membre portant le même nom existe déjà dans l'un des fichiers de base de données Performance Explorer de la bibliothèque indiquée (paramètre DTALIB), ce paramètre détermine si les données du membre sont remplacées. Si MGTCOL a été indiqué et qu'un objet portant le même nom existe déjà, ce paramètre détermine si les données de cet objet sont remplacées. Specifies whether to replace the data in an existing file member or management collection object with the new performance data. If DTAMBR was specified and a member with the same name already exists in any of the Performance Explorer database files in the specified library (DTALIB parameter), this parameter controls whether the member data is replaced. If MGTCOL was specified and an object already exists with the same name, this parameter controls whether the data in that object is replaced.

*NO

Si un membre de même nom existe déjà, un message d'erreur est envoyé à l'utilisateur. Cela évite à l'utilisateur d'écraser par inadvertance des données existantes. If a member already exists with the same name, an error message is sent to the user. This prevents the user from inadvertently writing over existing data.

*YES

Si un membre de même nom existe déjà, les anciennes données sont perdues et remplacées par les nouvelles. If a member already exists with the same name, the old data is lost and is replaced by the new data.

Nombre d'unités d'exécution (NBRTHD)Number of threads (NBRTHD)

Indique le nombre d'unités d'exécution simultanées que la commande ENDPEX utilise pour traiter les données de la session arrêtée. Indiquer un nombre supérieur à 1 permet à la commande ENDPEX de tirer parti des cycles UC disponibles, en particulier sur un système multiprocesseur. Cela peut accélérer le traitement de la commande, mais aussi dégrader les performances des autres travaux du système. Vous pouvez minimiser cet impact en attribuant au travail qui exécute la commande ENDPEX une priorité de valeur numérique plus élevée. Vous devez également vérifier que le sous-système de disques peut gérer les unités d'exécution supplémentaires. Specifies the number of concurrent threads that the ENDPEX command uses to process the data in the session being ended. Specifying a number greater than 1 allows the ENDPEX command to take advantage of available CPU cycles, especially on a multi-processor system. While this may speed up the command processing, it may also degrade the performance of other jobs on the system. You can minimize this impact by changing the priority of the job that runs the ENDPEX command to a higher number. You should also verify that the disk subsystem can handle the additional threads.

*CALC

Le système calcule un nombre raisonnable d'unités d'exécution pour le traitement de la commande, qui n'utilise pas de ressources UC ou disque excessives. The system calculates a reasonable number of threads to do the command processing which does not use excessive CPU or disk resources.

1-256

Indiquez le nombre d'unités d'exécution que la commande ENDPEX doit utiliser pour traiter les données collectées. Specify the number of threads for the ENDPEX command to use to process the collected data.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement le type de données collectées. Specifies the text that briefly describes the type of data collected.

*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 : Arrêt d'une session et sauvegarde des fichiers de base de données Example 1: End a Session and Save the Database Files

ENDPEX   SSNID(TEST3)  OPTION(*END)  DTAOPT(*LIB)
         DTAMBR(SYS1DATA)

Cette commande arrête la session Performance Explorer nommée TEST3 et sauvegarde les données dans un ensemble de fichiers de base de données de la bibliothèque QPEXDATA. Le nom de membre à utiliser pour chaque fichier est SYS1DATA. This command ends the performance explorer session named TEST3 and saves the data in a set of database files in library QPEXDATA. The member name to be used for each file is SYS1DATA.

Exemple 2 : Arrêt d'une session et suppression des données Example 2: End a Session and Delete the Data

ENDPEX   SSNID(TESTRUN)  OPTION(*END)  DTAOPT(*DLT)

Cette commande arrête la session Performance Explorer nommée TESTRUN et supprime les données de performance collectées. This command ends the performance explorer session named TESTRUN and deletes the collected performance data.

Exemple 3 : Arrêt d'une session et sauvegarde du *MGTCOL Example 3: End a Session and Save the *MGTCOL

ENDPEX   SSNID(TEST3)  OPTION(*END)  DTAOPT(*MGTCOL)
         MGTCOL(MYLIB/SYS1DATA)  NBRTHD(*CALC)

Cette commande arrête la session Performance Explorer nommée TEST3 et sauvegarde les données dans un objet de collecte de gestion de la bibliothèque MYLIB nommé SYS1DATA. ENDPEX calcule un nombre d'unités d'exécution pour traiter cette demande. Ce nombre d'unités d'exécution assurera le traitement ENDPEX aussi rapidement que possible sans perturber le reste du système. This command ends the performance explorer session named TEST3 and saves the data in a management collection object in library MYLIB in the management collection object named SYS1DATA. ENDPEX will calculate a number of threads to process this request. This number of threads will do the ENDPEX processing as quickly as possible without disrupting the rest of the system.

Exemple 4 : Suspension d'une session et extraction des données Example 4: Suspend a Session and Extract the Data

ENDPEX   SSNID(TEST3)  OPTION(*SUSPEND)

ENDPEX   SSNID(TEST3)  OPTION(*EXTRACT)  DTAOPT(*LIB)
         DTAMBR(USERADATA) JOB(000123/USERA/QPADEV0001)

STRPEX   SSNID(TEST3)  OPTION(*RESUME)

Cet exemple suspend d'abord la session Performance Explorer nommée TEST3. Pendant que la collecte est suspendue, l'option *EXTRACT est utilisée pour sauvegarder les données collectées pour le travail 000123/USERA/QPADEV0001 dans une collecte nommée USERADATA. Une fois les données extraites, la collecte est reprise et recommence à collecter des données. Cette technique peut être utilisée pour rechercher un problème intermittent. This example first suspends the performance explorer session named TEST3. While the collection is suspended, the *EXTRACT option is used to save data collected for job 000123/USERA/QPADEV0001 to a collection named USERADATA. After the data is extracted, the collection is resumed and will begin collecting data again. This technique can be used when trying to find an intermittent problem.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPFAF06

La commande ENDPEX n'a pas abouti. Le code anomalie est &1. Voir les détails pour plus d'informations. ENDPEX command was not successful. Reason code is &1. See details for more information.