Contrôle des performances

pm-job observable-classes

Cette sous-commande affiche la liste de toutes les classes d'objets actuellement contrôlables pour lesquelles il est possible de créer des tâches de contrôle des performances.

pm-job observable-objects [class=classe-objets] [domain=domaine-objets]

Cette sous-commande affiche la liste de tous les objets actuellement contrôlables pour lesquels il est possible de créer des tâches de contrôle des performances. Par défaut, tous les objets de toutes les classes contrôlables et de tous les domaines sont affichés. La liste des objets est triée par nom de classe.

class=classe-objets

Si vous spécifiez le paramètre classe-objets optionnel, cela permet de limiter la sortie aux objets contrôlables de la classe désignée. La valeur de classe-objets doit correspondre à l'une des classes qui figure dans la liste affichée par la sous-commande pm-job observable-classes.

domain=domaine-objets

Si vous spécifiez le paramètre domaine-objets optionnel, cela permet de limiter la sortie aux objets contrôlables du domaine désigné. Le domaine d'un objet correspond à la chaîne qui précède les deux-points (:) dans le nom de cet objet.

pm-job observable-attributes class=classe-objets

Cette sous-commande affiche la liste de tous les objets contrôlables dans la classe-objets spécifiée. Les attributs sont affichés avec leur nom et type. La valeur de classe-objets doit correspondre à l'une des classes qui prend en charge les tâches de contrôle des performances, telles que listées par la sous-commande pm-job observable-classes.

pm-job list

Cette sous-commande affiche la liste de toutes les tâches de contrôle des performances actuellement définies. Les tâches sont affichées pour chacun des objets auquel est associé une tâche de contrôle des performances. De plus, les objets sont triés par nom de classe. Les informations affichées pour chaque tâche sont identiques à celles obtenues avec la sous-commande pm-job info.

Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune tâche n'est affichée.

pm-job info nom-tâche

Cette sous-commande affiche les informations détaillées relatives à la tâche de contrôle des performances nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list. Les informations affichées par cette sous-commande sont les suivantes :

• Le nom de la tâche de contrôle des performances.

• Le type de la tâche de contrôle des performances, à savoir « par objet » ou par « par classe ».Les tâches de type par objet contrôlent une ou plusieurs instances de l'objet spécifié, tandis que les tâches de type par classe surveillent chaque instance d'une classe d'objets. Notez que la commande mfwkadm ne permet pas de créer des tâches de type par classe.

• L'état de la tâche de contrôle des performances : active en fonctionnement, active hors fonctionnement ou suspendue. Une tâche active en fonctionnement est actuellement planifiée pour être exécutée et collecte des données. Une tâche active hors fonctionnement est en cours d'exécution, mais ne collecte aucune donnée car l'heure courante se situe hors de la planification de traitement. Une tâche suspendue n'est pas exécutée et ne collecte aucune donnée. Utilisez les sous-commandes pm-job suspend et pm-job resume pour changer l'état d'exécution d'une tâche de contrôle des performances.

• La granularité, exprimée en secondes, de la tâche de contrôle des performances. Il s'agit de l'intervalle défini pour la collecte des données effectuée par cette tâche.

• La période de compte rendu définie pour la tâche de contrôle. La période de compte rendu multipliée par la granularité donne la fréquence de notification. Par exemple, si la période de granularité est définie sur 10 secondes et la période de compte rendu sur 6, un compte rendu de tâche par événement collectera les données toutes les 10 secondes et enverra une notification comprenant 6 comptes rendus toutes les 60 secondes (10*6). Si la tâche effectue également un compte rendu par fichier, elle enverra un événement toutes les 60 secondes avec l'emplacement des 6 fichiers générés.

• Si la tâche de contrôle des performances effectue un compte rendu par événement. Cela signifie que les résultats de la tâche de contrôle des performances sont envoyés sous forme de notifications à un client enregistré.

• Si la tâche de contrôle des performances effectue un compte rendu par fichier. Cela signifie que les comptes rendus de la tâche de contrôle des performances sont écrits dans des fichiers locaux et que les notifications contenant les noms de fichiers sont envoyées aux clients enregistrés.

• Le format du compte rendu de la tâche de contrôle des performances, qui est toujours XML.

• La planification de la tâche de contrôle des performances. La planification définit les jours et les heures auxquels la tâche est active en fonctionnement ou active hors fonctionnement (et collecte ou non des données, respectivement).

Puis, pour une tâche de type par objet :

• La liste des objets contrôlés, triée par nom.

• Si seul un sous-ensemble d'attributs contrôlables est spécifié, les attributs contrôlés des objets contrôlés sont listés par nom et par type.

Et, pour une tâche de type par classe :

• La liste des tâches contrôlés, triée par nom.

• Si seul un sous-ensemble d'attributs contrôlables est spécifié, les attributs contrôlés des classes contrôlées sont listés par nom et par type. Ces attributs sont communs à toutes les classes.

Sécurité : pour les utilisateurs autres que celui qui a démarré le Conteneur d'agents communs, aucune information n'est affichée.

pm-job create nom-tâche granularity= valeur-entière object=nom-objet [object=nom-objet ...]

Cette sous-commande crée une nouvelle tâche de contrôle des performances d'un ou plusieurs objets. La commande mfwkadm ne permet pas de créer des tâches par classe. Lors de la création de tâches de contrôle des performances, les paramètres suivants peuvent être définis :

nom-tâche

Chaîne qui identifie de façon unique la tâche de contrôle des performances. Le paramètre nom-tâche ne peut pas etre déjà utilisé par une autre tâche quelconque de contrôle des performances.

granularity=valeur-entière

Intervalle exprimé en secondes qui sépare le début de deux collectes successives de données de mesure alors que la tâche est active en fonctionnement. La période de granularité peut être définie sur 300 secondes (5 minutes), 900 secondes (15 minutes), 1800 secondes (toutes les demi-heures), 3600 secondes (toutes les heures). Une période de granularité de 300 secondes est convient dans la plupart des cas. Pour certaines mesures, l'utilisation de périodes de granularité plus longues pour la collecte des données peut cependant être plus significative.

object=nom-objet [object=nom-objet ...]

Un ou plusieurs objets contrôlables pour lesquels la tâche de contrôle des performances doit collecter des données et fournir un compte rendu. La valeur de nom-objet doit correspondre à l'un des noms affichés par les sous-commandes pm-job list ou pm-job observable-objects. Si vous spécifiez plusieurs paramètres object= nom-objet, une seule tâche de contrôle des performances est créée pour plusieurs objets.

Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.

pm-job delete nom-tâche

Cette sous-commande supprime la tâche de contrôle des performances nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list.

Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.

pm-job suspend nom-tâche

Cette sous-commande suspend la tâche de contrôle des performances nom-tâche. Une tâche suspendue n'est pas active et ne collecte aucune donnée, quelle que soit sa planification. Elle reste toutefois définie et peut être réactivée via l'utilisation de la sous-commande pm-job resume. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list.

Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.

pm-job resume nom-tâche

Cette sous-commande reprend l'exécution de la tâche de contrôle des performances nom-tâche. Une tâche dont l'exécution est reprise commencera à collecter des données et à envoyer des comptes rendus en fonction de sa planification. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande pm-job list. Cette sous-commande est l'homologue de la sous-commande pm-job suspend.

Sécurité : cette sous-commande peut uniquement être exécutée par l'utilisateur qui a démarré le Conteneur d'agents communs.