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:

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
- El valor se considera como una cadena de caracteres si está incluido entre comillas dobles. Se puede especificar un máximo de 70 caracteres.
- 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 elstatus_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
- Decimal
- (+ /-) (.) nnnnnnnnnnnnnnnnnnnnn-(+ /-) nnnnnnnnnnnnnnnnnnn (.)
- 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