Syntaxe de spécification des seuils

Utilisez la syntaxe, les valeurs et les paramètres décrits dans cette rubrique pour modifier les seuils prédéfinis.

La spécification des seuils utilise la syntaxe suivante:
diagramme de syntaxe pour la spécification de seuil

Paramètres

Chaque spécification de seuil comprend six éléments obligatoires et trois éléments facultatifs utilisés en présence d'un seuil complexe :
Mot clé IF
Ce mot clé indique le début de la spécification de seuil. L'analyse syntaxique interne considère que tout le texte situé entre les instructions IF fait partie de la spécification de seuil. Seule la première colonne de l'instruction IF a un statut si elle est évaluée positivement.
Parenthèse gauche – (
La parenthèse gauche est utilisée pour regrouper les seuils connectés dans une spécification de seuil complexe. Cette parenthèse est facultative mais, si elle est spécifiée, elle est traitée conformément aux règles standard de priorité des opérateurs. Autrement dit, elle bénéficie du niveau de priorité le plus élevé parmi les parenthèses et les opérateurs AND et OR. Chaque parenthèse gauche doit correspondre dans la spécification de seuil complexe à une parenthèse droite, sinon des erreurs sont signalées lors de l'analyse syntaxique.
Remarque: Cette parenthèse DOIT être précédée et suivie d'au moins un blanc.
application_name.table_name.column_name
Ce triplet doit suivre le mot clé IF, chacun des trois composants étant délimité par un point. Il doit être contigu, c'est-à-dire ne pas contenir de blancs imbriqués.
Comparateur
Cette spécification sur 1 ou 2 octets doit suivre le triplet application.nom_table.colonne.nom. Les comparateurs valides sont les suivants :
quotient émotionnel
comparateur égal
=
comparateur égal
NE
comparateur non égal
!=
comparateur non égal
GT
comparateur supérieur à
>
comparateur supérieur à
terminaison de transmission de ligne
comparateur inférieur à
<
comparateur inférieur à
Entrepreneur mondial
comparateur supérieur ou égal à
>=
comparateur supérieur ou égal à
GE
comparateur inférieur ou égal à
<=
comparateur inférieur ou égal à
Valeur ou plage de valeurs de comparaison
Cette valeur doit suivre le comparateur en respectant les formats suivants pris en charge :
  • La valeur est considérée comme une chaîne si elle entourée de guillemets doubles. Il est possible de spécifier jusqu'à 70 caractères.
    Remarque: Si un comparateur autre que EQ ou " = est utilisé par rapport à une chaîne, l'hypothèse est qu'une valeur de chaîne numérique est seuillée. Actuellement, la valeur des données de l'interface utilisateur et la valeur de seuil sont justifiées à droite avant toute comparaison. Cela va générer des résultats de comparaison de seuil attendus pour les valeurs numériques spécifiées avec le même nombre de décimales et des unités d'échelle, mais aucune analyse syntaxique de la chaîne ne sera tentée dans l'évaluation pour
  • Valeur entière décimale, précédée d'un signe facultatif (+ ou -), dans la plage -2^63 + 1 à 2^63 – 1, c'est-à-dire -9,223,372,036,854,775,807 Un séparateur décimal peut être inséré à n'importe quelle position, y compris comme premier ou dernier dans la valeur: c'est-à-dire que 1234. et .1234 sont valides.
  • Valeur hexadécimale dans la plage 0x8000000000000000 à 0x7FFFFFFFFFFFFFFF. Jusqu'à 16 valeurs hexadécimales peuvent être spécifiées après le préfixe 0x ; par exemple, 0x3F est valide.
  • En option, une plage de valeurs peut être spécifiée à l'aide du symbole <> immédiatement après la première valeur décimale ou hexadécimale et contiguë à celle-ci. La seconde valeur supérieure de la plage doit suivre les mêmes règles de spécification que celles de la première valeur (valeur la plus faible) de la plage si une combinaison de valeurs décimales et hexadécimales est spécifiée. La seconde valeur doit immédiatement et de manière contiguë suivre le symbole de plage.
    Remarque: L'utilisation du symbole < > peut être remplacée par une instruction IF composée telle que IF (a.b.c >= value1 AND a.b.c <= value2).
  • Un suffixe indiquant les unités qui s'appliquent aux valeurs numériques peut éventuellement être spécifié. Les caractères de l'unité doivent suivre immédiatement la valeur numérique auxquels ils s'appliquent (et être contigus à cette dernière). Les spécifications d'unité valides sont les suivantes :
    K
    met la valeur numérique à l'échelle par un facteur de 1024
    M
    met la valeur numérique à l'échelle par un facteur de 1024*1024
    G
    met la valeur numérique à l'échelle par un facteur de 1024*1024*1024
    T
    met la valeur numérique à l'échelle par un facteur de 1024*1024*1024*1024
    P
    met la valeur numérique à l'échelle par un facteur de 1024*1024*1024*1024*1024
    E
    met la valeur numérique à l'échelle par un facteur de 1024*1024*1024*1024*1024*1024
    milliseconde
    (millisecondes) met la valeur numérique à l'échelle en secondes par un facteur de 1000
    csec
    centièmes de seconde, met la valeur numérique à l'échelle en secondes par un facteur de 100
    seconde
    secondes, pas de mise à l'échelle
    /s
    unités par seconde, en interne met à l'échelle en débit par heure (multiplié par 3600)
    /min
    unités par minute, met à l'échelle en débit par heure en interne (*60)
    /h
    unités par heure, pas de mise à l'échelle
    %
    pourcentage, pas de mise à l'échelle
Parenthèse droite – )
La parenthèse droite est utilisée pour regrouper les seuils connectés dans une spécification de seuil complexe. Cette parenthèse est facultative mais si elle est spécifiée, elle est traitée conformément aux règles standard de priorité des opérateurs. Autrement dit, il s'agit du niveau de priorité le plus élevé parmi les parenthèses et les opérateurs AND et OR. Chaque parenthèse droite doit correspondre dans la spécification de seuil complexe à une parenthèse gauche, sinon des erreurs sont signalées lors de l'analyse syntaxique.
Remarque: Cette parenthèse DOIT être précédée et suivie d'au moins un blanc.
Mots clés de connexion AND et OR
Le connecteur entre deux seuils individuels, ou des groupes de seuils entre parenthèses, doit être un connecteur AND ou OR. Si les deux connecteurs sont utilisés dans un seuil complexe, les règles de priorité et d'associativité standard s'appliquent. Autrement dit, AND a une priorité plus élevée que celle de OR en l'absence de parenthèses, ou bien les deux connecteurs doivent être contenus dans une paire de parenthèses gauche et droite unique. L'associativité va de gauche à droite.
Mots clés THEN DO
THEN DO doit être spécifié après les instructions de seuil IF avec un mot clé ENDDO de fin correspondant. Les mots clés THEN DO et ENDDO sont spécifiés avant et après un ou plusieurs mots clés et valeurs de mots clés STATUS, ZOOMDEST
Mot clé STATUS
STATUS est un mot clé facultatif qui peut suivre les mots clés THEN DO de comparaison.
(état_statut, plage_statut)
Il s'agit d'une paire entre parenthèses, délimitée par des espaces, de paramètres de deux mots clés désignant un ou deux statuts interprétés par l'interface utilisateur. Les deux types de désignation doivent être spécifiés. Des mots clés spécifiques indiquant qu'une ou plusieurs désignations de statut ne s'appliquent pas au seuil en cours (NOSTATE ou NORANGE) sont utilisés à la place d'une valeur réelle. Au moins un blanc doit être indiqué entre le mot clé STATUS et la parenthèse gauche.
Remarque: la valeur status_state est prioritaire sur la valeur status_range spécifiée si les deux sont spécifiées.
  • status_state définit l'état à interpréter par l'interface utilisateur. Les spécifications valides sont les suivantes :
    • BON
    • AVERTISSEMENT
    • CRITIQUE
    • EN VEILLE
    • NOSTATE
  • status_range définit une valeur comprise entre 0 et 9 (0 est équivalent au mot clé NORANGE) pour augmenter les données de colonne dans le sous-panneau de l'interface utilisateur. Les spécifications valides sont les suivantes :
    • Valeur numérique comprise entre 0 et 9
    • NORANGE
Mots clés ENDDO
ENDDO doit être indiqué après les instructions threshold STATUS avec une paire de mots clés THEN DO correspondante.

Formats acceptables

Hexadécimal
0xH - 0xHHHHHHHHHHHHHHHH
0XH - 0XHHHHHHHHHHHHHHHH
1 à 16 chiffres hexadécimaux
Décimal
(+ /-) (.) nnnnnnnnnnnnnnnnnnnnn-(+ /-) nnnnnnnnnnnnnnn (.)
1 à 19 chiffres décimaux avec un séparateur décimal dans n'importe quelle position, y compris celle du premier ou du dernier caractère
Suffixe d'échelle
(1024) K (kilooctets), M (mégaoctets), G (gigaoctets), T (téraoctets), P (pétaoctets), E (exaoctets)
Pourcentage
%
Suffixe de temps
ms, csec, s
Taux
/s, /min, /h
Chaîne
1 à 70 caractères entre guillemets doubles