Contrôle des valeurs seuil

thrsh-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 valeurs seuil.

thrsh-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 valeurs seuil. 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 figurent dans la liste affichée par la sous-commande thrsh-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 de le 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.

thrsh-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 figurent dans la liste affichée par la sous-commande thrsh-job observable-classes.

thrsh-job list

Cette sous-commande affiche la liste de toutes les tâches de contrôle des valeurs seuil actuellement définies. Les tâches sont affichées pour chacun des objets auquel est associé une tâche de contrôle des valeurs seuil. 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 thrsh-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.

thrsh-job info nom-tâche

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

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

• La multiplicité de la tâche de contrôle des valeurs seuil. Cette version prend uniquement en charge des tâches de contrôle des valeurs seuil simples qui surveillent un attribut d'un seul objet.

• L'état de la tâche de contrôle des valeurs seuil : 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 pas de données car l'heure courante est en dehors 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 thrsh-job suspend et thrsh-job resume pour changer l'état d'exécution d'une tâche de contrôle des valeurs seuil.

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

• La planification de la tâche de contrôle des valeurs seuil. 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).

• La configuration de l'alarme pour la tâche de contrôle des valeurs seuil. Il s'agit de l'alarme qui sera déclenchée si la valeur observée de l'attribut contrôlé dépasse la valeur seuil définie. Le type et la gravité de l'alarme sont également affichés.

• L'objet contrôlé par la tâche de contrôle des valeurs seuil.

• Le nom de l'attribut auquel le seuil s'applique.

• La valeur du seuil sur lequel est basé le déclenchement de l'alarme.

• La direction de la progression de la valeur pour laquelle une alarme sera déclenchée en cas de dépassement du seuil, à savoir ÉLÉVATION ou CHUTE.

• Le décalage de tolérance pour le seuil. Lorsque la direction définie est ÉLÉVATION, l'alarme est redéclenchée lorsque la valeur de l'attribut contrôlé est inférieure à valeur-seuil-valeur-décalage. Lorsque la direction définie est CHUTE, l'alarme est redéclenchée lorsque la valeur de l'attribut contrôlé est supérieure à valeur-seuil+valeur-décalage. Ce comportement s'applique même si la valeur du décalage est égale à zéro.

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

thrsh-job create nom-tâche object=nom-objet granularity=valeur-entière attributeName=nom-attribut attributeType=type-attribut thresholdValue=valeur-seuil thresholdOffset=valeur-décalage thresholdDirection=[ÉLÉVATION|CHUTE]

Cette sous-commande crée une nouvelle tâche de contrôle des valeurs seuil qui surveille un attribut d'un seul objet. Lors de la création des tâches de contrôle des valeurs seuil, 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 valeurs seuil. Le paramètre nom-tâche ne peut pas etre déjà utilisé par une autre tâche quelconque de contrôle des valeurs seuil.

object=nom-objet

Objet contrôlable pour lequel la tâche de contrôle des valeurs seuil collectera les valeurs de l'attribut afin de les comparer à la valeur seuil définie. La valeur de nom-objet doit correspondre à l'un des noms affichés par les sous-commandes thrsh-job list ou thrsh-job observable-objects.

granularity=valeur-entière

Intervalle exprimé en secondes qui sépare le début de deux coontrôles successifs de la valeur de l'attribut alors que la tâche est active en fonctionnement.

attributeName=nom-attribut

Nom de l'attribut pour lequel la tâche de contrôle des valeurs seuil collecte les valeurs qu'elle compare à la valeur seuil. La valeur de nom-attribut doit correspondre à l'un des noms affichés par les sous-commandes thrsh-job list ou thrsh-job observable-objects.

attributeType=type-attribut

Type de l'attribut contrôlable à contrôler. La valeur de type-attribut doit figurer dans la liste affichée par les sous-commandes thrsh-job info et thrsh-job observable-attributes.

thresholdValue=valeur-seuil

Valeur de l'atribut contrôlé pour laquelle cette tâche de contrôle des valeurs seuil déclenchera une alarme en cas de dépassement dans la direction spécifiée par direction-seuil.

thresholdOffset=valeur-décalage

La valeur de valeur-décalage détermine la tolérance de la tâche de contrôle des valeurs seuil pour le déclenchement d'alarmes successives. La valeur de valeur-décalage doit être égale à zéro ou à une valeur positive. Après le déclenchement d'un premier événement d'alarme, une autre alarme est déclenchée lorsque la valeur de l'attribut contrôlé se trouve hors de la plage définie par valeur-décalage et direction-seuil.

thresholdDirection=[ÉLÉVATION|CHUTE]

Lorsque la direction définie est ÉLÉVATION, un événement d'alarme est redéclenché lorsque la valeur de l'attribut contrôlé est inférieure à valeur-seuil-valeur-décalage. Lorsque la direction définie est CHUTE, un événement d'alarme est redéclenché lorsque la valeur de l'attribut contrôlé est supérieure à valeur-seuil+valeur-décalage. Ce comportement s'applique même si la valeur de valeur-décalage est égale à zéro.

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

thrsh-job delete nom-tâche

Cette sous-commande supprime la tâche de contrôle des valeurs seuil nom-tâche. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande thrsh-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.

thrsh-job suspend nom-tâche

Cette sous-commande suspend la tâche de contrôle des valeurs seuil 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 thrsh-job resume. La valeur de nom-tâche doit correspondre à l'une des tâches affichées par la sous-commande thrsh-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.

thrsh-job resume nom-tâche

Cette sous-commande reprend l'exécution de la tâche de contrôle des valeurs seuil 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 thrsh-job list. Cette sous-commande est l'homologue de la sous-commande thrsh-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.