Aller au contenu

STRPFRCOL

Démarrer collecte de perf

En bref

La commande STRPFRCOL (Démarrer la collecte de performances) permet de démarrer la collecte des données de performances système effectuée par les services de collecte.

STRPFRCOL se lit STR (Démarrer) + PFRCOL. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRPFRCOL

Paramètres

Astuce : dans une session 5250, tapez STRPFRCOL puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande STRPFRCOL (Démarrer la collecte de performances) permet de démarrer la collecte des données de performances système effectuée par les services de collecte. Les propriétés de la collecte de niveau système sont contrôlées au moyen de la configuration des services de collecte, qui peut être modifiée à l'aide de la commande CFGPFRCOL (Configurer la collecte de performances). Les données incluses dans la collecte de niveau du système sont déterminées par la valeur spécifiée au paramètre Profil de collecte.

La collecte des données de performances est effectuée par le travail du serveur de services de collecte (QYPSPFRCOL). Si ce travail n'est pas actif, il démarre lorsque cette commande est exécutée. S'il est actif, toute modification apportée au profil de collecte prend effet immédiatement sans entraîner d'interruption de la collecte.

QYPSPFRCOL crée un objet de collecte de gestion (*MGTCOL) pour stocker les données de performances. Les données collectées incluent les catégories du profil de collecte de niveau système, ainsi que les données collectées pour le compte d'applications client (par exemple, moniteurs IBM System i Navigator ou API du collecteur de performances). Toutes les données sont stockées dans l'objet de collecte de gestion en cours. Elles peuvent être traitées à l'aide de la commande CRTPFRDTA (Créer données de performances) afin de générer des fichiers base de données de performances.

Lors de l'exécution d'un cycle de collecte des performances, un nouvel objet de collecte de gestion est créé par le travail du serveur de services de collecte, destiné à la mise en oeuvre du profil de collecte spécifié. Remarque : L'exécution d'un cycle peut entraîner la perte d'un intervalle de données et avoir des conséquences sur les applications client recourant aux services de collecte.

Paramètres

Mot-clé Description Valeurs possibles Remarques
COLPRF Profil de collecte *CFG, *MINIMUM, *STANDARD, *STANDARDP, *ENHCPCPLN, *CUSTOM Facultatif, positionnel 1
CYCCOL Boucler la collecte *NO, *YES Facultatif, positionnel 2

Profil de collecte par défaut (COLPRF)

Indique le profil de collecte. Cela détermine les catégories à inclure dans la collecte de niveau système. L'indication d'un profil pour ce paramètre modifie le profil de collecte par défaut figurant dans la configuration des services de collecte. Le profil de collecte par défaut peut être également modifié à l'aide de la commande CFGPFRCOL (Configurer la collecte de performances).

*CFG
La collecte utilise la valeur actuellement configurée. Si la valeur configurée n'a jamais été modifiée, le profil de collecte 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.

Boucler la collecte (CYCCOL)

Indique si la collecte doit opérer un cycle. Avec l'exécution du cycle, les données sont collectées dans un nouvel objet de collecte de gestion (*MGTCOL).

*NO
Les données continuent d'être collectées dans l'objet de collecte en cours.
*YES
Les données sont collectées dans un nouvel objet de collecte.

Exemples

Exemple 1 : Démarrage de la collecte de performances

STRPFRCOL

Avec cette commande, le travail du serveur de services de collecte (QYPSPFRCOL) démarre la collecte des données de performance système à l'aide du profil de collecte par défaut actuellement configuré.

Exemple 2 : Démarrage avec un profil de collecte et une collecte par cycle

STRPFRCOL COLPRF(*MINIMUM) CYCCOL(*YES)

Avec cette commande, le travail du serveur de services de collecte (QYPSPFRCOL) opère un cycle et commence à collecter des données de performances dans un nouvel objet de collecte de gestion (*MGTCOL) en utilisant le profil de collecte *MINIMUM. Remarque : Cette commande remplace également le profil de collecte configuré par défaut par le profil *MINIMUM.

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.
CPFB94A
Erreur de communication de collecteur. Code raison &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.