CRTPEXDTA

La commande Créer données de performances (CRTPEXDTA) crée les fichiers de base de données de Performance Explorer à partir des données d'un objet collecte de gestion de Performance Explorer (type d'objet *MGTCOL). The Create Performance Data (CRTPEXDTA) command creates the Performance Explorer database files based on the data in a Performance Explorer management collection object (object type *MGTCOL).

Additional information about the Performance Explorer tool can be found in the Informations sur la gestion des performances à l'adresse http://www.ibm.com/servers/eserver/iseries/perfmgmt/resource.html.

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 la bibliothèque TOLIB indiquée, et les droits *READ et *EXECUTE sur la bibliothèque FROMLIB. The user must have *ADD and *EXECUTE authority to the specified TOLIB library, and *READ and *EXECUTE authority to the FROMLIB library.
3. L'utilisateur doit posséder le droit *READ sur l'objet collecte de gestion. The user must have *READ authority to the management collection 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

Paramètres

Collecte d'origine (FROMMGTCOL)

Indique le nom de l'objet collecte de gestion de Performance Explorer. Les données de cet objet seront stockées dans les fichiers de base de données de Performance Explorer, dans le membre indiqué. Specifies the name of the Performance Explorer management collection object. The data in this object will be stored in the Performance Explorer database files in the specified member.

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

nom

Indiquez le nom de l'objet collecte de gestion. Specify the name of the management collection object.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

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 se trouve l'objet collecte de gestion. Specify the name of the library where the management collection object exists.

Membre de destination (TOMBR)

Indique le nom de membre utilisé pour stocker les données dans les fichiers de base de données de Performance Explorer. Specifies the member name used to store the data in the Performance Explorer database files.

*FROMMGTCOL

Le nom de l'objet collecte de gestion est utilisé comme nom de membre. The name of the management collection object is used as the member name.

nom

Indiquez le nom du membre de la base de données utilisée pour stocker les données de Performance Explorer. Specify the name of the member for the database used to store the Performance Explorer data.

Bibliothèque de destination (TOLIB)

Indique la bibliothèque utilisée pour stocker les données dans les fichiers de base de données de Performance Explorer. Specifies the library used to store the data in the Performance Explorer database files.

*FROMMGTCOL

La bibliothèque indiquée pour l'objet collecte de gestion est utilisée. The library specified for the management collection object is used.

nom

Indiquez le nom de la bibliothèque de la base de données utilisée pour stocker les données de Performance Explorer. Specify the name of the library for the database used to store the Performance Explorer 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 CRTPEXDTA utilise pour traiter les données. Indiquer un nombre supérieur à 1 permet à la commande CRTPEXDTA de tirer parti des cycles d'UC disponibles, en particulier sur un système multiprocesseur. Cela peut accélérer le traitement de la commande, mais peut aussi dégrader les performances des autres travaux du système. Vous pouvez limiter cet impact en attribuant au travail qui exécute la commande CRTPEXDTA une priorité numériquement 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. En règle générale, la commande CRTPEXDTA nécessite un bras de disque pour chaque unité d'exécution active. Specifies the number of concurrent threads that the CRTPEXDTA command uses to process the data. Specifying a number greater than 1 allows the CRTPEXDTA 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 CRTPEXDTA command to a higher number. You should also verify the disk subsystem can handle the additional threads. Typically, the CRTPEXDTA command requires one disk arm for each active thread.

*CALC

Le système calculera un nombre raisonnable d'unités d'exécution pour effectuer le traitement de CRTPEXDTA, sans utiliser de ressources d'UC ou de disque excessives. Il s'agit généralement d'une ou deux unités d'exécution par processeur disponible. The system will calculate a reasonable number of threads to do the CRTPEXDTA processing which will not use excessive CPU or disk resources. Usually this is one or two threads for each available processor.

number-of-threads

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

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

Indique s'il faut remplacer les données d'un ensemble existant de membres de fichiers par de nouvelles données de performances. Specifies whether to replace the data in an existing set of file members with new performance data.

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

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 : Création de données PEX Example 1: Creating PEX Data

CRTPEXDTA   FROMMGTCOL(QPEXDATA/MYCOL)  TOMBR(TEST)
            TOLIB(QPEXDATA)  NBRTHD(2)

Cette commande crée des données Performance Explorer (PEX) dans le membre nommé TEST de la bibliothèque QAPEXDATA. Les données collectées se trouvent dans l'objet collecte de gestion MYCOL situé dans la bibliothèque QAPEXDTA. Deux unités d'exécution seront utilisées pour traiter les données. This command creates Performance Explorer (PEX) data in member name TEST in library QAPEXDATA. The collected data exists in the management collection object MYCOL found in library QAPEXDTA. Two threads will be used to process the data.

Messages d'erreur

Aucun