Sintaxis para la especificación de umbrales

Utilice la sintaxis, los valores y los parámetros que se describen aquí para modificar umbrales predefinidos.

La especificación de umbrales utiliza la sintaxis siguiente:
diagrama de sintaxis para especificación de umbral

Parámetros

Cada especificación de umbral consta de seis elementos necesarios y tres elementos opcionales que se utilizan cuando se especifican un umbral complejo:
Palabra clave IF
Esta palabra clave indica el principio de la especificación del umbral. El análisis interno considera todo el texto comprendido entre sentencias IF como una especificación de umbral. Sólo se muestra el estado de la primera columna de la sentencia IF si se evalúa positivamente.
Paréntesis izquierdo – (
Se utiliza un paréntesis izquierdo opcional para ayudar a agrupar los umbrales conectados en una especificación de umbral compleja. La especificación del paréntesis izquierdo es opcional, pero, si se especifica, se trata siguiendo las reglas normales de precedencia de operadores. Es decir, el nivel más alto de precedencia entre paréntesis y los operadores AND y OR. Cada paréntesis izquierdo deben coincidir en la especificación de umbral compleja con un paréntesis derecho correspondiente; si no es así, se marcarán errores durante el análisis.
Nota: este paréntesis DEBE ir precedido y seguido de al menos un espacio en blanco.
application_name.table_name.column_name
Este triplete debe ir detrás de la palabra clave IF con cada uno de los tres componentes delimitados por un punto. El triplete debe ser contiguo, es decir, no debe contener espacios en blanco intercalados.
Comparador
Esta especificación de 1-2 bytes debe ir tras el triplete aplicación.nombre_tabla.column.nombre. Los comparadores válidos son:
EQ
comparación igual a
=
comparación igual a
NE
comparación no igual a
!=
comparación no igual a
GT
comparación mayor que
>
comparación mayor que
LT
comparación menor que
<
comparación menor que
GE (mayor o igual que)
comparación mayor o igual que
>=
comparación mayor o igual que
LE (menor o igual que)
comparación menor o igual que
<=
comparación menor o igual que
Valor o rango de valores de comparación
Este valor deben ir tras el comparador y se da soporte a los siguientes formatos:
  • El valor se considera como una cadena de caracteres si está incluido entre comillas dobles. Se puede especificar un máximo de 70 caracteres.
    Nota: Si se utiliza un comparador que no sea EQ o "=" en una serie, se presupone que se está utilizando un valor de serie numérica. Actualmente, el valor de datos de la interfaz de usuario y el valor del umbral se justifican a la derecha antes de la comparación en estas situaciones. Este proporcionará resultados de comparación de umbrales esperados para valores numéricos especificados con el mismo número de posiciones decimales, escalando unidades pero no se intentará analizar la cadena en la evaluación para “normalizar” las cadenas de caracteres.
  • Entero decimal, precedido de un carácter de signo opcional (+ o -), comprendido entre -2^63 + 1 y 2^63 – 1, es decir, -9.223.372.036.854.775.807 y +9.223.372.036.854.775.807. Una coma decimal puede ser insertada en cualquier posición, incluyendo como primera o última en el valor: es decir, 1234. y .1234 son válidos.
  • Valor hexadecimal comprendido entre 0x8000000000000000 y 0x7FFFFFFFFFFFFFFF. Tras el prefijo 0x, se pueden especificar entre 1 y 16 dígitos hexadecimales; por ejemplo, 0x3F es válido.
  • Opcionalmente, se puede especificar un rango de valores utilizando un símbolo <> inmediatamente después y contiguo al 1er valor decimal o hexadecimal. El segundo valor superior del rango debe ir seguir las mismas reglas de especificación que el primer valor del rango, aunque se puede especificar si se desea una combinación de valores decimales y hexadecimales. El segundo valor debe ir inmediatamente después del símbolo de rango.
    Nota: El uso del símbolo < > puede sustituirse por una sentencia IF compuesta como, por ejemplo, IF (a.b.c >= value1 AND a.b.c <= value2).
  • Si se desea, se puede especificar un que especifique las unidades que se aplican al valor o valores numéricos. Los caracteres de unidad debe seguir inmediatamente, y de forma contigua, después del valor numérico al que se aplican. Las especificaciones de unidades válidas son:
    K
    escala el valor numérico en un factor de 1024
    M
    escala el valor numérico en un factor de 1024*1024
    G
    escala el valor numérico en un factor de 1024*1024*1024
    T
    escala el valor numérico en un factor de 1024*1024*1024*1024
    P
    escala el valor numérico en un factor de 1024*1024*1024*1024*1024
    E
    escala el valor numérico en un factor de 1024*1024*1024*1024*1024*1024
    ms
    milisegundos, escale el valor numérico a segundos en un factor de 1000
    csec
    centisegundos, escale el valor numérico a segundos en un factor de 100
    segundo
    segundos, sin escalado
    /seg
    unidades por segundo, escala a velocidad por hora internamente (*3600)
    / mín
    unidades por minuto, escala a velocidad por hora internamente (*60)
    /h
    unidades por hora, sin escalado
    %
    porcentaje, sin escalado
Paréntesis derecho – )
Se utiliza un paréntesis derecho opcional para ayudar a agrupar los umbrales conectados en una especificación de umbral compleja. La especificación del paréntesis derecho es opcional, pero, si se especifica, se trata siguiendo las reglas normales de precedencia de operadores. Es decir, el nivel más alto de precedencia entre paréntesis y los operadores AND y OR. Cada paréntesis derecho deben coincidir en la especificación de umbral compleja con un paréntesis izquierdo correspondiente; si no es así, se marcarán errores durante el análisis.
Nota: este paréntesis DEBE ir precedido y seguido de al menos un espacio en blanco.
Palabras clave AND y OR de conector
El conector entre dos umbrales individuales, o grupos de umbrales entre paréntesis, debe ser una palabra clave AND u OR. Si se utilizan ambas en un umbral complejo, se aplican las reglas normales de precedencia y asociación. Es decir, AND prevalece sobre OR si no se utilizan paréntesis o si ambos conectores se encuentran dentro de un único par de paréntesis izquierdo y derecho. La asociación se realiza de izquierda a derecha.
Palabras clave THEN DO
Se debe especificar THEN DO tras las sentencias IF de umbral con una palabra clave ENDDO de terminación correspondiente. Las palabras clave THEN DO y ENDDO se especifican antes y después de una o varias palabras clave STATUS, ZOOMDEST o HELPDEST y valores de palabras clave.
Palabra clave STATUS
STATUS es una palabra clave opcional que puede ir tras las palabras clave de comparación DO THEN.
(status_state, status_range)
Éste es un par entre paréntesis, delimitado por espacios de parámetros de palabra clave que designan uno o dos estados para su interpretación por parte de la interfaz de usuario. Se deben especificar ambos tipos de designación. Las palabras clave específicas que indican que una o varias designaciones de estado no se aplican al umbral actual (NOSTATE o NORANGE) se utilizan en lugar del valor real. Se debe especificar al menos un espacio en blanco entre la palabra clave STATUS y el paréntesis izquierdo.
Nota: El valor status_state tiene prioridad sobre el status_range especificado si se especifican ambos.
  • status_state establece el estado que debe interpretar la interfaz de usuario. Las especificaciones válidas son:
    • BUENO
    • AVISO
    • CRÍTICO
    • INACTIVO
    • NOSTATE
  • status_range establece un valor comprendido entre 0 y 9 (0 es equivalente a la palabra clave NORANGE) para aumentar los datos de la columna en el subpanel de la interfaz de usuario. Las especificaciones válidas son:
    • Valor numérico comprendido entre 0 y 9
    • NORANGE
Palabras clave ENDDO
ENDDO debe especificarse después de las sentencias STATUS de umbral con un par de palabras clave THEN DO de inicio correspondiente.

Formatos aceptables

Hexadecimales
0xH - 0xHHHHHHHHHHHHHHHH
0XH - 0XHHHHHHHHHHHHHHHH
1-16 dígitos hexadecimales
Decimal
(+ /-) (.) nnnnnnnnnnnnnnnnnnnnn-(+ /-) nnnnnnnnnnnnnnnnnnn (.)
1-19 dígitos decimales con punto decimal en cualquier posición incluyendo la primera y la última posición
Sufijo de escalado
(1024) K (kilobytes), M (megabytes), G (gigabytes), T (terabytes), P (petabytes), E (exabytes)
Porcentaje
%
Sufijo de tiempo
ms, csec, sec
Tasa
/sec, /min, /hr
Serie
Entre 1 y 70 caracteres entre comillas dobles