STRPEX

La commande Démarrer Performance Explorer (STRPEX) démarre une nouvelle session Performance Explorer ou reprend une session Performance Explorer suspendue. The Start Performance Explorer (STRPEX) command starts a new Performance Explorer session or resumes a suspended Performance Explorer session.

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. The following user profiles have private authorities to use the command:
   • QPGMR
   • QSRV
4. Deux unités d'exécution d'un même travail ne peuvent pas exécuter STRPEX en même temps. L'unité d'exécution qui a émis STRPEX en premier exécute la commande jusqu'à son terme pendant que la seconde STRPEX attend. Two threads within the same job will not be allowed to run STRPEX at the same time. The thread that issued STRPEX first will run the command to completion while the second STRPEX waits.

Paramètres

ID de session (SSNID)Session ID (SSNID)

Indique un identificateur pour cette session Performance Explorer. Ce nom doit être unique parmi les sessions actives de l'outil Performance Explorer. Specifies an identifier for this Performance Explorer session. This name must be unique within the active sessions of the Performance Explorer tool.

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

session-identifier

Indiquez l'identificateur de session d'une session Performance Explorer nouvelle ou suspendue. Specify the session identifier for a new or suspended Performance Explorer session.

Option (OPTION)

Indique si une nouvelle session doit être démarrée ou si une session actuellement suspendue doit être reprise. Specifies whether a new session should be started or a session which is currently suspended should be resumed.

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

*NEW

Une nouvelle session de l'outil Performance Explorer est démarrée. La collecte des données de performances commence dès que la session est établie. A new session of the Performance Explorer tool is started. Performance data collection begins as soon as the session has been established.

*INZONLY

Une nouvelle session Performance Explorer est démarrée, mais une fois la session établie, elle est suspendue. Cette option permet à l'utilisateur d'effectuer la configuration d'une session donnée avant que le scénario à surveiller ne soit lancé. Pour commencer la collecte des données, l'utilisateur doit appeler de nouveau cette commande en indiquant le même identificateur de session et OPTION(*RESUME). A new Performance Explorer session is started, but once the session is established, it is suspended. This option allows the user to perform the setup for a particular session before the scenario to be monitored is started. To begin data collection, the user must invoke this command again specifying the same session identifier and OPTION(*RESUME).

*RESUME

Une session Performance Explorer suspendue est reprise. La session a été suspendue soit en indiquant OPTION(*SUSPEND) dans la commande ENDPEX, soit en indiquant OPTION(*INZONLY) dans une commande STRPEX précédente. A suspended Performance Explorer session is resumed. The session was suspended either by specifying OPTION(*SUSPEND) on the ENDPEX command or by specifying OPTION(*INZONLY) on a previous STRPEX command.

Définition (DFN)

Indique le nom de la définition Performance Explorer à utiliser au démarrage d'une nouvelle session Performance Explorer. La définition identifie les données de performances à collecter. Ce paramètre est obligatoire pour démarrer une nouvelle session Performance Explorer. Il ne peut pas être indiqué lors de la reprise d'une session suspendue, car celle-ci est déjà associée à une définition Performance Explorer. Specifies the name of the Performance Explorer definition to use when starting a new Performance Explorer session. The definition identifies the performance data to be collected. This parameter is required in order to start a new Performance Explorer session. This parameter cannot be specified when resuming a suspended session, since the suspended session already has an associated Performance Explorer definition.

nom

Indiquez le nom de la définition Performance Explorer. Specify the name of the Performance Explorer definition.

Filtre (FTR)

Indique le nom du filtre Performance Explorer à utiliser au démarrage d'une nouvelle session Performance Explorer. Le filtre détermine les événements collectés d'après les valeurs de filtre comparées aux données réelles de l'événement. Si aucun filtre n'est indiqué, tous les événements de la définition sont collectés. Ce paramètre ne peut pas être indiqué lors de la reprise d'une session suspendue. Specifies the name of the Performance Explorer filter to use when starting a new Performance Explorer session. The filter determines which events are collected based on the filter values which are compared to the event's actual data. If a filter is not specified, then all events in the definition are collected. This parameter cannot be specified when resuming a suspended session.

*SELECT

Une liste des filtres existants est affichée pour sélection par l'utilisateur. Cette valeur n'est valide que si la commande est exécutée dans un travail interactif. A list of existing filters will be displayed for user selection. This value is valid only if the command is run in an interactive job.

nom

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

Exemples

Exemple 1 : Démarrage d'une nouvelle session Example 1: Start a New Session

STRPEX   SSNID(TESTRUN2)  DFN(NEWDESC)  OPTION(*NEW)
         FTR(MYFILTER)

Cette commande démarre une nouvelle session de Performance Explorer en utilisant les critères identifiés dans une définition nommée NEWDESC et un filtre nommé MYFILTER. Le nom de la nouvelle session est TESTRUN2. This command starts a new session of the performance explorer using the criteria identified in a definition named NEWDESC and a filter named MYFILTER. The new session name is TESTRUN2.

Exemple 2 : Reprendre une session suspendue Example 2: Resume a Suspended Session

STRPEX   SSNID(TESTRUN1)  OPTION(*RESUME)

Cette commande reprend une session existante de Performance Explorer nommée TESTRUN1. This command resumes an already existing session of the performance explorer named TESTRUN1.

Messages d'erreur

Messages d'erreur RMVPEXDFN

Messages *ESCAPE *ESCAPE Messages

CPFAF05

La commande STRPEX a échoué. Le code motif est &1. Voir les détails pour plus d'informations. STRPEX command was not successful. Reason code is &1. See details for more information.

CPFAF11

Impossible de localiser le programme, l'objet, la bibliothèque ou le membre de fichier indiqué dans la définition ou le filtre. Unable to locate program, object, library, or file member as specified in the definition or filter.