CRTPFRDTA

La commande CRTPFRDTA permet de créer un ensemble de fichiers base de données de performance à partir d'informations relatives aux performances stockées dans un objet de collecte de gestion (*MGTCOL). Pour plus d'informations sur les fichiers base de données, reportez-vous à la rubrique Performance du manuel IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Les fichiers base de données de performance et membres de fichiers sont créés au fur et à mesure des besoins, en fonction des données contenues dans l'objet de collecte de gestion et des informations requises par la commande. Si des fichiers base de données existent déjà et si le membre demandé existe dans l'un d'eux, le membre est alors mis à blanc avant que la collection ne soit générée.

Paramètres

Collecte d'origine (FROMMGTCOL)

Indique l'objet de collecte de gestion à partir duquel un ensemble de fichiers base de données de performance doit être créé.

Valeurs uniques

*ACTIVE

L'objet de collecte actuellement actif sera utilisé.

*SELECT

Affiche la totalité des objets de collecte disponibles dans la bibliothèque indiquée pour que l'utilisateur puisse sélectionner l'objet de collecte à traiter. Cette option est autorisée uniquement si la commande est exécutée dans un travail interactif.

Qualificatif 1 : Collecte d'origine

nom

Indiquez le nom de l'objet de collecte de gestion qui doit être utilisé.

Qualificatif 2 : Biblio

QPFRDATA

La bibliothèque de données de performances fournie par IBM, QPFRDATA, doit être utilisée pour localiser la collecte de gestion.

nom

Indiquez le nom de la bibliothèque pour la collecte de gestion.

Membre de destination (TOMBR)

Indique le membre du fichier de base de données dans lequel les données de sortie doivent être écrites. Si un membre portant ce nom n'existe dans aucun des fichiers base de données de performance, un membre est créé, et le nom indiqué ici lui est attribué.

*FROMMGTCOL

Le nom de l'objet de collecte de gestion est utilisé pour désigner le membre du fichier base de données de performance.

nom

Indiquez le nom du membre dans lequel les données en sortie doivent être inscrites.

Bibliothèque de destination (TOLIB)

Indique la bibliothèque dans laquelle les fichiers base de données relatifs aux données de performance doivent se trouver. Tout fichier introuvable dans la bibliothèque indiquée est automatiquement créé dans celle-ci.

*FROMMGTCOL

Les fichiers base de données de performance se trouvent ou sont créés dans la même bibliothèque que l'objet de collecte de gestion (paramètre FROMMGTCOL).

nom

Indiquez le nom de la bibliothèque dans laquelle les fichiers base de données de performance se trouvent ou doivent être créés.

Texte 'descriptif' (TEXT)

Indique le texte à utiliser pour chaque membre de l'ensemble des fichiers de base de données de performance associé à la collecte.

*SAME

La valeur reste inchangée.

*FROMMGTCOL

Le texte associé à l'objet de collecte de gestion est utilisé comme texte du membre.

*GEN

Le texte suivant est généré - "Créé à partir de <nom collecte> dans la bibliothèque <nom bibliothèque>". Si le membre existe déjà, aucune modification n'est apportée.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Indiquez un texte de 50 caractères au maximum, placé entre apostrophes.

Catégories à traiter (CGY)

Indique les catégories d'informations contenues dans l'objet de collecte de gestion qui vont être transformées en fichiers base de données.

Valeurs uniques

*FROMMGTCOL

Toutes les catégories d'informations qui se trouvent dans l'objet de collecte de gestion seront transformées en fichiers base de données.

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

nom-catégorie

Indiquez le nom de la catégorie d'informations de performances qui doit être transformée à partir de l'objet de collecte de gestion. Il est possible d'indiquer plusieurs noms de catégories. Les noms de catégorie suivants sont admis :

  Nom               Description
  -------------     ---------------------------
  *APPN             APPN
  *CMNBASE          Communications (de base)
  *CMNSAP           Communications (SAP)
  *CMNSTN           Communications (poste)
  *DISK             Mémoire disque
  *DOMINO           IBM Domino for i
  *DPS              Services de point d'accès
  *EXTSTG           Mémoire externe
  *HDWCFG           Configuration matérielle
  *HTTP             IBM HTTP Server for i (sous Apache)
  *IOPBASE          Processeurs d'E-S (de base)
  *IPCS             Serveur réseau
  *JOBMI            Travaux (tâches et unités d'exécution MI)
  *JOBOS            Travaux (système d'exploitation)
  *JAVA             Java
  *LCLRSP           Temps de réponse local
  *LPAR             Partition logique
  *POOL             Pool de mémoire
  *POOLTUNE         Optimisation du pool de mémoire
  *RDMA             Accès direct à la mémoire à distance
  *RMVSTG           Mémoire amovible
  *SNA              SNA
  *SNADS            SNADS
  *SUBSYSTEM        Sous-système
  *SYSBUS           Bus système
  *SYSCPU           Unité centrale du système
  *SYSINT           Données système internes
  *SYSLVL           Données système
  *SQL              SQL
  *TCPBASE          TCP/IP (de base)
  *TCPIFC           TCP/IP (interface)
  *TOPO             Topologie
  *USRTNS           Données de transaction définies par l'utilisateur
  *WAS              Websphere Application Server
  *XSTGSVC          Mémoire externe (SVC)

Intervalle temps (en minutes) (INTERVAL)

Indique l'intervalle de temps entre deux entrées successives dans le(s) fichier(s) base de données. Dans la base de données, ces intervalles entre collectes sont identifiés par un numéro d'intervalle et un intervalle de temps.

Les numéros d'intervalle commencent par 1 et sont incrémentés d'une unité à chaque intervalle. L'intervalle de temps est basé sur l'heure de la fin de l'intervalle synchronisée avec l'heure de l'horloge (par exemple, si INTERVAL(15) est spécifié, les intervalles sont générés comme suit : 01:00:00, 01:15:00, 01:30:00 et 01:45:00).

*FROMMGTCOL

L'intervalle par défaut qui se trouve dans l'objet de collecte de gestion est utilisé.

nombre-minutes

Indiquez un intervalle compris entre 0,25 (15 secondes) et 60 minutes.

Créer données récapit standard (CRTPFRSUM)

Indique si des données de type récapitulatif supplémentaires doivent être créées pour cette collecte.

Valeurs uniques

.*NONE

Des données de fichier récapitulatives ne sont pas générées.

*ALL

Toutes les données de fichier récapitulatives sont générées.

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

*PFRSUM

Cette option permet de créer des fichiers logiques supplémentaires, via la commande CRTPFRSUM, afin d'améliorer les performances SQL de fonctions comme Performance Data Investigator.

*SYSMON

Cette option permet la création d'autres fichiers base de données de moniteur système. Ces fichiers contiennent diverses données de catégorie et sont nécessaires pour utiliser les perspectives de moniteur système dans Performance Data Investigator. La création de ces fichiers permet d'utiliser ces perspectives avec cette collecte.

Date et heure de début (FROMTIME)

Indique la date et l'heure de début des données de performance dans l'objet de collecte de gestion qui seront utilisés pour créer le(s) fichier(s) base de données de performance. Associée à la valeur de l'intervalle, cette date détermine la date et l'heure pour chaque intervalle de base de données.

Valeurs uniques

*FROMMGTCOL

La date et l'heure de début sont la date et l'heure à laquelle l'objet de collecte de gestion a été créé.

Elément 1 : Date de début

date

Indiquez la date à laquelle les données de collecte ont commencé à être générées. Cette date doit être entrée au format spécifié par la valeur système QDATFMT et, si des séparateurs sont utilisés, par la valeur système QDATSEP.

Elément 2 : Heure de début

heure

Indiquez l'heure de la date spécifiée à laquelle les intervalles de bases de données doivent commencer à être générés.

Si une date de début est indiquée sans heure de début, cette dernière sera, par défaut :

• L'heure de début de la collecte, si la date de début indique la première date de la collecte.
• Minuit (00:00:00), si la date de début ne correspond pas à la première date de la collecte.

Date et heure de fin (TOTIME)

Indique la date et l'heure de fin des dernières données de performance dans l'objet de collecte de performance qui seront utilisées pour créer le(s) fichier(s) base de données de performance.

Valeurs uniques

*FROMMGTCOL

La date et l'heure de fin de la collecte dans l'objet de collecte de gestion seront la date et l'heure de fin pour la génération de la base de données.

*ACTIVE

La génération de la base de données se poursuivra jusqu'à la fin de la collecte actuellement active.

Avec cette option, la base de données est générée simultanément avec la collecte active. La base de données est générée en fonction de l'heure de début indiquée pour toute donnée se trouvant actuellement dans l'objet de collecte de gestion. Les données supplémentaires sont traitées à mesure qu'elles sont ajoutées dans l'objet de collecte, jusqu'à ce que la collecte en cours s'arrête.

Cette option pouvant impliquer un temps de traitement très long, il est recommandé d'indiquer le paramètre TOTIME(*ACTIVE) uniquement lorsque la commande CRTPFRDTA est exécutée dans un travail par lots.

Elément 1 : Date de fin

date

Indiquez la date à laquelle les données de l'objet de collecte cessent d'être utilisées pour générer les fichiers de base de données. Cette date doit être entrée au format spécifié par la valeur système QDATFMT et, si des séparateurs sont utilisés, par la valeur système QDATSEP.

Elément 2 : Heure de fin

heure

Indiquez, pour la date spécifiée, l'heure à laquelle les données de l'objet de collecte cessent d'être utilisées pour générer les fichiers de base de données.

Reportez-vous à la description de l'élément Heure de début du paramètre Date et heure de début (FROMTIME) pour obtenir plus de détails sur la spécification de l'heure.

Si la date de fin est spécifiée sans l'heure de fin, cette dernière sera par défaut :

• L'heure de fin de la collecte, si la date de fin indique la dernière date de la collecte.
• 23:59:59, si la date de fin n'indique pas la dernière date de la collecte.

Exemples

Exemple 1 : Génération de l'ensemble des données

CRTPFRDTA   FROMMGTCOL(Q099365001)  TOMBR(JAN1)  TOLIB(MYLIB)

Dans cet exemple, la base de données est générée pour l'ensemble des catégories de l'objet de collecte de gestion Q099365001 dans la bibliothèque QPFRDATA. Les fichiers base de données de performances seront créés dans la bibliothèque MYLIB et le nom du membre de la collecte sera JAN1.

Les données sont générées à partir du début de la collecte des données dans cet objet de collecte de gestion et jusqu'à la fin de cette collecte. L'intervalle de la base de données est l'intervalle par défaut de la collecte, qui a été précisé au démarrage de la collecte.

Exemple 2 : Sélection de données spécifiques

CRTPFRDTA   FROMMGTCOL(Q099364002)  TOMBR(JAN1J)  TOLIB(MYLIB)
            CGY(*JOBMI)  INTERVAL(15)
            FROMTIME(('01/01/98' '14:00:00'))
            TOTIME(('01/01/98' '16:00:00'))

Dans cet exemple, seul le fichier base de données QAPMJOBMI est généré à l'aide des données de catégorie *JOBMI issues de la collecte de gestion Q099364002 dans la bibliothèque QPFRDATA. L'intervalle de base de données sera de 15 minutes même si les données sont collectées plus fréquemment (ainsi, l'objet de collecte de gestion peut contenir des données collectées toutes les 5 minutes). Le fichier généré contiendra uniquement les données collectées entre 14 heures et 16 heures, même si l'objet de collecte peut contenir des données sur un intervalle plus long.

Messages d'erreur

*ESCAPE Messages

CPF0A0E

Exécution de CRTPFRDTA terminée. Aucun fichier n'a été modifié.

CPF0A1A

Aucune collecte n'est active.

CPF0A2B

Impossible de traiter l'objet de collecte de gestion &1 de &2.

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9810

Bibliothèque &1 non trouvée.