CFGPFRCOL

La commande CFGPFRCOL permet de modifier certains attributs de collecte et détermine la façon dont les services de collecte gèrent la collecte des données. Certains attributs modifiés à l'aide de cette commande prennent effet immédiatement alors que d'autres ne s'appliquent qu'à la création du prochain objet de collecte. Reportez-vous à l'aide relative aux paramètres pour déterminer le mode de traitement de chaque attribut. La commande STRPFRCOL permet de démarrer le travail du serveur de services de collecte ou de lui faire opérer un cycle.

Paramètres

Intervalle par défaut (INTERVAL)

Indique l'intervalle de collecte par défaut (en minutes). Cette valeur est utilisée comme modèle d'intervalle de collecte par la plupart des catégories de données. Lorsqu'un intervalle minimal ou maximal est associé à une catégorie et que celle-ci utilise également l'intervalle de collecte par défaut, l'intervalle par défaut est utilisé tant qu'il n'entre pas en conflit avec les autres paramètres. En cas de conflit, l'intervalle minimal ou maximal est utilisé. Par exemple, l'intervalle maximal est de cinq minutes pour *DISK et *IPCS. Si la valeur définie pour l'intervalle de collecte par défaut est supérieure à cinq minutes, la catégorie effectue toujours la collecte toutes les cinq minutes. Cette modification s'applique immédiatement.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, l'intervalle est de 15 minutes.

0.25

L'intervalle de collecte par défaut est de 15 secondes.

0.5

L'intervalle de collecte par défaut est de 30 secondes.

1.0

L'intervalle de collecte par défaut est de 1 minute.

5.0

L'intervalle de collecte par défaut est de 5 minutes.

15.0

L'intervalle de collecte par défaut est de 15 minutes.

30.0

L'intervalle de collecte par défaut est de 30 minutes.

60.0

L'intervalle de collecte par défaut est de 60 minutes.

Bibliothèque de collecte (LIB)

Indique la bibliothèque où doit résider l'objet de collecte de gestion (*MGTCOL). Cette modification prend effet à la création du prochain objet de collecte. Si vous modifiez la bibliothèque de collecte, vous devez savoir que les collectes sont automatiquement retirées de la nouvelle bibliothèque en fonction de la durée de conservation des fichiers de collecte standard indiquée.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, il s'agit de la bibliothèque QPFRDATA.

nom

Indiquez le nom de la bibliothèque dans laquelle doit être créé l'objet de collecte de gestion.

Profil de collecte par défaut (DFTCOLPRF)

Indique le profil de collecte par défaut. Cela détermine les catégories à inclure dans la collecte de niveau système. Cette modification prend effet à la création du prochain objet de collecte.

*SAME

La valeur reste inchangée. Si cette valeur n'a jamais été modifiée, le profil de collecte par défaut est *STANDARDP.

*MINIMUM

Collecte de données minimale recommandée. Ce profil englobe les catégories suivantes : *SYSBUS, *POOL, *HDWCFG, *SYSCPU, *SYSLVL, *JOBMI, *JOBOS et *DISK.

*STANDARD

Le profil standard englobe toutes les catégories généralement requises par les outils IBM Performance Tools for i, à l'exception des données de communication. Ce profil englobe toutes les catégories du profil *MINIMUM, auxquelles viennent s'ajouter les catégories suivantes : *POOLTUNE, *SUBSYSTEM, *SNADS, *LCLRSP, *APPN, *SNA, *TCPBASE, *USRTNS, *LPAR, *EXTSTG, *SYSINT, *RMVSTG, *SQL, *TOPO et *XSTGSVC. La catégorie *DOMINO est également incluse si le produit IBM Domino for i a été installé sur le système. De même, la catégorie *HTTP est incluse si le produit IBM HTTP Server for i (optimisé par Apache) a été installé sur le système.

*STANDARDP

Le profil standard plus englobe toutes les catégories généralement requises par les outils IBM Performance Tools for i, y compris les données de communication. Il regroupe toutes les catégories du profil *STANDARD, auxquelles viennent s'ajouter les catégories suivantes : *IPCS, *CMNBASE, *CMNSTN, *CMNSAP, *TCPIFC, *DPS et *RDMA.

*ENHCPCPLN

Le profil de planificateur de capacité avancé englobe toutes les catégories contenues dans le profil *STANDARDP, plus *INTPEX.

*CUSTOM

Le profil personnalisé comporte des catégories définies par l'utilisateur. Ce profil doit être défini via la tâche Configuration des services de collecte d'IBM Navigator for i.

Temps de cycle (CYCTIME)

Indique l'heure de base à laquelle le travail du serveur de services de collecte (QYPSPFRCOL) doit arrêter la collecte en cours et commencer à collecter des données dans un nouvel objet de collecte de gestion (*MGTCOL). Cette modification prend effet immédiatement.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, il s'agit de minuit.

heure

Indiquez l'heure à laquelle le collecteur opère un cycle. Bien que la commande CL vous permette d'entrer une valeur d'heure contenant des secondes, les services de collecte ne prennent en charge que le cycle des heures et des minutes. Toute valeur de seconde entrée ne sera pas prise en compte.

Intervalle de cycles (CYCITV)

Indique la période de temps à l'issue de laquelle le travail du serveur de services de collecte (QYPSPFRCOL) arrête la collecte en cours et commence à collecter des données dans un nouvel objet de collecte de gestion (*MGTCOL). Ce paramètre contrôle le volume maximal de données (calculé en fonction du temps) qui doit être stocké dans un même objet de collecte. Cette modification prend effet immédiatement.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, l'intervalle de temps est de 24 heures.

1-24

Indiquez le nombre d'heures à l'issue duquel la collecte opère un cycle.

Période de rétention *MGTCOL (RETPERIOD)

Indique le délai pendant lequel les objets de collecte de gestion (*MGTCOL) sont conservés sur le système. La durée de conservation permet de calculer une date et une heure d'expiration qui sont stockées dans l'objet de collecte. Une fois la durée de conservation expirée, l'objet est automatiquement supprimé par le travail du serveur de services de collecte (QYPSPFRCOL). Les collectes parvenues à expiration sont retirées du système à chaque démarrage ou cycle d'une collecte. Les objets de collecte sont supprimés automatiquement, uniquement s'ils existent dans la bibliothèque de collecte configurée du système. Cette modification prend effet immédiatement et concerne les objets de collecte en cours et à venir.

Valeurs uniques

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la durée de conservation est de 24 heures.

*PERM

L'objet n'est pas automatiquement supprimé.

Elément 1 : Nombre d'unités

durée-conservation

Indiquez le laps de temps, en heures et en jours, pendant lequel un objet de collecte de gestion doit être conservé. La durée maximale de conservation d'un objet de collecte est de 30 jours.

Elément 2 : Unité de temps

Indiquez si la durée de conservation spécifiée pour l'élément Nombre d'unités doit être traitée comme un nombre d'heures ou de jours.

*HOURS

La durée de conservation est indiquée en heures. Les valeurs admises sont comprises entre 1 et 720.

*DAYS

La durée de conservation est indiquée en jours. Les valeurs admises sont comprises entre 1 et 30.

Activer moniteur système (ENBSYSMON)

Permet d'indiquer si les services de collecte permettent de prendre en charge le moniteur système. Un cycle est nécessaire pour que les modifications puissent prendre effet.

Pour permettre la prise en charge du moniteur système, les services de collecte collectent certaines catégories de données à un intervalle plus fréquent que celui configuré pour le profil de collecte, et elles soumettent un second travail par lots (CRTPFRDTA2) afin de générer une seconde collecte de fichier base de données pour prendre en charge le moniteur système.

Les catégories et les intervalles de collecte associés peuvent être configurés via le paramètre SYSMONCGY si vous souhaitez modifier les paramètres par défaut du moniteur système. La collection de fichiers du moniteur système porte le même nom que la collection standard, à ceci près qu'elle commence par la lettre "R". Seuls les fichiers associés aux catégories du moniteur système sont générés.

Les services de collecte prennent également en charge une durée de conservation unique pour les données du moniteur système via le paramètre SYSMONRET. L'expiration est traitée comme les données standard.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est *NO.

*YES

La prise en charge du moniteur système est activée.

*NO

La prise en charge du moniteur système n'est pas activée.

Créer données d'historique (CRTPFRHST)

Permet d'indiquer si les services de collecte créent ou non des données d'historique à chaque cycle de collecte. Cette modification s'applique immédiatement.

Si cette option est activée, les services de collecte soumettent le travail par lots QYPSPFRHST au moment du cycle pour créer les données d'historique. Ce travail traite l'objet de collecte de gestion pour la collecte qui vient de se terminer et alimente la collecte d'historique avec les données de l'objet de collecte de gestion.

L'intervalle de temps utilisé pour créer des données d'historique peut être configuré via le paramètre HSTITV si vous souhaitez modifier la valeur par défaut.

La durée de conservation des données récapitulatives d'historique peut être configurée via le paramètre HSTSUMRET si vous souhaitez modifier la valeur par défaut.

L'option permettant de créer des données détaillées d'historique peut être configurée via le paramètre CRTHSTDTL si vous souhaitez modifier la valeur par défaut.

La durée de conservation des données détaillées d'historique peut être configurée via le paramètre HSTDLTRET si vous souhaitez modifier la valeur par défaut.

Le filtre des données détaillées d'historique peut être configuré via le paramètre HSTFILTER si vous souhaitez modifier la valeur par défaut.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est *YES.

*YES

Des données d'historique sont créées.

*NO

Aucune donnée d'historique n'est créée.

Créer fichiers BDD standard (CRTDBF)

Permet d'indiquer si le travail CRTPFRDTA doit être soumis. Ce travail crée la collection de fichiers base de données standard et traite les données dans l'objet de collecte de gestion en cours au fur et à mesure de leur collecte. Il prend fin lorsque le travail du serveur de services de collecte (QYPSPFRCOL) s'arrête ou opère un cycle. Lorsque la valeur *YES est associée à cette option, un nouveau travail CRTPFRDTA est soumis pour chaque objet de collecte de gestion (*MGTCOL) créé. Un cycle est nécessaire pour que les modifications puissent prendre effet.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est *YES.

*YES

Le travail CRTPFRDTA est soumis.

*NO

Le travail CRTPFRDTA n'est pas soumis.

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

Permet d'indiquer si des données de type récapitulatif supplémentaires doivent être créées pour la collection de fichiers base de données standard. Un cycle est nécessaire pour que les modifications puissent prendre effet.

Valeurs uniques

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est *NONE.

*NONE ou *NO

Aucune donnée de fichier de type récapitulative n'est générée.

*ALL ou *YES

Toutes les données de fichier de type récapitulatif 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 entraîne la création d'autres fichiers base de données du moniteur système avec la collection de fichiers base de données standard. Ces fichiers contiennent diverses données de catégorie et sont nécessaires pour utiliser les perspectives du moniteur système dans Performance Data Investigator. La création de ces fichiers permet d'utiliser ces perspectives avec les collections de données standard.

Intervalle données historique (HSTITV)

Indique l'intervalle de temps utilisé pour créer des données d'historique. Cette modification s'applique immédiatement.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, l'intervalle est de 60 minutes.

0.25

L'intervalle de collecte des données d'historique est de 15 secondes.

0.5

L'intervalle de collecte des données d'historique est de 30 secondes.

1.0

L'intervalle de collecte des données d'historique est de 1 minute.

5.0

L'intervalle de collecte des données d'historique est de 5 minutes.

15.0

L'intervalle de collecte des données d'historique est de 15 minutes.

30.0

L'intervalle de collecte des données d'historique est de 30 minutes.

60.0

L'intervalle de collecte des données d'historique est de 60 minutes.

Conserver récap. historique (HSTSUMRET)

Indique la durée de conservation pour les données récapitulatives d'historique.

La durée de conservation de données récapitulatives d'historique permet de déterminer le temps pendant lequel les données récapitulatives d'historique des services de collecte doivent être conservées. Les données récapitulatives d'historique sont stockées dans des fichiers commençant par QAPMHM*. Les données récapitulatives d'historique antérieures à la durée de conservation sont supprimées par le travail du serveur des services de collecte (QYPSPFRCOL) au prochain cycle du collecteur.

La durée de conservation est indiquée en mois. Vous pouvez indiquer de 1 à 600 mois.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est de 12 mois.

durée-conservation

Nombre de jours pendant lesquels les données récapitulatives d'historique sont conservées avant de pouvoir être supprimées.

Créer données dét. historique (CRTHSTDTL)

Permet d'indiquer si les services de collecte créent ou non des données détaillées d'historique.

Si cette option est cochée, des données détaillées relatives nombre maximal de contributeurs pour chaque attribut sont stockées dans la collecte d'historique à utiliser comme données d'exploration. Le nombre maximal de contributeurs est déterminé par le paramètre HSTFILTER.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est *YES.

*YES

Des données détaillées d'historique sont créées.

*NO

Aucune donnée détaillée d'historique n'est créée.

Conserver détail historique (HSTDTLRET)

Indique la durée de conservation pour les données détaillées d'historique.

La durée de conservation de données détaillées d'historique permet de déterminer le temps pendant lequel les données détaillées d'historique des services de collecte doivent être conservées. Les données détaillées d'historique sont stockées dans des fichiers commençant par QAPMHM*. Les données détaillées d'historique antérieures à la durée de conservation sont supprimées par le travail du serveur des services de collecte (QYPSPFRCOL) au prochain cycle du collecteur.

La durée de conservation est indiquée en jours. Vous pouvez indiquer de 1 à 60 jours.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est de 7 jours.

durée-conservation

Nombre de jours pendant lesquels les données détaillées d'historique sont conservées avant de pouvoir être supprimées.

Filtre données dét. historique (HSTFILTER)

Indique le nombre maximal de contributeurs pour chaque attribut à stocker dans la collecte de données d'historique à utiliser comme données d'exploration.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est 20.

*ALL

Toutes les données détaillées sont conservées.

filtre-données-détaillées

Nombre d'utilisations maximales de chaque attribut à conserver.

Modifier biblio PM Agent (CHGPMLIB)

Permet d'indiquer si la bibliothèque de PM Agent doit être modifiée pour correspondre à celle utilisée par les services de collecte.

Ce paramètre n'est plus pris en charge. Il est conservé uniquement à des fins de compatibilité avec les éditions antérieures à la version 5 édition 5 modification 0 du système d'exploitation.

Conserv données std (jours) (STDDTARET)

Indique la durée de conservation des collections de fichiers base de données standard.

Les collections de fichiers base de données standard comportent des données qui sont généralement créées par le travail CRTPFRDTA dans la bibliothèque de collecte configurée. Le nom de la collection (qui commence par la lettre "Q") est identique au nom de la collection *MGTCOL à partir de laquelle les données ont été exportées.

La durée de conservation de données de fichier standard détermine le temps pendant lequel les collections de fichiers base de données standard doivent être conservées sur le système. Lorsque des données standard de la bibliothèque de collecte configurée sont antérieures à la durée de conservation actuellement définie, elles sont automatiquement supprimées par le travail du serveur des services de collecte (QYPSPFRCOL) au prochain démarrage ou cycle du collecteur.

La durée de conservation est indiquée en jours.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est de 10 jours.

*PERM

Les collections de fichiers base de données standard ne sont pas supprimées automatiquement.

durée-conservation

Nombre de jours pendant lesquels des collections de fichiers base de données standard sont conservées avant de devenir admissibles pour la suppression.

Rétention données moniteur sys (SYSMONRET)

Indique la durée de conservation des collections de fichiers base de données du moniteur système.

Ces collections sont générées lorsque le moniteur système est activé via le paramètre ENBSYSMON. Les collections de fichiers base de données du moniteur système comportent des données qui sont généralement créées par le travail CRTPFRDTA2 dans la bibliothèque de collecte configurée. Les fichiers générés sont limités aux catégories identifiées pour les données du moniteur système. Le nom de la collection est identique au nom de la collection *MGTCOL à partir de laquelle les données ont été exportées, à ceci près qu'il commence par la lettre "R".

La durée de conservation du moniteur système permet de déterminer le temps pendant lequel les collections de fichiers base de données du moniteur système doivent être conservées sur le système. Lorsque des données du moniteur système figurant dans la bibliothèque de collecte configurée sont antérieures à la durée de conservation actuellement définie, elles sont automatiquement supprimées par le travail du serveur des services de collecte (QYPSPFRCOL) au prochain démarrage ou cycle du collecteur.

La durée de conservation est indiquée en jours.

*SAME

La valeur reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est de 2 jours.

*PERM

Les collections de fichiers du moniteur système ne sont pas supprimées automatiquement.

durée-conservation

Nombre de jours pendant lesquels des collections de fichiers du moniteur système sont conservées avant de devenir admissibles pour la suppression.

Catégories moniteur système (SYSMONCGY)

Indique les catégories utilisées par le moniteur système. Chaque catégorie peut comporter un intervalle de collecte indépendant. Un cycle est nécessaire pour que les modifications puissent prendre effet.

Vous pouvez indiquer jusqu'à 10 combinaisons de liste de catégories/éléments d'intervalle pour ce paramètre.

Elément 1 : Catégories à traiter

Valeurs uniques

*SAME

La liste reste inchangée. Si la valeur n'a jamais été modifiée, la valeur par défaut du système est *SYSMONDFT.

*SYSMONDFT

La liste de catégories est réinitialisée afin de contenir uniquement les catégories spécifiquement prises en charge par le moniteur système. Ces catégories sont notamment les suivantes : *SYSLVL, *POOL, *DISK, *JOBMI, *JOBOS, *CMNBASE et QHTTP. Toutes les données sont collectées à 1 minute d'intervalle.

Autres valeurs

nom-catégorie

Indiquez les noms de catégorie pour la prise en charge du moniteur système.

Remarque :La catégorie *SYSLVL doit être incluse dans la liste.

Les noms de catégorie admis sont les suivants :

  Nom               Description
  -------------     ---------------------------
  *APPN             APPN
  *CMNBASE          Communications (de base)
  *DISK             Mémoire disque
  *DOMINO           IBM Domino for i
  *DPS              Services de point d'accès
  *EXTSTG           Mémoire externe
  QHTTP             IBM HTTP Server for i (sous Apache)
  *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
  *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)
  *USRTNS           Données de transaction définies par l'utilisateur
  *WAS              Websphere Application Server

Elément 2 : Intervalle temps (en minutes)

1.0

L'intervalle de collecte est de 1 minute pour cette catégorie.

0.25

L'intervalle de collecte par défaut est de 15 secondes pour cette catégorie.

0.5

L'intervalle de collecte est de 30 secondes pour cette catégorie.

5.0

L'intervalle de collecte est de 5 minutes pour cette catégorie.

Exemples

Exemple 1 : Configuration de l'intervalle par défaut et de la bibliothèque de collecte

CFGPFRCOL INTERVAL(5) LIB(QMPGDATA)

Cette commande permet de remplacer immédiatement par une valeur de 5 minutes l'intervalle par défaut appliqué à la collecte de la plupart des données exemples. De plus, la bibliothèque dans laquelle les données sont collectées sera remplacée par QMPGDATA lors de la création du prochain objet de collecte de gestion (*MGTCOL).

Exemple 2 : Configuration de l'heure et de l'intervalle de cycle

CFGPFRCOL CYCTIME(030000) CYCITV(6)

Cette commande permet de modifier l'heure et l'intervalle de cycle associés à la collecte. L'heure de base du cycle est fixée à 3 heures et la collecte opère un cycle toutes les six heures à partir de cette heure de base. De nouveaux objets de collecte de gestion (*MGTCOL) sont créés aux heures suivantes : 3:00, 9:00, 15:00, 21:00, 3:00, 9:00, etc.

Exemple 3 : Configuration d'une durée de conservation

CFGPFRCOL RETPERIOD(25 *DAYS)

Cette commande permet de conserver pendant 25 jours sur le système les objets de collecte en cours et à venir, avant qu'ils ne soient automatiquement supprimés par le travail du serveur de services de collecte (QYPSPFRCOL).

Exemple 4 : Configuration du profil de collecte par défaut et travail de création de fichiers base de données

CFGPFRCOL DFTCOLPRF(*STANDARD) CRTDBF(*YES)

Avec cette commande, les modifications s'appliquent lors de la création du prochain objet de collecte de gestion (*MGTCOL). A ce moment-là, le profil de collecte est remplacé par le profil *STANDARD et le travail CRTPFRDTA est soumis.

Exemple 5 : Configuration de la prise en charge du moniteur système

CFGPFRCOL ENBSYSMON(*YES) SYSMONCGY((*SYSLVL .25) (*DISK .5)
                                    (*JOBMI 1) (*JOBOS 1))

Cette commande permet d'activer la prise en charge du moniteur système au prochain cycle de la collecte ou au prochain démarrage du collecteur. Les données associées à la catégorie *SYSLVL sont collectées toutes les 15 secondes, les données de la catégorie *DISK sont collectées toutes les 30 secondes, et les données de travail (catégories *JOBMI et *JOBOS) sont collectées toutes les minutes.

Le travail CRTPFRDTA2 est soumis et crée une collection du moniteur système qui inclut uniquement ces catégories. Les fichiers QAPMSMSYS, QAPMSMDISK, QAPMSMJMI et QAPMSMJOS sont également générés.

Messages d'erreur

*ESCAPE Messages

CPF3CF2

Une ou plusieurs erreurs se sont produites pendant l'exécution de l'API &1. Error(s) occurred during running of &1 API.

CPF9810

Bibliothèque &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.