Tivoli Universal Agent

®

Versión 6.2.0

Guía del usuario

SC11-3144-01

Tivoli Universal Agent
®

Versión 6.2.0

Guía del usuario

SC11-3144-01

Nota Antes de utilizar esta información y el producto al que da soporte, lea la información que figura en el Apéndice L, “Avisos”, en la página 281.

Esta edición se aplica a la versión 6, release 2, modificación 0 de IBM Tivoli Monitoring (número de producto 5724-C04) y a todos los releases y modificaciones siguientes a no ser que se afirme lo contrario en nuevas ediciones. © Copyright International Business Machines Corporation 2003, 2007. Reservados todos los derechos.

Contenido
Figuras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Tablas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Acerca de esta publicación . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii A quién va destinada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Publicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Biblioteca de IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . xvii IBM Tivoli Open Process Automation Library (OPAL) . . . . . . . . . . . . . . . . . . xviii Acceso a la terminología en línea . . . . . . . . . . . . . . . . . . . . . . . . . xviii Acceso a las publicaciones en línea . . . . . . . . . . . . . . . . . . . . . . . . xviii Solicitud de publicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Formación técnica de Tivoli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Información de soporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Convenios empleados en esta guía . . . . . . . . . . . . . . . . . . . . . . . . . . xix Convenios de tipo de letra . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Variables y vías de acceso que dependen del sistema operativo . . . . . . . . . . . . . . xx Sintaxis de mandatos de Tivoli . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Capítulo 1. Visión general de Tivoli Universal Agent . . Funcionamiento de Tivoli Universal Agent . . . . . . . Definición de datos para Tivoli Universal Agent . . . . . Suministro de datos a Tivoli Universal Agent . . . . . . Trabajo con los datos . . . . . . . . . . . . . . Un caso de supervisión sencillo . . . . . . . . . . Selección del proveedor de datos . . . . . . . . . Preparación de la fuente de datos . . . . . . . . . Definición de la aplicación de Tivoli Universal Agent . . Visualización de datos de atributos desde FTPLOGFILE Creación de una política de automatización . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 4 4 5 5 5 6 6 7 7

Capítulo 2. Cómo comenzar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Configuración de Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . . . . . . 9 Selección de un proveedor de datos . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Selección de los datos que se desean supervisar . . . . . . . . . . . . . . . . . . . . 9 Determinación de la ubicación de los datos . . . . . . . . . . . . . . . . . . . . . . 9 Determinación del proveedor de datos . . . . . . . . . . . . . . . . . . . . . . . . 10 Determinación del número necesario de agentes de Tivoli Universal Agent . . . . . . . . . . . 10 Determinación de cuántas instancias de Tivoli Universal Agent se pueden ejecutar en el mismo host 11 Determinación de cuántos proveedores de datos se pueden iniciar con un Tivoli Universal Agent 11 Establecimiento de las variables de entorno . . . . . . . . . . . . . . . . . . . . . . . 11 Nombre y ubicación del archivo de variables de entorno . . . . . . . . . . . . . . . . . 11 Edición de variables de entorno en los sistemas operativos Windows . . . . . . . . . . . . 12 Edición de variables de entorno en los sistemas operativos UNIX . . . . . . . . . . . . . . 12 Establecimiento del directorio de trabajo . . . . . . . . . . . . . . . . . . . . . . . 12 Utilización de las variables de entorno para determinar los nombres de host de las aplicaciones 13 Inicio de Tivoli Universal Agent y de sus proveedores de datos. . . . . . . . . . . . . . . . 14 Especificación de proveedores de datos . . . . . . . . . . . . . . . . . . . . . . . 15 Especificación de parámetros de inicio en los sistemas operativos Windows . . . . . . . . . . 15 Especificación de parámetros de inicio en los sistemas operativos UNIX . . . . . . . . . . . 16

© Copyright IBM Corp. 2003, 2007

iii

Capítulo 3. Creación de una aplicación . . . . . . . . . . . . . . . . . . Introducción a la aplicación de Tivoli Universal Agent . . . . . . . . . . . . . . Creación de una aplicación de Tivoli Universal Agent . . . . . . . . . . . . . . Construcción de un metarchivo de definición de datos . . . . . . . . . . . . . . Denominación de metarchivos . . . . . . . . . . . . . . . . . . . . . . Creación de ayuda para aplicaciones, grupos de atributos y atributos . . . . . . . Almacenamiento de metarchivos . . . . . . . . . . . . . . . . . . . . . Validación de las definiciones de datos . . . . . . . . . . . . . . . . . . . Ejecución del programa de validación . . . . . . . . . . . . . . . . . . . Ejemplo de salida de informe de validación . . . . . . . . . . . . . . . . . Activación de metarchivos . . . . . . . . . . . . . . . . . . . . . . . . Activación de metarchivos mediante mandatos de consola . . . . . . . . . . . Activación de metarchivos mediante los mandatos de Actuación . . . . . . . . . Activación de metarchivos con un archivo de configuración . . . . . . . . . . . Creación de un servidor de metarchivos . . . . . . . . . . . . . . . . . . . Designación de un servidor de metarchivos . . . . . . . . . . . . . . . . . Almacenamiento de metarchivos de servidor . . . . . . . . . . . . . . . . Determinación de los roles de cliente y servidor en el mismo host . . . . . . . . Sincronización del servidor y el cliente de metarchivos . . . . . . . . . . . . . Alteración temporal de la definición central de metarchivo . . . . . . . . . . . Interacción con otros componentes de IBM Tivoli Monitoring . . . . . . . . . . . Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent . . . . . . . . Incremento del número de versión y de los números de modificación . . . . . . . Otras versiones de los sistemas gestionados, espacios de trabajo y grupos de atributos Cambios que no afectan al número de modificación o de versión . . . . . . . . . Cambios que afectan al número de modificación (cambios de menor importancia) . . Cambios que afectan al número de versión (cambios de gran importancia) . . . . . Restablecimiento de los números de versión . . . . . . . . . . . . . . . . Aplicaciones SNMP de Tivoli Universal Agent . . . . . . . . . . . . . . . . . Nombres de metarchivos . . . . . . . . . . . . . . . . . . . . . . . . Ubicación de los metarchivos SNMP . . . . . . . . . . . . . . . . . . . Importación de metarchivos SNMP . . . . . . . . . . . . . . . . . . . . Metarchivos SNMP sólo de condición de excepción . . . . . . . . . . . . . . Mantenimiento de versiones de aplicaciones . . . . . . . . . . . . . . . . Visualización de metarchivos de aplicaciones . . . . . . . . . . . . . . . . Creación de aplicaciones SNMP personalizadas . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17 17 17 17 19 19 20 20 21 21 21 21 22 24 25 25 25 25 26 26 26 27 27 27 28 28 29 29 32 33 33 34 34 34 34 35 37 37 37 38 41 41 41 42 42 43 43 43 44 44 44 44 45 45 45

Capítulo 4. Acerca de los proveedores de datos . . . . . . . . . . . . . . . . . . Visión general de los proveedores de datos . . . . . . . . . . . . . . . . . . . . . Tipos de proveedores de datos . . . . . . . . . . . . . . . . . . . . . . . . Ejecución de varias instancias de un proveedor de datos . . . . . . . . . . . . . . . Proveedor de datos de servidor de API . . . . . . . . . . . . . . . . . . . . . . Invocación de las API . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paquete de cliente de API . . . . . . . . . . . . . . . . . . . . . . . . . . Invocación de programas . . . . . . . . . . . . . . . . . . . . . . . . . . Mandatos de consola API . . . . . . . . . . . . . . . . . . . . . . . . . . Especificación del host del proveedor de datos de servidor de API . . . . . . . . . . . Especificación del puerto de escucha del proveedor de datos del servidor de API . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de servidor de API . Proveedor de datos de archivo . . . . . . . . . . . . . . . . . . . . . . . . . Ubicación del proveedor de datos de archivo . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados en las aplicaciones del proveedor de datos de archivo . . Frecuencia de muestreo de archivos . . . . . . . . . . . . . . . . . . . . . . Rutinas de extracción especiales . . . . . . . . . . . . . . . . . . . . . . . . Entrada de varios registros . . . . . . . . . . . . . . . . . . . . . . . . . . Supervisión de archivos globalizados . . . . . . . . . . . . . . . . . . . . . .

iv

IBM Tivoli Universal Agent: Guía del usuario

. . . . . . . . . . . . . . . . . . . . . Autentificación de script . . . . 63 . . . . . . . . . . . 70 . . . . Metarchivos ODBC de muestra . . . . . . . . . . . . . 80 . . . . . . . . . . . . . . . . . . . . Utilización del proveedor de datos de script . . . . . . . . Proceso de un archivo desde el principio . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de script . . . 76 . . 102 . . . . . . . . . . . . . . . . . . . . . . . . . . 70 . . . 74 . . . . . Personalización de las especificaciones en tiempo de ejecución del proveedor de datos de envío Datos suministrados por el proveedor de datos de envío . . . . 64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . El programa KUMPSEND . . 74 . . . . . . . . 67 . . . . . . . . . . . . . . . . . . . . . . . 69 . . . . . . Proveedor de datos de script . . . . . . . . . 46 49 49 50 51 51 51 51 53 56 56 56 57 57 59 60 60 61 61 61 62 62 . . . . . . . . . . . . . . . . . Variables de entorno de script . . . . . . Proveedor de datos de SNMP . . . . . . . Supervisión de un URL . . . . . . . . . . . . . . Supervisión de las aplicaciones SNMP . . . 108 . . 67 . . . . . . . 75 . . . . . . . . . . . . . . . . . . Generación automática de metarchivos ODBC . . . . . 64 . . . . . . . . . 78 . . . Características del proveedor de datos de SNMP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de ODBC . . . . . . . . . . . . . . . . . . . . . . . 71 . . . . . . . . . . . . . . . . . . . . Modificación del puerto de escucha predeterminado . . . . . . . . . . . . . . . . . . . . . Inicio del proveedor de datos de SNMP . . . . . . . . . . . 72 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Contenido v . . . . . . 77 . . . . . . . Establecimiento de contacto con el proveedor de datos de socket . . . . Proveedor de datos de socket . . Inicio del proveedor de datos de ODBC . . . . . . . . Especificación de nombres de comunidad . . . . . . . . . . . . . 66 . . . . . . . . Asociación de fuentes de datos con metarchivos . . . . . . . Espacio de archivo preasignado . . . . . . . . . . . . . . . . . . 66 . . . . Modalidades de ejecución de script . . . . . . . . . Nombre de sistema gestionado de la aplicación de proveedor de datos de HTTP . . . . . . 71 . 74 . . . . . . . . . . . . . . . . . . Varias máquinas host . . . . . . . . . . . . . . . . . . Nombre de sistema gestionado de la aplicación de proveedor de datos de envío . . . 71 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Metarchivos de script . . . . . . . . Tiempos de espera excedidos de los scripts . . . . . . . . . . . . . . . Categorías de mensajes . . . . . . . . . Personalización del proveedor de datos de envío con el metarchivo KUMPOST . . . . . . . . . . . 102 . . . . . . . . . . . . . 101 . Envío de condiciones de excepción de SNMP al proveedor de datos . . 102 . . Asignación de nombres de red simbólicos . . . . . . . . . . . . . . . . . . . . . . . Proveedor de datos de envío . . . . . . . . . . . . 100 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Conversión de nombres de host y de direcciones TCP/IP . . . . . . . . . . . Atributos de URL . . . . Directorio de scripts . . . . . . . . . . . . . . Formato de un almacenamiento intermedio de sockets para la transmisión . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de las aplicaciones del proveedor de datos de SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Envío de datos al proveedor de datos de envío . . . . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de socket . . . . . . 102 . . . . . . . . . . . . . . . . . . . Manejo de errores de script . . . . . . . . . . . . . . Inicio del proveedor de datos de HTTP . . . . . . . . . . . . . Indicación de reconocimiento . . . . . . . . . . . Códigos de retorno . . . . . . . . . . . . . . . . . Proveedor de datos de ODBC . . . . . . . . . . . . Opciones adicionales de supervisión de archivos . . . . . . . . . Aplicación SNMP-MANAGER . . . . . . . . . . . . . . . . . . . 67 . 108 . . . . . . . . . . . . . . . . . 78 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Metarchivo de ejemplo de script . . . . . . . . . . . . . . 103 . . . . . . . Parámetros y sentencias . . . . . . . . . . Proveedor de datos de HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Soporte de nombres de archivo dinámicos . . . . . . . . . . . . Ubicación del proveedor de datos de script . . . . . Configuración predeterminada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tiempo de espera excedido . . . . . . .

Envío de mandatos de acción a clientes de socket . Registro CLEAR-PRIOR-DATA . . . . . . . . Fin de sesión de la entrada de datos . . . . . . Conversión de código de caracteres . . . . . . Utilización del formato de caracteres para los datos Detección de interrupciones TCP . . . . . . . Retraso de la notificación de desconexión TCP . . Reconocimiento de datos . . . . . . . . . . Limitaciones del proveedor de datos de socket . .

. . . . . . . . . . . . . . . . numéricos . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

108 109 109 109 110 110 111 111 111 113 113 113 114 114 114 115 115 115 116 116 116 117 117 117 118 119 119 119 120 120 120 121 121 121 123 123 124 124 124 124 125 125 125 129 129 130 130 130 130 131 131 131 131

Capítulo 5. Supervisión de aplicaciones . . . . . . . . . Supervisión de los datos de Tivoli Universal Agent . . . . . . Sistemas gestionados por Tivoli Universal Agent . . . . . . Nombres de sistemas gestionados . . . . . . . . . . . Truncamiento de los nombres de sistemas gestionados . . . Números de versión de sistemas gestionados . . . . . . Cambios de versión de sistemas gestionados . . . . . . Espacios de trabajo de aplicaciones . . . . . . . . . . . Física . . . . . . . . . . . . . . . . . . . . . Lógica . . . . . . . . . . . . . . . . . . . . . Personalización del contenido de espacios de trabajo . . . . Acceso a la ayuda para grupos de atributos y atributos . . . Espacios de trabajo UAGENT . . . . . . . . . . . . . Nombres de sistemas gestionados de UAGENT . . . . . . Espacio de trabajo DPLOG . . . . . . . . . . . . . Espacio de trabajo ACTION . . . . . . . . . . . . . Situaciones de Tivoli Universal Agent . . . . . . . . . . . Acerca de las situaciones predefinidas . . . . . . . . . Utilización de situaciones . . . . . . . . . . . . . . Nombres de atributos y grupos de atributos . . . . . . . Creación de situaciones con atributos de distintos grupos . . Distribución de situaciones a sistemas gestionados . . . . Intervalo de situación y valor de tiempo de vida (TTL) . . . Reglas especiales para conjuntos de muestras de varias filas Recopilación de datos históricos . . . . . . . . . . . . Capítulo 6. Introducción al emisor de SNMP . . . . . . Visión general del emisor de SNMP . . . . . . . . . . Variables de entorno del emisor de SNMP . . . . . . . Instalación e integración del emisor de SNMP . . . . . . Instalación del emisor de SNMP . . . . . . . . . . Integración del emisor de SNMP en soluciones de terceros Visualización de los datos del emisor de SNMP . . . . . Utilización del emisor de SNMP y sus datos . . . . . . . Establecimiento de los parámetros del emisor de SNMP . Apéndice A. Sentencias Introducción . . . . . Sentencia SNMP . . . Descripción . . . . Sintaxis . . . . . Parámetro . . . . . Sentencia APPL . . . Descripción . . . . Sintaxis . . . . . Parámetros . . . . de control de definición . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . de . . . . . . . . . datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

vi

IBM Tivoli Universal Agent: Guía del usuario

Sentencia NAME . . . . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Grupos de atributos invisibles . . . . Sentencia SOURCE . . . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Sentencia INTERNAL . . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Sentencia RECORDSET . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Delimitadores de atributos ausentes . . Sentencia CONFIRM . . . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Sentencia SQL . . . . . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Sentencia SUMMARY . . . . . . . . Descripción . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Ejemplo 1 . . . . . . . . . . . . Ejemplo 2 . . . . . . . . . . . . Ejemplo 3 . . . . . . . . . . . . Número total de un intervalo de resumen Ejemplo 4 . . . . . . . . . . . . Creación de nuevos atributos . . . . Ejemplo 5 . . . . . . . . . . . . Sentencia ATTRIBUTES . . . . . . . Sintaxis . . . . . . . . . . . . Parámetros . . . . . . . . . . . Ejemplos de metarchivos . . . . . . . Ejemplo 1 de metarchivo . . . . . . Ejemplo 2 de metarchivo . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

134 134 134 134 138 140 140 140 140 150 150 150 150 153 153 153 153 156 157 157 157 157 158 158 158 158 159 159 159 159 160 161 161 162 162 163 163 164 164 164 167 167 167 169 169 169 169 169 177 177 178 178 179 179 180

Apéndice B. Definiciones de atributos . . . . . . . . . . Definición de atributos . . . . . . . . . . . . . . . . . Descripción . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . Exploración de las características de los atributos . . . . . . . Duplicación de atributos . . . . . . . . . . . . . . . Atributos invisibles . . . . . . . . . . . . . . . . . Truncamiento por la izquierda de atributos de visualización . . Derivación de atributos . . . . . . . . . . . . . . . . . Atributos derivados incorporados como números reales . . . . Concatenación de cadenas de caracteres de atributos derivados

Contenido

vii

Funciones de atributos derivados . . Filtrado de atributos . . . . . . . . Sintaxis . . . . . . . . . . . Descripción . . . . . . . . . . Secuenciado de definiciones de atributos

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

180 181 182 182 186 191 191 191 191 191 192 193 193 194 194 194 194 194 194 195 195 196 196 196 196 197 197 197 197 197 197 198 198 198 198 198 198 198 198 199 199 200 200 200 200 200 200 200 200 202 202 202 202 202 202

Apéndice C. Atributos de SNMP . . . . . . . . . . Acerca de los atributos y los grupos de atributos . . . . Correlación de variables MIB con atributos . . . . . Denominación de grupos de atributos . . . . . . . Determinación de las características de los atributos . . Grupos de atributos MIB-2. . . . . . . . . . . . Dónde encontrar más información acerca de los atributos Grupos de atributos SNMP-MANAGER . . . . . . . Grupo de atributos MANAGED-NODES . . . . . . . . Address . . . . . . . . . . . . . . . . . . Current_Response_Time_ms . . . . . . . . . . . Name . . . . . . . . . . . . . . . . . . . Node_Description . . . . . . . . . . . . . . . Node_Status . . . . . . . . . . . . . . . . . Node_Type . . . . . . . . . . . . . . . . . Status_TimeStamp . . . . . . . . . . . . . . Grupo de atributos MIBNODATA . . . . . . . . . . Enterprise_Module . . . . . . . . . . . . . . No_Data_Tables . . . . . . . . . . . . . . . Node_Name . . . . . . . . . . . . . . . . . Grupo de atributos MIBSTATUS. . . . . . . . . . . Attribute_Group . . . . . . . . . . . . . . . . Enterprise . . . . . . . . . . . . . . . . . . Monitor_Agent_Info . . . . . . . . . . . . . . Monitor_Interval . . . . . . . . . . . . . . . Last_Sample_TimeStamp . . . . . . . . . . . . Grupo de atributos NETSUMMARY . . . . . . . . . Active_Nodes . . . . . . . . . . . . . . . . Curr_RespTime_ms . . . . . . . . . . . . . . Inactive_Nodes . . . . . . . . . . . . . . . . Managed . . . . . . . . . . . . . . . . . . Max_RespTime_ms . . . . . . . . . . . . . . Min_RespTime_ms . . . . . . . . . . . . . . Network_Address . . . . . . . . . . . . . . . Network_Mask . . . . . . . . . . . . . . . . Network_Routers . . . . . . . . . . . . . . . Grupo de atributos NETWORK . . . . . . . . . . . Address . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . Location . . . . . . . . . . . . . . . . . . Name . . . . . . . . . . . . . . . . . . . SNMP_Enabled . . . . . . . . . . . . . . . Status . . . . . . . . . . . . . . . . . . . Type . . . . . . . . . . . . . . . . . . . . Grupo de atributos ROUTER . . . . . . . . . . . . Destination_Networks . . . . . . . . . . . . . Route_Count. . . . . . . . . . . . . . . . . Router_Address . . . . . . . . . . . . . . . Router_Description . . . . . . . . . . . . . . Router_Name . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . MIB-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

viii

IBM Tivoli Universal Agent: Guía del usuario

Router_Status . . . Grupo de atributos TRAP Alert_Name . . . . Category . . . . . Description . . . . Enterprise_Name . . Generic_Trap . . . Object ID . . . . . Severity . . . . . Source_Name . . . Source_Status . . . Source_Type. . . . Specific_Trap . . . Time_Stamp . . . . Value_List . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

202 204 204 204 204 204 205 205 205 205 205 205 206 206 206 207 207 207 207 208 208 208 208 210 210 210 210 211 211 211 211 212 214 214 214 215 215 215 215 216 216 216 217 217 217 218 218 218 219 219 219 220 220 220 221

Apéndice D. Mandatos de consola . . . . . . . . . . . . . . . . . . . Utilización de mandatos de consola . . . . . . . . . . . . . . . . . . . Invocación de la interfaz de mandatos de consola en el sistema operativo Windows Invocación de la interfaz de mandatos de consola en los sistemas operativos UNIX Especificación de nombres de metarchivo y de aplicación en los mandatos . . . Sistemas de varias interfaces . . . . . . . . . . . . . . . . . . . . Códigos de retorno . . . . . . . . . . . . . . . . . . . . . . . . Envío de mandatos de consola a una instancia de Tivoli Universal Agent alternativa DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilización . . . . . . . . . . . . . . . . . . . . . . . . . . . . GENERATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . Ejemplos . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilización . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . Salida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOADCOMM. . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . LOADLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . LOADNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . MNL ADD NODE . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . MNL REMOVE NODE . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parámetros . . . . . . . . . . . . . . . . . . . . . . . . . . . REFRESH . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contenido

ix

Sintaxis . Parámetros Utilización . SET . . . . Sintaxis . Parámetros SHOW . . . Sintaxis . Parámetros Mensajes . SHUTDOWN. Sintaxis . Parámetros TRAPCNFG . Sintaxis . Parámetros UNPACK . . Sintaxis . Parámetros VALIDATE. . Sintaxis . Parámetros

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

221 221 221 222 222 222 223 223 223 223 224 224 224 225 225 225 226 226 226 227 227 227 229 229 229 229 229 232 232 232 233 233 234 234

Apéndice E. Configuración de condiciones de excepción de SNMP . . El archivo de configuración de condiciones de excepción de SNMP, trapcnfg Ubicación del archivo de configuración . . . . . . . . . . . . . Utilización del archivo trapd.conf de HP OpenView . . . . . . . . Tipos de registros . . . . . . . . . . . . . . . . . . . . . Valores predeterminados del archivo trapcnfg . . . . . . . . . . . Categorías soportadas . . . . . . . . . . . . . . . . . . . Estatus soportados . . . . . . . . . . . . . . . . . . . . ID de fuente soportados . . . . . . . . . . . . . . . . . . Modificación del archivo trapcnfg . . . . . . . . . . . . . . . . Modificación de las definiciones predeterminadas . . . . . . . . . Mandato de consola TRAPCNFG . . . . . . . . . . . . . . .

Apéndice F. Expresiones regulares ICU . . . . . . . . . . . . . . . . . . . . . . . 235 Texto de sustitución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Opciones de distintivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Apéndice G. Referencia de variables de entorno . . . . . . . . . . . . . . . . . . . 241 Tivoli Universal Agent y las variables de entorno del proveedor de datos . . . . . . . . . . . 241 Apéndice H. Actualización . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Actualización a la versión 6.2.0 de Tivoli Universal Agent . . . . . . . . . . . . . . . . . 255 Proceso de actualización . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Apéndice I. Inicio de proveedores de datos Inicio de los proveedores de datos. . . . . Programas de inicio . . . . . . . . . Entorno de ejecución . . . . . . . . Conexión con Tivoli Universal Agent . . . Secuencia de inicio . . . . . . . . . Detención de los proveedores de datos . . . El mandato SHUTDOWN . . . . . . . Retrasos en la terminación . . . . . . como procesos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . independientes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 257 257 257 258 259 259 260 260

x

IBM Tivoli Universal Agent: Guía del usuario

Sistema gestionado fuera de línea . . . . . . . . . . . . . . . . . . . . . . . . . 260 Apéndice J. Determinación de problemas . . . . Rastreo de Tivoli Universal Agent . . . . . . . . Valores de depuración especiales . . . . . . . Aplicación UAGENT . . . . . . . . . . . . . Espacio de trabajo DPLOG . . . . . . . . . Espacio de trabajo ACTION . . . . . . . . . Recopilación de la documentación correcta . . . . Lectura del registro de Tivoli Universal Agent . . . . Qué hay que buscar . . . . . . . . . . . . . Reconocimiento de un registro incorrecto . . . . . Categorías habituales de problemas . . . . . . . Problemas de condiciones de excepción de SNMP Errores de inicio de Tivoli Universal Agent . . . . Ninguna salida en el espacio de trabajo de portal . Datos personalizados no resumidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 261 261 262 262 263 263 265 265 268 269 269 271 273 276

Apéndice K. Accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Desplazamiento por la interfaz mediante el teclado . . . . . . . . . . . . . . . . . . . 279 Ampliación de lo que aparece en la pantalla . . . . . . . . . . . . . . . . . . . . . . 279 Apéndice L. Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 Marcas registradas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 Índice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

Contenido

xi

xii IBM Tivoli Universal Agent: Guía del usuario .

. . . . . . . . . . . metarchivos y proveedores de datos . . . . . . . . . . . . . . Metarchivo de definición de datos KUMPOST . . . . . . . . . . . . . Ejemplos de tipos de registros de configuración 2 y 3 . . . . . . . . . . . . . . . 22 6.MDL . . Rol del proveedor de datos de socket. Implementación del Proveedor de datos del servidor de API . . . . . . . . . . . . . 37 9. . . . 2007 xiii . . . . 36 8. . . . . . 212 14. .MDL . . . . . . . . . . . . . Ejemplo de un archivo de proveedor de datos . . . . . . . . . . . . . Funcionamiento de Tivoli Universal Agent . . . . . 6 4. . . . . . . . Especificación de acceso de escritura en la definición de variable MIB-2 . . . Relación entre las fuentes de datos. . . . 42 10. . . . . . . . 231 © Copyright IBM Corp. . . . . . . . . . . . . . . . . . . . . . . . 3 2. . . . . . . . . 98 12. . . . . . . . . . . . . . . . . . . . . . 61 11. . . . . 19 5. . . . . Ejemplo de KUMPCON GENERATE (en inglés) . . 4 3. . . . . . . . . . . . . . . . . . . . Ejemplo de metarchivo NTLOG. . . . Flujo de datos de Tivoli Universal Agent e interrelaciones con otros componentes clave de IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . . . . . . . Activación de metarchivos . . . . . . . Metarchivo de aplicación SNMP personalizado . . . 24 7. 101 13. . . . 2003. . . . . .Figuras 1. . . . Creación de un metarchivo de definición de datos: ejemplo TCPIOQ. . . . . . . .

xiv IBM Tivoli Universal Agent: Guía del usuario .

. . . 239 Variables de entorno de Tivoli Universal Agent . . . . . . . . 32. 19. . . . . 85 Columnas del espacio de trabajo MIBSTATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 Columnas del espacio de trabajo DPLOG . . . . . . 25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Variables de entorno del proveedor de datos de envío . . . . . . . . . . . . 2. . 11. . . . . . . 21. . . . . . . . . . . . . . . . . . 20 Numeración de versiones. . . . . . . . . . . . . . . 75 Columnas del espacio de trabajo MANAGED-NODES . Proveedores de datos de Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . . . . . . 257 © Copyright IBM Corp. . . . . . . . . . . . . 87 Columnas del espacio de trabajo ROUTER . . . . . . . . . 233 Metacaracteres de expresiones regulares . . . . 35. . . 22. . . . . . . . . . . . . . . . . . . . . . . . 2007 xv . . . . . . . 13. . . . . . . . . . . . . . . . . 20. . . . . . . . . 4. . . . . 15. . . . . . . . . . 118 Columnas del espacio de trabajo ACTION . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Opciones de distintivo . . . . . . . . 232 IDs de fuente que soporta el Proveedor de datos de SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Columnas del espacio de trabajo TRAP . . . . . . 8. . 27. . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Nombre y ubicación del archivo de variables de entorno en función del sistema operativo . . . . . . . . . . . . . . . . 183 Tabla de conversión de ASN. . . . . . . . . 12 Ubicación predeterminada de los metarchivos . . 69 Formatos de nombres de sistemas gestionados . . . . . . . . . . . . . 60 Categorías de mensajes del proveedor de datos de envío . . . . . . . . . . 18. 54 Atributos MAS del proveedor de datos de envío . . . . . . . . . 26. . . . . . . . . . . . . . 39. . . 53 Objetos URL . . . . . 31. . . . . . . . . . . . . . 24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23. 86 Columnas del espacio de trabajo NETSUMMARY . . . . . . . . . . . . . . . . . . . . . . 86 Columnas del espacio de trabajo NETWORK . . . . . 7. 180 Características de funciones de filtro . . . . . . . . . . . . . . . . 28 Atributos de URL . . . . . . . . . . . . . . . . . . 235 Operadores de expresiones regulares . . . 88 Situaciones proporcionadas por el producto . . 34. . . . 9. 232 Estatus soportados por el Proveedor de datos de SNMP . . . . 16. . . . . . 241 Inicio de proveedores de datos . . . . 29. . . . . . 236 Caracteres del texto de sustitución . . . . . . . . . . . . . . . . . . . . 10. . . . . 5. . . . . . . . . . . . . . . . . . . . . . . 232 Niveles de gravedad soportados por el Proveedor de datos de SNMP . . . . . 37. . . . . . . . . . . 28. . . . . .1 a tipos de IBM Tivoli Monitoring . . . . . . . 3. . . . . . 85 Columnas del espacio de trabajo MIBNODATA . . . . 119 Valores predeterminados para diferentes tipos de atributos . . . . . . 191 Resumen de los mandatos de consola . . . . 36. . . . . . . . . . . . . . . . . . . 117 Categorías del espacio de trabajo DPLOG . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 Variables de entorno generadas . . . . . . . . . . 6. . . 209 Categorías soportadas por el Proveedor de datos de SNMP . . . . 2003. . 30.Tablas 1. . . . . . . . 2 Proveedores de datos preferidos . . . . . 17. . . 14. . . . 38. . . . . . . . 95 Sistemas gestionados por Tivoli Universal Agent . . . . . . . . 12. . . . . . . 33. 171 Descripciones de funciones de atributos derivados . .

xvi IBM Tivoli Universal Agent: Guía del usuario .

un agente de IBM Tivoli Monitoring.Acerca de esta publicación La publicación IBM Tivoli Universal Agent . Está diseñada para complementar la ayuda en línea de Tivoli Enterprise Portal que se proporciona con Tivoli Universal Agent y Tivoli Enterprise Portal. y sobre la actualización de OMEGAMON V350 o V360.Guía de instalación y configuración. Biblioteca de IBM Tivoli Monitoring Los siguientes documentos proporcionan información sobre el producto IBM Tivoli Monitoring: v IBM Tivoli Monitoring . v Configuring IBM Tivoli Enterprise Monitoring Server on z/OS.Guía del usuario es una introducción a Tivoli Universal Agent. de la preparación y definición de los datos que hay que enviar a Tivoli Universal Agent. GC32-9458 Proporciona información y mensajes para ayudar a los usuarios en la resolución de problemas del software. v IBM Tivoli Monitoring . Después de completar las actividades descritas en este libro de trabajo. de la creación de programas y scripts para recopilar datos o de la supervisión de datos de Tivoli Universal Agent utilizando Tivoli Enterprise Portal. A quién va destinada Esta guía está diseñada para los responsables de la configuración de Tivoli Universal Agent y sus proveedores de datos. SC11-3111-01 Complementa la ayuda en línea de Tivoli Enterprise Portal. Tivoli Universal Agent permite utilizar las características de supervisión y automatización de IBM Tivoli Monitoring para supervisar cualquier tipo de datos que se recopile. v IBM Tivoli Monitoring .Guía del usuario.Guía del usuario. el usuario habrá instalado y configurado su entorno.Guía del administrador. GC11-3605-01 Proporciona información sobre la instalación y configuración de IBM Tivoli Monitoring. habrá utilizado muchas de las nuevas características de este release de IBM Tivoli Monitoring (como crear un supervisor basándose en un script personalizado) y habrá trabajado con varios agentes de supervisión. así como los temas tratados en la publicación Tivoli Enterprise Portal Administrator’s Guide. v IBM Tivoli Universal Agent . v IBM Tivoli Monitoring Problem Determination Guide. SC32-9463 Describe cómo configurar y personalizar el servidor de Tivoli Enterprise Monitoring que se ejecuta en z/OS. habrá explorado las interfaces gráficas y de línea de mandatos del producto. v Exploración de IBM Tivoli Monitoring. Publicaciones Este apartado lista las publicaciones de la biblioteca de Tivoli Universal Agent. 2003. SC11-3606-01 Describe las tareas y las funciones de soporte necesarias para el servidor de Tivoli Enterprise Portal y los clientes. SC11-3155 Proporciona una serie de ejercicios que ayudan a los usuarios a explorar IBM Tivoli Monitoring. Esta guía está pensada para proporcionar la información necesaria para utilizar Tivoli Universal Agent e IBM Tivoli Monitoring para supervisar datos definidos por el usuario. La guía proporciona lecciones prácticas e instrucciones detalladas para todas las funciones de Tivoli Enterprise Portal. incluida la administración de usuarios de Tivoli Enterprise Portal. SC11-3144 © Copyright IBM Corp. También describe cómo acceder a las publicaciones de Tivoli en línea y cómo realizar pedidos de publicaciones de Tivoli. 2007 xvii .

un agente de IBM Tivoli Monitoring. Tivoli Universal Agent permite utilizar las funciones de supervisión y automatización de IBM Tivoli Monitoring para supervisar cualquier tipo de datos que se recopile. y proporciona descripciones. Permite que los datos recopilados por los puntos finales de IBM Tivoli Monitoring V5. El formato de las publicaciones es PDF. en cuanto están disponibles y siempre que se actualizan.com/infocenter/tivihelp/v3r1/index.boulder. HTML o bien ambos.1. Solicitud de publicaciones Puede solicitar en línea muchas de las publicaciones de Tivoli en la siguiente página web: http://www. Consulte el archivo readme en el CD para obtener instrucciones sobre cómo acceder a la documentación.x Endpoint Agent amplía las características de IBM Tivoli Monitoring V5.2. SC11-3680-01 Explica los procedimientos para implementar las API de Tivoli Universal Agent. documentos técnicos y otras informaciones útiles para los clientes de Tivoli. IBM Tivoli Open Process Automation Library (OPAL) Puede encontrar información adicional sobre Tivoli Universal Agent y otros productos de Tivoli en el sitio web de IBM Tivoli Open Process Automation Library (OPAL).com/wps/portal/tm.jsp. IBM pone a disposición de los usuarios los manuales correspondientes a éste y todos los demás productos de Tivoli.com/publications/servlet/pbi. Puede acceder al sitio web de terminología en la siguiente dirección web: http://www.com/software/globalization/terminology Acceso a las publicaciones en línea El CD de documentación contiene las publicaciones que están en la biblioteca del producto.Ofrece una introducción a Tivoli Universal Agent.ibmlink. Para acceder a las publicaciones mediante un navegador web.lotus. que contiene muchas soluciones de supervisión de Tivoli Universal Agent.htm El sitio web de terminología de IBM consolida la terminología de las bibliotecas de productos de IBM en una sola ubicación conveniente. HTML o bien ambos.ibm. en el siguiente sitio web del centro de información de Tivoli: http://publib.ibm.com/tividd/glossary/tivoliglossarymst. El archivo se encuentra en el directorio de publicaciones correspondiente en el CD del producto.2 desplegados aparezcan en Tivoli Enterprise Portal y se almacenen en Tivoli Data Warehouse.ibm.ibm.elink. Acceso a la terminología en línea El Glosario de software de Tivoli incluye definiciones de muchos de los términos técnicos relacionados con el software de Tivoli. El formato de las publicaciones es PDF. establezca la opción de la ventana Archivo → Imprimir que permite que Adobe® Reader imprima páginas de tamaño carta en el tamaño de papel disponible. El CD del producto contiene las publicaciones que están en la biblioteca del producto.x Endpoint Agent User’s Guide IBM Tivoli Monitoring 5.html. v IBM Tivoli Monitoring: IBM Tivoli Monitoring 5. El Glosario de software de Tivoli está disponible en el siguiente sitio web de la biblioteca de software de Tivoli: http://publib. Nota: Si imprime documentos en formato PDF en un papel que no sea de tipo carta (letter).Guía de consulta de programación de API y de mandatos. sintaxis y códigos de estado de retorno de las llamadas a las API y de los mandatos de interfaz de línea de mandatos. abra el archivo infocenter. v IBM Tivoli Universal Agent .wss xviii IBM Tivoli Universal Agent: Guía del usuario .1.boulder. La dirección web es: http://catalog.

así como mandatos y vías de acceso que dependen del sistema operativo. a utilizar satisfactoriamente los productos de software. como puede ser de movilidad o de visión. Ayuda para la determinación de problemas Para obtener más información sobre la resolución de problemas.elink.ibm. realice los pasos siguientes: 1. Con este producto. También se puede usar el teclado en lugar del ratón para utilizar todas las funciones de la interfaz gráfica de usuario. deseará resolverlo rápidamente.com/software/tivoli/education/ Información de soporte Si tiene un problema con el software de IBM. consulte el siguiente sitio web de formación de IBM Tivoli: http://www. Convenios empleados en esta guía Esta guía utiliza varios convenios para términos y acciones especiales. Para localizar el número de teléfono del representante local. 2. Acerca de esta publicación xix . Vaya a: http://www.html y siga las instrucciones.ibm. 3. consulte el apéndice sobre accesibilidad de la guía del usuario de este producto. Formación técnica de Tivoli Para obtener información sobre la formación técnica de Tivoli.ibm. IBM proporciona los siguientes métodos para obtener el servicio de soporte que necesite: En línea Acceda al sitio web de soporte de IBM en http://www. ISA ofrece acceso rápido a las herramientas de prestación de servicios e información relacionada con el soporte para determinar los problemas.cgi.com/software/support/probsub. Para instalar el software ISA.También es posible solicitarlas por teléfono llamando a uno de estos números: v En los Estados Unidos: 800-879-2755 v En Canadá: 800-426-4968 En el resto de países. vea la información de determinación de problemas de este producto. Accesibilidad Las funciones de accesibilidad ayudan a los usuarios con alguna discapacidad física. que ayuda al usuario a resolver cuestiones y problemas relacionados con los productos de software de IBM. Seleccione su país en la lista y pulse Go (Ir).ibmlink.ibm.com/public/applications/publications/cgibin/pbi. se pueden utilizar tecnologías de asistencia para escuchar y desplazarse por la interfaz. IBM Support Assistant IBM Support Assistant (ISA) es un entorno de trabajo de prestación de servicios de software local libre.com/software/support/isa. Pulse About this site (Acerca de este sitio) en el panel principal para ver una página de información que incluye el número de teléfono del representante local. póngase en contacto con el representante de la cuenta de software para solicitar las publicaciones de Tivoli. Para obtener información adicional. visite la página web: http://www.

Por ejemplo. campos. Indica que se pueden especificar varios valores para el elemento anterior. y sustituya cada barra inclinada (/) por una barra inclinada invertida (\) en las vías de acceso del directorio. Sintaxis de mandatos de Tivoli Los siguientes caracteres especiales definen la sintaxis de mandatos de Tivoli: [] . xx IBM Tivoli Universal Agent: Guía del usuario . a menos que se indique lo contrario en la información del mandato... iconos. Si los puntos suspensivos correspondientes a un elemento van a continuación de un corchete de cierre. recuadros de lista. Por ejemplo. nombres de menús. carpetas. listas de varias columnas. pulsadores. separadores. botones de selección.... Consejo: y Consideraciones sobre el sistema operativo:) v Palabras clave y parámetros del texto Cursiva v Palabras definidas en el texto v Énfasis en palabras (por ejemplo ″Utilice la palabra that para introducir una cláusula restrictiva″). Nota: Si va a utilizar el shell bash en un sistema Windows.]. Los elementos obligatorios no se encuentran entre corchetes. palabras clave de programación y otros elementos que resulten difíciles de distinguir del resto del texto v Texto de mensajes y solicitudes dirigidas al usuario v Texto que el usuario deba escribir v Valores para argumentos u opciones de mandatos Variables y vías de acceso que dependen del sistema operativo Las publicaciones de esta biblioteca utilizan el convenio UNIX para especificar variables de entorno y para la notación de directorios. elementos de recuadros de lista. Por ejemplo. opciones de menús. para especificar dos hosts para la opción [ –h host. sustituya $variable por %variable% para las variables de entorno. Los nombres de variables de entornos no son siempre los mismos en los entornos Windows y UNIX. puede utilizar los convenios de UNIX. para especificar dos administradores para la opción [–a admin]. etiquetas (por ejemplo. utilice la sintaxis del interior de los corchetes para especificar varios valores. hojas de propiedades). selectores cíclicos. contenedores. Separe los distintos valores mediante un espacio. Cuando utilice la línea de mandatos de Windows. utilice –a admin1 –a admin2.Convenios de tipo de letra En esta guía se utilizan los siguientes convenios sobre los tipos de letra: Negrita v Mandatos en minúsculas y mandatos en mayúsculas y minúsculas que de otro modo resultan difíciles de distinguir del resto del texto v Controles de interfaz (recuadros de selección.. utilice la sintaxis del último elemento para especificar varios valores. utilice –h host1 host2. Identifica elementos opcionales. Si los puntos suspensivos correspondientes a un elemento están dentro de los corchetes. %TEMP% en los entornos Windows es equivalente a $TMPDIR en los entornos UNIX.. v Términos nuevos en el texto (excepto en una lista de definiciones) v Variables y valores que el usuario deba proporcionar Monoespaciado v Códigos y otros ejemplos v Nombres de archivos.

Delimita un conjunto de elementos mutuamente excluyentes cuando un mandato necesita uno de estos elementos. Las llaves indican que el elemento que contienen es obligatorio. la sintaxis de mandatos de Tivoli utiliza los convenios de tipo de letra que se describen en “Convenios de tipo de letra” en la página xx. –i y objeto son mutuamente excluyentes.. v wchkdb [–o archivo_salida] [–u] [–x] {–f archivo_entrada | –i | objeto.| {} Indica información mutuamente excluyente. Los puntos suspensivos que van a continuación de la opción –a admin indican que se pueden especificar varios administradores varias veces.} Los elementos –f.... Los siguientes ejemplos muestran los convenios de tipo de letra utilizados en la sintaxis de mandatos de Tivoli: v wcrtpr [–a admin]. nombre El argumento nombre es el único elemento obligatorio para el mandato wcrtpr. Los corchetes indican que las opciones que contienen son opcionales. Los puntos suspensivos que van a continuación de la opción –m recurso indican que se pueden especificar varios recursos varias veces. [–s región] [–m recurso]. Además de los caracteres especiales. Puede utilizar la opción de la izquierda o de la derecha de la barra vertical. podrá especificar más de un objeto. Si especifica el argumento objeto. Acerca de esta publicación xxi .. Los elementos opcionales se incluyen entre corchetes ([ ])..

xxii IBM Tivoli Universal Agent: Guía del usuario .

jsp?topic=/com.ibm. Tivoli Universal Agent utiliza las sentencias de metarchivos para generar dinámicamente y subir archivos de definiciones de aplicaciones. llamadas a la API. Tivoli Universal Agent es el agente genérico de IBM Tivoli Monitoring. que a su vez envía los datos de supervisión al servidor de Tivoli Enterprise Monitoring (servidor de supervisión). que representan las definiciones que se han suministrado en el metarchivo. Tivoli Universal Agent proporciona las siguientes características adicionales: v Supervisa e informa acerca del estado de los proveedores de datos. puede proporcionar datos mediante un archivo secuencial. v Proporciona control sobre los atributos y la exteriorización de los datos. Aunque los proveedores de datos se ejecutan como subprocesos en el interior del proceso de Tivoli Universal Agent. Proporciona un punto único de gestión para todos los recursos de la empresa y protege la inversión en aplicaciones y recursos. subsistemas y redes. al servidor de supervisión y a Tivoli Enterprise Portal.Capítulo 1.itm.ibm.doc/welcome. 2007 1 . 2003. Los proveedores de datos permiten proporcionar datos a Tivoli Universal Agent de cualquier manera que resulte conveniente o práctica para un caso de supervisión particular. Puede configurar Tivoli Universal Agent para supervisar cualquier dato que recopile.Guía de instalación y configuración. Puede ver los datos en espacios de trabajo actuales e históricos en Tivoli Enterprise Portal y gestionar mediante la supervisión de Tivoli Enterprise Portal situaciones y políticas de automatización. scripts de shell. v Supervisa sólo aquellos atributos de datos que sean del interés del usuario. que puede encontrar aquí en el centro de información de Tivoli: http://publib. Por ejemplo.com/infocenter/tivihelp/v15r1/index. Al generar dinámicamente los archivos de definición de aplicación. UNIX y Linux. Por ejemplo.htm Funcionamiento de Tivoli Universal Agent Tivoli Universal Agent obtiene los datos a partir de interfaces denominadas proveedores de datos.boulder. bases de datos. Tivoli Universal Agent proporciona las siguientes características: v Integra datos de virtualmente cualquier sistema operativo y de cualquier fuente. Dichas definiciones de datos se almacenan en metarchivos. programa de sockets de TCP/IP. © Copyright IBM Corp. v Responde rápidamente a situaciones cambiantes de gestión y supervisión. Tivoli Universal Agent permite crear soluciones personalizadas de supervisión que funcionan como si fueran agentes de IBM Tivoli Monitoring normales. Para obtener una lista completa de los sistemas operativos soportados. aplicaciones personalizadas. Puede crear las definiciones de datos que describan la fuente y estructura de los datos proporcionados por los proveedores de datos. También presenta un caso simple que ilustra los pasos necesarios para implementar la supervisión con Tivoli Universal Agent utilizando el proveedor de datos de archivo. Tivoli Universal Agent amplía el rendimiento y capacidad de gestión de disponibilidad de IBM Tivoli Monitoring a aquellas aplicaciones y sistemas operativos que otros agentes de IBM Tivoli Monitoring no cubren. Los proveedores de datos transmiten los datos de supervisión y las sentencias de metarchivos a Tivoli Universal Agent. Visión general de Tivoli Universal Agent Este capítulo proporciona una introducción de alto nivel a Tivoli Universal Agent. es útil considerarlos como entidades independientes. consulte la publicación IBM Tivoli Monitoring . al igual que los datos de otros agentes de Tivoli Enterprise Monitoring. Tivoli Universal Agent se puede instalar en la mayoría de plataformas Windows. condiciones de excepción de SNMP o mandatos de consola. v Acepta y procesa las solicitudes de los proveedores de datos. sistemas.

Archivo. iniciado como un único subproceso para ahorrar en utilización de recursos. API. Consulte “Proveedor de datos de socket” en la página 100 para obtener información adicional. Socket. v Gestiona el control de versión de las definiciones de datos. incluidos el descubrimiento de red. Script (ASFS) Archivo HTTP ODBC Envío Script SNMP Socket 2 IBM Tivoli Universal Agent: Guía del usuario . servidor de Tivoli Enterprise Monitoring y Tivoli Enterprise Portal. Permite la recopilación de datos a partir de bases de datos que cumplan la norma ODBC utilizando sentencias Select de SQL y procedimientos almacenados. Permite la supervisión de URL de Internet acerca de su disponibilidad y tiempo de respuesta. Este es el proveedor de datos predeterminado al instalar Tivoli Universal Agent. alertas y estatus. Consulte “Proveedor de datos de HTTP” en la página 51 para obtener información adicional. Consulte “Proveedor de datos de servidor de API” en la página 41 para obtener más información. Puede especificar qué URL supervisar en un archivo de configuración de inicio o dentro de las situaciones de Tivoli Enterprise Portal.v Acepta las solicitudes de información de Tivoli Enterprise Portal acerca de la supervisión de espacios de trabajo y de sucesos. En la Figura 1 en la página 3 se muestra la relación entre los proveedores de datos. En la Tabla 1 se listan los proveedores de datos que están disponibles actualmente con Tivoli Universal Agent. Consulte “Proveedor de datos de ODBC” en la página 56 para obtener información adicional. Permite recopilar datos desde varios dispositivos remotos o sistemas para los que no existe soporte de API de Tivoli Universal Agent. v Distribuye solicitudes de automatización a los proveedores de datos. Permite enviar notificaciones ad hoc como mensajes. Consulte “Proveedor de datos de script” en la página 66 para obtener información adicional. Permite la recopilación de datos desde cualquier script o programa que envíe resultados a la salida estándar. Consulte “Proveedor de datos de archivo” en la página 44 para obtener información adicional. agentes de Tivoli Universal Agent. Aplicación de sockets de TCP/IP con datos predefinidos. Supervisa archivos secuenciales. Unifica los cuatro tipos de proveedores de datos en un único paquete. Consulte “Proveedor de datos de SNMP” en la página 74 para obtener información adicional. la supervisión de condiciones de excepción y la recopilación de datos MIB. Proporciona el método más directo y sencillo de recopilar datos. Proveedores de datos de Tivoli Universal Agent Tipo Servidor de API Descripción Permite recopilar datos de recursos en sistemas remotos donde el software cliente de la API de Tivoli Universal Agent está soportado. Escucha en un socket de TCP/IP los datos enviados utilizando comunicación de programa a programa. como registros del sistema o de mensajes. Proporciona la funcionalidad de un gestor de SNMP. Tabla 1. Consulte “Proveedor de datos de envío” en la página 60 para obtener más información.

al igual que la Fuente de datos D en un host remoto. Visión general de Tivoli Universal Agent 3 . la Fuente de datos A es un archivo de registro. Capítulo 1. se muestra una vista pictórica del flujo de datos de Tivoli Universal Agent y cómo se interrelaciona con los otros componentes clave de la plataforma de IBM Tivoli Monitoring. La Fuente de datos B es un programa en un host remoto que proporciona datos mediante un socket TCP/IP al proveedor de datos de socket. supervisado por el proveedor de datos de archivo. En la Figura 2 en la página 4.Figura 1. Funcionamiento de Tivoli Universal Agent En la Figura 1. La Fuente de datos C utiliza las API de Tivoli Universal Agent para enviar datos al proveedor de datos de servidor de API.

Definición de datos para Tivoli Universal Agent Indíquele a Tivoli Universal Agent qué datos desea supervisar creando una aplicación de Tivoli Universal Agent. Tivoli Universal Agent toma estas sentencias y genera los archivos CAT. que Tivoli Universal Agent importa. si los datos que desea supervisar ya están en un archivo secuencial y decide utilizar un proveedor de datos de archivo. mediante el uso de metarchivos. Inicie Tivoli Universal Agent y active uno o más de los Proveedores de datos. sólo necesitará crear un metarchivo que describa el diseño del archivo secuencial.Figura 2. De este modo. en la página 123). que supervisan y recopilan datos de la fuente de datos definida en el metarchivo. Flujo de datos de Tivoli Universal Agent e interrelaciones con otros componentes clave de IBM Tivoli Monitoring Para crear una aplicación de Tivoli Universal Agent. puede escribir un script o programa que preprocese los datos en estado puro y que los grabe como una serie de registros en un archivo secuencial que el proveedor de datos de archivo pueda supervisar utilizando un metarchivo. Si sólo desea utilizar un proveedor de datos de archivo. Suministro de datos a Tivoli Universal Agent Puede proporcionar datos a Tivoli Universal Agent de cualquier manera que sea conveniente y adecuada para sus necesidades y entorno. Por ejemplo. Tivoli Universal Agent también incluye una función de emisión de condiciones de excepción de SNMP controlada por una política (vea el Capítulo 6. pero los datos no están ya en un archivo secuencial. El metarchivo también incluye sentencias de definición de tabla y atributo. debe crear un metarchivo de definición de datos que describa los datos de la aplicación que desea recopilar. 4 IBM Tivoli Universal Agent: Guía del usuario . Una aplicación de Tivoli Universal Agent consta de uno o más grupos de atributos. que describen la aplicación ante el servidor de Tivoli Enterprise Monitoring y el servidor de Tivoli Enterprise Portal (servidor de portal). que constan cada uno de ellos de uno o más atributos. puede crear sus propias soluciones de supervisión de IBM Tivoli Monitoring. ATR y ODI. Defina la aplicación en un archivo de definición de datos llamado metarchivo. “Introducción al emisor de SNMP”.

Puede personalizar los espacios de trabajo y exportar los datos del espacio de trabajo a otras aplicaciones para su manipulación y presentación. Definición de la aplicación de Tivoli Universal Agent. Puede incluso crear situaciones complejas que combinen situaciones de Tivoli Universal Agent con situaciones de otros agentes de Tivoli Enterprise Monitoring. puede realizar lo siguiente: Ver datos actuales e históricos bajo demanda Cuando el servidor de Tivoli Enterprise Monitoring importa los datos y las definiciones de datos. Capítulo 1. 2. Desea además impedir que los usuarios suban datos al servidor que consuman grandes cantidades de espacio de disco. NTSRV1. Por ejemplo. puede ver los espacios de trabajo actuales o históricos para cada grupo de atributos que defina. 3. Programar respuestas automáticas a sucesos Puede crear políticas que respondan automáticamente a sucesos críticos.No obstante. Selección del proveedor de datos apropiado. Si MIB de SNMP no está disponible. si decide utilizar un proveedor de datos de servidor de API o de socket para supervisar los datos. Un caso de supervisión sencillo Este sencillo caso ilustra los pasos necesarios para implementar la supervisión con Tivoli Universal Agent: 1. Establecer alertas de sucesos Puede utilizar los atributos que defina para crear situaciones de Tivoli Enterprise Portal que alerten de problemas reales o potenciales que amenacen la disponibilidad o rendimiento de las aplicaciones y recursos. 4. Selección del proveedor de datos Un usuario desea supervisar la actividad del FTP en el servidor Windows. siempre que la ejecución de Tivoli Universal Agent no sea un requisito en dichos sistemas operativos. debe decidir que la solución más sencilla es utilizar el proveedor de datos de archivo. entonces el script del cliente de socket de TCP/IP o el programa pueden desarrollarse en el sistema operativo para recopilar y enviar datos a través de la red al proveedor de datos de socket. como OpenVMS o Tandem. Visión general de Tivoli Universal Agent 5 . Para poder configurar el servicio FTP de Windows para crear un archivo de registro. o crear un programa que envíe los datos mediante un socket al proveedor de datos de socket. Puede supervisar aplicaciones en entornos no soportados. Trabajo con los datos Después de que Tivoli Universal Agent importe el metarchivo y comience a recopilar datos. Consulte “Espacios de trabajo UAGENT” en la página 117 para obtener información adicional. Supervisar el estado de los proveedores de datos de Tivoli Enterprise Portal Tivoli Universal Agent proporciona espacios de trabajo que permiten supervisar el estado y funcionamiento de sus proveedores de datos y de las acciones automatizadas que soportan. Creación de situaciones de supervisión y políticas utilizando los atributos de aplicación de Tivoli Universal Agent. puede crear un programa que emita llamadas a la API de Tivoli Universal Agent para reenviar los datos directamente al proveedor de datos de servidor de API. ejecutando mandatos del sistema o programas de actividades complejas. Consulte “Espacios de trabajo de aplicaciones” en la página 115 para obtener información adicional. Consulte “Situaciones de Tivoli Universal Agent” en la página 119 para obtener información adicional. las soluciones SNMP no necesitan que Tivoli Universal Agent se esté ejecutando en el sistema operativo donde se encuentra el agente de SNMP. Preparación de la fuente de datos.

y especifica el método de supervisión. Consulte “Activación de metarchivos” en la página 21 para obtener más información acerca de la 6 IBM Tivoli Universal Agent: Guía del usuario . Por ejemplo. El usuario define un grupo de atributos. el nombre de archivo de marzo de 2007 es IN0703. “Creación de una aplicación”. Para realizar esta tarea.’ ClientAddr D 32 ClientName D 32 Date D 16 Time D 16 Service D 32 ServerName D 32 ServerAddr D 32 ElapsedTime C 100000 BytesReceived C 100000 BytesSent C 100000 SrvStatusCode C 100000 NTStatusCode C 100000 OperationName D 64 ObjectName D 256 Figura 3.LOG Tail //ATTRIBUTES ’. el valor predeterminado de la instalación. Cuando se esté ejecutando Tivoli Universal Agent.MDL.MDL En el metarchivo. Esta característica permite que la aplicación de supervisión del registro vaya automáticamente al nuevo archivo de registro que se crea cada mes. “Sentencias de control de definición de datos”. Consulte el Capítulo 3. de forma automática. Definición de la aplicación de Tivoli Universal Agent El usuario define una aplicación de supervisión del registro del FTP creando el metarchivo NTLOG. llamado FTPLOGFILE. E. especificando su nombre y características. Como el nombre del archivo de registro se incrementa cada mes. en la página 17 y el Apéndice A. no es necesario volver a configurar los proveedores de datos que se activan durante el arranque de Tivoli Universal Agent. Nota: Como el proveedor de datos de archivo está incluido automáticamente en el proveedor de datos de ASFS. situado en C:\WINNT\SYSTEM32\LOGFILES. El usuario decide que el sistema abra cada mes.Preparación de la fuente de datos El usuario configura el servicio FTP de Windows para que cree un archivo de registro. Ejemplo de metarchivo NTLOG. Control Import. donde los caracteres de patrón {####} representan los valores de mes y año de dos dígitos de incremento. debe decidir la característica de coincidencia de patrones de nombre de archivo que se describe en “Soporte de nombres de archivo dinámicos” en la página 46. El usuario coloca el metarchivo en el directorio de metarchivos de Tivoli Universal Agent en NTSRV1. puede utilizar el mandato de consola Import de Tivoli Universal Agent proporcionado o la ventana de Actuación de Tivoli Enterprise Portal. en la página 129 para obtener más información acerca de la creación de metarchivos. se nombra la aplicación NTLOG y se especifica que la fuente de los datos de atributo es un archivo denominado IN{####}. La importación de un metarchivo es el proceso de activar una aplicación de metarchivo dentro de un Tivoli Universal Agent en ejecución. lo que ahorra el esfuerzo de actualizar la sentencia //SOURCE en el metarchivo de definición de datos cuando el nombre del archivo de registro cambia.MDL como se muestra en el siguiente ejemplo: //Appl NTLOG //NAME FTPLOGFILE E //SOURCE FILE C:\WINNT\SYSTEM32\LOGFILES\IN{####}. puede importar el metarchivo NTLOG. para sucesos. Proporciona entonces los nombres y características de los 14 atributos que desea supervisar. Ahora ya es posible iniciar Tivoli Universal Agent.LOG. un nuevo registro.

2. Creación de una política de automatización Ahora que ha definido los atributos del registro NT en la aplicación de metarchivo de Tivoli Universal Agent. Visión general de Tivoli Universal Agent 7 . agentes de supervisión y de los grupos de atributos desde los que los agentes pueden recopilar información. Las columnas del espacio de trabajo se corresponden con los atributos que haya definido en el metarchivo. A continuación cree una política llamada FTPLimit.carga de metarchivos. que distribuirá a NTSRV1: NTLFTPLOGFILE00. Consulte “Sistemas gestionados por Tivoli Universal Agent” en la página 113 y el Capítulo 5. se activará esta situación. organizada por sistema operativo.Guía de instalación y configuración para obtener instrucciones acerca de cómo iniciar y detener Tivoli Enterprise Monitoring Agent. puede utilizar el atributo BytesReceived para crear la siguiente situación.000 A partir de ahora. podrá ver una entrada de espacio de trabajo llamada FTPLOGFILE. También podrá ver una correlación física del sistema dentro del Navigator de Tivoli Enterprise Portal con el nombre NTLOG00.000. Reinicie el servicio si el operador no realiza ninguna acción transcurridos 5 minutos. Consulte la publicación IBM Tivoli Monitoring . siempre que un usuario intente subir un archivo de 10 MB o más. tipo de sistema. Visualización de datos de atributos desde FTPLOGFILE Cuando el metarchivo se haya importado y se haya comenzado a recopilar registros de archivos que se añadan a la parte inferior del archivo del mes. Lleve a cabo la acción ″Net stop ″FTP Publishing Service″ para detener el servicio FTP. que espere a que se active la situación y 1. Envíe un mensaje al usuario que está subiendo el archivo (ClientName) comunicándole las restricciones del FTP y que el servicio se está finalizado. Notifique al operador en Tivoli Enterprise Portal que el servicio FTP Publishing Service se ha detenido. 4. Con el editor de situaciones de Tivoli Enterprise Portal. podrá comenzar a visualizar los datos en el Navigator de Tivoli Enterprise Portal.BytesReceived *GE 10. Uno de los sistemas gestionados que aparece en Navigator se denomina NTSRV1:NTLOG00. espacios de trabajo personalizados y atributos. Pulse sobre el elemento para acceder al espacio de trabajo. “Supervisión de aplicaciones”. que representa el grupo de atributos. Navigator proporciona una vista física de la red supervisada. 3. puede utilizar dichos atributos para crear una situación de supervisión que se active cuando se suba un archivo de 10 MB o más. en la página 113 para obtener información sobre la denominación de los sistemas gestionados. Capítulo 1. Consulte la publicación Tivoli Enterprise Portal Administrator’s Guide y la ayuda en línea de Tivoli Enterprise Portal para obtener instrucciones acerca de la creación de situaciones y políticas. Cuando abra este elemento que representa la aplicación. Consulte “Espacios de trabajo de aplicaciones” en la página 115 para obtener información acerca de los espacios de trabajo. que indica que la aplicación que se ha definido en la sentencia APPL en el metarchivo.

8 IBM Tivoli Universal Agent: Guía del usuario .

Determinación de la ubicación de los datos La posibilidad de utilizar el proveedor de datos de archivo o la elección entre el Servidor de la API o el proveedor de datos de socket puede depender del sistema operativo donde se encuentra la fuente de datos. Si los datos no se pueden exportar fácilmente a un archivo secuencial o la fuente de datos está en un sistema operativo no soportado por Tivoli Universal Agent. Cómo comenzar En este capítulo se describe cómo configurar Tivoli Universal Agent. 2007 9 . el proveedor de datos de archivo ofrece la manera más sencilla y directa de supervisar los datos. puede utilizar el proveedor de datos de SNMP. puede crear un programa de extracción para exportar los datos desde la fuente nativa a un archivo secuencial o bien modificar la aplicación de modo que redirija los datos a un archivo secuencial y utilizar así una solución de proveedor de datos de archivo. Aunque los © Copyright IBM Corp. Trata del tipo de proveedor de datos que se debe utilizar y cuántas instancias de Tivoli Universal Agent se deben instalar. Aunque los datos no se encuentren en un archivo secuencial. puede utilizar el proveedor de datos de socket o el proveedor de datos de servidor de API. Si esta supervisando condiciones de excepción de SNMP o el estado de recursos habilitados para SNMP. Introducción La implementación de Tivoli Universal Agent implica los siguientes tres procedimientos: v Instalación y configuración de Tivoli Universal Agent v Definición de aplicaciones de metarchivo de Tivoli Universal Agent v Supervisión de datos en Tivoli Enterprise Portal Configuración de Tivoli Universal Agent La configuración de Tivoli Universal Agent implica los siguientes pasos: v Selección de los tipos de proveedores de datos que desea utilizar v Decisión de cuántos Tivoli Universal Agent desea instalar v Configuración de las variables de entorno Selección de un proveedor de datos La decisión acerca de qué tipo de proveedor de datos que se va a utilizar para supervisar los datos debe tener en cuenta las siguientes consideraciones: v el tipo de datos que desea supervisar v la ubicación de los datos que desea supervisar Selección de los datos que se desean supervisar Si los datos están disponibles en un archivo secuencial. 2003.Capítulo 2. El proveedor de datos de archivo debe estar en el mismo sistema operativo que el archivo que supervisa o ser capaz de correlacionar de forma lógica el archivo en una red como si éste fuera local. Los siguientes capítulos hacen referencia a la definición de los datos en Tivoli Universal Agent creando aplicaciones y supervisando los datos en Tivoli Enterprise Portal. en un sistema operativo soportado por Tivoli Universal Agent. También trata de la configuración de las variables de entorno para ajustarse a los casos de ejemplo de supervisión y proporciona instrucciones para el inicio y detención del agente y sus proveedores de datos.

Script (ASFS) Proveedor de datos preferido Determinación del número necesario de agentes de Tivoli Universal Agent Puede ejecutar más de un Tivoli Universal Agent. Si los datos están en un sistema operativo no soportado por el paquete de cliente de API como z/OS. Socket. El sistema operativo debe contar con una pila TCP/IP con una interfaz de sockets si desea utilizar el proveedor de datos de socket. Archivo. que forma parte de lo que se denomina el paquete cliente de API. elija el proveedor de datos de servidor de API. La siguiente tabla proporciona información para seleccionar el proveedor de datos: Tabla 2. el tipo de proveedor de datos que va a utilizar para supervisarlos y consideraciones específicas del sitio como tráfico de red y control de departamentos ayudan a determinar el número apropiado de instancias de Tivoli Universal Agent que se va a ejecutar. Determinación del proveedor de datos Como las API de Tivoli Universal Agent encapsulan muchos de los detalles para tratar con los sockets TCP/IP. Esta biblioteca en tiempo de ejecución. La fuente de los datos. Si puede elegir entre el proveedor de datos de socket y el proveedor de datos de servidor de API. entonces el proveedor de datos de socket es la elección adecuada.datos estén en un archivo secuencial no es posible utilizar un proveedor de datos de archivo si se encuentran en un sistema operativo no soportado por Tivoli Universal Agent. si desea supervisar los archivos de registro de aplicaciones en 20 sistemas 10 IBM Tivoli Universal Agent: Guía del usuario . Por lo tanto. Un proveedor de datos de archivo debe iniciarse en un sistema en el que los archivos estén disponibles localmente. alertas e información de estatus Programas internos de la aplicación (sistema operativo del cliente de la API soportado) Programas internos de la aplicación (sistema operativo del cliente de la API no soportado) que utilizan TCP/IP Cualquier combinación de los siguientes: v Archivos de registro v Programas internos de la aplicación (sistema operativo del cliente de la API soportado) v Programas internos de la aplicación (sistema operativo del cliente de la API no soportado) v Mensajes de salida estándar producidos por un script o programa URL de Internet o intranet Bases de datos relacionales Datos MIB de SNMP Mensajes de salida estándar producidos por un script o programa HTTP ODBC SNMP Script Archivo Envío Servidor de API Socket API. Proveedores de datos preferidos Fuente de datos Archivos de registro Notificaciones ad hoc tales como mensajes. es más sencillo utilizar el proveedor de datos de servidor de API que el proveedor de datos de socket. Para utilizar las API de Tivoli Universal Agent necesita instalar la biblioteca de enlaces dinámicos de la API de Tivoli Universal Agent para el sistema operativo en que planee realizar el desarrollo. no está disponible en todos los sistemas operativos.

Si desea iniciar todos los proveedores de datos posibles en los sistemas Windows. Por ejemplo.distintos. Puede utilizar más de un Tivoli Universal Agent para limitar el tráfico de red o permitir que distintas instancias de Tivoli Universal Agent supervisen datos acerca de recursos gestionados por distintos departamentos. debe entrar la variable adecuada y el valor deseado en el archivo de variables de entorno. por lo que sólo debe iniciar los que necesite. Cómo comenzar 11 . Consulte el Apéndice G.HTTP. No obstante. Siempre puede modificar la lista en el futuro. Nombre y ubicación del archivo de variables de entorno Para cambiar los valores predeterminados de las variables de entorno. no tienen que iniciarse en la misma ubicación que sus fuentes de datos. puede iniciar un único Tivoli Universal Agent que pueda recibir datos enviados desde cualquier sistema en la empresa. Cuando haya instalado Tivoli Universal Agent. varios scripts y varios clientes de socket.ODBC. si piensa supervisar datos no accesibles desde un archivo.SNMP. en un Tivoli Universal Agent. Determinación de cuántas instancias de Tivoli Universal Agent se pueden ejecutar en el mismo host Es posible ejecutar más de un Tivoli Universal Agent en un host determinado. HTTP. actualice la variable de entorno KUMA_STARTUP_DP del modo siguiente: KUMA_STARTUP_DP=ASFS. puertos. Los proveedores de datos de envío. El proveedor de datos de script debe ejecutarse en un sistema en el que el script se esté ejecutando ya que los mensajes de salida estándar producidos por el script se conducen del sistema local al proveedor de datos de script. Existe una sobrecarga del sistema asociada a cada proveedor de datos activos. en la página 241 para obtener descripciones. esto no suele ser necesario ya que un Tivoli Universal Agent puede ejecutar varias aplicaciones y supervisar datos de varias fuentes. con el proveedor de datos de ASFS un único Tivoli Universal Agent puede supervisar varios archivos. puede alterar temporalmente los valores predeterminados de cualquiera de estas variables. La primera vez que se inicia el agente después de la instalación. Para obtener más información. si los requisitos de supervisión cambian. El nombre y la ubicación del archivo de variables son diferentes en función del sistema operativo. servidor de API.POST Si se activan varios proveedores de datos. puede iniciar todos los proveedores de datos o un subconjunto de ellos. Es decir. Observe que el proveedor de datos de ODBC sólo está disponible en los sistemas Windows. Por lo tanto. Determinación de cuántos proveedores de datos se pueden iniciar con un Tivoli Universal Agent En función de los requisitos de supervisión. varios clientes de API. los valores predeterminados de dichas variables están ya activos. valores predeterminados y ejemplos de cada variable. Capítulo 2. necesitará instalar 20 instancias de Tivoli Universal Agent. “Referencia de variables de entorno”. consulte “Ejecución de varias instancias de un proveedor de datos” en la página 38. Establecimiento de las variables de entorno Tivoli Universal Agent y sus proveedores de datos soportan un número de variables de entorno que especifican valores para ubicaciones. ODBC y SNMP son proveedores de datos distribuidos. el agente inicia de forma predeterminada el Proveedor consolidado de datos de ASFS. directorios de trabajo y otros elementos similares. deben estar en una lista separada por comas tal como se muestra en la variable de entorno anterior. Es necesario instalar un agente en cada host a no ser que los archivos remotos estén disponibles mediante software como NFS o Samba. A no ser que se especifique lo contrario.

no el archivo um. Edición de variables de entorno en los sistemas operativos UNIX Utilice un editor de texto para establecer las variables de entorno en el archivo um. debe volver a ejecutar ″itmcmd config -A um″ en lugar de editar directamente la variable de entorno KUMA_STARTUP_DP en el archivo um. . Estas variables de entorno contienen un valor de palabra clave entre dos caracteres $. Pulse con el botón derecho sobre Tivoli Universal Agent y.config está completamente reconstruido a partir del archivo um. si desea cambiar el conjunto de Proveedores de datos que Tivoli Universal Agent inicia. Por lo tanto. el archivo um. Establecimiento del directorio de trabajo El directorio de trabajo es donde Tivoli Universal Agent busca los archivos de configuración y donde coloca sus archivos de trabajo. Nombre y ubicación del archivo de variables de entorno en función del sistema operativo Sistema operativo UNIX Windows Ubicación <dir_instalación>/config/ IBM\ITM\TMAITM6\ um. 2.config o se perderán las actualizaciones la siguiente vez que se inicie Tivoli Universal Agent. puede editar las variables de entorno en el archivo KUMENV directamente utilizando un editor de texto o utilizando Manage Tivoli Enterprise Monitoring Services.La Tabla 3 contiene el nombre y la ubicación del archivo de variables de entorno de cada uno de los sistemas operativos soportados. y la variable KUM_WORK_PATH se preestablece para especificar 12 IBM Tivoli Universal Agent: Guía del usuario . Nota: Deberá editar el archivo um. donde <dir_instalación> es el directorio donde se ha instalado Tivoli Universal Agent. Tabla 3. 4. a continuación. Cada vez que inicie Tivoli Universal Agent en los sistemas operativos UNIX. Los scripts de inicio del agente realizan sustituciones de variables y copian el contenido del archivo um. Edición del archivo KUMENV en los sistemas operativos Windows mediante Manage Tivoli Enterprise Monitoring Services Realice los pasos siguientes para editar el archivo KUMENV mediante Manage Tivoli Enterprise Monitoring Services: 1. Edite o añada las variables que desea especificar. Aparecerá la ventana Manage Tivoli Enterprise Monitoring Services.ini que no debe editarse directamente. Hay una categoría especial de variables de entorno en um.ini. Guarde los cambios y cierre el Bloc de notas. que se encuentra en <dir_instalación>/config. En los sistemas operativos Windows se crea un directorio independiente.config.ini.ini KUMENV Nombre Edición de variables de entorno en los sistemas operativos Windows En los sistemas operativos Windows. Desde el menú Inicio. seleccione Avanzado → Editar archivo ENV . Si decide utilizar un editor de texto. el archivo KUMENV está situado de forma predeterminada en el directorio IBM\ITM\TMAITM6\. denominado work. seleccione Programas → IBM Tivoli Monitoring → Manage Tivoli Enterprise Monitoring Services. . El archivo KUMENV se abre en el Bloc de notas.ini en el archivo um.ini. por ejemplo: KUMA_STARTUP_DP=$DATAPROVIDER$ Este tipo de variable de entorno sólo debe actualizarse mediante el mandato ″itmcmd config -A um″. 3.ini.

Observe que Tivoli Universal Agent es diferente de otros agentes de Tivoli Monitoring a este respecto. KUM_DCH_HOSTNAME 2. Tivoli Universal Agent utiliza el valor de nombre de host local predeterminado. se crea automáticamente un directorio independiente denominado work. Tivoli Universal Agent realiza una búsqueda DNS durante el arranque para obtener el nombre de host local donde se está ejecutando. Cuando se enlazan sockets para crear puertos de escucha.34.ini (en las plataformas UNIX) o el archivo \TMAITM6\KUMENV (en las plataformas Windows). Hay cuatro variables de entorno distintas que responden todas a la misma finalidad básica que consiste en permitir que se altere temporalmente el nombre de host local de Tivoli Universal Agent. Si necesita que Tivoli Universal Agent utilice un nombre de host local no predeterminado. debe establecer un valor de alteración temporal de variable de entorno en el archivo /config/um. 2.IBM\ITM\TMAITM6\work como el directorio de trabajo. KDEB_INTERFACELIST=9. KDCB0_HOSTNAME 4. Utilización de las variables de entorno para determinar los nombres de host de las aplicaciones El modo en que Tivoli Universal Agent determina el nombre de host local es importante porque el valor de nombre de host se utiliza de las dos formas siguientes: 1.3 de 32 bits. el valor de nombre de host local se utiliza en la parte ″XXX″ del nombre. Nota: Para diagnosticar por qué se utiliza un valor de nombre de host local determinado. De forma predeterminada. KUM_DP_HOSTNAME 3. Si se ha establecido la variable de entorno KDEB_INTERFACELIST y el valor asignado es una dirección IP decimal separada por puntos. KDEB_INTERFACELIST Si no se ha establecido ninguna de estas variables de entorno. El archivo de registro RAS1 de Tivoli Universal Agent contiene información de rastreo detallada que muestra la secuencia de búsqueda que ha generado el valor de nombre de host local actual. En la nomenclatura de los sistemas gestionados que Tivoli Universal Agent registra con el servidor de supervisión y que se visualizan en el árbol de navegación del portal. por ejemplo. Tivoli Universal Agent intenta resolver la dirección IP con un nombre de host simbólico para mejorar la presentación en el portal.4. donde <arquitectura> es el sistema operativo y la versión. Por ejemplo: /TivoliHome/aix533/um/work Indica el sistema operativo IBM AIX 5. Puede utilizar KUM_WORK_PATH para especificar el directorio que desee. En el nombre de sistema gestionado XXX:YYY estándar que Tivoli Universal Agent registra. y la variable KUM_WORK_PATH se preestablece para especificar <dir_instalación>/<arquitectura>/um/work. Otros agentes de supervisión no suelen funcionar como servidores que permanecen a la escucha de conexiones de socket de cliente. Cómo comenzar 13 .67. En los sistemas operativos UNIX. mientras que esta función es una parte esencial de lo que Tivoli Universal Agent realiza. porque el agente se ejecuta en un sistema multitarjeta (múltiples NIC). La secuencia de búsqueda de la variable de entorno es la siguiente: 1. A continuación. como por ejemplo. este valor de nombre de host se utiliza para nombrar los sistemas gestionados y enlazar sockets de enlace. Capítulo 2. establezca el parámetro de rastreo KBB_RAS1 de Tivoli Universal Agent en ERROR (UNIT:kum0lhns ALL).

La cantidad depende de cuántos metarchivos estén activos. 2. El uso de un nodo de gestor individual por cada instancia de Tivoli Universal Agent reduce el tráfico en la red porque el servidor de supervisión sólo tiene que realizar el seguimiento del estatus de un nodo de latido en lugar de docenas potenciales de subnodos de aplicación diferentes. si establece CTIRA_HOSTNAME=MICKEY en el archivo KUMENV o um. Pero ahora. Un nodo de gestor individual. Los sistemas operativos UNIX también ofrecen una interfaz de línea de mandatos mediante el script itmcmd para configurar. es importante reconocer la diferencia entre los dos tipos de nodos que Tivoli Universal Agent registra con el servidor de supervisión: 1. sin el sufijo de nombre de dominio. es el nombre de host abreviado.Para comprender el rol del nombre de host local en las operaciones de Tivoli Universal Agent.ini. que también se visualiza en el espacio de trabajo Estatus de sistemas gestionados. y MICKEY:UA es el nuevo nombre del nodo del gestor de Tivoli Universal Agent. Además de las variables de entorno descritas arriba. Desde el punto de vista del servidor de supervisión y del servidor del portal. en el árbol de navegación del portal aparecen los nombres siguientes: BH-T60 (máquina host) --> Universal Agent --> BH-T60:MYAPP00 En el espacio de trabajo gestionado Estatus de sistemas gestionados. como por ejemplo ManagedSystemName=xxxx (consulte el parámetro ManagedSystemName en la página 148 para obtener más información) o enviando un registro //SETSOURCENAME=xxxx cuando se utiliza el proveedor de datos de socket (consulte “Función SETSOURCENAME” en la página 102 para obtener más información). el escenario cambia. Los subnodos contienen los datos de aplicación recopilados por Tivoli Universal Agent que se consultan en las situaciones y las políticas. Por ejemplo. el sistema gestionado es MICKEY. El valor de CTIRA_HOSTNAME se utiliza para definir la parte de nombre de host del nodo del gestor de Tivoli Universal Agent. Inicio de Tivoli Universal Agent y de sus proveedores de datos En los sistemas operativos Windows. si tiene un host que se denomina BH-T60 donde Tivoli Universal Agent está en ejecución y una aplicación de Tivoli Universal Agent denominada MYAPP (//APPL MYAPP aparece en el metarchivo). también se pueden alterar temporalmente los valores de nombre de host local en los subnodos de Tivoli Universal Agent estableciendo parámetros de metarchivo. De forma predeterminada. se visualizan los dos sistemas siguientes en la lista de otros sistemas gestionados: BH-T60:UA BH-T60:MYAPP00 donde BH-T60:UA es el nodo del gestor y BH-T60:MYAPP00 es un subnodo de aplicación debajo de BH-T60:UA. inicie Tivoli Universal Agent con Manage Tivoli Enterprise Monitoring Services. 14 IBM Tivoli Universal Agent: Guía del usuario . que el servidor de supervisión comprueba periódicamente para ver su estatus en línea y fuera de línea. Los nombres de subnodos de aplicación de Tivoli Universal Agent en el árbol de navegación del portal y en el espacio de trabajo Estatus de sistemas gestionados para este ejemplo siguen siendo BH-T60:MYAPP00. del sistema local. A la variable de entorno CTIRA_HOSTNAME se le asigna automáticamente un valor durante la configuración de Tivoli Universal Agent. conocido también como nodo de latido. Uno o más subnodos de aplicación. BH-T60 es el sistema gestionado y se visualiza en el árbol de navegación del portal del modo siguiente: BH-T60 (máquina host) --> Universal Agent A modo de ejemplo. iniciar y detener Tivoli Universal Agent.

así como el proveedor de datos de SNMP cuando inicie Tivoli Universal Agent. 2. si especifica el siguiente mandato. al iniciar Tivoli Universal Agent. realice los siguientes pasos para especificar los parámetros de inicio en los sistemas operativos Windows: 1. de socket.SNMP Especificación de parámetros de inicio en los sistemas operativos Windows Para cambiar manualmente los proveedores de datos listados en KUMA_STARTUP_DP.″ el código de producto oficial de 2 caracteres es ″um. ASFS Inicia el proveedor consolidado de datos APIS FILE Inicia el proveedor de datos de servidor de API Inicia el proveedor de datos de archivo HTTP Inicia el proveedor de datos de HTTP ODBC Inicia el proveedor de datos de ODBC POST Inicia el proveedor de datos de envío SCRP Inicia el proveedor de datos de script SNMP Inicia el proveedor de datos de SNMP SOCK Inicia el proveedor de datos de socket Por ejemplo. pulse Aceptar. de archivo y de script. y a continuación.″ que es la razón por la que muchos mandatos. KUMA_STARTUP_DP=ASFS. pulse con el botón derecho del ratón sobre Universal Agent. itmcmd config –A um. separados por comas.Por ejemplo. Esta misma interfaz de Tivoli Enterprise Portal también permite detener o reiniciar el agente. se activa el proveedor consolidado de datos (ASFS). De forma predeterminada. actualice indirectamente KUMA_STARTUP_DP invocando el script de configuración. Resalte y pulse con el botón derecho en Universal Agent en Navigator y seleccione Iniciar. Cómo comenzar 15 . Capítulo 2. se activarán los proveedores consolidados de datos de API. puede iniciar el agente en los sistemas UNIX entrando el siguiente mandato desde el directorio <dir_instalación>/bin: itmcmd agent start um Nota: Aunque Tivoli Universal Agent se conoce habitualmente como ″UA. Desde el botón Inicio. También puede iniciar Tivoli Universal Agent desde el árbol de Navigator de Tivoli Enterprise Portal. En los sistemas UNIX. archivos de configuración y binarios de Tivoli Universal Agent incluyen los caracteres ″um″ en sus nombres. Escriba los parámetros en el campo de entrada. y a continuación seleccione Cambiar parámetros de inicio en el menú emergente. Especificación de proveedores de datos Especifique cuál de los siguientes proveedores de datos desea iniciar estableciendo KUMA_STARTUP_DP en uno o más de los siguientes argumentos. En la ventana Manage Tivoli Enterprise Monitoring Services. y especificando en el indicador del “Proveedor de datos” final los proveedores de datos que desea utilizar. 3. seleccione Programas → IBM Tivoli Monitoring → Manage Tivoli Monitoring Services. Si desea especificar que se activen otros proveedores de datos o unos adicionales al iniciar Tivoli Universal Agent cambie la variable de entorno KUMA_STARTUP_DP.

pero para realizar pruebas desea iniciar únicamente los proveedores de datos de SNMP y de ARCHIVO. Por ejemplo. debe especificar el siguiente mandato: itmcmd agent -o SNMP. siguen activos cuando se reinicia el agente.FILE start um Si inicia manualmente el proveedor de datos de HTTP en una instancia alternativa de Tivoli Universal Agent denominada Test (prueba). debe suministrar el distintivo -o como alteración temporal manual en la línea de mandatos. en caso de que detecte que se inicia un conjunto de proveedores de datos distinto de los que especificó en KUMA_STARTUP_DP.Los parámetros de inicio que especifique mediante esta ventana son permanentes. si los proveedores de datos configurados son ASFS y HTTP. Especificación de parámetros de inicio en los sistemas operativos UNIX Si desea iniciar un conjunto de proveedores de datos diferente de los que están configurados actualmente en la variable de entorno KUMA_STARTUP_DP. Es importante recordarlo. especifique la siguiente cadena de mandatos utilizando el distintivo -p para especificar un nombre de instancia alternativo: itmcmd agent -o HTTP -p Test start um 16 IBM Tivoli Universal Agent: Guía del usuario .

Este metarchivo puede tener tres grupos de atributos. Tivoli Universal Agent las crea a partir de MIB estándares o de cualquier MIB que se le proporcione. espacios de trabajo y atributos en Tivoli Enterprise Portal. Construcción de un metarchivo de definición de datos Un metarchivo es un archivo de texto sin formato que contiene las siguientes sentencias de control en el orden en que aparecen (si están presentes): SNMP Sólo para proveedores de datos de SNMP. NAME Define el nombre de un grupo de atributos. © Copyright IBM Corp. representando recursos de red. para uno o más grupos de atributos de datos. 2007 17 . una aplicación es cualquier cosa que defina en el metarchivo. sistema y aplicaciones. puede crear un metarchivo con un nombre de aplicación de HOSTRESOURCES. Desde el punto de vista de Tivoli Universal Agent. Creación de una aplicación En este capítulo se describe cómo crear una aplicación de Tivoli Universal Agent que define los datos que desea gestionar. Cada aplicación de Tivoli Universal Agent consiste en una especificación de definición de datos o metarchivo. SNMP TEXT introduce la definición de datos para aplicaciones SNMP definidas por el usuario. APPL Especifica el nombre que Tivoli Universal Agent utiliza para la aplicación. 2003. introduce la definición de datos de aplicaciones MIB de SNMP proporcionadas por Tivoli Universal Agent. el tipo de datos recopilados y el periodo durante el cual son válidos los datos. Por ejemplo. Trata de cómo realizar las tareas siguientes: v Construcción de un metarchivo de definición de datos v Validación del metarchivo v Importación del metarchivo a Tivoli Universal Agent v Creación de un servidor de metarchivos Este capítulo también explica cómo se asignan números de versión a los metarchivos y cómo los números de versión de los metarchivos afectan a la denominación de los sistemas gestionados. Creación de una aplicación de Tivoli Universal Agent Se crea una aplicación construyendo un metarchivo que especifique la siguiente información: v Nombre de la aplicación v Nombre de cada uno de los grupos de atributos que componen la aplicación v Fuente o fuentes de los datos en cada grupo de atributos v Nombres y características de los atributos individuales La clave para crear aplicaciones de Tivoli Universal Agent útiles es colocar los atributos relacionados en grupos y colocar los grupos de atributos relacionados en aplicaciones de Tivoli Universal Agent individuales. Introducción a la aplicación de Tivoli Universal Agent Una aplicación de Tivoli Universal Agent define los datos que se desean gestionar en Tivoli Universal Agent.Capítulo 3. Nota: No es necesario crear metarchivos si se está utilizando el proveedor de datos de SNMP.

en la página 129 contiene las definiciones y sintaxis de las sentencias de metarchivos. deberá guardar el metarchivo como UTF-8. constantes enumeradas y patrones de filtros de atributo. grupos de atributos y atributos. (vea la Figura 4 en la página 19). ATTRIBUTES Introduce las definiciones de atributos y especifica los delimitadores de atributos en la cadena de datos. Puede utilizar cualquier editor de texto para crear un metarchivo.INTERNAL Proporciona la redirección de datos entre grupos de atributos como método para realizar procesos adicionales en los mismos datos de entrada. liste las sentencias de definición de atributos individuales. Después de la sentencia de control ATTRIBUTES. como UTF-16 o UTF-32. Identifique las fuentes de los datos. 18 IBM Tivoli Universal Agent: Guía del usuario . define la sentencia Select o procedimiento almacenado a utilizar en la recopilación de los datos relacionales. no están soportadas. Se pueden especificar ejemplos de texto que no está en inglés en un metarchivo como los textos de ayuda. “Sentencias de control de definición de datos”. RECORDSET Sólo para proveedores de datos de archivo y de script. caracteres delimitadores. SUMMARY Define los requisitos para reunir la frecuencia de entrada de datos durante la supervisión. títulos de atributos. SQL Sólo para proveedores de datos de ODBC. define el conjunto de registros desde los que el proveedor de datos extrae los datos. El Apéndice A. nombre la aplicación y grupos de datos de atributos a los que pertenecen los atributos. CONFIRM Sólo para proveedores de datos de socket. Puede crear un metarchivo de definición de datos para definir los atributos que desea supervisar. Si un metarchivo contiene texto que no está en inglés. En el metarchivo. especifique qué tipo de datos desea supervisar y defina el texto de ayuda de la aplicación. SOURCE Define la ubicación de los datos que se están recopilando. especifica los requisitos para el reconocimiento de datos. Otras codificaciones de archivo.

MDL. que define una aplicación de socket llamada UXnet: //APPL UXnet @aplicación de socket de ejemplo de PD //NAME TCPioQ E @grupo de atributos para aplicación de PD de ejemplo //SOURCE SOCK UNIX1 //SOURCE SOCK UNIX2 //ATTRIBUTES LocalApplAddress D 24 @dirección de la aplicación local TargetApplAddress D 24 @dirección de la aplicación de destino SendQueueSize C 999999 @tamaño de la cola de envío TCP/IP RecvQueueSize C 999999 @tamaño de la cola de recepción TCP/IP Denominación de metarchivos Por convenio.Figura 4. Para el proveedor de datos de SNMP. La ayuda que se defina para cada grupo de atributos aparece en el editor de situaciones cuando seleccione un grupo de atributos. Creación de ayuda para aplicaciones. Puede utilizar cualquier nombre soportado por el sistema operativo en el que se encuentra el archivo. cada uno de sus grupos de atributos y cada atributo en su grupo.MDL El siguiente ejemplo ilustra un pequeño metarchivo llamado TCPIOQ.mdl. se creará la ayuda de forma automática a partir de las descripciones de atributos en el MIB. Consulte el ejemplo anterior para observar las descripciones de ayuda en un metarchivo y el Apéndice A. La ayuda que defina para cada atributo aparece cuando pase el ratón por encima de los encabezados de la columna de la tabla que representa cada atributo. pero no existen restricciones acerca de los nombres de los metarchivos. Creación de una aplicación 19 . grupos de atributos y atributos En el metarchivo es posible definir la ayuda para la aplicación. en la página 129 para obtener información acerca del parámetro @helptext. Creación de un metarchivo de definición de datos: ejemplo TCPIOQ. los metarchivos de Tivoli Universal Agent terminan con la extensión . “Sentencias de control de definición de datos”. Capítulo 3. Es aconsejable darle al archivo el mismo nombre que tenga la aplicación.

rpt.Almacenamiento de metarchivos De forma predeterminada. que invoca la misma subrutina de validación de datos que Tivoli Universal Agent utiliza durante el tiempo de ejecución. VALIDATE lee el metarchivo y produce mensajes de validación detallados. Ubicación predeterminada de los metarchivos Sistema operativo Windows UNIX IBM\ITM\TMAITM6\metafiles <dir_instalación>/$ARCH/um/metafiles Ubicación Puede cambiar la ubicación utilizando la variable KUMP_META_PATH. Ejecute el mandato VALIDATE para un metarchivo recién desarrollado o modificado para poder identificar y corregir rápidamente errores sintácticos y de especificación antes de activar el metarchivo nuevo.mdl Copia de seguridad de los metarchivos Realice siempre copias de seguridad de sus metarchivos ya que representan una parte importante del sistema de gestión empresarial. Tabla 4. También crea un informe de especificación de datos que muestra la definición de aplicación activa con exactitud. si ejecuta el programa en el metarchivo tcpioq. Por ejemplo. no es sencillo volver a crear un metarchivo si se ha suprimido por error. si desea almacenar todos los metarchivos en un directorio especial fuera de la estructura del directorio de instalación de Tivoli Universal Agent. si utiliza el mandato de consola VALIDATE para comprobar la sintaxis de un metarchivo en un sistema Windows y el metarchivo no está en el directorio predeterminado \IBM\ITM\TMAITM6\metafiles. Aunque muchos de los metarchivos son simples. Por ejemplo: kumpcon validate . se creará un archivo llamado tcpioq. algunos son tan complejos como pequeños programas si emplea las distintas características del lenguaje del metarchivo. Trate los metarchivos como trataría un activo empresarial importante. realice copias de seguridad de los mismos y protéjalos de cualquier alteración o pérdida. Por ejemplo. Tivoli Universal Agent busca los metarchivos en el directorio indicado en la Tabla 4. entre el siguiente mandato en la línea de mandatos: kumpcon validate C:\ua\test\my_metafile. Si está utilizando un mandato de consola de Tivoli Universal Agent para un metarchivo y el metarchivo no está en el directorio de metarchivos predeterminado. puede crear subdirectorios en el directorio designado por KUMP_META_PATH. Cuando utilice un mandato de consola que haga referencia a un metarchivo en uno de los subdirectorios. podrá utilizar una vía de acceso relativa cuando especifique el nombre del metarchivo. 20 IBM Tivoli Universal Agent: Guía del usuario . Por ejemplo.mdl Si dispone de muchos metarchivos. En dichos casos. El informe tiene el mismo nombre de archivo que el metarchivo. sino que se encuentra en \ua\test. puede especificar el nombre de metarchivo calificado al completo. utilice la variable de entorno KUMP_META_PATH para redirigir el metarchivo desde el directorio predeterminado a una ubicación alternativa. Validación de las definiciones de datos IBM Tivoli Monitoring soporta un mandato de consola llamado VALIDATE.\nombre_subdirectorio\mymetafile. como hace con cualquier código fuente de su empresa. Consulte “Creación de un servidor de metarchivos” en la página 25 para obtener más información acerca del recurso opcional del servidor de metarchivos.mdl. Nota: La especificación KUMP_META_PATH local de un cliente de metarchivos no altera temporalmente la especificación KUMP_META_PATH del servidor de metarchivos. con la extensión rpt.

Puede activar los metarchivos de cualquiera de las siguientes maneras: v Dinámicamente mediante un mandato de consola v Dinámicamente mediante un mandato de Actuación en el Tivoli Enterprise Portal v Mediante una actualización del archivo de configuración y un reinicio de Tivoli Universal Agent Cuando decida qué método utilizar para activar un metarchivo. que es un contenedor para kumpcon que permite ejecutar el programa de validación de metarchivos. desde el directorio de metarchivos. utilice el script de shell um_console. Activación de metarchivos mediante mandatos de consola Puede activar los metarchivos dinámicamente utilizando los mandatos IMPORT y REFRESH. o si ha modificado un metarchivo activo y desea renovarlo sin tener que reiniciar Tivoli Universal Agent. mantenimiento y la reducción de errores causada por acciones implícitas y valores predeterminados.MDL Attribute Group: TCPioQ Type: Event data Total number of SOURCEs: 2 SOURCE is SOCKET UNIX1 Total Attributes: 4 Attribute delimiter is Space Character LocalApplAddress Display Type Size 24 Delimiter is Space Character TargetApplAddress Display Type Size 24 Delimiter is Space Character SendQueueSize Counter Type Size 4 Delimiter is Space Character RecvQueueSize Counter Type Size 2 Delimiter is Space Character SOURCE is SOCKET UNIX2 Total Attributes: 4 Attribute delimiter is Space Character LocalApplAddress Display Type Size 24 Delimiter is Space Character TargetApplAddress Display Type Size 24 Delimiter is Space Character SendQueueSize Counter Type Size 4 Delimiter is Space Character RecvQueueSize Counter Type Size 4 Delimiter is Space Character Total Attribute Groups: 1 Activación de metarchivos Para gestionar los datos de aplicación. Utilice este método si ha creado un nuevo metarchivo y desea importarlo. Tivoli Universal Agent carga los metarchivos correspondientes a partir de los nombres de vía de acceso especificados en KUMPCNFG o si no se especifican nombres calificados al completo. “Mandatos de consola”.Ejecución del programa de validación Para ejecutar el programa de validación de metarchivos.MDL: Application Name: UXnet. Creación de una aplicación 21 . Definition Metafile Name: C:\IBM\ITM\TMAITM6\METAFILES\TCPIOQ. También puede utilizar los mandatos de Capítulo 3. Ejemplo de salida de informe de validación El siguiente ejemplo muestra el contenido del archivo de informe que es una salida de una aplicación llamada UXnet. no puede ejecutar el programa kumpcon directamente. Consulte “Invocación de la interfaz de mandatos de consola en los sistemas operativos UNIX” en la página 207 para obtener más información acerca del script um_console. en la página 207 para obtener información acerca de la interfaz de línea de mandatos de Tivoli Universal Agent. definida en el metarchivo denominado TCPIOQ. intente alcanzar un equilibrio entre flexibilidad. Durante el inicio Tivoli Universal Agent comprueba si existe algún metarchivo especificado en el archivo de configuración KUMPCNFG. De ser así. facilidad de uso. Consulte el Apéndice D. En su lugar. Tivoli Universal Agent debe activar los metarchivos correspondientes. entre desde cualquier consola lo siguiente: kumpcon validate nombre_metarchivo Nota: En los sistemas operativos UNIX.

después de haber modificado un metarchivo activo.consola REFRESH para importar metarchivos nuevos y revisados en cualquier momento. o si. Utilice el método de Actuación si no desea reiniciar Tivoli Universal Agent después de haber creado un nuevo metarchivo y desea importarlo.. 2. Desde cualquier ubicación en el árbol de Navigator de Tivoli Enterprise Portal debajo de Universal Agent. Realice los siguientes pasos para seleccionar los mandatos de Actuación de Tivoli Universal Agent desde Tivoli Enterprise Portal: 1.. por ejemplo. → Seleccionar. Figura 5... Activación de metarchivos Activación de metarchivos mediante los mandatos de Actuación Puede activar los metarchivos dinámicamente utilizando los mandatos de Actuación Control Import y Control Refresh.. Deberá tener la sesión cliente de Tivoli Enterprise Portal activa si tiene la intención de utilizar este método. desea renovar el metarchivo. 22 IBM Tivoli Universal Agent: Guía del usuario . seleccione una hoja en el árbol de Navigator. Pulse con el botón derecho del ratón sobre la hoja y seleccione Actuación. El método de Actuación no precisa que haya una conexión de socket con el servidor de consola. debido a que un cortafuegos bloquea la conexión de socket entre el programa kumpcon y el servidor de consola de Tivoli Universal Agent. Aparecerá la ventana Actuación. El método de Actuación puede ser útil si tiene problemas con la interfaz de línea de mandatos.

Creación de una aplicación 23 .MDL como Valor. 4. 6. Pulse en Aceptar. seleccione un sistema de destino para la acción. En la ventana Actuación. Como ejemplo. el Capítulo 3. En este ejemplo. Nota: Distribuya siempre el mandato de Actuación a los sistemas de destino cuyo tipo de proveedor de datos coincida con el tipo de proveedor de datos que desea importar. seleccione Control Import en la lista desplegable Nombre:. Escriba el nombre del metarchivo que desea activar en el campo Valor de la ventana Editar valores de argumentos. Aparecerá la ventana Editar valores de argumentos. si va a importar el archivo TCPIOQ.3. entre TCPIOQ. seleccione una acción de la lista desplegable Nombre:. 5. En la ventana Editar valores de argumentos. En la sección Sistemas de destino de la ventana Actuación.MDL.

metarchivos del proveedor de datos de SNMP. v Si edita directamente KUMPCNFG. por ejemplo. metarchivos del proveedor de datos de archivo.txt son cargados por Tivoli Universal Agent. mymeta appl1. v Cualquier registro de archivo de configuración con un asterisco (*) se tratará como si fuera un comentario y será ignorado. o el directorio especificado por KUM_WORK_PATH. Activación de metarchivos con un archivo de configuración KUMPCNFG es un archivo de texto sin formato que contiene los nombres de los metarchivos que Tivoli Universal Agent carga durante el inicio. utilice únicamente nombres de metarchivos sin calificar en el archivo de configuración. Nota: La especificación de vía de acceso es sensible a mayúsculas y minúsculas en algunos sistemas operativos. Especificar un metarchivo por registro de archivo simplifica la actualización del archivo de configuración. un proveedor de datos de archivo no puede comenzar a supervisar las conexiones de socket entrantes y un proveedor de datos de servidor de API no puede generar subprocesos para los 24 IBM Tivoli Universal Agent: Guía del usuario . normalmente. pero cada proveedor de datos sólo comienza a supervisar los metarchivos que pertenecen a su tipo de datos definido e ignora el resto. Directrices para actualizar los archivos de configuración Observe las siguientes directrices cuando actualice un archivo de configuración para incluir un nuevo metarchivo: v El nombre del archivo de configuración debe ser KUMPCNFG. El mismo archivo KUMPCNFG puede contener metarchivos del proveedor de datos de socket. Por ejemplo. appl1. En aquellos sistemas en los que los archivos son sensibles a mayúsculas y minúsculas.mdl appl2 CustInq. Si no se especifica ningún valor para KUMP_INIT_CONFIG_PATH. 7. separados por un espacio o bien puede especificar un metarchivo por registro de archivo. el nombre estará completamente en mayúsculas. el nombre del archivo de configuración es KUMPCNFG_&nombre de instancia. v Puede entrar uno o más nombres de metarchivos en un único registro de archivo de configuración. KUMPCNFG_TEST. para distribuir la acción al sistema de destino &localhostASFSdp:UAGENT00 o &localhostSOCKdp:UAGENT00. Ubicación del archivo de configuración Tivoli Universal Agent utiliza el valor especificado por la variable de entorno KUMP_INIT_CONFIG_PATH como la ubicación del archivo de configuración. Cada proveedor de datos carga los metarchivos especificados en KUMPCNFG. Ejemplo de un archivo de proveedor de datos Compartir los archivos de configuración Varios Tivoli Universal Agent y subprocesos de proveedor de datos pueden compartir un archivo KUMPCNFG. v Si está ejecutando una instancia alternativa de Tivoli Universal Agent. metarchivos del proveedor de datos de ODBC y metarchivos del proveedor de datos de script. /um/work en sistemas UNIX y \TMAITM6\work en sistemas Windows. Utilice este método cuando desee que Tivoli Universal Agent cargue de forma automática determinados metarchivos durante el arranque.txt *Payroll Figura 6. Tivoli Universal Agent utiliza el directorio de trabajo predeterminado.metarchivo utiliza el proveedor de datos de socket. en función de si ha configurado ASFS DP o SOCK DP. Pulse en Aceptar. Por ejemplo. La ventana Estatus de acción aparece e indica si la acción ha sido correcta. appl2 y CustInq. sólo los metarchivos mymeta. los cambios no surtirán efecto hasta el siguiente reinicio de Tivoli Universal Agent. Consulte “Establecimiento del directorio de trabajo” en la página 12 para obtener más detalles acerca del directorio de trabajo predeterminado y la variable KUM_WORK_PATH. En la Figura 6. v Excepto cuando sea estrictamente necesario.mdl.

inmediatamente asume el rol de servidor de metarchivos. Por lo tanto. Creación de una aplicación 25 . no existe el peligro de conflictos de gestión entre los distintos proveedores de datos. como haría cualquier Tivoli Universal Agent iniciado en cualquier parte de la empresa. la característica del servidor se inhabilitará y el proveedor de datos cargará los metarchivos desde la ubicación de metarchivos local. El departamento financiero selecciona el sistema FIN4 como servidor de metarchivos. Por ejemplo. El recurso de servidor de metarchivos centralizados permite designar uno o más Tivoli Universal Agent como servidores de metarchivos. v Si no es el primer Tivoli Universal Agent inicializado en este sistema. Para asegurar definiciones consistentes en toda la empresa y para reducir la complejidad de la gestión y mantenimiento de varios Tivoli Universal Agent. el proveedor de archivos de SNMP sólo carga metarchivos MIB de SNMP y los proveedores de datos que no son SNMP sólo cargan metarchivos que no son de SNMP. el departamento de ingeniería podría designar un Tivoli Universal Agent que se ejecuta en el sistema ENG1 como servidor de metarchivos. Del mismo modo. Creación de un servidor de metarchivos En una empresa. Designación de un servidor de metarchivos Utilice la variable de entorno KUMP_META_SERVER para especificar el nombre de host de Tivoli Universal Agent que desea utilizar como servidor: KUMP_META_SERVER=nombrehost La presencia de la variable de entorno le indica a Tivoli Universal Agent que debe utilizar un servidor de metarchivos centralizado. es decir. almacene los metarchivos en una única ubicación. Es también una buena práctica realizar copias de seguridad a intervalos regulares ya que representan una parte importante del sistema de gestión empresarial. Determinación de los roles de cliente y servidor en el mismo host Cuando Tivoli Universal Agent se inicia y descubre que KUMP_META_SERVER está configurado con el nombre de su propio host. Consulte “Activación de metarchivos” en la página 21 para obtener más información acerca de KUMP_META_PATH y “Establecimiento del directorio de trabajo” en la página 12 para obtener más información acerca de KUM_WORK_PATH. Socket. toma la siguiente determinación: v Si es el primer Tivoli Universal Agent inicializado en este sistema. aparte del almacenamiento extra asignado para cada proveedor de datos para los bloques de control de definición de datos internos. Capítulo 3. se iniciarán todas las supervisiones correspondientes para cada tipo de proveedores de datos al mismo tiempo. Todos los Tivoli Universal Agent en el departamento de ingeniería descargan los metarchivos necesarios del Tivoli Universal Agent de ENG1. Archivo y Script (ASFS). API. Si el nombre de host especificado por KUMP_META_SERVER no puede resolverse en una dirección TCP/IP. Almacenamiento de metarchivos de servidor Debe almacenar los metarchivos del servidor en el directorio de trabajo predeterminado de Tivoli Universal Agent o en la ubicación identificada por las variables de entorno KUMP_META_PATH o KUM_WORK_PATH. mientras que todos los Tivoli Universal Agent del departamento financiero recuperar los metarchivos necesarios del Tivoli Universal Agent en FIN4. Los Tivoli Universal Agent cliente pueden recuperar los metarchivos que necesiten del servidor designado durante el tiempo de ejecución en lugar de mantener copias locales. Si inicia los proveedores de datos tipo ASFS. Si está variable de entorno no está establecida. las mismas aplicaciones pueden ser soportadas por varios Tivoli Universal Agent en distintas ubicaciones. Tivoli Universal Agent funciona en modalidad autónoma y sólo buscará los metarchivos necesarios localmente. presupone que el servidor de metarchivos ya se ha iniciado y asume el rol de cliente de metarchivos.archivos del registro de supervisión.

Si la conexión es satisfactoria. el cliente vuelva automáticamente a la modalidad autónoma y planifica reintentos periódicos hasta que se restablezca la conexión con el servidor. Por lo tanto. Tivoli Universal Agent genera y sube los archivos de definición denominados MYTCAT00. Tivoli Universal Agent configura la estructura de gestión interna necesaria y continúa con el proceso de arranque. ATR y ODI. sin precisar que se recicle ninguno de los componentes de Tivoli Monitoring. ATR y ODI para cada aplicación de metarchivos que se active. si Tivoli Universal Agent está configurado en un 26 IBM Tivoli Universal Agent: Guía del usuario . Puede supervisar estos mensajes en los espacios de trabajo DPLOG. el servidor de metarchivos permanece a la escucha de conexiones en el puerto 7800.Sincronización del servidor y el cliente de metarchivos Si Tivoli Universal Agent determina durante el arranque que la variable de entorno KUMP_META_SERVER no está establecida con el nombre de su propio host. Tivoli Universal Agent es exclusivo en el sentido de que genera dinámicamente un archivo CAT. La comunicación entre el cliente y el servidor de metarchivos puede interrumpirse duran un funcionamiento normal por un diversas razones relacionadas con el sistema o la red. Se emiten mensajes de registro que identifican claramente el estatus del servicio de metarchivo. ya sea por problemas de red o porque el servidor de metarchivos de Tivoli Universal Agent no se ha iniciado. Interacción con otros componentes de IBM Tivoli Monitoring Todas las aplicaciones de IBM Tivoli Monitoring están representadas por un archivo de catálogo. Alteración temporal de la definición central de metarchivo Si necesita alterar temporalmente un metarchivo de definición de datos mientras está probando la actualización de una aplicación o está editando las especificaciones. el cliente de metarchivos planifica reintentos periódicos de la conexión y finaliza la inicialización. Los archivos CAT y ATR se suben automáticamente a Tivoli Enterprise Monitoring Server (servidor de supervisión) con el que Tivoli Universal Agent está configurado y el archivo ODI se sube a Tivoli Enterprise Portal Server (servidor del portal) asociado al servidor de supervisión concentrador. La subida dinámica de estos tres archivos de definiciones permite que nuevas aplicaciones de Tivoli Universal Agent inicien la supervisión. asume el rol de cliente e inmediatamente intenta establecer una conexión de socket con el servidor de metarchivos designado. De forma predeterminada. Si se interrumpen las comunicaciones. términos que a menudo se conocen simplemente con el nombre de archivos CAT. ATR y ODI tienen el siguiente formato. que es un valor que se puede cambiar con la variable de entorno KUMP_META_SERVER_PORT. según lo especificado en la sentencia //APPL del metarchivo: v appCAT00 v appATR00 v appODI00 Por ejemplo. Tenga en cuenta que el servidor del portal sólo recupera información de definición de aplicaciones del servidor de supervisión concentrador. muestren los datos en Tivoli Enterprise Portal Client (cliente de portal) y creen nuevas situaciones y políticas. donde app representan los tres primeros caracteres del nombre de aplicación. Otros agentes de IBM Tivoli Monitoring distribuyen estos tres archivos de definiciones como parte del paquete de instalación. si el metarchivo contiene la sentencia //APPL MYTEST. Consulte “Espacios de trabajo UAGENT” en la página 117 para obtener información adicional. de atributo y ODI (Object Definition Interchange-Intercambio de definición de objeto). Un cliente de metarchivos siempre comprueba la existencia de una copia local del metarchivo necesario antes de intentar descargarlo del servidor de metarchivos. Si la conexión no es satisfactoria. MYTATR00 y MYTODI00. Los nombres de archivos CAT. haga que el nuevo metarchivo de aplicación esté disponible localmente para el cliente de Tivoli Universal Agent.

los archivos CAT y ATR se almacenan como miembros de conjuntos de datos particionados en RKANDATV). Otras versiones de los sistemas gestionados. Tivoli Universal Agent notifica a los demás componentes de Tivoli Monitoring de que debe utilizarse un nuevo conjunto de definiciones de tabla y atributo. Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent El mantenimiento de versiones de aplicaciones es una parte necesaria de Tivoli Universal Agent. Volver a configurar temporalmente Tivoli Universal Agent para conectar con el servidor de supervisión concentrador. (Para los servidores de supervisión en los sistemas z/OS. Incremento del número de versión y de los números de modificación A las aplicaciones de Tivoli Universal Agent se les asignan números de versión y de modificación. listas de sistemas gestionados y grupos de atributos basados en el número de versión anterior pasan a estar fuera de línea y los nuevos con el nuevo número de versión pasan a estar en línea. Importar el metarchivo. Consulte la Tabla 5 en la página 28 y el Capítulo 5. espacios de trabajo y grupos de atributos Tivoli Universal Agent añade el número de versión de la aplicación al nombre de sistemas gestionados. no puede visualizarla en el cliente del portal.servidor de supervisión remoto y se activa una nueva aplicación de metarchivo. tal como se representan con los archivos CAT. El mantenimiento de versiones es necesario porque los otros componentes de Tivoli Monitoring. 3. Opción 2 Copie manualmente los archivos CAT y ATR para las aplicaciones de metarchivos en el servidor de supervisión concentrador y a continuación. el proceso de copiar archivos en el servidor de supervisión concentrador sólo se tiene que realizar una vez aunque disponga de un entorno a gran escala con muchos Tivoli Universal Agents. Cuando se importa por primera vez un metarchivo a Tivoli Universal Agent. Tenga presente que si dispone de centenares o miles de sistemas Tivoli Universal Agent y todos ellos utilizan el mismo conjunto de metarchivos. dispone de las dos opciones posibles: Opción 1 1. Observe que Tivoli Universal Agent también conserva copias locales de estos archivos en el subdirectorio de trabajo. ATR y ODI. La opción 1 presenta la ventaja de que no es necesario que se recicle el servidor de supervisión concentrador. las listas de sistemas gestionados y los grupos de atributos. en la página 113 para obtener más información. Puede copiar los archivos de los directorios /RKDSCATL y /ATTRLIB del servidor de supervisión remoto en los mismos directorios en el servidor de supervisión concentrador. Creación de una aplicación 27 . a medida que cambie el metarchivo y lo renueve en Tivoli Universal Agent. se incrementará por 1 el número de versión de la aplicación (cambios de mayor importancia) o el número de modificación (cambios de menor importancia) dependiendo del tipo de cambios que haya realizado. “Supervisión de aplicaciones”. 2. Volver a configurar Tivoli Universal Agent para conectar con el servidor de supervisión remoto. el servidor del portal. sólo necesita volver a configurar un Tivoli Universal Agent en el servidor de supervisión concentrador para subir dinámicamente los archivos CAT y ATR. que es \TMAITM6\work en los sistemas Windows. Cuando cambia el número de versión de un metarchivo. No es una característica opcional que se puede desactivar. y /um/work en los sistemas UNIX. Al igual que con la Opción 1. y Data Warehouse requieren un conjunto conocido de definiciones de tabla y atributo para cada una de las aplicaciones de Tivoli Monitoring. El cambio del nombre del sistema gestionado significa Capítulo 3. a la aplicación se le asigna un número de versión de 0 y un número de modificación de 0. como el servidor de supervisión. Después. el servidor del portal no conoce la nueva aplicación y por lo tanto. Para resolver este problema. Añadiendo un sufijo de versión a cada aplicación e incrementando el número de versión si se produce un cambio de metarchivo importante. recicle el concentrador. los sistemas gestionados.

S o K v Delimitador especificado en la sentencia ATTRIBUTE v Un cambio en la sentencia RECORDSET v Un cambio en la sentencia CONFIRM v Un cambio en los parámetros FILTER de atributo v Un cambio en la sentencia SQL Cambios que afectan al número de modificación (cambios de menor importancia) Los siguientes cambios provocan que se aumente el número de modificación: v Adición de un nuevo atributo al final de la lista de atributos de un grupo de atributos v Adición de un grupo de atributos nuevo al final del metarchivo v v v v Adición. Los cambios de número de versión se consideran cambios de gran importancia porque no es posible simplemente reiniciar las situaciones distribuidas a una versión anterior de un sistema gestionado. o bien títulos. eliminación o modificación del texto de ayuda Atomización de un atributo existente Adición. siempre que sea posible. Sin embargo. y que se colocan espacios de trabajo de informes debajo la entrada. valores de escala o de precisión. por ejemplo. Tabla 5. el cliente del portal deberá reciclarse porque mantiene una memoria caché de definiciones de atributos que no se renueva automáticamente después de realizar un cambio de versión de menor importancia en una aplicación de Tivoli Universal Agent. Nota: Los cambios de menor importancia se implementan sin que se precise reciclar el servidor de supervisión o el servidor de portal. Cuando se incrementa el número de modificación. Este tipo de cambio no precisa que se redefinan las situaciones. distribuir las situaciones a las nuevas versiones de los sistemas gestionados o lista de sistemas gestionados. eliminación o modificación de los valores de Scale o Precision Adición. cambios en el texto de ayuda del atributo. es aconsejable. También necesita actualizar cualquier política o consulta existente para que haga referencia al nuevo número de versión. Es necesario crear nuevas situaciones o modificar las antiguas para utilizar los nuevos nombres de grupos de atributos y. Numeración de versiones Nombre sistema gestionado ENG1:UL300 Versión 00 ENG1:UL301 *CUSTOM_UL301 SYSLOG01 Versión 01 lista de sistemas gestionados *CUSTOM_UL300 grupo de atributos SYSLOG00 Cambios que no afectan al número de modificación o de versión Puede realizar los siguientes cambios sin alterar el número de versión de modificación o de versión del metarchivo: v Valor de TTL v Un cambio en la sentencia SOURCE v Tipo de datos de P. realizar cambios de metarchivos que sólo afecten al número de modificación. S o K a cualquiera de P. Por esto. a continuación. si los cambios de metarchivos afectan a las definiciones de atributos. consultas personalizadas o políticas existentes.que se inserta una nueva entrada en el árbol Navigator de Tivoli Enterprise Portal para la nueva versión de la aplicación. eliminación o modificación del valor de Caption IBM Tivoli Universal Agent: Guía del usuario 28 . se considera que es un cambio de versión de menor importancia.

4. de una cadena a un entero v Modificación del tamaño máximo de un atributo v Adición de un atributo nuevo en cualquier otra parte que no sea el final de un grupo de atributos existente v Modificación de la secuencia de atributos v v v v Modificación de un grupo de atributos de E a P. Desde la vista Navigator físico del cliente de portal. Capítulo 3. eliminación o modificación de los parámetros Warehouse o Aggregation v Adición. Asegúrese de que el servidor de supervisión y el servidor del portal están en ejecución 2. Inicie la sesión en el cliente del portal. de MyAttr a -MyAttr Restablecimiento de los números de versión El restablecimiento de los números de versión de las aplicaciones de Tivoli Universal Agent consta de los dos pasos básicos siguientes: 1. S o K a E Adición de un nuevo grupo de atributos en cualquier parte que no sea el final del metarchivo Modificación de un atributo de visible a oculto o viceversa. pero todos los sufijos de las versiones estarán a 00. 3. debe concluir Tivoli Universal Agent y suprimir manualmente los sistemas gestionados de Tivoli Universal Agent del espacio de trabajo Tivoli Enterprise Portal Estatus de sistemas gestionados. Detenga Tivoli Universal Agent de modo que todos los sistemas gestionados estén fuera de línea. Estos scripts no afectan a los metarchivos. por ejemplo.v Adición. S o K Modificación de un tipo de grupo de atributos de P. Creación de una aplicación 29 . Supresión manual de los sistemas gestionados Lleve a cabo los siguientes pasos para suprimir sistemas gestionados existentes: 1.bat v Para los sistemas operativos UNIX. Suprimir manualmente todos los sistemas gestionados de Tivoli Universal Agent 2. Antes de ejecutar cualquiera de estos scripts. por ejemplo. ATR y ODI generados por Tivoli Universal Agent Se proporcionan los siguientes scripts de limpieza para que se pueda restablecer el número de versión de las aplicaciones de nuevo a las versiones 00 originales: v Para los sistemas operativos Windows. um_cleanup Nota: Estos scripts de limpieza eliminan todas las aplicaciones de Tivoli Universal Agent. eliminación o modificación de los parámetros de afinidad dinámica Cambios que afectan al número de versión (cambios de gran importancia) Los siguientes cambios provocan que se aumente el número de modificación: v Cambio de nombre o supresión de un atributo existente v Cambio de nombre o supresión de un grupo de atributos existente v Modificación del tipo de un atributo. Ejecutar scripts de limpieza para suprimir archivos CAT. Aparecerá el espacio de trabajo Estatus de sistemas gestionados. pulse con el botón derecho del ratón sobre Empresa y seleccione Espacio de trabajo → Estatus de sistemas gestionados. um_cleanup. eliminación o modificación de las opciones HistoricalTimestamp o PrimaryKey v Adición. La siguiente vez que se importen o se activen los metarchivos. las aplicaciones de Tivoli Universal Agent volverán a estar en línea.

2. y que ha elegido el directorio de instalación de \IBM\ITM. Ejecute el mandato um_cleanup.bat IBM\ITM UA para suprimir todos los archivos CAT. Resalte todos los sistemas gestionados de Tivoli Universal Agent. Abra un indicador de mandatos y vaya al directorio \TMAITM6. Por ejemplo. 9. Las aplicaciones se visualizan en el árbol de Navigator con los sufijos de la versión 00. Los sistemas gestionados de Tivoli Universal Agent ya no aparecen en el árbol. Ejecute el mandato um_cleanup. ATR y ODI apropiados. 1. 8. realice los pasos siguientes. 4. ejecute el script tres veces sucesivas en el sistema de Tivoli Universal Agent. 6.bat IBM\ITM CNPS para suprimir todos los archivos ODI generados por Universal Agent en el directorio \CNPS del servidor del portal. ATR y ODI generados por Universal Agent en el directorio \work en el sistema de Tivoli Universal Agent. Por ejemplo. Para ejecutar el script de limpieza en Windows. Seleccione el icono Aplicar actualizaciones pendientes para volver a crear el árbol de Navigator.bat directorio_instalación componente [directorio_trabajo] donde: directorio_instalación El directorio base donde están instalados los componentes de IBM Tivoli Monitoring. el servidor del portal y Tivoli Universal Agent.5. Si el servidor de supervisión y el servidor de portal están instalados en otros sistemas. directorio_trabajo Sólo es necesario si el directorio de trabajo no es el directorio IBM\ITM\TMAITM6\work predeterminado. Detenga el servidor de supervisión. El icono Aplicar actualizaciones pendientes aparece resaltado en el cliente de portal. Observe que estos pasos presuponen que el servidor de supervisión y el servidor del portal están instalados en el mismo sistema Windows que Tivoli Universal Agent. debe (1) ejecutar por separado el script de limpieza en estos otros sistemas utilizando los parámetros de línea de mandatos “CMS” y “CNPS” para el servidor de supervisión y el servidor del portal respectivamente. Inicie la sesión en el cliente del portal. Ejecute el mandato um_cleanup. 6. del servidor de supervisión y del servidor de portal. 30 IBM Tivoli Universal Agent: Guía del usuario . el servidor del portal y Tivoli Universal Agent. Pulse con el botón derecho del ratón y seleccione Borrar entrada fuera de línea. utilice UA y no utilice Ua o ua. o bien (2) ejecutar los mandatos de supresión de archivo equivalentes incluidos en el script de limpieza para que se eliminen los archivos CAT. 7. Finalice la sesión en Tivoli Enterprise Portal Client. 7. 5. Si el servidor de supervisión y el servidor del portal están instalados en el mismo sistema que Tivoli Universal Agent. IBM\ITM componente Uno de los tres valores: UA CMS CNPS Nota: Ponga en mayúsculas cada uno de estos valores. 3. Reinicie el servidor de supervisión.bat IBM\ITM CMS para suprimir todos los archivos CAT y ATR de Universal Agent generados por los directorios \ATTRLIB y \RKDSCATL del servidor de supervisión. el archivo um_cleanup bat tiene previstos los siguientes parámetros de línea de mandatos: um_cleanup. En los sistemas Windows. Ejecución del script de limpieza Debe ejecutar el script de limpieza tres veces para suprimir todos los archivos de definición de Tivoli Universal Agent existentes de los directorios de Universal Agent.

Uno de los tres valores: UA CMS CNPS Nota: Ponga en mayúsculas cada uno de estos valores.%%’. Tras completar el proceso de limpieza. Por consiguiente. Por ejemplo. El script es muy corto y sólo utiliza el siguiente mandato: kfwsqlclient /d TEPS2 /e "delete from kfwquery where id like ’zkum. cuando se visualiza la aplicación DISKMONITOR00. Por ejemplo. hay un script proporcionado por Tivoli Universal Agent." Capítulo 3." el parámetro debe especificarse siempre cuando se ejecuta el script um_cleanup. denominado um_cnpsCleanup.bat. /opt/IBM/ITM. el script de shell um_cleanup prevé los siguientes parámetros de la línea de mandatos: um_cleanup directorio_instalación arquitectura nombre_TEMS componente donde: directorio_instalación arquitectura nombre_TEMS El directorio base donde están instalados los componentes de IBM Tivoli Monitoring. como por ejemplo li6243. A modo de ejemplo de ejecución de um_cleanup en los sistemas UNIX. y a continuación. que está al tanto de los cinco grupos de atributos originales. aunque el metarchivo sólo contenga tres. que muestra cómo realizar la supresión. que forma parte del nombre de vía de acceso a los directorios /ATTRLIB y /RKDSCATL. emplee CMS y no emplee Cms o cms. decide ejecutar um_cleanup para restablecer la versión de DISKMONITOR a 00. Supresión de las consultas del espacio de trabajo Como paso de limpieza adicional opcional. sol286 o aix533. que está instalado en los sistemas Windows. El nombre asignado durante la configuración del servidor de supervisión. se sigue utilizando la versión 00 original de las consultas. Supongamos que luego elimina dos de los grupos de atributos. A continuación. vaya al directorio /um/bin y escriba este mandato: ./um_cleanup /opt/IBM/ITM sol286 PRODTEMS UA componente Después de ejecutar el script um_cleanup en los sistemas Windows o UNIX. el árbol de Navigator sigue mostrando espacios de trabajos para cada uno de los cincos grupos de atributos originales. Creación de una aplicación 31 . debe reciclar los servidores de supervisión y del portal. que dan como resultado que se cree un nuevo sufijo de versión de aplicación. Si se da cuenta de que es necesario suprimir una o más consultas generadas por el servidor del portal para las aplicaciones de Tivoli Universal Agent. reiniciar Tivoli Universal Agent para activar los sufijos de la versión 00. Aunque este parámetro sólo se utiliza si el valor de componente es "CMS. Esta discrepancia se debe a que el servidor del portal guarda consultas del espacio de trabajo en la tabla KFWQUERY de la base de datos del servidor del portal que no se actualiza con el script um_cleanup.En los sistemas UNIX. Si no elimina los archivos del servidor de supervisión. revise si debe suprimirse algunas de las consultas del espacio de trabajo generadas por el servidor del portal para las aplicaciones de Tivoli Universal Agent. El nombre de la arquitectura de la plataforma del SO. Un caso donde tal vez este paso sea necesario es si inicialmente crea una aplicación de metarchivo denominada DISKMONITOR que contiene cinco grupos de atributos. puede proporcionar un nombre ficticio para este parámetro.

2. Los siguientes detalles son exclusivos de los metarchivos SNMP: v Como norma. la aplicación se registra con el sufijo de la versión 00. 5. 3. Puede descifrarlos con el mandato UNPACK proporcionado por Tivoli Universal Agent. no debe crear metarchivos para aplicaciones MIB de SNMP de la misma manera que lo hace para aplicaciones que se utilizan con otros proveedores de datos. El mandato presupone que la base del servidor del portal utiliza el nombre de fuente de datos predeterminado. Suprima el archivo DISODI00 del directorio \CNPS o /cq/data en el servidor del portal. debe realizar las acciones siguientes: 1.mdl. Para confirmar que se han suprimido las consultas de Tivoli Universal Agent generadas por el servidor del portal o para ver qué consultas hay actualmente definidas. Recicle el servidor de supervisión. Suprima los archivos DISATR00 y DISCAT00 de los directorios ATTRLIB y RKDSCATL. este mandato se entra desde el directorio \IBM\ITM\CNPS . Estos metarchivos los proporciona IBM. name from kfwquery where id like ’zkum. Si utiliza el ejemplo de aplicación DISKMONITOR mencionado en el apartado anterior. v Determinados metarchivos SNMP más antiguos están cifrados. Suprima los archivos DISATR00. utilizando únicamente un subconjunto de variables MIB que. Elimine todos los sistemas gestionados Hostname:DISKMONITORnn. ejecute el siguiente mandato select con respecto a la tabla KFWQUERY: kfwsqlclient /d TEPS2 /e "select id. Pero puede crear una versión modificada de un metarchivo SNMP.Para un servidor de portal basado en Windows. RFC1213_mib-2. TEPS2. DISODI00 y kumawDIS del directorio de trabajo de Universal Agent. v Normalmente. utilizando la opción Borrar entrada fuera de línea del cliente del portal. Tenga en cuenta que este mandato suprime todas la consultas de Universal Agent generadas por el servidor del portal. a se denominaremos aplicación SNMP personalizada. 4. el servidor de portal y Tivoli Universal Agent." 6. respectivamente. Debe compilar una MIB SNMP en un metarchivo de Tivoli Universal Agent mediante el programa MibUtility. v De forma predeterminada. Si desea suprimir todas las consultas de espacio de trabajo existentes para la aplicación DISKMONITOR.lotus. incluidas las sentencias de definición de atributos para todas las variables de MIB y los OID. pero puede cambiarlo si ha configurado otro nombre de fuente de datos distinto. Cuando se active la aplicación de metarchivo DISKMONITOR durante el arranque de Tivoli Universal Agent." Limpieza de una única aplicación Para restablecer el número de versión de una sola aplicación de Universal Agent. los metarchivos SNMP representan el contenido completo de una MIB. DISCAT00. puede realizar una serie de pasos manuales que esencialmente duplican las acciones realizadas en los scripts de limpieza. los metarchivos de SNMP se almacenan en subdirectorios distintos debajo de \metafiles. por ejemplo. v Algunos archivos SNMP creados durante el proceso de conversión de MIB a metarchivo sirven exclusivamente para definir variables de condición de excepción y no se utilizan para recopilar datos de MIB. en el servidor de supervisión. ejecute una versión modificada del mandato kfwsqlclient. Aplicaciones SNMP de Tivoli Universal Agent En este apartado se describen algunas de las propiedades especiales de los metarchivos SNMP de Tivoli Universal Agent. 32 IBM Tivoli Universal Agent: Guía del usuario .com/wps/portal/tm. pero se pueden modificar para crear sus propias aplicaciones SNMP personalizadas. 7.%%’.DISKMONITOR%%’. “Supresión de las consultas del espacio de trabajo” en la página 31. como por ejemplo. que se encuentra en la página de IBM Tivoli Monitoring en el sitio web de Open Process Automation Library (OPAL) que se encuentra en http://catalog. que siempre empiezan por zkum. como en el siguiente ejemplo: kfwsqlclient /d TEPS2 /e "delete from kfwquery where id like ’zkum.

Si en OPAL no encuentra lo que necesita y prefiere realizar usted mismo las conversiones de MIB a metarchivo.mdl.mdl donde: nombreproveedor Especifica el número RFC para MIB estándares IETF o un nombre de proveedor para un MIB específico de proveedor. No es necesario almacenar lo metarchivos SNMP proporcionados por Tivoli Universal Agent y los archivos trapcnfg o los propios metarchivos SNMP personalizados. empresa Especifica el nombre de la empresa MIB. Ubicación de los metarchivos SNMP En los sistemas operativos Windows. Por ejemplo. Si tiene aplicaciones específicas SNMP MIB que desea supervisar. No es necesario almacenar lo metarchivos SNMP proporcionados por Tivoli Universal Agent y los archivos trapcnfg o los propios metarchivos SNMP personalizados. Metarchivos MIB de proveedor convertidos proporcionados por IBM Tivoli Monitoring IBM\ITM\TMAITM6\metafiles\SNMP\vendor Metarchivos MIB RFC estándares de la industria convertidos proporcionados por IBM Tivoli Monitoring IBM\ITM\TMAITM6\metafiles\SNMP\standard Metarchivos SNMP personalizados IBM\ITM\TMAITM6\metafiles\CUSTOMIZED Metarchivos trapcnfg_* IBM\ITM\TMAITM6\metafiles\TRAPCNFG En los sistemas operativos UNIX. Acceda al programa MibUtility pulsando en la opción SNMP MIB to Universal Agent Conversion Utility que se encuentra en el ángulo inferior derecho de la página. Capítulo 3. primero consulte la página de IBM Tivoli Monitoring en el sitio web de OPAL que se encuentra en http://catalog. Creación de una aplicación 33 .lotus. pero puede utilizarlos para organizar mejor los archivos de definiciones SNMP. y compruebe los metarchivos de Tivoli Universal Agent existentes que dan soporte a la aplicación SNMP. en estos subdirectorios personalizados. los metarchivos de un proveedor de datos no SNMP se encuentran en el siguiente directorio: IBM\ITM\TMAITM6\metafiles Los metarchivos SNMP y archivos trapcnfg se encuentran en los siguientes subdirectorios. Nombres de metarchivos Los nombres de metarchivos SNMP tienen el formato: nombreproveedor__empresa. puede utilizar el programa MibUtility en la página de IBM Tivoli Monitoring que se encuentra en el sitio web de OPAL en la dirección: http://catalog. pero puede utilizarlos para organizar mejor los archivos de definiciones SNMP.com/wps/portal/tm.com/wps/portal/tm.lotus. el metarchivo para el estándar de la industrial MIB-2 es RFC1213_mib-2.mdl. en estos subdirectorios personalizados. los metarchivos un proveedor de datos no SNMP se encuentra en el siguiente directorio: <dir_instalación>/$ARQBIN/um/metafiles Los metarchivos SNMP y archivos trapcnfg se encuentran en los siguientes subdirectorios. y el de la interfaz de Cisco MIB es Cisco_linterfaces.IBM ofrece metarchivos SNMP para centenares de MIB estándares de la industria.

mdl.1.3=xxxx}. los números de versión de todos los sistemas gestionados.3.2.1. El número de versión de una aplicación y. Metarchivos SNMP sólo de condición de excepción Determinados metarchivos SNMP se utilizan exclusivamente con el fin de que los datos de condición de excepción recibidos sean más inteligibles en la columna Value_List del espacio de trabajo SNMP-MANAGER TRAP.″ La sustitución del nombre de atributo del OID hace que la información sea más inteligible en el espacio de trabajo TRAP.3.Metarchivos MIB de proveedor convertidos proporcionados por IBM Tivoli Monitoring <dir_instalación>/$ARQBIN/um/metafiles/SNMP/vendor Metarchivos MIB RFC estándares de la industria convertidos proporcionados por IBM Tivoli Monitoring <dir_instalación>/$ARQBIN/um/metafiles/SNMP/standard Metarchivos SNMP personalizados <dir_instalación>/$ARQBIN/um/metafiles/CUSTOMIZED Metarchivos trapcnfg_* <dir_instalación>/$ARQBIN/um/metafiles/TRAPCNFG Importación de metarchivos SNMP Utilice el mandato de consola IMPORT. pero ésta es la única finalidad del metarchivo sólo de condición de excepción.858. se invoca una rutina de búsqueda para determinar si hay un metarchivo SNMP activo que defina el mismo OID. Por consiguiente.1.1.4.txt en el mismo directorio que el archivo . Visualización de metarchivos de aplicaciones Los metarchivos SNMP cifrados no son legibles a menos que se procesen mediante el mandato de consola UNPACK: kumpcon unpack nombre_metarchivo Este mandato produce un archivo llamado metarchivo_nombre. si se ha importado autosys.2.3. espacios de trabajo y grupos de atributos basados en el mismo. Cuando el proveedor de datos de SNMP recibe una condición de excepción y extrae un valor OID del paquete de condiciones de excepción.mdl y el OID 1. Los espacios de trabajo para metarchivos que son sólo de condición de excepción no se llenan con los datos de condición de excepción recibidos. Mantenimiento de versiones de aplicaciones El número de versión de todas las aplicaciones SNMP es 00.2. Estos metarchivos sólo de condición de excepción no recopilan datos de condición de excepción o datos MIB. consulte “Redirección de los datos de condición de excepción” en la página 79 para obtener más información al respecto.858. la columna Value_List en el espacio de trabajo SNMP-MANAGER TRAP muestra ″{alarmText=xxxx}″ en lugar de ″{1.2.4.3 está descodificado de un paquete de condiciones de excepción.mdl tiene el OID coincidente. Los datos de condición de excepción sólo están en el espacio de trabajo SNMP-MANAGER TRAP (a menos que se utilice la característica de redirección de condición de excepción.6.1. Por ejemplo. se incrementa cada vez que se carga una definición actualizada (metarchivo) de la aplicación.1. por lo tanto. la rutina de búsqueda determina que "alarmText″ en autosys.6. el recuadro de diálogo de Actuación Control Import o dirija la actualización del archivo de inicialización KUMPCNFG para importar los metarchivos que definen las aplicaciones SNMP a Tivoli Universal Agent. También puede utilizar el mandato de consola VALIDATE para ver el contenido del metarchivo SNMP en un formato descifrado: kumpcon validate nombre_metarchivo 34 IBM Tivoli Universal Agent: Guía del usuario .3. y por consiguiente los espacios de trabajo siempre están vacíos.1.1.

puede establecer la variable de entorno. Para impedir que entre los niveles de directorio adicionales.1. Las variables MIB de SNMP tienen OID que no terminan en cero.1. Las variables MIB de SNMP escalares son definiciones con OID que acaban en cero. Los siguientes apartados describen los pasos necesarios para creas sus propias aplicaciones. “Creación de una aplicación”.0 udpInDatagrams C 999999 1. Por ejemplo: SysName D 255 1.7.0 ipInReceives C 999999 1. No obstante.4. si desea utilizar atributos de distintos grupos en la situación.txt llamado RFC1213_mib-2. tendrá que crear otras situaciones e incorporarlos.3. en la página 17 para obtener información adicional sobre el mandato validate.1.6.2. No obstante.3. Creación de una aplicación 35 . sólo algunos pocos atributos en un grupo pueden resultar interesantes en una situación de gestión de red en particular. entre otras cosas.6. se crea un nuevo grupo de atributos para cada nuevo grupo de variables escalares encontradas y para cada nueva tabla conceptual.1. procedentes de las que proporciona IBM Tivoli Monitoring.Cuando ejecute el mandato de validación (validate).3.mdl descifra el metarchivo estándar de la industria RFC1213_mib-2. Utilizando el siguiente ejemplo. información acerca de los atributos.1. Por ejemplo.2.3. Consulte el Capítulo 3. lo cual significa que tiene que abrir varios espacios de trabajo para ver y analizar una situación de problema.0 Tenga en cuenta el formato de los atributos o cópielos al metarchivo en el que vaya a definir la aplicación SNMP personalizada. O bien puede comprobar y correlacionar valores de atributos de distintos grupos de atributos o incluso de MIB distintos. Paso 1: Desempaquete los metarchivos SNMP Ejecute el mandato de consola UNPACK en cada metarchivo cifrado que contenga atributos que desee incluir en la aplicación y examine el archivo de texto de salida. Ya que sólo es posible crear situaciones que utilicen atributos del mismo grupo de atributos.txt. Puede colocar todos los atributos escalares en uno o más grupos de atributos.2.1.1. KUMP_META_PATH.1. Creación de aplicaciones SNMP personalizadas En los metarchivos creados por IBM Tivoli Monitoring a partir de las MIB. produce un archivo de informe que termina con la extensión . No necesita copiar todos los atributos en una tabla MIB dentro del grupo de atributos. en el directorio donde se encuentra el metarchivo de MIB de SNMP. no puede mezclar atributos MIB escalares y tabulares en un grupo de atributos. En estas aplicaciones personalizadas puede utilizar atributos de distintos grupos e incluso de distintas MIB. deberá definir cada tabla de atributos MIB como su propio grupo de atributos. puede elegir únicamente aquellos atributos en la tabla que sean de interés.mdl y produce un archivo .6.5.mdl Paso 2: Identifique las variables MIB de SNMP escalares que sean interés Explore los atributos que aparecen en el archivo de texto para identificar todas las variables escalares que sean de interés.rpt que contiene. Puede evitar estas limitaciones construyendo sus propias aplicaciones SNMP basadas en MIB. entre los dos mandatos siguientes en un indicador de mandatos DOS de Windows: C:\IBM\ITM\TMAITM6>set KUMP_META_PATH=C:\IBM\ITM\TMAITM6 \metafiles\SNMP\standard C:\IBM\ITM\TMAITM6>kumpcon unpack RFC1213_mib-2. el mandato kumpcon unpack metafiles\SNMP\standard\RFC1213_mib-2. Capítulo 3. Si está interesado en los datos tabulares.

1.1.6.6.1.2. utilizando el recuadro de diálogo de Actuación Control Import o incluido el nombre de metarchivo en el archivo de configuración.6.2.7.3.6.2.1.10.1. Paso 5: Importe el metarchivo en Tivoli Universal Agent Haga que metarchivo esté disponible para Tivoli Universal Agent ejecutando el mandato de consola IMPORT. //SNMP TEXT //APPL SNMPEXAMPLE //NAME TcpipNodeMonitor k 3600 //ATTRIBUTES’.2.0 ipInDelivers C 999999 1.1. Debe hacer que los primeros tres caracteres del nombre de aplicación sea exclusivo entre todos los Tivoli Universal Agent conectados a un servidor de Tivoli Enterprise Monitoring determinado.6.2. En la Figura 7 se muestra un ejemplo de metarchivo de aplicación SNMP personalizado.1.0 tcpAttemptFails C 999999 1.3.6. los primeros dos atributos debe ser: Agent_Info Agent_Name D D 128 64 0.1.6. v En cada grupo de atributos.1.2.4.1. pero puede asignar atributos a más de un grupo de atributos.1.4.1.0 tcpOutSeqs % 999999 1.0 tcpInSeqs % 999999 1.Paso 3: Construya un metarchivo de aplicación SNMP personalizado Revise los requisitos de metarchivo.6.0 tcpRetransSeqs C 999999 1.2.0 sysServices C 127 1.5.1.’ Agent_Info D 128 0.7.3.0 Figura 7.1.12.6.6.0 tcpActiveOpens # 999999 1.0 ipInReceives C 999999 1.3.1.6.2.0 Agent_Name D 64 KEY 0.6. Recuerde que no puede utilizar atributos de distintos grupos en una única situación.11.6.0 ipOutDiscards C 999999 1.9.1.10.0 tcpPassiveOpens # 999999 1.0 Consulte la Figura 7 para ver un ejemplo de un metarchivo de SNMP personalizado de ejemplo.3.6.3.11.2.2.3.1.2.3.0 udpOutDatagrams ? 999999 1.6.3.0 ipInDeliverPercent (ipInDelivers %ipInReceives) ipInDiscardPercent (ipInDiscards %ipInReceives) ipInAddrErrors # 999999 1.1.6.0 ipOutDiscardPercent (ipOutDiscards %ipOutRequests) udpInDatagrams ? 999999 1.3.4.9. sintaxis y restricciones.6.2.1.2.6.1.3.3.3.1.6.1.3.1.1. Existen dos normas para los metarchivos SNMP: v El metarchivo debe incluir //SNMP TEXT como primera sentencia.0 sysName D 255 1.4.2.1. KUMPCNFG.7.7.1. y a continuación.1.1.3.4.3.6.1. Procure seleccionar un nombre exclusivo para la aplicación.0 KEY 0.1.1.0 sysDescr D 255 1.6.0 ipInDiscards C 999999 1.6.2.6.3.0 tcpCurrEstab C 999999 1.6.7.1.2.1.1.2. Metarchivo de aplicación SNMP personalizado 36 IBM Tivoli Universal Agent: Guía del usuario . Agrupe los atributos seleccionados en uno o más grupos de atributos según sea conveniente para las situaciones de gestión propias.3.1.1. Revise el informe de salida en busca de cualquier mensaje de aviso o error y modifique el metarchivo según sea necesario.1.5.1.10.1.1.6.4.0 ipOutRequests C 999999 1.6.2.1. reciclando Tivoli Universal Agent.8. Paso 4: Valide el metarchivo Ejecute el mandato de consola VALIDATE.1.

La Figura 8 ilustra la relación entre los proveedores de datos y las fuentes de datos. metarchivos y proveedores de datos © Copyright IBM Corp. socket. Visión general de los proveedores de datos Los proveedores de datos son las interfaces de Tivoli Universal Agent. Los proveedores de datos permiten hacer lo siguiente: v Cargar y validar metarchivos de definición de datos. Un proveedor de datos determinado puede soportar varias aplicaciones de Tivoli Universal Agent simultáneamente. programas cliente. como archivos de registro. SNMP. URL. 2007 37 . Tipos de proveedores de datos Tivoli Universal Agent da soporte a los proveedores de datos de archivo. Este capítulo describe dicho proveedores de datos y sus características. envío. servidor de API. Relación entre las fuentes de datos. Aunque es útil desde un punto de vista conceptual para ver los proveedores de datos como entidades independientes. scripts. Figura 8. v Pasar los datos recopilados y la información acerca de los metarchivos de definición de datos a Tivoli Universal Agent. tablas relacionales o agentes de SNMP.Capítulo 4. Acerca de los proveedores de datos Este capítulo trata acerca de las características de los proveedores de datos necesarios para crear metarchivos para definir aplicaciones de Tivoli Universal Agent o para desarrollar programas para enviar datos a Tivoli Universal Agent. Script y ODBC. HTTP. metarchivos y Tivoli Universal Agent. v Recopilar datos desde las fuentes de datos. Permiten proporcionar datos de la manera que sea más conveniente o práctica para el caso de supervisión en cuestión. 2003. se ejecutan como subprocesos dentro del proceso Tivoli Universal Agent de general.

No obstante. realice los pasos siguientes para crear una instancia no primaria nueva (también conocida con el nombre de instancia alternativa) de Tivoli Universal Agent: 1. de una en una. 3. Los convenios de nomenclatura de los nombres de instancia incluyen: Prueba de latido Proveedor de datos Aplicación nombreinst:nombrehost:UA nombreinst_nombrehostDPTIPOdp:UAGENT00 nombreinst_nombrehost:aplicaciónVV El nombre de instancia se añade como sufijo a todos los archivos de configuración y de tiempo de ejecución en el directorio de trabajo de Tivoli Universal Agent. el nombre de sistema gestionado por Tivoli Universal Agent generado utiliza un parámetro de nombre de instancia como prefijo para garantizar la exclusividad. v Puede crear versiones de Tivoli Universal Agent especializadas con fines de agrupamiento lógico. Los archivos de configuración y de tiempo de ejecución de Tivoli Universal Agent primario permanecen como antes. Por ejemplo: itmcmd config -A -o Test um 38 IBM Tivoli Universal Agent: Guía del usuario . Creación de instancias de Tivoli Universal Agent alternativas En los sistemas operativos Windows. como verificar los cambios en las variables de entorno y los metarchivos antes de actualizarlos en la versión de Tivoli Universal Agent de prueba. Seleccione Crear instancia. es posible ejecutar varias copias adicionales. con o sin Tivoli Universal Agent primario activo. y pulse Aceptar. Por ejemplo. Para ejecutar varias instancias del mismo proveedor de datos en el mismo sistema. puede utilizar los agentes especializados para supervisar partes de la red. KUMATBLS_INST1 o KUMPURLS_PROD. Tivoli Universal Agent añade como prefijo de un parámetro de nombre de instancia el nombre del sistema gestionado. 2. Para distinguir entre las diferentes instancias a medida que se registran con el servidor de supervisión. ni tiene un sufijo de nombre de instancia en sus archivos de configuración. Escriba un nombre de instancia corto. KUMPCNFG_TEST. Sólo puede haber una copia primaria de Tivoli Universal Agent configurada y activa en el sistema al mismo tiempo. cada una con un nombre de instancia exclusivo. una copia primaria o no de instancia de Tivoli Universal Agent genera un nombre de sistema gestionado con el formato: nombrehostDPTIPOdp:UAGENT00. v Puede equilibrar cargas de trabajo. Pulse con el botón derecho del ratón en el Universal Agent primario del recuadro de diálogo Manage Tivoli Enterprise Monitoring Services. La versión de Tivoli Universal Agent de prueba se puede utilizar para verificar un nuevo mantenimiento. El Tivoli Universal Agent primario no tiene un prefijo de nombre de instancia en sus nombres de sistema gestionado. Nombres de instancias Para cada proveedor de datos que pase a estar en línea. Se visualiza el recuadro de diálogo Crear instancia. v Puede conectar varios Tivoli Universal Agent a diferentes servidores de supervisión. sin sufijo. si el volumen de los datos recopilados está sobrecargando un único Tivoli Universal Agent. Por ejemplo. En los sistemas operativos UNIX. preferentemente entre 3 y 6 caracteres. se crean instancias alternativas de Tivoli Universal Agent con el distintivo -o en el mandato itmcmd config. Ejecutar varias copias de IBM Tivoli Universal Agent en un único sistema ofrece las siguientes ventajas: v Puede ejecutar una versión de Tivoli Universal Agent de prueba y producción en el mismo sistema.Ejecución de varias instancias de un proveedor de datos Puede ejecutar varias instancias de un tipo de proveedor de datos determinado en un único sistema configurando o ejecutando varias instancias de Tivoli Universal Agent en dicho sistema.

como recopilar datos MIB. si se utiliza el nombre de instancia ABCDEFGHIJKLMNOP y el nombre de sistema gestionado resultante es de 35 caracteres. El no poder adquirir el puerto de escucha de condiciones de excepción queda registrado en el registro RAS1 de Tivoli Universal Agent y en el espacio de trabajo UAGENT DPLOG del proveedor de datos de SNMP. Envío de mandatos de consola a una instancia alternativa Para que una conexión de programa o consola utilice una instancia de Tivoli Universal Agent alternativa. la lista de nombres de sistemas gestionados disponibles incluye el prefijo del nombre de la instancia. En las plataformas UNIX. Para preservar la integridad del nombre de sistema gestionado. el primer Tivoli Universal Agent que active el proveedor de datos de SNMP adquiere el puerto 162. cuando se accede a un Tivoli Universal Agent no primario mediante la interfaz de la consola.Guía de instalación y configuración. y no en el entorno de proceso de Tivoli Universal Agent principal. 520. Asumiendo que no hay otro gestor de SNMP distinto de Tivoli Universal Agent o escucha de condición de excepción ya activo. no una restricción de Tivoli Universal Agent. el indicador del proveedor de datos de destino muestra el Nombre de instancia junto a cada proveedor de datos. seleccione nombres de instancia cortos para evitar el truncamiento del nombre del sistema gestionado. Acerca de los proveedores de datos 39 . que proporciona los números de puerto de las escuchas de socket y API. Tivoli Universal Agent limita el nombre completo de sistema gestionado (prefijo de instancia + nombre de host + nombre de aplicación + sufijo de versión) a 32 caracteres. Por ejemplo. Para acceder al Tivoli Universal Agent de destino correcto. Cualquier Tivoli Universal Agent siguiente que active el proveedor de datos de SNMP no podrá abrir el puerto de escucha de condiciones de excepción pero podrá realizar otras funciones de proveedor de datos de SNMP. De forma predeterminada. La interfaz de actuación no tiene este problema de ambigüedad. y el puerto de consola para los mandatos kumpcon. que la característica de descubrimiento de red que el proveedor de datos de SNMP utiliza. el prefijo del nombre de instancia se trunca por la izquierda. el Tivoli Universal Agent de destino es la copia primaria y utiliza un puerto de consola en el rango entre 7700 y 7710. el error al iniciar los componentes de escucha de condiciones de excepción y descubrimiento de la red genera los siguientes mensajes de error después de emitir el mandato itmcmd agent start um: Nota: El proceso de Universal Agent. Esta es una restricción de SNMP. Para impedir que se emitan mandatos para el Tivoli Universal Agent equivocado. Sólo un proceso puede adquirir el puerto de escucha 162 reservado para la condición de excepción de SNMP. Por ejemplo.ini. Nota sobre el truncamiento Manage Tivoli Enterprise Monitoring Services ofrece una ventana con menús contextuales donde puede utilizar un nombre de instancia de entre 1 y 20 caracteres. puede encontrar el número de puerto buscando "DP console port en el registro RAS1 de Tivoli Universal Agent de dicha instancia. en función de qué tipo de proveedor de datos esté activo. Se produce el mismo conflicto de puertos con el puerto del direccionador predeterminado. el sistema gestionado registrado aparece como: DEFGHIJKLMNOP_nombrehost:nombreapliVV Por lo tanto. Cuando se distribuye una acción como URL Add o Manage Start. Capítulo 4. Ejecución de varias instancias de los proveedores de datos de SNMP Incluso con soporte para varias instancias. no especifique esta variable en los archivos \TMAITM6\KUMENV o /config/um. el proveedor de datos ASFS utiliza el puerto de escucha de consola 7701 y el proveedor de datos de ODBC utiliza el 7704. debe especificar la variable de entorno KUMP_DPCONSOLE_PORT en el entorno del script de shell kumpcon. utilice el espacio de trabajo UAGENT DPLOG. consulte la publicación IBM Tivoli Monitoring . no es posible ejecutar dos proveedores de datos de SNMP a pleno rendimiento en el mismo sistema.exe o um_console. kumstrap no se ha iniciado.Para obtener más información sobre cómo configurar varias instancias de Tivoli Universal Agent en los sistemas UNIX. Si el número de puerto de la Consola del proveedor de datos ya no es visible porque se ha desplazado fuera del informe DPLOG. No obstante. Es decir.

kumsnetd no se ha iniciado.Nota: El proceso de Universal Agent. en especial si ejecuta varias versiones de una aplicación con el mismo nombre. copie o renombre el archivo trapcnfg en el directorio de trabajo para que tenga el sufijo del nombre de la instancia. una supervisión duplicada puede causar problemas. No obstante. Nota: Si utiliza una instancia alternativa de Tivoli Universal Agent como el receptor de condiciones de excepción de SNMP. Conflictos entre aplicaciones duplicadas No ejecute la misma aplicación en dos instancias de Tivoli Universal Agent diferentes. copie trapcnfg a trapcnfg_SNMP. Mediante el uso de los archivos de configuración con sufijos es relativamente fácil mantener un conjunto diferente de aplicaciones de Tivoli Universal Agent para las distintas versiones de Tivoli Universal Agent que ejecute. es una pérdida de tiempo y una acción poco eficaz. nada le impide activa la misma aplicación en dos Tivoli Universal Agent distintos. En algunos casos. puede supervisar el mismo archivo de registro y los mismos URL. Por ejemplo. si la instancia alternativa se llama ″SNMP″. 40 IBM Tivoli Universal Agent: Guía del usuario . Por ejemplo. En otros casos.

Este método es particularmente útil porque permite enviar datos o crear sucesos siempre que surja la necesidad. El representante de servicio al cliente podría entrar un mandato de API con texto adicional. Acerca de los proveedores de datos 41 . el soporte cliente puede recibir una llamada urgente de una localización crítica de un cliente. No crea complejidad o dependencias de programación añadidas para el programa que realiza la llamada. El mandato provoca que una situación fuese cierta y que se notifique al equipo de acción de guardia. Invocación de las API Puede invocar las API de Tivoli Universal Agent de las siguientes maneras: v Llamadas de función de programa Puede desarrollar o modificar los programas C/C++ que invocan las funciones de API directamente como subrutinas. El proveedor de datos y las API de Tivoli Universal Agent permiten un sencillo de desarrollo de scripts y programas en C/C++ para enviar datos a Tivoli Universal Agent.Proveedor de datos de servidor de API El proveedor de datos de servidor de API (interfaz de programación de aplicaciones) soporta las funciones de cliente de API. También soportan una interfaz de línea de mandatos que implementa un subconjunto de las funciones de API. v Mandatos manuales Puede entrar mandatos de API directamente desde una consola del sistema. Capítulo 4. Consulte la publicación IBM Tivoli Universal Agent . Paquete de cliente de API El paquete de cliente de API del proveedor de datos consiste de lo siguiente: v Una biblioteca que contiene los archivos ejecutables de las funciones API v Un archivo de cabecera de C v Un conjunto de programas de interfaz de la línea de mandatos El paquete de cliente se ha desarrollado en C y sólo requiere un entorno en tiempo de ejecución de C común y TCP/IP con una interfaz de sockets. v Llamadas de archivo de script Puede desarrollar o modificar archivos de script o por lotes que llamen a los programas de interfaz de línea de mandatos de API.Guía de consulta de programación de API y de mandatos para obtener información completa acerca de las API y los mandatos soportados de Tivoli Universal Agent. Por ejemplo.

Implementación del Proveedor de datos del servidor de API Invocación de programas Los programas de llamada C/C++ creados con las API de Tivoli Universal Agent descansan sobre los servicios de API proporcionados por la biblioteca dinámica en tiempo de ejecución. y proporciona descripciones. La publicación IBM Tivoli Universal Agent . Los programas se pueden localizar localmente con el Proveedor de datos del servidor de API o no pueden iniciarse en una ubicación remota. Los mandatos de consola API también se pueden integrar en un script.Guía de consulta de programación de API y de mandatos contiene descripciones de los mandatos de consola.Guía de consulta de programación de API y de mandatos contiene los requisitos de programa y los procedimientos para implementar las funciones de la API. Estos programas de llamadas suelen ser denominados clientes API porque dependen del paquete cliente de API y siguen el paradigma cliente-servidor en las conexiones que establecen con el proveedor de datos de API. Los mandatos utilizan la misma biblioteca en tiempo de ejecución como funciones API C/C++ y se pueden invocar desde una ventana de mandatos en el sistema local o desde una ventana de mandatos en un sistema remoto. También puede considerar los clientes de API como recopiladores de datos ya que su principal propósito es realizar cierto tiempo de recopilación de datos y enviar dichos datos recopilados al proveedor de datos de servidor de API. así como un programa cliente de ejemplo de API. La publicación IBM Tivoli Universal Agent .Figura 9. Mandatos de consola API Los mandatos de consola API son programas de la interfaz de línea de mandatos que llaman a las funciones API. sintaxis y códigos de retorno de las llamadas a la API. 42 IBM Tivoli Universal Agent: Guía del usuario .

puede establecer la variable de entorno KUMP_API_DPAPI_PORT en el puerto preferido. el valor NombreHost es diferente del host donde se ejecuta el proveedor de datos de las API.Guía de consulta de programación de API y de mandatos para obtener información adicional. Puede personalizar la parte NombreHost del nombre de sistema gestionado con la API dp_SetSourceName. deberá establecer la misma variable en el lado del cliente de API. Acerca de los proveedores de datos 43 . Nota: El sistema gestionado de una aplicación de metarchivo API no pasa a estar en línea en Tivoli Enterprise Portal Navigator hasta que el programa cliente de API se haya conectado al proveedor de datos de servidor de API. Puede comprobar el espacio de trabajo UAGENT DPLOG del Proveedor de datos (o ASFS) para verificar el número de puerto de escucha correcto. Nota: Si el cliente de API se está conectando desde un sistema remoto. El mensaje KUMPL020I en DPLOG muestra el puerto de escucha que el proveedor de datos de servidor de API está utilizando. Si este puerto ya se está utilizando o prefiere que se utilice un puerto distinto. Si el proveedor de datos de servidor de API se ejecuta en un sistema remoto. Consulte la publicación IBM Tivoli Universal Agent . debe establecer la variable de entorno KUMP_API_DPAPI_HOST en el nombre de host del proveedor de datos de servidor de API. Si establece esta variable para el proveedor de datos de servidor de API o si esta variable se ha reasignado de forma automática como resultado de una instancia alternativa de Tivoli Universal Agent. VV Sufijo de dos dígitos de la versión. Capítulo 4. NombreAplic Nombre de valor especificado en la aplicación de metarchivo API. Especificación del puerto de escucha del proveedor de datos del servidor de API El puerto de escucha predeterminado para el proveedor de datos de servidor de API es 7600. Nombres de sistemas gestionados de aplicaciones del proveedor de datos de servidor de API El nombre del sistema gestionado de una aplicación de metarchivo de API tiene el siguiente formato: NombreHost:NombreAplicVV donde: NombreHost Host donde se está ejecutando el programa cliente de API.Especificación del host del proveedor de datos de servidor de API La modalidad predeterminada del cliente API presupone que el proveedor de datos de servidor de API se encuentra en el mismo sistema.

En este caso. Nombres de sistemas gestionados en las aplicaciones del proveedor de datos de archivo Si el archivo especificado en la sentencia //SOURCE FILE del metarchivo es accesible cuando se activa el metarchivo. El sistema operativo puede eliminar la naturaleza remota de un archivo del proveedor de datos en ejecución implementando un sistema de archivos de red o correlacionando un recurso del sistema remoto con un dispositivo local. También debe hacer referencia al nombre de archivo en el metarchivo utilizando el formato UNC (Convenio Universal de Nomenclatura) en lugar de utilizar una correlación de letra de unidad. volver a configurar el servicio Tivoli Universal Agent de Windows con una cuenta distinta de la cuenta "LocalSystem" predeterminada. Consulte “Sentencia APPL” en la página 131 para obtener información adicional. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. El applet Servicios del Panel de control de Windows permite configurar una cuenta diferente para un servicio en particular. Puede personalizar la parte de NombreHostLocal del nombre de sistema gestionado con el parámetro en la sentencia //SOURCE del metarchivo. Y debe asegurarse de que el mismo id de usuario/cuenta configurados en el applet Servicios estén definidos en el sistema remoto donde se encuentra el archivo. Ubicación del proveedor de datos de archivo El proveedor de datos de archivo debe estar en el mismo sistema que los archivos que el proveedor de datos de archivo supervisa o los archivos deben aparecer en el proveedor de datos como si estuvieran en el sistema local. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27 para obtener información adicional.Proveedor de datos de archivo El proveedor de datos de archivo supervisa los datos que se encuentran en un archivo de texto secuencial. VV Sufijo de dos dígitos de la versión. La frecuencia de muestreo queda determinada como se muestra a continuación: v Para los datos de tipo de suceso. el proveedor de datos de archivo muestrea los datos cada 15 segundos o los segundos especificados por la variable de entorno KUMP_DP_EVENT. Nota: Si el proveedor de datos de archivo está supervisando un archivo en un sistema remoto mediante el uso de la correlación de unidades lógicas. puede cambiar la cuenta de Tivoli Universal Agent de "LocalSystem" a un ID de administrador autorizado en la LAN para acceder a los archivos en el sistema remoto. El proveedor de datos de archivo ofrece la manera más simple y más directa de utilizar Tivoli Universal Agent para supervisar los datos con IBM Tivoli Monitoring. 44 IBM Tivoli Universal Agent: Guía del usuario . el ID de usuario y la cuenta asociadas con Tivoli Universal Agent deben tener suficiente autorización para abrir y leer el archivo en el sistema remoto. por ejemplo. Consulte “Sentencia SOURCE” en la página 140 para obtener más información. En algunos casos esto requiere. Frecuencia de muestreo de archivos El proveedor de datos de archivo muestrea un archivo supervisado periódicamente en busca de nuevos registros. El archivo supervisado no puede tener un tamaño de más de 4 GB. un nombre de sistema gestionado con el siguiente formato pasa a estar en línea: NombreHostLocal:NombreAplicVV donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de archivo.

Supervisión de archivos globalizados Puede utilizar el proveedor de datos de archivo para supervisar los archivos en cualquier idioma o codificación de caracteres. se graba un mensaje en el registro RAS1 de Tivoli Universal Agent que identifica la frecuencia de muestreo mínima en vigor. El proveedor de datos de archivo también cumple una frecuencia de muestreo mínima. Puede alterar temporalmente este valor predeterminado utilizando la variable KUMP_DP_SAMPLE_FACTOR. en el caso de un TTL igual a 180 y un KUMP_DP_SAMPLE_FACTOR igual a 360. La frecuencia de muestreo que se hace cumplir en realidad es 300. el máximo predeterminado. Entrada de varios registros El proveedor de datos de archivo soporta la entrada de varios registros en aquellos casos en los que los registros de archivos físicos comprendan más de un registro físico. Cuando lo haga. La frecuencia de muestreo predeterminada máxima es de 5 minutos (300 segundos). Dichos dos parámetros le dicen al proveedor de datos de archivo qué codificación de caracteres utilizar Capítulo 4. la frecuencia de muestreo es 3600 dividida por 5. redes y aplicaciones mantienen información útil en archivos adecuados para su supervisión mediante un proveedor de datos de archivo. la frecuencia de muestreo deriva del valor de tiempo de vida (TTL) especificado en el metarchivo de definición de datos. los datos de los dos primeros atributos en un grupo de atributos pueden encontrarse en un registro de archivo. si un metarchivo especifica un TTL de 3600 segundos. Por ejemplo. el registro de sucesos de Windows no puede leerse fácilmente como un archivo secuencial. No obstante. debe especificar los parámetros CODEPAGE y LOCALE en la sentencia del //SOURCE del metarchivo. si los datos no están ya en un archivo secuencial. El programa obtiene los registros mediante las API correspondientes y. tenga en cuenta lo siguiente: v Si el idioma y página de códigos de los datos de archivo que está supervisando no están en el idioma y página de códigos predeterminado del sistema en el que Tivoli Universal Agent se está ejecutando. Por ejemplo. si especifica KUMP_DP_SAMPLE_FACTOR como 10. Puede definir conjuntos de registros que consistan en un número fijo de registros. La frecuencia de muestreo de cada archivo supervisado también se graba en UAGENT DPLOG en el mensaje KUMPL016I. el proveedor de datos de archivo muestrea los datos cada 60 segundos (300 dividido por 5). Consulte “Sentencia RECORDSET” en la página 153 para obtener más detalles.v Para aquellos datos sondeados. Si no define una alteración temporal. Rutinas de extracción especiales Muchos sistemas operativos. La frecuencia de muestreo predeterminada de 30 segundos se sustituye si el TTL dividido por el factor de muestreo resulta en una frecuencia de menos de 1 segundo. el archivo se muestreará realmente cada 30 segundos. No obstante. o 720 segundos. puede desarrollar un programa extractor utilizando las API de registro de sucesos de Win32 para acceder a los registros de sucesos. Por ejemplo. La alteración temporal máxima tiene lugar sólo si no se ha definido una especificación de usuario. la frecuencia de muestreo es 360. dividido por el factor de muestreo. podrá crear un programa de extracción para exportar los datos de la fuente nativa a un archivo secuencial para que el proveedor de datos de archivo tenga acceso al mismo. o de un número variable de registros identificados por un patrón delimitador. Por ejemplo. a continuación graba los registros en un archivo secuencial supervisado por el proveedor de datos de archivo. Si se altera temporalmente la frecuencia especificada. y los datos del quinto atributo en un tercer registro. O bien puede concatenar los datos de cinco registros y tratarlos como si fuesen un único atributo para propósitos de supervisión. y los datos del tercer y cuarto atributo en un segundo registro. Puede controlar la frecuencia de muestreo para los datos sondeados y muestreados utilizando la variable de entorno KUMP_DP_SAMPLE_FACTOR y el TTL. Acerca de los proveedores de datos 45 . No obstante. muestreados y con clave. El TTL predeterminado es de 300 segundos y el factor de muestreo es 5.

basándose en qué nombre de archivo coincidente tiene el número o valor de fecha/hora más alto. En estos casos. especifique el siguiente patrón de nombre de archivo de supervisión en la sentencia //SOURCE en lugar del nombre de archivo real: //SOURCE ARCHIVO espec-patrón-nombre-archivo El proveedor de datos de archivo inspecciona todos estos archivos en la ubicación de vía de acceso designada.txt. deberá escribir el nombre de vía de acceso y de archivo en el metarchivo en el idioma correspondiente. Coincide con los nombres de archivos numéricos de longitud 8 e ignora la extensión del archivo. Por ejemplo. Se pueden especificar patrones para nombres de archivo que consten de una o varias partes.log. 10252006. Por ejemplo.log y 10252006. Se supervisa el archivo Console. el año o un nombre de archivo que incluye un número de secuencia de incremento.000133.txt y PS010FTP. Se supervisará el archivo 02110200. Tivoli Universal Agent sólo puede abrir y leer archivos en codificación ASCII o UTF-8. la sentencia //SOURCE define un nombre de archivo de aplicación fijo. Coincide con los nombres de archivo que comienzan por PS seguido por tres numerales seguido de FTP y la extensión .cuando se procesen los datos de archivo. Coincide con los nombres de archivos que contienen Console en la parte del nombre y un número de 6 dígitos en la parte de la extensión. Log{###} coincide con nombres de archivo de una parte. deberá guardar el metarchivo como un archivo UTF-8.{######} IN{######}.abc.abc. PS005FTP.* {######??}. se pueden especificar caracteres de patrón en tan sólo una de las partes. en lugar de por la fecha de creación u otros criterios.000201.abc porque 021102 es el número más grande. aaa.abc. Se supervisará el archivo PS010FTP.abc y 021101AZ.txt.abc porque 10262006 es mayor que 10252006.txt.log se supervisa porque 20061101 es el número más grande.abc Coincide con los nombres de archivos numéricos de longitud 8 y con la extensión de archivo . el mes.log. Los ejemplos incluyen IN021001.bbb{???}. 02110200.txt 46 IBM Tivoli Universal Agent: Guía del usuario . Se supervisará el archivo 10262006. En los nombres de archivo de varias partes.log.ccc es un patrón válido. Los ejemplos incluyen PS001FTP. IN021002. El proveedor de datos de archivo siempre gestiona el archivo coincidente más reciente. como por ejemplo Log010 o bien Log456. No obstante.abc.abc.log. Los ejemplos incluyen Console.000201 y Console. Los ejemplos incluyen 02110199.txt.abc Console. Los ejemplos incluyen 20061025.bbb{???}.log.ccc{###}. 20061101. buscando archivos que coincidan con el patrón definido. No obstante. Los siguientes ejemplos ilustran la especificación de patrón de nombre de archivo: {########}. El archivo 20061101. como por ejemplo. pero no lo es aaa. {########}.000134. Se supervisará el archivo IN021004. Coincide con los nombres de archivos numéricos de longitud 8 e ignora las dos últimas posiciones de la parte de nombre. Soporte de nombres de archivo dinámicos Como norma. Consulte “Sentencia SOURCE” en la página 140 para obtener información adicional acerca de la utilización de esta sentencia de metarchivo.abc o 10262006. algunos programas de aplicación crean un nombre de archivo de salida que está sujeto a cambios en función de criterios específicos como el día actual. El archivo correspondiente que se va a supervisar queda determinado por el nombre de archivo.log y IN021004. Coincide con los nombres de archivo que comienzan con IN seguido de seis numerales y de la extensión de archivo .log PS{###}FTP. Console. v Si el archivo supervisado se encuentra en un sistema de directorio que no está en inglés.

no se tienen en cuenta. Si se define una extensión de archivo en particular.* No hay ninguna llave delante del asterisco (*).log están presentes en el directorio /logs. error*. si desea supervisar el registro más reciente del servidor de supervisión en el directorio /opt/IBM/ITM/logs. Ejemplos de uso correcto del comodín (*): err{??}. si desea hacer coincidir dos archivos que se denominan Log y LogA. Esta cadena de caracteres patrón es útil cuando se realiza la supervisión automática de los componentes de Tivoli Monitoring. utilice las letras Y. v Utilice un asterisco (*) como comodín para omitir las extensiones de archivo o caracteres finales que haya en el nombre de archivo. Acerca de los proveedores de datos 47 . Por ejemplo. error. Utilice un símbolo de ($) para representar cualquier carácter o ningún carácter. Cuando se utilice el asterisco en una extensión de nombre de archivo. Los nombres de archivo como AA001 o AA00001 no se tendrán en cuenta. Utilice un símbolo de número para indicar cada elemento numérico del nombre de un archivo. Por ejemplo.log Tail v v v v v v v Si Host1_ms_452053c0-01. sólo los archivos con la misma extensión se tendrán en cuenta. AA222X y AA55555. Vea los ejemplos siguientes: {YYYYMMDD}. Por ejemplo.log* especifica que cualquier nombre de archivo que empiece por Myapp. La presencia de caracteres de patrón dentro de las llaves en una sentencia //SOURCE FILE indica al proveedor de datos de archivo que se utiliza un patrón de nombre de archivo. seguido de 3 dígitos y seguido de ″log. Los nombres de archivo. se selecciona el archivo Host1_ms_45205946-01.* Ejemplos de uso incorrecto del comodín (*): error. Debe coincidir exactamente con la parte del nombre de archivo.log. Capítulo 4.{###} No se utiliza el asterisco al final del nombre de archivo. M y D en mayúsculas. El asterisco debe especificarse después de las llaves ({ }) y no se puede utilizar al principio de un nombre de archivo. Estas letras deben estar delimitadas por llaves.Siga estas directrices para establecer patrones de nombres de archivo: v Utilice llaves {} para delimitar los caracteres de patrón en un nombre de archivo. Host1_ms_45205946-01.″ es una coincidencia. puede codificar la siguiente sentencia de metarchivo: //SOURCE File /opt/IBM/ITM/logs/Host1_ms_{TIVOLILOGTIME}. Utilice un signo de interrogación para excluir cada elemento del convenio de nomenclatura que no sirva como criterio de búsqueda determinado del nombre de archivo apropiado.log.log Especifica nombres de archivo como por ejemplo 20060930.20* No hay ninguna llave delante del asterisco {*). especifique Log{$}. AA0001. se tratarán como caracteres literales en el nombre de archivo. las partes constantes y numéricas. el patrón AA{###} da instrucciones al proveedor de datos de archivo para que compruebe el archivo AA101. Host1_ms_451f11f4-01. El patrón de nombre de archivo exacto.log. Por ejemplo. Para especificar de forma precisa un nombre de archivo que consta de componentes de fecha (año. El número total de símbolos de número y de interrogación delimitados por llaves es significativo. Utilice la cadena de caracteres patrón reservado {TIVOLILOGTIME} para sustituir por la indicación de la hora hexadecimal y el número de secuencia de archivo en un archivo de registro de servidor o agente de Tivoli Monitoring. el patrón AA{####} da instrucciones al proveedor de datos para que busque archivos como por ejemplo.log y Host1_ms_451f11f4-02. como XAA101. el asterisco debe emplearse sólo.* error{$}. Myapp{###}. independientemente de lo que venga después. de lo contrario.log o 20061015. Por ejemplo. deben coincidir exactamente con el nombre de archivo.log para la supervisión. mes y día).

TXT’.{MMDDYY}.log {DDMMMYY}. entrará en efecto la coincidencia de patrón basada en nombre de archivo. Esta restricción se ha implementado para impedir una caso en el que varios archivos coincidentes cambiasen de tamaño a intervalos irregulares.log Especifica nombres de archivo como por ejemplo 101106. MY{YYDDD}.log. el patrón ABC{?####?##?##?##?##?##?}XYZ. MY06202. El intervalo predeterminado es de 10. En muchos casos. Puede cambiar el intervalo por un intervalo más corto o más largo especificando una variable de entorno KUMP_DP_FILE_SWITCH_CHECK_INTERVAL=número-de-segundos El proveedor de datos de archivo emite un mensaje DPLOG notificándose que el archivo activo supervisado ha cambiado del archivo actual al nuevo archivo.log En los casos más complejos en los que hay un campo de fecha intercalado en un nombre de archivo más largo y los patrones de fecha listados en los ejemplos anteriores no son suficientes. Especifica nombres de archivo como por ejemplo. donde sólo se actualiza uno en un momento dado. Por ejemplo.log {MM-DD-YY}.log {DDMMYYYY}. el proveedor de datos de archivo conmuta automáticamente la supervisión de aplicación al nuevo archivo. //SOURCE FILE espec-patrón-nombre-archivo tail CompareBySize El parámetro CompareBySize significa que de los dos archivos que cumplen los criterios del patrón. Especifica nombres de archivo como por ejemplo. y seguir realizando comparaciones numéricas que seleccionen el archivo más actual para la supervisión. Observe que el carácter separador ’-’ se omite en el campo de fecha y no es preciso un carácter patrón de interrogación para omitirlo. ’ABC 2006-04-20 11_22_33 XYZ. o 15082006.log o 110106. Especifica nombres de archivo como por ejemplo 01092006. Cualquier caso provoca que la supervisión se reinicie al principio del archivo. Algunas aplicaciones utilizan un par de archivos de registro relacionados que cambian entre estar activos e inactivos.TXT se puede utilizar para nombres de archivo como por ejemplo. MY06010. donde sólo interesan los dígitos marcados como # y los signos de interrogación sirven como marcadores que permiten omitir otros caracteres en el nombre de archivo. debido a la posibilidad de frecuentes cambios de archivo. Utilice CompareBySize cuando haya dos archivos coincidentes.log. puede crear patrones que combinen los signos de número y los interrogantes. 11-02-06 o 04-29-07. El proveedor de datos de archivo busca el archivo con la mejor coincidencia cuando: v Se inicia por primera vez el proveedor de datos de archivo. el inactivo se borra y el activo va gradualmente aumentando su tamaño hasta que se produce el siguiente cambio. 48 IBM Tivoli Universal Agent: Guía del usuario . Especifica nombres de archivo como por ejemplo 24Jan07 o 13Sep06. Cuando se detecta un archivo más reciente que coincide con el patrón. v El contenido del archivo existente ha cambiado debido a una posible sobregrabación.log. Puede utilizar la característica de comparación de patrón para que el proveedor de datos de archivo supervise un par de archivos basándose en el tamaño relativo de archivo. v El archivo supervisado actualmente ya no existe debido a que se ha cambiado su nombre o se ha suprimido. CompareBySize sólo funciona si hay dos o menos archivos en el directorio que cumple el criterio de patrón. se supervisa el archivo de mayor tamaño. No utilice CompareBySize con dos archivos que se estén actualizando al mismo tiempo. El proveedor de datos de archivo busca periódicamente nuevos archivos que coincidan con el patrón de archivos definido en la ubicación de vía de acceso de destino.log.log o MY04350.log. lo cual puede conducir a cambios de archivo frecuentes. Si hay más de dos archivos coincidentes. v Ha caducado el intervalo de comprobación.

y si los dos archivos cambian periódicamente de lugar. Para los datos de sucesos. v Si el archivo supervisado no existe en el momento del arranque de Tivoli Universal Agent y se crea posteriormente. CompareByLastUpdate se limita a los casos en que no hay más de dos archivos que coincidan. El tamaño del archivo sigue siendo el mismo hasta que el programa de aplicación asigna el siguiente incremento de espacio de archivo. si se suprimen los registros de archivo del archivo supervisado y se reduce el tamaño total de archivo. el proveedor de datos de archivo presupone que se ha vuelto a crear el archivo supervisado o se ha copiado encima de él. el proveedor de datos de archivo presupone que se ha vuelto a crear el archivo supervisado o se ha copiado encima de él y empieza a procesar desde el principio del archivo. El caso típico es utilizar CompareByLastUpdate si hay dos archivos de registro en los que uno está activo y se actualizan de uno en uno. Tail. y debe procesarse desde el principio. Por ejemplo. El registro de Microsoft Internet Information Server es un ejemplo de este tipo de archivo. Capítulo 4. especifique el parámetro tailbyrecord como en la siguiente sentencia //SOURCE: //SOURCE FILE nombre-archivo tailbyrecord El parámetro tailbyrecord ordena al proveedor de datos de archivo que utilice un método alternativo cuando supervise el archivo. el nuevo archivo supervisado se procesa desde el principio. TailByCount y TailRestart. y por lo tanto procesa todo el archivo desde el principio. el retraso es el TTL dividido por el factor de muestreo definido por la variable de entorno KUMP_DP_SAMPLE_FACTOR o el factor de muestreo predeterminado de 5. Las reglas siguientes describen cómo el proveedor de datos de archivo determina si se ha sustituido o reescrito un archivo supervisado. Al igual que sucede con CompareBySize. Si va a supervisar un archivo de este tipo. No obstante. el proveedor de datos de archivo cuenta los registros físicos del archivo. Para aquellos datos muestreados. el proveedor de datos de archivo procesa el archivo supervisado desde el principio. puede esperar un retraso de hasta 3 minutos (180 segundos) para un archivo supervisado con un TTL de 900 segundos. Acerca de los proveedores de datos 49 . v Si se utiliza la característica de nombre de archivo dinámico y se produce un cambio de nombre de archivo. Proceso de un archivo desde el principio En las diferentes modalidades del proceso de tail. se prevé que el tamaño de archivo total siga aumentando a medida que el archivo crece. El proveedor de datos de archivo experimenta un leve retraso al reconocer que un archivo supervisado se ha vuelto a crear o copiar. los registros añadidos se procesan como datos nuevos. se supervisa el archivo actualizado más recientemente. En cada intervalo de muestreo. el retraso es el intervalo establecido por la variable de entorno KUMP_DP_EVENT o el valor predeterminado de 15 segundos. v Si el contenido del primer registro de archivo ha cambiado de alguna manera. La técnica común de realizar tail en un archivo comprobando periódicamente la ubicación del puntero de final de archivo en busca de registros recién añadidos resulta poco efectiva para un archivo preasignado porque el puntero de final de archivo no cambia cuando se actualiza el archivo. cuando se utiliza el parámetro CompareByLastUpdate.Asimismo. Espacio de archivo preasignado Un programa de aplicación puede pre-asignar un archivo con un tamaño específico y gestionar los registros de archivo en este espacio de archivo pre-asignado basándose en un algoritmo especial. puede elegir entre dos archivos en función de la actividad de actualización reciente: //SOURCE FILE espec-patrón-nombre-archivo tail CompareByLastUpdate Si hay dos archivos en el directorio que cumplen los criterios del patrón. como por ejemplo. Si el recuento actual es mayor que el recuento anterior.

Consulte “Sentencia SOURCE” en la página 140 para obtener información adicional acerca de estas opciones. es suficiente con realizar la supervisión mediante tail de los nuevos registros añadidos al final de un archivo. Consulte “Sentencia SOURCE” en la página 140 para obtener más información. si existe la necesidad de emplear otras formas de supervisión mediante tail. el proveedor de datos de archivo soporta las opciones TailRestart. No obstante. el método de contar registros en cada intervalo de muestreo es menos eficaz que el método estándar de supervisar cambios en la ubicación del puntero de final de archivo. TailRestartFromTop y TailByCount. Opciones adicionales de supervisión de archivos Para la mayoría de las situaciones. 50 IBM Tivoli Universal Agent: Guía del usuario . No obstante.Nota: También puede especificar el parámetro tailbyrecord para los archivos que no están preasignados.

Archivo de inicialización de URL KUMPURLS lista los URL iniciales de supervisión y debe encontrarse en el directorio WORK de instalación del producto.HTTP Nombre de sistema gestionado de la aplicación de proveedor de datos de HTTP Cuando la supervisión de HTTP pasa a estar activa. Acerca de los proveedores de datos 51 . Supervisión de un URL Inicie la supervisión de cualquier URL de una de las siguientes tres maneras: v Incluya los URL de destino en el archivo de inicialización del URL de arranque del proveedor de datos KUMPURLS.tivoli.com/e/t/home http://moneycentral.com/investor/home. En el siguiente ejemplo. Nota: No es posible crear metarchivos para el proveedor de datos de HTTP. Inicio del proveedor de datos de HTTP Inicie el proveedor de datos de HTTP utilizando el mismo método que utiliza para iniciar otros proveedores de datos. el parámetro KUMA_STARTUP_DP inicia el proveedor de datos de HTTP. que siempre tiene la versión 00. v Cree situaciones de IBM Tivoli Monitoring basadas en la tabla INTERNET. El intervalo predeterminado de muestreo del URL es de 300 segundos para los URL definidos en este archivo. está representada por el siguiente nombre de sistema gestionado: NombreHostLocal:INTERNET00 donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de HTTP. no es posible utilizar otra aplicación que no sea INTERNET con este proveedor de datos. sólo podrá comenzar a supervisar URL utilizando situaciones de IBM Tivoli Monitoring o mediante Actuación. ** ***************************************************** www. v Utilice la opción de actuación URL Add. KUMA_STARTUP_DP=HTTP En el siguiente ejemplo. Por lo tanto. Vea el siguiente ejemplo KUMPURLS: ***************************************************** ** Lista de URL iniciales a supervisar. KUMA_STARTUP_DP=ASFS. Si este archivo no existe o está vacío.asp Capítulo 4.SNMP.msn.etrade. INTERNET00 Aplicación INTERNET suministrada por el proveedor de datos de HTTP.Proveedor de datos de HTTP El Proveedor de datos de HTTP de Tivoli Universal Agent permite supervisar la disponibilidad y el tiempo de respuesta de los URL seleccionados. o mediante una opción de Actuación.com https://us. el parámetro KUMA_STARTUP_DP inicia el proveedor de datos de HTTP en conjunción con los proveedores de datos de ASFS y SNMP. Puede especificar la supervisión de varios URL en el archivo de configuración de arranque. dentro de situaciones. El ID de usuario predeterminado es INITCNFG. INTERNET es una aplicación que se genera internamente y que se coloca en línea automáticamente cuando se inicia el proveedor de datos de HTTP.

ObjCache% Parámetro opcional que puede utilizar para calcular las medidas de tiempo de respuesta. Al detener la situación se detiene la supervisión del URL de destino en particular. Si el URL todavía no se ha supervisado como consecuencia de su presencia en el archivo KUMPURLS. URLaliasName Parámetro opcional que es posible especificar para asociar un nombre más significativo a un URL. Por ejemplo. entonces se iniciará su supervisión. Si no desea que se sustituya el nombre de situación. si se supervisan varios URL como resultado de situaciones de Tivoli Monitoring que se activan todas al mismo tiempo. el ID de usuario pasará a TAKE_ACTION y el porcentaje de memoria caché toma el valor predeterminado de 0%.Nota: Los prefijos http:// y https:// son opcionales. De forma predeterminad. El intervalo de situación Test_Yahoo define la frecuencia de muestreo de supervisión del URL. que debe empezar por el prefijo http:// o https://. Si edita directamente el archivo KUMPURLS. No obstante. se visualiza una ventana que le permite especificar los siguientes parámetros: URL Parámetro obligatorio que representa al mismo URL. La sustitución de _Z_INT36863000 viene dada como resultado de la característica ″DUPER″ del servidor de supervisión que optimiza la activación de varias situaciones que tienen el mismo intervalo de muestreo. los cambios no se implementarán hasta que recicle Tivoli Universal Agent. El ID de usuario predeterminado es el ID de inicio de sesión especificado cuando se establece conexión con el servidor de portal. Si está supervisando varios URL. el intervalo de muestreo. se restablece en la tabla de URL gestionados a 60 porque ese es el intervalo de muestreo mínimo permitido para los URL. Puede escribir este parámetro con o sin el prefijo http:// o https://. si especifica el 50% 52 IBM Tivoli Universal Agent: Guía del usuario . ID Parámetro opcional que representa el usuario que ha iniciado la supervisión del URL. la situación todavía es válida pero no se crea una segunda instancia de supervisión para el URL. especifique dicho valor en ObjCache%. Opción de Actuación También puede especificar la supervisión de varios URL mediante una opción de Actuación llamada URL Add. Si esta sustitución de ID de usuario se ha producido para un URL y está intentando eliminar el URL mediante la ventana URL Remove. el ID de usuario asignado para el URL de destino es el nombre de situación. Si el intervalo de situación Test_Yahoo es menor de 60 segundos. Si este parámetro no está cumplimentado. StatusInterval Parámetro opcional que representa el tiempo transcurrido en segundos entre muestras. también es posible especificar un valor de ID de usuario distinto. Situaciones de IBM Tivoli Monitoring Es posible construir situaciones utilizando el atributo URL en la tabla INTERNET para la supervisión de cualquier URL de destino. No obstante. El proveedor de datos de HTTP incorpora el porcentaje de la memoria caché en sus cálculos sobre el tiempo de respuesta del URL. es decir. El único atributo obligatorio cuando se crea una situación para supervisar un URL es el propio nombre del URL. Si ya existe en KUMPURLS. Al seleccionar esta opción. puede especificar un intervalo de estatus distinto para cada URL. especifique _Z_INT36863000 en la ventana. el valor predeterminado del nombre de alias pasará a estar vacío. deberá inhabilitar la característica DUPER del servidor de supervisión especificando la variable de entorno CMS_DUPER=N en el archivo KBBENV del servidor de supervisión. El ID de usuario en este contexto también recibe el nombre de propietario del URL. el intervalo de estatus toma el valor predeterminado de 300 segundos. Si sabe aproximadamente qué porcentaje de las páginas web están en la memoria caché. es posible que vea los valores de ID de usuario de _Z_INT36863000 sustituidos por uno o más de los URL iniciados por la situación.

Título de la página del URL recibido. asigne la acción URL Remove al sistema gestionado de destino asociado con la aplicación INTERNET de Tivoli Universal Agent. asigne la acción URL Add al sistema gestionado de destino asociado con la aplicación INTERNET de Tivoli Universal Agent. entonces sólo 10 de los objetos se descargarán. Si no está seguro de cuál es el valor de ID de usuario que debe especificar. El valor de ID de usuario deben coincidir con el valor especificado para el URL cuando se comenzó la supervisión o la acción de eliminación fallará. Nombre del ISP (proveedor de servicios de Internet).1) del servidor web del sitio web del URL de destino. Tamaño. Atributos de URL El proveedor de datos de HTTP de Tivoli Universal Agent registra automáticamente la aplicación INTERNET. Después de cumplimentar la información y cerrar la ventana. El URL eliminado también se suprime del archivo KUMPURLS.para ObjCache% y hay 20 objetos en la página web. Número total de objetos adicionales asociados con la página supervisada. de la página del URL recibido. puede comprobar el archivo KUMPURLS. La supervisión del nuevo URL comienza inmediatamente. Tabla URL gestionados La tabla URL gestionados incluye los atributos listados en la Tabla 6. que tiene un parámetro USER= para cada URL supervisado. Tiempo actual de respuesta de un URL gestionado observado en milisegundos. reduciendo el valor de tiempo de respuesta. También puede comprobar el valor de columna User_Name en el espacio de trabajo MANAGED_URL debajo de la aplicación INTERNET. También se añade el URL al archivo KUMPURLS para que se continúe supervisando en distintos reinicios de Tivoli Universal Agent. Atributos de URL Nombre de atributo Tiempo promedio de respuesta Tiempo de respuesta actual Versión de HTTP Nombre_ISP Tiempo máximo de respuesta Objetos de página Tamaño de página Titulo de la página Tipo de servidor Estatus Entero Entero Carácter Carácter Entero Entero Entero UTF-8 Carácter Carácter Tipo Tamaño Largo Largo 8 64 Largo Largo Largo 256 64 64 Descripción Tiempo medio de respuesta del URL gestionado observado en milisegundos. Capítulo 4. en bytes. Versión de HTTP (HTTP 1. La ventana de URL Remove sólo solicita los valores de URL y de ID de usuario. Esta aplicación contiene los URL gestionados y las definiciones de tabla de objetos URL que se visualizan en los informes de INTERNET. Después de cumplimentar la información y cerrar la ventana. permite la inmediata detención de la supervisión de un URL determinado. a menos que se haya añadido el URL editando directamente el archivo KUMPURLS. Tiempo máximo de respuesta del URL gestionado observado en milisegundos.0 o 1. que están disponibles en situaciones de IBM Tivoli Monitoring que utilizan la supervisión de URL: Tabla 6. llamada URL Remove. Tipo de servidor web utilizado en el sitio web del URL de destino. Acerca de los proveedores de datos 53 . Estatus actual del URL gestionado (OK o descripción del estatus). Una opción de Actuación correspondiente. Los datos de disponibilidad y de tiempo de respuesta del URL están disponibles en el cliente de Tivoli Enterprise Portal para su visualización tan pronto como el periodo de intervalo de estatus del nuevo URL haya transcurrido.

Debe utilizar el formato http:// o https://. 54 IBM Tivoli Universal Agent: Guía del usuario .ID que se encuentra en el directorio WORK de instalación del producto Tivoli Universal Agent. Objetos URL. conocida como conjunto de muestras. el proveedor de datos de HTTP mantiene una tabla interna. entre las comprobaciones de estatus del URL de destino. Debe utilizar el formato http:// o https://. en segundos. Puede especificar el nombre de ISP en un archivo de texto llamado ISP. URL gestionado de destino. Tamaño del objeto de página dentro del URL de destino. Objetos URL Nombre de atributo Nombre de objeto Tamaño del objeto URL UTF-8 Entero UTF-8 Tipo Tamaño 512 Largo 512 Descripción Nombre del objeto de página dentro del URL de destino. El tamaño del conjunto de muestra está determinado por un valor del Intervalo de estatus del URL. configure la recopilación de datos históricos para la tabla URL gestionados. El valor de los conjuntos de muestras puede estar comprendido entre 3 y 15 (3 si el intervalo de estatus son 5 minutos y 15 si el intervalo de estatus es 1 minuto). Objetos de URL La segunda tabla INTERNET. Número total de bytes descargados de los objetos de página asociados. Indicación de la hora del estatus Tamaño total del objeto Total de muestras tomadas URL Alias de URL Nombre de usuario Carácter Entero Entero UTF-8 UTF-8 UTF-8 32 Largo Largo 512 32 32 Los cálculos que se realizan para determinar los valores de atributos como el Tiempo medio de respuesta y el Tiempo máximo de respuesta se basan en el concepto de un ″conjunto de muestras″. De hecho. Tiempo medio de respuesta. URL gestionado de destino. No obstante.Tabla 6. Hora a la se ha tomado el último estatus del URL gestionado. ID de usuario que ha iniciado la supervisión del URL de destino. de las muestras obtenidas más recientemente y utiliza sólo dichos valores para calcular las estadísticas de tiempo de respuesta. incluir las medidas de tiempo de respuesta de días y horas antes puede acabar alterando el promedio. Número total de muestras tomadas de este URL desde que comenzó la supervisión. Si un URL se ha supervisado durante días. Un intervalo de estatus pequeño conlleva un conjunto de muestras de gran tamaño y un intervalo de estatus grande conlleva un conjunto de muestras pequeño. Alias especificado por el usuario del URL. se utilizará un valor predeterminado de ISP ″LAN″. pero siempre se basan en los últimos 15 minutos de los datos muestreados. incluye los siguientes atributos: Tabla 7. sólo las estadísticas más recientes son necesarias para los informes como por ejemplo. se habrán obtenido miles de estadísticas de muestreo del mismo. Si el archivo no existe. Atributos de URL (continuación) Nombre de atributo Intervalo del estatus Entero Tipo Tamaño Largo Descripción Tiempo transcurrido. Por lo tanto. Si necesita captar información de URL durante más tiempo que los últimos 15 minutos.

Autentificación de servidor proxy Si el proveedor de datos de HTTP se ejecuta en un sistema que requiere la autentificación de servidor proxy para poder acceder a los URL.gif y . Si el URL https:// se puede recuperar con una llamada Get de HTTP estándar. Si hay un servidor proxy en particular que desee utilizar que no esté el host local y no utilice un número de puerto HTTP predeterminado. Acerca de los proveedores de datos 55 . Supervisión de los URL https:// El proveedor de datos de HTTP sólo puede supervisar URL https:// seguros que no requieren el acceso con script o una solicitud interactiva.ini: KUMP_HTTP_PROXY_USERID=xxxxxx KUMP_HTTP_PROXY_PASSWORD=yyyyyy Los valores que suministre para estas dos variables están cifrados por el proveedor de datos de HTTP y se envían al servidor proxy si la llamada Get de HTTP inicial para un URL genera un error de autentificación 401 o 407. Cuando necesite supervisar el tiempo de respuesta y la disponibilidad de determinados objetos dentro de un sitio web. entonces se podrá supervisar.La tabla Objetos URL contiene una entrada URL para cada objeto incorporado.jpg que pueden utilizarse en el sitio web indicado en el informe URL gestionados. también deberá especificar la variable de entorno KDH_CLIENTPROXY. revise el contenido de la tabla Objetos URL. igual que sucede en el siguiente ejemplo: KDH_CLIENTPROXY=http://HostA:1920 Capítulo 4. debe especificar las dos siguientes variables de entorno en el archivo \tmaitm6\KUMENV o /config/um. como los archivos .

Cualquier sentencia Select de SQL o procedimiento almacenado válido que recupere datos de columna de una o más tablas o vistas puede especificarse en un metarchivo de ODBC. que permite que la parte del nombre de sistema gestionado NombreHostLocal se personalice. Las tablas y columnas de la fuente de datos de ODBC se convierten en grupos de atributos y atributos en el metarchivo asociado. consulte ″ManagedSystemName=″ debajo de “Sentencia //SOURCE” en la página 59.ODBC Nombres de sistemas gestionados de aplicaciones del proveedor de datos de ODBC Si la fuente de datos especificada en la sentencia //SOURCE ODBC del metarchivo es accesible cuando se activa el metarchivo. El proveedor de datos de ODBC de Tivoli Universal Agent permite recopilar datos de bases de datos que se ajuste a ODBC utilizando sentencias Select de SQL y procedimientos almacenados soportados por la fuente ODBC particular que se está supervisando. Como resultado. la variable de entorno KUMA_STARTUP_DP especifica que se inicie el proveedor de datos de ODBC junto con el proveedor de datos de ASFS:KUMA_STARTUP_DP=ASFS. Inicio del proveedor de datos de ODBC El proveedor de datos de ODBC se inicia de la misma manera que otros proveedores de datos de Tivoli Universal Agent. VV Sufijo de dos dígitos de la versión. el proveedor de datos de ODBC puede ejecutarse en un sistema al tiempo que recopila datos de forma simultánea de varios sistemas de bases de datos remotos en la red. En el siguiente ejemplo. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27. La fuente de datos ODBC. Para más información. un nombre de sistema gestionado con el siguiente formato pasará a estar en línea: NombreHostLocal:NombreAplicVV donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de ODBC. El parámetro ManagedSystemName permite agrupar varias frentes de datos ODBC relacionadas que tienen el mismo diseño de atributos bajo una misma sentencia //NAME. Consulte “Sentencia APPL” en la página 131 para obtener más información. Cualquier fuente de datos de ODBC que pueda configurarse en los sistemas operativos Windows donde se esté ejecutando el proveedor de datos de ODBC puede ser supervisada. tablas e información Select de SQL se especifica mediante parámetros y sentencias en metarchivos de Tivoli Universal Agent. El proveedor de datos de ODBC se ejecuta como un proveedor de datos independiente. El proveedor de datos de ODBC da soporte al parámetro ManagedSystemName=xxxxxx en la sentencia //SOURCE. Sólo está disponible en los sistemas operativos Windows. 56 IBM Tivoli Universal Agent: Guía del usuario . El software del controlador de ODBC maneja todos los problemas de conectividad de red.Proveedor de datos de ODBC ODBC (Open Database Connectivity) es una interfaz de programación de aplicaciones estándar para acceder a los datos en fuentes de datos relacionales. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. ODBC permite recopilar datos desde una fuente de datos remota sin tener que instalar ningún tipo de software adicional en el sistema remoto.

Metarchivos ODBC de muestra En el ejemplo siguiente se muestran los parámetros y sentencias específicos de los metarchivos ODBC: Ejemplo 1 //APPL NWIND //NAME EMPLOYEES K 300 Interval=60 //SOURCE ODBC nwind //SQL select * from empleados //ATTRIBUTES IDempleado N 8 KEY ATOMIC Apellido D 32 Nombre D 32 Título D 32 Tratamiento D 16 FechaNacimiento D 24 FechaContratación D 24 Dirección D 32 Ciudad D 32 Región D 32 CódigoPostal D 32 País D 32 Teléfono D 32 Extensión D 16 Notas D 128 Supervisor N 4 Modalidades de recopilación de datos de tablas Puede recopilar los datos de tablas ODBC en modalidad de intervalo o bajo demanda. que indica que es una tabla con clave y que sus datos tienen un valor TimeToLive de 300 segundos. Parámetros y sentencias Sentencia //NAME La sentencia //NAME también especifica ″K 300″. Si la fuente de datos no es accesible desde la red o el proveedor de datos de ODBC no puede conectarse a ella porque faltan las credenciales de ID de usuario/contraseña o estas son incorrectas. debe estar delimitado por comillas simples. El valor predeterminado es bajo demanda. Si el nombre de la fuente de datos contiene espacios en blanco incorporados. Este ejemplo utiliza la recopilación mediante intervalo. Debe configurar esta fuente de datos ya que el proveedor de datos de ODBC no lo configura automáticamente. Sentencia //SOURCE La sentencia //SOURCE soporta un parámetro ″ODBC″ para especificar que es un metarchivo ODBC. lo cual significa que los datos sólo se recopilan si se emite una solicitud de situación o de informe para la tabla. Debe utilizar una tabla con clave para los metarchivos ODBC por las siguientes razones: v Impide que las mismas filas recuperadas se añadan varias veces cuando se inicia la sentencia Select de SQL. lo cual quiere decir que se recopilan datos para esta tabla cada 60 segundos. v La mayoría de las tablas ODBC tienen una o más columnas indexadas que se corresponden de manera lógica con los atributos KEY en el metarchivo de Tivoli Universal Agent. Si se omite el parámetro Interval=nn. A continuación del parámetro ″ODBC″ deberá incluir el nombre de la fuente de datos de ODBC. Capítulo 4. Este es un parámetro obligatorio para todos los metarchivos ODBC. indicada por el parámetro Interval=60 en la sentencia //NAME. Acerca de los proveedores de datos 57 . La presencia de este parámetro significa que otros proveedores de datos omiten cargar el metarchivo y sólo el proveedor de datos de ODBC lo carga y lo activa. el sistema gestionado asociado no pasará a estar en línea. Es el mismo nombre con el que ha configurado el applet Fuentes de datos ODBC. la recopilación bajo demanda se activará. ″nwind″ en este ejemplo.

No es posible renombrar un atributo en el metarchivo para que ya no coincida con su columna correspondiente. Puede añadir atributos derivados y otros atributos específicos de Tivoli Universal Agent como un LocalTimeStamp. Ejemplo 2 Este es otro ejemplo que ilustra las características adicionales de los metarchivos ODBC: //APPL TEPS //NAME spt_server_info K 300 AddTimeStamp //SOURCE ODBC teps2 user=sa pswd= maxrows=50 //SQL select * from spt_server_info where attribute_id > 2 //ATTRIBUTES attribute_id N 8 KEY ATOMIC attribute_name D 64 attribute_value D 64 * //NAME sp_helpdb K 300 //SOURCE ODBC teps2 user=sa pswd= //SQL proc=sp_helpdb "master" //ATTRIBUTES name D 32 KEY ATOMIC db_size D 32 owner D 32 dbid C 999999 created D 20 status D 64 Sentencia //NAME La ausencia del parámetro Interval= indica que esas dos tablas utilizan la recopilación de datos bajo demanda. no se utiliza el delimitador de atributo porque cada valor de columna se recupera por separado. Tampoco es necesario enumerar los atributos en la misma secuencia que las columnas que se muestran en la tabla ODBC. En el ejemplo anterior todas las columnas y filas se seleccionan de la tabla Empleados de la base de datos Microsoft Access Northwind. como nombre de aplicación en la sentencia //APPL. v Aunque este ejemplo utiliza el nombre de fuente de datos de ODBC. configurada como ″nwind″. no es un requisito que ambos nombres coincidan. los atributos que se incluyan deberán tener un nombre de columna coincidente. Notas sobre la utilización v En los metarchivos ODBC. no importa lo que se especifique como valor del delimitador en la sentencia //ATTRIBUTES. v Utilice el mandato de renovación de Tivoli Universal Agent sin cambiar el número de versión de la aplicación de metarchivo ODBC para implementar los cambios de forma dinámica en las sentencias //SOURCE y //SQL. Puede utilizar una sentencia Select de SQL o un nombre de procedimiento almacenado. los atributos listados en la sentencia //ATTRIBUTES deben coincidir con los nombres de columna definidos en la tabla ODBC a la que se está accediendo. Los nombres no son sensibles a mayúsculas y minúsculas. 58 IBM Tivoli Universal Agent: Guía del usuario . que inserta una columna LocalTimeStamp en el informe spt_server_info.SQL Sentencia //ATTRIBUTES En los metarchivos ODBC. La tabla spt_server_info incluye un parámetro AddTimeStamp. Por lo tanto. No obstante.Sentencia //SQL Cada metarchivo ODBC requiere una sentencia //SQL válida para cada sentencia //NAME. No es necesario incluir un atributo para cada columna de la tabla. nwind.

el parámetro ″master″ debe ir entre comillas dobles. De forma predeterminada. El único requisito es que las columnas recuperadas tengan nombres de atributos coincidentes. Las uniones de SQL están soportadas. las columnas no tienen que proceder de la misma tabla. por lo que el parámetro ″pswd=″ se deja en blanco. Capítulo 4. se devuelven un máximo de 100 filas para cada tabla ODBC en un metarchivo. Para aumentar o disminuir este valor para una tabla en particular. pero esto no es un requisito. Los dos metarchivos de ejemplo anteriores presuponen que existe una relación de uno a uno entre los grupos de atributos de Tivoli Universal Agent y las tablas SQL. Emita sentencias Select de SQL calificadas que sólo recuperen las filas que desee evaluar en las situaciones. deberán ser señales separadas por espacios en blanco después del nombre de procedimiento almacenado. Acerca de los proveedores de datos 59 . En este ejemplo. puede incluir una alteración temporal mediante maxrows=nn en la sentencia //SOURCE. Si existe algún parámetro de entrada para el procedimiento almacenado. Por lo tanto. la sentencia //SQL puede especificar el nombre de un procedimiento almacenado. es posible generar automáticamente un metarchivo ODBC completo y sintácticamente correcto partiendo de un nombre de fuente de datos determinado. Se presupone que los parámetros de procedimiento almacenado sin comillas dobles son parámetros enteros. sólo las primeras 50 filas se utilizarán para los informes y la evaluación de la situación. Puede alterar globalmente el valor predeterminado con la variable de entorno KUMP_ODBC_MAX_ROWS. El ID de usuario ″sa″ no tiene una contraseña asociada. Puede utilizar una sentencia //SQL para seleccionar columnas de 10 tablas diferentes y almacenar los valores recuperados en atributos que pertenecen a un único grupo de atributos de Tivoli Universal Agent. ambas sentencias //SOURCE incluyen los parámetros ″user=″ y ″pswd=″. Esta cláusula es más eficaz porque se recuperan menos filas. el cual debe ir precedido de la palabra clave ″proc=″. Sentencia //SQL La primera sentencia //SQL en el Ejemplo 2 muestra cómo incluir una cláusula Where para filtrar qué filas devolver. Utilice el filtrado mediante cláusula Where en los metarchivos ODBC siempre que sea posible. ″master″ es el único parámetro proporcionado al procedimiento sp_helpdb. La tabla sp_helpdb en el Ejemplo 2 ilustra la utilización de los procedimientos almacenados. Consulte la descripción del mandato GENERATE en “GENERATE” en la página 211.Sentencia //SOURCE La fuente de datos ″teps2″ de SQL Server requiere una combinación de ID de usuario/contraseña para conectarse. no obstante. El valor maxrows=50 especificado para la tabla spt_server_info significa que si la sentencia Select devuelve más de 50 filas. Generación automática de metarchivos ODBC Para ahorrarse el esfuerzo de crear manualmente los metarchivos ODBC. En lugar de una sentencia Select. Dado que se trata de una cadena de caracteres.

de los que informarán al centro de control de la red.). que se instala con Tivoli Universal Agent. También puede desarrollar aplicaciones Java sencillas que envíen mensajes al proveedor de datos de envío.Proveedor de datos de envío El proveedor de datos de envío ofrece una manera conveniente de enviar notificaciones ad hoc como mensajes. Cualquier problema puede abrir rápidamente un socket y enviar mensajes. 60 IBM Tivoli Universal Agent: Guía del usuario . Los valores de los tres primeros atributos los proporciona el proveedor de datos de envío de forma automática. Atributos MAS del proveedor de datos de envío Atributo Post_Time Post_Origin Post_Ack_Stamp Post_Text Post_Category Definición Hora en que se recibió el mensaje. delimitados por signos de punto y coma (. Texto del mensaje enviado al proveedor de datos de envío. Identificador exclusivo generado para cada mensaje recibido. Tabla 8. La aplicación recopila datos con un tiempo de vida de una hora. Consulte “Personalización del proveedor de datos de envío con el metarchivo KUMPOST” en la página 62 para obtener más información. alertas o estatus a un proveedor de datos de envío bajo demanda. El proveedor de datos de envío utiliza automáticamente esta definición de metarchivo a menos que la altere temporalmente con su propia implementación de KUMPOST. Escucha en los puertos 7575 para los protocolos TCP y UDP o en cualquier puerto especificado por la variable de entorno KUMP_POST_DP_PORT. Alertas. alertas e información de estatus a IBM Tivoli Monitoring. Un representante de servicio al cliente puede iniciar un archivo de script de mandatos básico y enviar mensajes de consulta a Help Desk. Los operadores del sistema pueden invocar rápidamente un mandato de consola cuando observen sucesos fuera de lo normal. Configuración predeterminada Las características de supervisión predeterminadas del proveedor de datos de envío se especifican en el metarchivo predefinido KUMPOST que se muestra en la Figura 10 en la página 61. El nombre de la aplicación definida por KUMPOST es MAS (Mensajes. Hay cinco atributos en el grupo. Estatus) y el nombre del grupo de atributos es dpPost. KUMPSEND acepta la entrada de texto de mensajes que no estén en inglés. Puede personalizar el proveedor de datos de envío para responder a una utilización en particular. con un mínimo de programación adicional. Una de las diez categorías predefinidas de mensajes del proveedor de datos de envío. una aplicación puede utilizar un socket TCP/IP para enviar el estatus de procesado a IBM Tivoli Monitoring. Por ejemplo. El proveedor de datos de envío está implementado como una aplicación de socket TCP/IP con un metarchivo predefinido. Los valores de atributos de Post_Text y Post_Category se obtienen de una aplicación o de un mandato de consola utilizando el programa KUMPSEND. Nombre de host que ha enviado el mensaje. El método más común para entrar datos en el proveedor de datos de envío es utilizar el programa de interfaz de línea de mandatos KUMPSEND.

como se muestran en la Tabla 9. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27. que es la aplicación suministrada por el proveedor de datos de envío generada internamente. Categorías de mensajes Existen diez categorías predefinidas de mensajes de envío.’ Post_Time T Post_Origin D Post_Ack_Stamp D Post_Text U Post_Category D 16 32 26 512 16 Figura 10. La indicación se devuelve a la aplicación remitente sólo si la aplicación está conectada al proveedor de datos de envío mediante un socket TCP orientado a Capítulo 4. VV Sufijo de dos dígitos de la versión. No obstante. El significado de cada categoría viene determinado por los datos y las directrices locales de utilización. el nombre se puede cambiar con un metarchivo KUMPOST personalizado o con la variable de entorno KUMP_POST_APPL_NAME. Categorías de mensajes del proveedor de datos de envío Categoría I O P S N A C W R D Información Operación Aplicación Sistema Red Alertas Crítico Aviso Restablecer Detalle Descripción Indicación de reconocimiento El proveedor de datos de envío genera una indicación de reconocimiento para identificar de manera exclusiva cada mensaje recibido desde una aplicación. NombreAplic El nombre de aplicación suele ser MAS. Tabla 9.//APPL MAS //NAME dpPost S 3600 //ATTRIBUTES ’. está representada por el siguiente nombre de sistema gestionado: NombreHostLocalPOSTdp:NombreAplicVV donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de envío. Acerca de los proveedores de datos 61 . Metarchivo de definición de datos KUMPOST Nombre de sistema gestionado de la aplicación de proveedor de datos de envío Cuando la supervisión del proveedor de datos de envío pasa a estar activa.

es posible rastrear e identificar todos los mensajes de proveedor de datos de envío mientras estén en el sistema. pero no se devuelve. KUMPOST 62 IBM Tivoli Universal Agent: Guía del usuario . Consulte “El programa KUMPSEND” en la página 64 para obtener información adicional. es posible modificar la aplicación MAS a través de un metarchivo. v El delimitador del atributo. Personalización de las especificaciones en tiempo de ejecución del proveedor de datos de envío Puede configurar un número de especificaciones en tiempo de ejecución para el proveedor de datos de envío utilizando variables de entorno. Variables de entorno del proveedor de datos de envío Variable de entorno KUMP_POST_DP_PORT KUMP_POST_APPL_NAME KUMP_POST_GROUP_NAME Descripción Altera temporalmente el puerto de escucha del proveedor de datos de envío. el programa KUMPSEND funciona sólo con los cinco atributos predeterminados. tipos de datos. v El metarchivo debe encontrarse en el directorio KUMP_META_PATH. Si define atributos adicionales deberá desarrollar un programa propio para formatear y enviar los valores añadidos al proveedor de datos. tipos de datos y tiempo de vida que se correspondan adecuadamente con el sitio y también puede definir atributos adicionales después de los tres primeros obligatorios. debe ser un delimitador único. La indicación AAAAAAAATTTTTTTTTTTTCSSSSS se compone de cuatro partes donde: AAAAAAAA TTTTTTTTTTTT C SSSSS es el origen del mensaje es la hora local de llegada del mensaje es la categoría del mensaje es la suma de comprobación complementaria del mensaje Personalización del proveedor de datos de envío con el metarchivo KUMPOST Como otras aplicaciones de Tivoli Universal Agent. especificaciones y orden no pueden alterarse. nombre de grupo de atributos. La pura presencia de un archivo denominado KUMPOST en el directorio KUMP_META_PATH es suficiente para activar dicho archivo en lugar del archivo KUMPOST generado internamente por el proveedor de datos de envío. la indicación se asocia internamente con el mensaje recibido. v El nombre del metarchivo debe ser KUMPOST. Altera temporalmente el nombre de aplicación definido en el metarchivo KUMPOST. Tabla 10. Puede especificar un nombre de aplicación. v Los tres primeros atributos deben especificarse exactamente como aparecen en la Figura 10 en la página 61. Sus nombres. Altera temporalmente el nombre del grupo de atributos definido en el metarchivo.conexiones. que suele ser el subdirectorio \metafiles estándar. Al utilizar la indicación de reconocimiento. existen las siguientes restricciones para la aplicación MAS. No obstante. No obstante. si se especifica alguno. La Tabla 10 lista dichas variables y proporciona descripciones de su función. En el caso de los sockets UDP. v No es necesario importar el metarchivo KUMPOST personalizado ni añadirlo al archivo KUMPCNFG.

Acerca de los proveedores de datos 63 . debajo del sistema gestionado NombreHostLocalPostDP:BOB00 se suprimen automáticamente después de 2 horas (7200 segundos): KUMP_POST_APPL_TTL=7200 KUMP_POST_APPL_NAME=BOB KUMP_POST_GROUP_NAME=GENERAL También puede añadir. Por ejemplo. Consulte el Capítulo 5. Los valores de los tres primeros atributos —Post_Time. el nombre del sistema gestionado es NombreHostLocalPostDP:SYSTEM00 y el nombre de espacio de trabajo en el árbol de Navigator de TEP (Tivoli Enterprise Portal o portal) es HELPDESK. redefinir o eliminar las definiciones de categorías predeterminadas. “Supervisión de aplicaciones”. Redefine las categorías predeterminadas de envío o añade nuevas. Post_Origin y Post_Ack_Stamp— son proporcionados por el proveedor de datos de envío. Es posible un máximo de 16 categorías de mensajes. KUMP_POST_APPL_NAME=SYSTEM KUMP_POST_GROUP_NAME=HELPDESK Cuando se inicia el proveedor de datos de envío con estas dos variables de entorno en vigor. en la página 113 para obtener información sobre la nomenclatura de sistemas gestionados y espacios de trabajo.D=) Cualquier categoría predefinida que no se redefina o elimine explícitamente permanece inalterada. Por ejemplo. puede alterar temporalmente los nombres de aplicación y grupo de atributos utilizando las variables de entorno KUMP_POST_APPL_NAME y KUMP_POST_GROUP_NAME. Por ejemplo. los mensajes recopilados en el espacio de trabajo GENERAL. Datos suministrados por el proveedor de datos de envío Los datos transferidos entre el programa remitente y el proveedor de datos de envío son los valores de los atributos definidos por el metarchivo KUMPOST.Tabla 10. que aparece listado como crítico: Capítulo 4. la secuencia de datos recibida por un proveedor de datos de envío enviada por un usuario descontento al help desk podría ser el siguiente mensaje. los únicos valores de atributo para enviar son Post_Text y Post_Category. si desea que el nombre de sistema gestionado de la aplicación y el nombre de espacio de trabajo reflejen con más precisión el área específica que sea de su interés. Un programa necesita enviar valores sólo a los atributos restantes. como en el ejemplo siguiente. Variables de entorno del proveedor de datos de envío (continuación) Variable de entorno KUMP_POST_APPL_TTL KUMP_POST_CATEGORY Descripción Altera temporalmente el valor de tiempo de vida del grupo de atributos.P=Programación. es posible que el proveedor de datos de envío satisfaga la mayoría de los requisitos del usuario. la siguiente definición añade la categoría X al proveedor de datos de envío: KUMP_POST_CATEGORY=(X=Experimental) Esta definición vuelve a definir la categoría P desde Aplicación hasta Programación: KUMP_POST_CATEGORY=(P=Programación) Esta definición elimina la categoría D: KUMP_POST_CATEGORY=(D=) Esta definición especifica las tres definiciones anteriores en una sentencia: KUMP_POST_CATEGORY=(X=Experimental. En el caso del metarchivo predeterminado. No obstante. Otro ejemplo es que si inicia el proveedor de datos de envío con las siguientes especificaciones.

Indica que es necesario un reconocimiento por parte del proveedor de datos. Categoría del mensaje. necesito ayuda.c El programa KUMPSEND El programa KUMPSEND proporciona una interfaz de línea de mandatos para el proveedor de datos de envío. Puerto en el que el proveedor de datos de destino está escuchando." dp=ENG1 Para enviar un mensaje de alerta al proveedor de datos de envío y solicitar de este un reconocimiento en el host atlantis.Por favor. Nombre de host del proveedor de datos. delimitado por comillas dobles (““). para enviar el mensaje de estatus de información. El valor predeterminado es 7575. El valor predeterminado es el host local.” al proveedor de datos de envío en ENG1 sin solicitar un reconocimiento. Si añade más atributos a la aplicación o altera la secuencia de atributos. Por ejemplo. KUMPSEND ? Códigos de retorno Si llama al programa KUMPSEND desde el interior de un script y necesita comprobar los códigos de retorno. deberá desarrollar un nuevo programa de apoyo para interactuar con el proveedor de datos de envío. Las categorías predeterminadas pueden consultarse en la Tabla 9 en la página 61. Este programa funciona junto con los cinco atributos predeterminados MAS. El valor predeterminado es N. La sintaxis del mandato KUMPSEND es: kumpsend msg=”texto” [cat=categoría] [dp=nombrehost_pd] [port=puerto_escucha_pd] [ack=Y|N] donde: msg cat dp port ack Mensaje enviado al proveedor de datos. El programa KUMPSEND recibe peticiones examinando los parámetros de entrada orientados a palabras clave. entre: KUMPSEND msg="¡Hello World! Ya estoy listo. entre: KUMPSEND msg="La tasa de descarte de paquetes del direcionador NY-TC1 excede el umbral" dp=atlantis cat=a ack=yes Entre un signo de interrogación (?) con el mandato para obtener ayuda con las palabras clave. “¡Hello World! Ya estoy listo. Por ejemplo. 64 IBM Tivoli Universal Agent: Guía del usuario . Este parámetro acepta entradas globalizadas. a continuación se suministran cuatro posibles códigos de retorno: 0 1 2 3 = = = = Satisfactorio Entorno de socket local no válido Error del parámetro de entrada Error al contactar con el proveedor de datos de destino Envío de datos al proveedor de datos de envío La comunicación entre el programa de envío y el proveedor de datos de envío es directa. El sistema lleva sin funcionar una hora y no puedo trabajar.

Utilización de un socket TCP El 1. No espera una respuesta. Capítulo 4. 2. Envía los valores de atributo al proveedor de datos. Cierra el socket TCP. Acerca de los proveedores de datos 65 . 4. Espera a recibir una indicación de reconocimiento del proveedor de datos. bien sea KUMPSEND o su propia aplicación escrita in situ. 3. atraviese el cortafuegos y se comunique con el proveedor de datos de envío. Establece una sesión TCP conectando el socket TCP al proveedor de datos de envío.Utilización de un socket UDP El programa de envío abre un socket UDP y envía los valores de atributo al proveedor de datos de envío. programa remitente hace lo siguiente: Abre un socket TCP y lo enlaza a cualquier puerto local. 5. deberá permitir explícitamente que el programa de envío. Si hay un cortafuegos que bloquea la comunicación de socket entre uno y otro programa.

si se ejecuta un script REXX.exe HelloWorld. La sentencia //SOURCE debe apuntar a una ubicación de vía de acceso en el sistema local donde pueda encontrarse un archivo de script. archivo bat.exe’ "-jar \ C:\Java\HelloWorld.exe es un archivo binario y no un script. Algunos ejemplos de tipos de script son VBScript. que es el valor predeterminado de la instalación de Tivoli Universal Agent. el archivo myprog. v la lista de parámetros que se va a pasar al script. v un conjunto opcional de variables de entorno que se colocará en el entorno del script antes de la ejecución.exe es necesario para procesar los scripts Perl. script Perl. en los sistemas Windows.Proveedor de datos de script El proveedor de datos de script facilita la recopilación de datos de supervisión ejecutando un script o programa a intervalos regulares y analizando la salida del script de modo que se busquen errores.exe "-c miscript. podrá importar y utilizar los metarchivos de script. El proveedor de datos de script es la S final en el proveedor consolidado de datos de ASFS. script de shell. como en este ejemplo: //SOURCE SCRIPT ’C:\Archivos de programa\IBM\Java142\jre\bin\java. como se muestra en los siguientes ejemplos. Metarchivos de script Un metarchivo de script requiere una sentencia //SOURCE por cada sentencia //NAME. De forma predeterminada. Deberá rodear el nombre de vía de acceso o de script de comillas simples si contiene espacios en blanco incorporados.sh arg1 arg2" //SOURCE SCRIPT miprog. Deberá colocar cualquier argumento que se pase al script entre comillas dobles a continuación del nombre del script en la sentencia //SOURCE. En el segundo ejemplo anterior.rex Interval=60 E incluso puede ejecutar código Java desde un archivo jar.exe "arg1 arg2" //SOURCE SCRIPT miscript. el programa intérprete perl.jar" Un intérprete de script no siempre es necesario. Por ejemplo.exe myscript. El proveedor de datos de script facilita la especificación de la siguiente información en un metarchivo: v el nombre del script que se va a ejecutar. como en este ejemplo: //SOURCE SCRIPT C:\ObjREXX\rexx. //SOURCE SCRIPT sh. y a pesar de ello el archivo se puede utilizar en un metarchivo de script si el archivo binario envía la salida a la salida estándar. Cualquier tipo de script puede supervisarse siempre que el intérprete de script esté disponible para el proveedor de datos de script. cada señal separada por un 66 IBM Tivoli Universal Agent: Guía del usuario . el analizador de metarchivos de Tivoli Universal Agent presupone que la primera señal delimitada por espacios en blanco después de ″//SOURCE SCRIPT″ es el nombre de script.pl "arg1 arg2" Asimismo. la sentencia //SOURCE podría ser parecida a la siguiente: //SOURCE SCRIPT C:\Perl\bin\perl. Si es necesario. v el intervalo entre cada ejecución de script. anomalías y condiciones de umbral. el nombre de intérprete de scripts debe preceder al nombre de script en la sentencia //SOURCE.sh "arg1 arg2" Si no incluye el nombre de intérprete de script. Si activa el proveedor de datos de ASFS. Aunque se llama proveedor de datos de script. suministre el programa intérprete REXX. puede especificar en el metarchivo del script cualquier programa que escriba mensajes en salida estándar. JavaScript y script REXX.

espacio en blanco dentro de las comillas dobles se trata como un argumento independiente. Si necesita agrupar una o más señales separadas por espacios en blanco en un argumento, colóquelas entre comillas simples. En el siguiente ejemplo:
//SOURCE SCRIPT monitor.sh "aaa bbb ’ccc ddd’"

el script monitor.sh recibe los tres argumentos siguientes:
Arg1: aaa Arg2: bbb Arg3: ccc ddd

Debe ser posible ejecutar el script como un mandato independiente. El script no puede tener dependencias de una infraestructura o subsistema mayor que impide que el script pueda ser llamado desde una línea de mandatos.

Ubicación del proveedor de datos de script
El proveedor de datos de script debe estar en el mismo sistema que los archivos que los scripts que ejecute o los scripts deben aparecer en el proveedor de datos como si residieran en el sistema local. Los scripts deben ejecutarse localmente porque el proveedor de datos de script obtiene los datos del conducto de salida estándar, que se redirige antes de que se inicie el proceso del script. No obstante, no hay nada que impide ejecutar un script en el sistema local que recopila datos de uno o más sistemas remotos, por ejemplo, incorporando conexiones Windows Management Instrumentation (WMI) en un script para emitir consultas WMI remotas. Nota: El sistema operativo puede eliminar la característica remota de un archivo implementando un sistema de archivos de red o correlacionando un recurso de sistema remoto con un dispositivo local. Si el proveedor de datos de script ejecuta un archivo de script que se encuentra en un sistema remoto mediante el uso de la correlación de unidades lógicas, el ID de usuario y la cuenta asociadas a Tivoli Universal Agent deben tener suficiente autorización para abrir y leer el archivo de script en el sistema remoto. En algunos casos, eso requiere, por ejemplo, volverá a configurar el servicio de Tivoli Universal Agent Windows con una cuenta distinta de la cuenta ″LocalSystem″ predeterminada. El applet Servicios del Panel de control de Windows permite configurar una cuenta diferente para un servicio en particular. En este caso, debe cambiar la cuenta de Tivoli Universal Agent de ″LocalSystem″ a un ID de administrador que esté autorizado en la LAN para accederá los archivos del sistema remoto. También debe hacer referencia al nombre de script en el metarchivo utilizando el formato UNC (Convenio Universal de Nomenclatura) en lugar de utilizar una correlación de letra de unidad. Y debe asegurarse de que el mismo id de usuario/cuenta configurados en el applet Servicios estén definidos en el sistema remoto donde se encuentra el script.

Utilización del proveedor de datos de script
El proveedor de datos de script recibe los datos de atributo de la utilización que los script llamados hacen de la salida estándar. Los scripts iniciados por el proveedor de datos de script no requieren conciencia de agente universal. Ejecutan un mandato que envía datos a la salida estándar y el subproceso del proveedor de datos de script que origina la llamada lee la salida estándar gracias a haberla redirigido antes de iniciar el proceso del script. Cuando el proveedor de datos de script ha recibido un almacenamiento intermedio de salida estándar, analiza los datos en los valores de atributos como si los datos procediesen de un socket, archivo, agente de SNMP o cualquier otro mecanismo de entrada de Tivoli Universal Agent.

Variables de entorno de script
Debido que muchos scripts necesitan tener variables de entorno configuradas para ejecutarse correctamente, el proveedor de datos de script da soporta a un parámetro envfile=xxxx> en la sentencia //SOURCE SCRIPT. Este archivo envfile debe contener una serie de sentencias variable=valor, una por línea. Deberá rodear la vía de acceso del archivo envfile en comillas simples si contiene espacios en
Capítulo 4. Acerca de los proveedores de datos

67

blanco incorporados. Si envfile se especifica como un nombre de archivo sin calificar, el proveedor de datos de script busca automáticamente el envfile en el directorio de scripts. Siempre que se dispone a iniciar un script, el proveedor de datos de script establece cada variable de entorno especificada en el archivo envfile y pasa dicho entorno al proceso de script llamado. Si el tamaño del archivo envfile o su fecha de última modificación cambian, indicando que se ha actualizado el archivo envfile, volverá a procesarse el contenido del archivo. En caso contrario, los mismos valores de la variable de entorno permanecen en vigor para cada invocación de script. A continuación, se muestra un ejemplo de envfile que se puede utilizar para dar soporte a un script Perl script que ejecuta ping en una serie de dispositivos de red:
SYSTEMROOT=C:\winnt SYSTEMDRIVE=C:

Las API de red Perl de Windows requieren que se establezcan las variables de entorno SYSTEMROOT y SYSTEMDRIVE, por lo que este envfile garantiza que el proceso hijo del script iniciado tiene acceso a estas variables. Cuando se investiga un problema en el que un script que se ha ejecutado satisfactoriamente desde una ventana de mandatos no se ejecuta correctamente cuando el proveedor de datos de script lo inicia, compruebe si el script iniciado tiene todos los mismos valores de entorno que el ID de usuario en una ventana de mandatos. Los scripts se bifurcan como procesos hijo en segundo plano, que es una modalidad diferente de funcionamiento que ejecutarlos en un shell de mandatos en primer plano. Por ejemplo, en el segundo plano, Windows, no es necesario que se añada como prefijo a un script de Perl el intérprete Perl.exe porque el registro de Windows sabe qué cualquier nombre de archivo que finalice por una extensión ″.pl″ está asociado a Perl.exe. Pero la información de registro de Windows no es accesible a un proceso hijo de script iniciado por el proveedor de datos de script, que es la razón por la que se necesita una especificación explícita del intérprete Perl.exe en el metarchivo. Asimismo, un script que abre y lee un nombre de archivo sin calificar podría funcionar correctamente en el segundo plano porque la vía de acceso relativa del archivo se puede determinar desde el contexto actual de la ventana de mandatos, pero este mismo script requiere que el nombre de archivo esté calificado al completo cuando lo inicia el proveedor de datos de script. La diferencia entre la ejecución de un script en segundo plano y uno en primer plano es la razón principal de que un parámetro envfile=xxxx sea a veces necesario en el proveedor de datos de script, para que el script tenga acceso a todos los valores de entorno adicionales que necesita. Para crear rápidamente un envfile que contiene todos los valores del entorno local, puede emitir un mandato que redirija los valores a un archivo, y a continuación, hacer referencia a dicho archivo en el metarchivo del proveedor de datos de script. Por ejemplo, en UNIX puede emitir este mandato:
env >env.dat

Y en Windows, emita este mandato:
set >env.dat

Si a continuación el archivo env.dat se especifica en un parámetro envfile=env.dat en la sentencia de metarchivo //SOURCE SCRIPT, y se renueva el metarchivo, puede determinar si el problema de ejecución de un script de segundo plano se ha debido a un valor de variable de entorno que falta. Para mantener la compatibilidad con los scripts o programas utilizados por IBM Tivoli Distributed Monitoring, se generarán determinadas variables de entorno si no están ya especificadas dentro de un archivo de entorno especificado. No todos los valores que IBM Tivoli Distributed Monitoring (DM) utiliza se generarán. La siguiente tabla proporciona el nombre del valor generado y su valor predeterminado:

68

IBM Tivoli Universal Agent: Guía del usuario

Tabla 11. Variables de entorno generadas Nombre del valor MONITOR_ID Valor predeterminado El hash del script a ejecutar, los argumentos y los valores de entorno PROFILE_OID y ENDPOINT_OID si están presentes en el entorno. El hash del script a ejecutar, los argumentos y los valores de entorno PROFILE_OID y ENDPOINT_OID si están presentes en el entorno. Igual que MONITOR_ID. El nombre de host del sistema supervisado. Los valores soportados son: aix4-r1, solaris2, linux-ix86 y hpux10. El script o a ejecutar. La cadena de argumentos. El script o a ejecutar. Igual que MONITOR. La última salida del script o programa. La indicación de la hora del momento en que se obtuvo la última salida. El número de veces que se ha ejecutado el script.

PROBE_ID

HOSTNAME INTERP MONITOR PROBE_ARG PROBE PREV_VALUE LASTSTAMP RUNCOUNT

El siguiente metarchivo simple muestra cómo se podrían utilizar algunas de estas variables de entorno generadas:
//APPL Sample //NAME TestScript K 300 AddTimeStamp //SOURCE Script /bin/sh test.sh Interval=60 //Attributes HostName (GetEnvValue = HOSTNAME) Script (GetEnvValue = PROBE) PreviousValue (GetEnvValue = PREV_VALUE) Stdout D 256 KEY

La función de atributo derivado GetEnvValue obtiene el último valor para cada una de las tres variables de entorno y almacena el valor en el atributo correspondiente. Si no se ha establecido una variable de entorno, se almacena un único espacio en blanco en el atributo correspondiente a menos que se haya especificado un valor de parámetro DEFAULT para el atributo (para obtener más información sobre el parámetro DEFAULT, vea el Apéndice B, “Definiciones de atributos”, en la página 169). Estos tres atributos forman parte de los datos de espacio de trabajo TestScript de la misma manera que la salida de script capturada en el atributo de salida estándar. Para obtener más información sobre cómo utilizar las funciones de atributo derivadas, consulte “Funciones de atributos derivados” en la página 180.

Modalidades de ejecución de script
El proveedor de datos de script soporta la recopilación de datos por intervalos y bajo demanda. Si el parámetro INTERVAL=nn está presente en la sentencia //NAME del metarchivo, el script se iniciará siempre que hayan transcurrido nn número de segundos. Si se omite el parámetro INTERVAL, se activará la recopilación de datos bajo demanda, lo cual quiere decir que el script no se ejecutará a no ser que se produzca un intervalo de situación para la tabla de situación asociada con la sentencia //SOURCE del metarchivo o que se produzca una renovación o apertura de un espacio de trabajo de Tivoli Enterprise Portal de la tabla de aplicación. A la hora de decidir qué modalidad de ejecución de script es mejor para la aplicación, un aspecto a considerar es la longitud de tiempo que el script tarda en completarse. De forma predeterminada, en una solicitud de recopilación de datos dirigida por mandatos se permite un máximo de 15 segundos antes de que se cancele la solicitud, lo que desbloquea el espacio de trabajo de Tivoli Enterprise Portal. (Este límite de 15 segundos se puede modificar con la variable de entorno KUMA_REPORT_REQUEST_EXPIRATION=nn). Si un script a veces requiere más de 15 segundos por
Capítulo 4. Acerca de los proveedores de datos

69

ejemplo, porque consulta bases de datos remotas o sondea diversos dispositivos en la red, entonces es mejor implementar el script a intervalos con un parámetro INTERVAL=nn. Esto permite que el espacio de trabajo se abra y se renueve para responder con rapidez con los datos que se han obtenido de la ejecución de script más reciente. Por otro lado, si el script sólo precisa de un segundo o dos en completarse, y el usuario siempre desea ver datos que se acerquen al máximo posible del tiempo real, entonces es preferible un script dirigido por mandatos sin el parámetro INTERVAL=nn.

Directorio de scripts
Al instalar Tivoli Universal Agent, se creará un directorio de scripts en el mismo nivel que los metarchivos y directorios de trabajo. Almacene todos los archivos de script en este directorio de scripts para no tener que proporcionar un nombre de vía de acceso calificado al completo para los scripts en la sentencia //SOURCE SCRIPT. Cuando el proveedor de datos de script procesa un metarchivo que contiene un archivo de script sin calificar, buscará automáticamente el archivo en el directorio de scripts.

Nombres de sistemas gestionados de aplicaciones del proveedor de datos de script
Si el script especificado en la sentencia //SOURCE SCRIPT del metarchivo es accesible cuando se activa el metarchivo, un nombre de sistema gestionado con el siguiente formato pasará a estar en línea:
NombreHostLocal:NombreAplicVV

donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de Script. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. Consulte “Sentencia APPL” en la página 131 para obtener información adicional. VV Sufijo de dos dígitos de la versión. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27.

Si el archivo de script no es accesible durante el arranque, el sistema gestionado correspondiente no pasará a estar en línea. Del mismo modo, si el archivo de script se renombra o suprime después del arranque, su sistema gestionado pasará a estar fuera de línea. En ambos casos, el proveedor de datos de script entrará en un bucle de espera/reintentos para comprobar de forma periódica si el script está disponible. Cuando el script vuelva a estar disponible, el sistema gestionado pasará a estar en línea. Como el proveedor de datos de archivo, ODBC y de socket, el proveedor de datos de script soporta el parámetro ManagedSystemName=xxxxxx en la sentencia //SOURCE, que permite personalizar la parte NombreHostLocal del nombre de sistema gestionado. El parámetro ManagedSystemName también permite agrupar varios scripts relacionados que tienen el mismo diseño de atributos bajo una misma sentencia //NAME, por ejemplo:
//APPL MyAppl //NAME AttrData K 300 AddTimeStamp Interval=60 //SOURCE SCRIPT C:\wmi\resmodel1.vbs “arg1” ManagedSystemName=ResModel1 //SOURCE SCRIPT C:\wmi\resmodel2.vbs “arg1” ManagedSystemName=ResModel2 //SOURCE SCRIPT C:\wmi\resmodel3.vbs “arg1” ManagedSystemName=ResModel3 //ATTRIBUTES ’;’ Attr1 R 512 Key @Attr1 help text

Si este metarchivo se activase y el proveedor de datos de script pudiese acceder a los tres scripts, los siguientes tres sistemas gestionados se registrarían en el servidor de Tivoli Enterprise Monitoring y se insertarían en el Navigator del Tivoli Enterprise Portal:
ResModel1:MyAppl00, ResModel2:MyAppl00, ResModel3:MyAppl00

70

IBM Tivoli Universal Agent: Guía del usuario

El valor del nombre de host local será sustituido por el valor de ManagedSystemName=xxxxxx. Para más información, consulte ″ManagedSystemName=″ debajo de “Sentencia //SOURCE” en la página 59.

Autentificación de script
Un requisito común de un script es que un ID de usuario especialmente autorizado debe ejecutar el script para dar acceso de script a recursos protegidos. De forma predeterminada, cada script iniciado hereda el ID de usuario del proceso de Tivoli Universal Agent. En los sistemas operativos Windows, se utiliza el ID de usuario de la cuenta "LocalSystem" del Servicio de Windows, que tiene privilegios de Administrador en el sistema local. En los sistemas operativos UNIX, se utiliza el ID de usuario ha iniciado Tivoli Universal Agent. Si un script requiere una autentificación especial, deberá proporcionar un parámetro User= y Pswd= en la sentencia //SOURCE. Si están presentes, dichos valores serán utilizados por el proveedor de datos de script como credenciales de autorización cuando se inicia el script. El usuario indicado debe estar definido en el sistema y tener autorización de ejecución sobre el script que va a ejecutar. A continuación se muestran sentencias de metarchivo de muestra para mostrar cómo codificar los parámetros User y Pswd:
//APPL DBQUERY //NAME OUTPUT K 300 AddTimeStamp //SOURCE SCRIPT dbquery.sh User=db2admin

Pswd=Xyz!345g

Interval=90

Nota: En los sistemas UNIX, no es necesario incluir el parámetro Pswd= si Tivoli Universal Agent se ha iniciado con un ID raíz. En dicho caso, es suficiente incluir únicamente el parámetro User= porque raíz puede conmutarse por un ID de usuario distinto sin tener que suministrar una contraseña. No obstante, en los sistemas Windows, el parámetro Pswd= debe especificarse siempre que exista un parámetro User=. Otra estrategia para autentificar scripts es configurar Tivoli Universal Agent para que su propio ID de usuario propietario tenga la autorización necesaria para ejecutar todos los scripts. En los sistemas operativos Windows, vuelva a configurar el servicio de Tivoli Universal Agent mediante el applet Panel de control → Herramientas administrativas → Servicios. Cambie "LocalSystem" por un ID de usuario en el dominio local. Del mismo modo, en los sistemas operativos UNIX, inicie Tivoli Universal Agent con un ID de usuario que tenga autorización en tiempo de ejecución para el script requerido.

Manejo de errores de script
Al igual que sucede con la salida estándar, el proveedor de datos de script también redirige el error estándar (stderr) antes de iniciar un proceso de script. Sin embargo, el almacenamiento intermedio de errores estándar no se analiza en valores de atributo porque normalmente tiene un formato muy distinto del almacenamiento intermedio de salidas estándar. En cambio, si se captura algún error estándar durante la ejecución del script, el proveedor de datos de script graba un mensaje KUMPL139E en UAGENT DPLOG, que contiene el nombre del script y el texto del error estándar. Si desea crear situaciones que busquen errores de script, un método es definir una situación que busque la cadena KUMPL139E en el atributo DP_Log_MsgID de la tabla DPLOG. Otra categoría de error de script es cuando un script no graba ningún dato en el error estándar, pero el script sale con un código de retorno no satisfactorio, que se supone que es cualquier valor que no sea 0. En este caso, el proveedor de datos de script envía un mensaje KUMPL135W UAGENT DPLOG, que contiene el nombre del script y el valor de código de retorno. De nuevo, puede creare situaciones que generen alertas siempre que la tabla DPLOG tenga un mensaje KUMPL135W nuevo indicando que se ha completado un script con un código de retorno distinto de cero.

Tiempos de espera excedidos de los scripts
Un tipo especial de condición anómala es cuando un script excede el tiempo de espera antes de que finalice su ejecución. De forma predeterminada, el proveedor de datos de script otorga a cada script un máximo de 60 segundos para finalizar. El proveedor de datos de script termina cualquier script que no

Capítulo 4. Acerca de los proveedores de datos

71

haya salido dentro de dicho periodo de tiempo. Esto se consigue para evitar una acumulación gradual de procesos de script que se encuentran en un bucle sin fin o una espera indefinida. Hay varias razones posibles por las que se produce una espera excedida de script. El script puede tener un error de codificación que haga que se cuelgue o entre en un bucle. O quizás, el script está atascado en una espera indefinida mientras intenta acceder a un recurso que no da respuesta. O simplemente, el script puede tardar un tiempo largo en finalizar porque sondea docenas o centenares de dispositivos remotos, algunos de los cuales tardan varios segundos en agotar el tiempo de espera, en cuyo caso, deberá especificar una modificación temporal del parámetro Runtime=nnn en la sentencia //SOURCE para otorgar al script más de 60 segundos para completarse. (Consulte “Sentencia SOURCE” en la página 140 para obtener más información sobre el parámetro Runtime). Tenga en cuenta que si establece un valor de Runtime en más de 60 segundos porque tiene un script de larga ejecución, deberá ajustar también el parámetro Interval=nnn para que el Intervalo del script sea mayor o igual a Runtime. Si desea crear situaciones que busquen tiempos de espera excedidos de script, un método es definir una situación que busque la cadena KUMPL136W en el atributo DP_Log_MsgID de la tabla DPLOG. El mensaje KUMPL136W lista el nombre del script, el ID de proceso, y el número de segundos que estaba activo antes de exceder el tiempo de espera. Si desea impedir que determinados script propensos a errores excedan el tiempo de espera una y otra vez, puede establecer la variable de entorno KUMP_MAXSCRIPT_TIMEOUTS=nn. Por ejemplo,
KUMP_MAXSCRIPT_TIMEOUTS=5

significa que si un script ha excedido más de 5 veces el tiempo de espera, el proveedor de datos de script ya no intentará iniciar el script y terminará el subproceso de supervisión del script. Si posteriormente, desea reactivar el script después de corregir la causa de los tiempos excedidos de espera, puede renovar el metarchivo del script para borrar el contador de tiempos de espera de nuevo, ponerlo a 0 y reiniciar el subproceso de supervisión del script.

Metarchivo de ejemplo de script
El siguiente es un metarchivo de ejemplo que ilustra la sintaxis del metarchivo del proveedor de datos de script:
//APPL MyAppl //NAME AttrData K 300 AddTimeStamp Interval=60 //SOURCE SCRIPT listdrives.vbs “arg1 arg2” envfile=env.dat //ATTRIBUTES ’;’ Attr1 D 128 KEY @Attr1 help text -FILTER={MATCH(0,#)} Attr2 C 2147483647 @Attr2 help text Attr3 C 2147483647 @Attr3 help text DerivedAttr (Attr2 / Attr3) @DerivedAttr help text

El nombre sin calificar, listdrives.vbs, quiere decir que el script listdrives.vbs se encuentra en el directorio de scripts de Tivoli Universal Agent. En el siguiente apartado se describen otros aspectos del metarchivo de script de ejemplo:

Filtrado de salidas de scripts no deseadas
Muchos scripts envían filas de datos especiales a la salida estándar, como encabezados de columnas y frases de copyright que generalmente no desea ver en el espacio de trabajo de Tivoli Enterprise Portal. Para filtrar estas filas de datos, podrá utilizar el parámetro -FILTER en el metarchivo del script, por ejemplo:
//APPL Disk //Name FreeSpace K 300 AddTimeStamp Interval=120 //Source Script cscript.exe listfreespace.vbs "/S myHost" Interval=60 //Attributes DriveLetter D 4 KEY DLM=’:’ -FILTER={SCAN(0,Micr) OR SCAN(0,Copy)} FreeSpace D 32

72

IBM Tivoli Universal Agent: Guía del usuario

El uso de los atributos KEY proporciona la capacidad de correlación de datos. Consulte “Filtrado de atributos” en la página 181 para obtener información adicional acerca del parámetro FILTER. la nueva fila de datos recopilados sustituye a la fila anterior con los valores KEY correspondientes. Nota: Sólo se especifican los primeros 4 caracteres ya que el atributo DriveLetter tiene un tamaño máximo de 4. comprueba si existe algún atributo KEY (clave) y si tienen los mismos valores que una fila de datos recopilados anteriormente. Reservados todos los derechos. Para impedir que dichas dos filas de datos se visualicen en el espacio de trabajo de Tivoli Enterprise Portal. Atributos clave (key) Si un script se ejecuta a intervalos regulares y genera las mismas filas de datos básicos.6 Copyright (C) Microsoft Corporation 1996-2001.Este metarchivo de ejemplo de script invoca el programa de Windows Script Host. primero analice la salida de un script de ejemplo para determinar si existe algún valor que pueda lógicamente tratarse como índice o clave. Este parámetro hace que se inserte una columna LocalTimeStamp automáticamente en el espacio de trabajo. el primer atributo del metarchivo del script incluye un parámetro -FILTER que explora los primeros 4 caracteres de esas dos filas de datos. que generalmente escribe dos sentencias de encabezado en la parte superior de su salida estándar: Microsoft (R) Windows Script Host versión 5. cscript. Acerca de los proveedores de datos 73 . Cuando el proveedor de datos de script recopila una nueva fila de datos para n grupo de atributos. Si este fuese el caso. Adicionalmente.exe. Para los metarchivos de script. El valor LocalTimeStamp lo rellena el proveedor de datos de script con la hora local cuando el script ha terminado de ejecutarse. Capítulo 4. utilice tablas KEY para impedir que las mismas filas recuperadas se añadan varias veces siempre que se ejecute el script. el espacio de trabajo de Tivoli Enterprise Portal muestra dichas columnas acumulándose en cada intervalo de recopilación de datos a no ser que designe uno o más atributos como KEY (clave) en el metarchivo de script. deberá marcar el grupo de atributos con una ‘K’ para indicar que es una tabla KEY. Para implementar un metarchivo de script con atributos KEY. Adición de una columna LocalTimeStamp Incluya el parámetro AddTimeStamp en la sentencia del metarchivo del script //NAME si el script no incluye la hora en que fue ejecutado como parte de su salida estándar.

v Recopilar estadísticas históricas de los dispositivos habilitados para SNMP Nota: El proveedor de datos de SNMP está limitado a la seguridad basada en el nombre de comunidad y no da soporte a SNMP Versión 3 con el modelo de seguridad más reciente. Estas funciones incluyen la recepción de condiciones de excepción. operaciones SET y supervisión de red. v Gestionar y configurar dispositivos habilitados para SNMP en la empresa. v Crear políticas para automatizar respuestas a clientes de red. Inicio del proveedor de datos de SNMP El proveedor de datos de SNMP se inicia de la misma manera que otros proveedores de datos de Tivoli Universal Agent. el proveedor de datos de SNMP puede: v Recopilar datos MIB de la empresa. Tivoli Universal Agent puede supervisar cualquier variable de la Base de información de gestión (MIB) de SNMP como un atributo de IBM Tivoli Monitoring. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. Además. v Realizar operaciones SET de SNMP. IBM Tivoli Universal Agent: Guía del usuario 74 . v Crear situaciones para supervisar y alertarle de condiciones de excepción. También puede crear sus propias aplicaciones SNMP personalizadas para supervisar varias tablas de atributos y varios MIB.SNMP Nombres de sistemas gestionados de las aplicaciones del proveedor de datos de SNMP Como norma. el proveedor de datos de SNMP no da soporte a contadores de 64 bits. Mediante el proveedor de datos de SNMP.Proveedor de datos de SNMP El proveedor de datos de SNMP proporciona la funcionalidad de la capacidad de gestión de SNMP (Protocolo simple de gestión de red) en IBM Tivoli Monitoring. Esto permite: v Ver espacios de trabajo actuales e históricos mostrando valores para todas las variables de MIB en Tivoli Enterprise Portal. Además. NombreHostLocal:NombreAplicVV donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de SNMP. las aplicaciones del proveedor de datos de SNMP siguen el mismo estándar de nomenclatura de sistema gestionado que otras aplicaciones de proveedores de datos. VV Sufijo de dos dígitos de la versión. la variable de entorno KUMA_STARTUP_DP especifica que se inicie el proveedor de datos de SNMP junto con los Proveedores de datos de Archivo y de HTTP: KUMA_STARTUP_DP=FILE. consultas MIB.HTTP. En el ejemplo siguiente. v Supervisar cualquier condición de excepción de SNMP enviada al proveedor de datos. IBM Tivoli Monitoring crea aplicaciones para que convierta las MIB en metarchivos de definición de datos. Tivoli Universal Agent puede supervisar una MIB estándar o cualquier MIB que se le proporcione. Consulte “Sentencia APPL” en la página 131 para obtener más información. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27. Mediante el proveedor de datos de SNMP. Puede entonces supervisar cualquier variable MIB como un atributo. permitiéndole integrar la gestión de red con la gestión de sistemas y de aplicaciones.

como por ejemplo. Características del proveedor de datos de SNMP El proveedor de datos de SNMP es un gestor de SNMP completo. MIBSTATUS y MIBNODATA Espacios de trabajo MANAGED-NODES Espacios de trabajo NETWORK Una aplicación MIB en particular Se utilizan los mismos nombres de sistemas gestionados cuando se distribuye una situación. Capítulo 4. permiten gestionar y controlar los datos MIB de SNMP. Nota: Si se utiliza una aplicación de metarchivo para recopilar los mismos datos de MIB de varios agentes SNMP que se ejecutan en diferentes hosts. capaz de descubrir la red. si crea una situación que incluye atributos del grupo MANAGED-NODES. Tabla 12. respectivamente. Cuando se inicia el proveedor de datos de SNMP. Descubrimiento y gestión de red Una aplicación definida por Tivoli Universal Agent. Si crea una situación que incluye atributos del grupo NETWORK. TRAP. debe distribuirlo a HotListName:SNMP-MANAGER00. Los datos MIB recopilados de cada host se listan como una fila de datos separados en un espacio de trabajo común. Las aplicaciones de metarchivo SNMP. Hay dos excepciones en el formato de nomenclatura del sistema gestionado para las aplicaciones del proveedor de datos de SNMP. para la aplicación de metarchivo MIB-2. sigue habiendo sólo un sistema gestionado para representar dicha aplicación. Varios espacios de trabajo del proveedor de datos de SNMP. en el que el nombre de host del agente sirve de atributo KEY. el nombre de sistema gestionado correspondiente es NombreHostLocal>:MIB-200. también hay una aplicación especial denominada SNMP-MANAGER que se coloca inmediatamente en línea con el siguiente nombre de sistema gestionado: NombreHostLocal:SNMP-MANAGER00 SNMP-MANAGER es una aplicación generada internamente que siempre está en la versión 00. La tabla 11 resume los formatos de todos los sistemas gestionados del proveedor de datos de SNMP. con una correlación de uno a uno de variables MIB con atributos ITM. supervisar las condiciones de excepción de SNMP enviadas al proveedor de datos. Espacios de trabajo NETSUMMARY. consultar a los agentes de SNMP. Formatos de nombres de sistemas gestionados Nombre de sistema gestionado NombreHostLocal:SNMP-MANAGER00 NombreListaFavoritos:SNMP-MANAGER00 NombreRed:SNMP-MANAGER00 NombreHostLocal:NombreAplicMIBVV Utilizado para ver. como otros datos cualesquiera utilizando la capacidad de ITM estándares. en los que la parte NombreHostLocal se sustituye por NombreListaFavoritos y NombreRed. ROUTER. Por ejemplo.Por ejemplo.. Los espacios de trabajo de SNMP-MANAGER se describen en “Espacios de trabajo de la aplicación SNMP-MANAGER” en la página 84. en específico para los espacios de trabajo MANAGED-NODES (también conocido como ″listas de favoritos″) y NETWORK. debe distribuirla a NombreRed:SNMP-MANAGER00. Acerca de los proveedores de datos 75 . SNMP-MANAGER. supervisar condiciones de excepción de SNMP y de controlar los agentes mediante operaciones SET. permite descubrir la topología de red TCP/IP. La Tabla 12 resume los formatos de los sistemas gestionados.. y gestionar y configurar los dispositivos habilitados para SNMP en la empresa. TRAP y MIBSTATUTS son accesibles debajo del sistema gestionado NombreHostLocal:SNMP-MANAGER00 en Tivoli Enterprise Portal Navigator.

Especificación de nombres de comunidad El proveedor de datos de SNMP realiza dos operaciones que requieren nombres de comunidad: v Descubrimiento de red v Recopilación de datos de MIB El proveedor de datos permite una flexibilidad considerable sobre cómo especificar los nombres de comunidad para dichas operaciones. Especificación de un nombre de comunidad flexible El proveedor de datos de SNMP acomoda las variantes en los nombres de comunidad con una tabla de nombre de comunidad que se puede modificar dinámicamente. se utilizará dicho nombre. consulte “Aplicaciones SNMP de Tivoli Universal Agent” en la página 32). crear situaciones de supervisión y establecer políticas de automatización. especifique dicho nombre en el archivo KUMSCOMM. el proveedor de datos resuelve el nombre de comunidad en el siguiente orden: v Si se especifica un nombre de comunidad en el campo & para la operación Actuación → Monitor Start. Ancho de banda de red reducido recopilando únicamente un subconjunto de variables MIB. Listas de nodos gestionados personalizados (listas de favoritos) Las listas de nodos gestionados permiten dividir la red empresarial en segmentos más pequeños y más sencillos de gestionar. o puede utilizarlos como base para aplicaciones SNMP personalizadas. Puede importar estos metarchivos tal cual. el proveedor de datos utilizará el valor predeterminado especificado por KUMP_SNMP_NET_COMMUNITY. pero el valor predeterminado no es público. en las que sólo debe incluir los atributos MIB en los que esté interesado y definir sus propias agrupaciones de atributos. La consolidación de grupos de atributos para que pueda realizar un seguimiento y análisis de los problemas desde una única ventana de espacio de trabajo. para los cuales puede ver espacios de trabajo. Soporte de nombres simbólicos Con su tabla de nombres simbólicos. Consulte “Nombres de sistemas gestionados de las aplicaciones del proveedor de datos de SNMP” en la página 74 para obtener más información. el proveedor de datos de SNMP permite utilizar nombres más familiares en lugar de direcciones de red. Si no se indica nombre de comunidad alguno en el archivo KUMSCOMM de un host o dispositivo determinado. Las aplicaciones SNMP personalizadas incluyen las siguientes ventajas: 1. utilice la variable de entorno KUMP_SNMP_NET_COMMUNITY para especificar el nombre que desea utilizar como valor predeterminado. Consulte “Creación de aplicaciones SNMP personalizadas” en la página 35 para obtener más información. Si no se especifica un valor predeterminado. (Para obtener más información. v Si debe utilizarse un nombre de comunidad específico para una dirección de red en particular. se utilizará el valor público predeterminado. v Si no se especifica ningún nombre de comunidad para &. IBM Software Support crea automáticamente metarchivos SNMP convirtiendo las MIB en metarchivos. Durante la recopilación de datos de MIB. El método más sencillo de especificar nombres de comunidad son: v Si desea utilizar el valor predeterminado. Resolución de nombres de comunidades Durante el descubrimiento de red. se utiliza el nombre especificado. pero se especifica un nombre en el archivo KUMSCOMM para el host en particular.Aplicaciones personalizables por el usuario No deben crearse metarchivos para aplicaciones MIB de SNMP de la misma manera que se hace con otros proveedores de datos. 2. el proveedor de datos de SNMP intenta recopilar datos MIB-2 (RFC1213) de los dispositivos. 76 IBM Tivoli Universal Agent: Guía del usuario .

32.10. Acerca de los proveedores de datos 77 . El proveedor de datos soporta nombres simbólicos mediante la información que se guarda en un archivo llamado KUMSNAME.tivoli. cambiar o suprimir entradas en cualquier momento. y activar la tabla utilizando el mandato de consola LOADCOMM: kumpcon loadcomm Este mandato también está disponible desde la interfaz de Actuación.18. Después de haber definido los nombres simbólicos. En este archivo.1 yellowtail El proveedor de datos de SNMP lee la tabla de nombres de comunidad durante el arranque. Pero puede añadir. El formato de las entradas es: nombre_agente/dirección nombre_comunidad Por ejemplo: alpha tiger beta.0 Chicago-FIN Tenga en cuenta los siguientes convenios cuando cree la lista de nombres simbólicos: v El cero final de la dirección de red es opcional v El nombre de red simbólico debe ser exclusivo v Los nombres sólo pueden contened caracteres alfanuméricos. seguidas de sus nombres simbólicos: 10. creando una lista de direcciones de red IP decimales separadas por puntos.0 LA-TEST 198. guiones y subrayados. y podrá utilizarlos siempre que sea necesario especificar el nombre o dirección de red. Para especificar nombres simbólicos para la red.36.0 Chicago-DEV 10. Asignación de nombres de red simbólicos El proveedor de datos de SNMP permite referirse a las redes utilizando sus nombres simbólicos. liste todos los recursos de red que desea gestionar que no acepten el nombre de comunidad junto con el nombre que sí aceptan. el proveedor de datos utiliza el valor predeterminado especificado por KUMP_SNMP_NET_COMMUNITY.32.10.v Si no se especifica ningún nombre en el campo & o el archivo KUMSCOMM. que se encuentra en el directorio de trabajo de Tivoli Universal Agent. v Si no se especifica un valor predeterminado. Capítulo 4. Especificación de nombres de comunidad no predeterminados La tabla de nombres de comunidad se almacena en un archivo de texto denominado KUMSCOMM. establezca la variable de entorno KUMP_SNMP_NET_COMMUNITY con el nombre preferido: KUMP_SNMP_NET_COMMUNITY=nombre_predeterminado Especifique el nombre de comunidad exactamente como se ha asignado ya que es sensible a mayúsculas y minúsculas. se utilizarán para referirse a las redes en todos los espacios de trabajos.com osprey 10.210. se utilizará el valor público predeterminado. Edición del archivo de nombres simbólicos El archivo KUMSNAME se encuentra en el directorio de trabajo de Tivoli Universal Agent. Especificación de un nombre de comunidad predeterminado Para especificar un nombre de comunidad predeterminado distinto para el proveedor de datos de SNMP.10.

“Configuración de condiciones de excepción de SNMP”. Observe que éste es el valor predeterminado. El puerto de escucha de condiciones de excepción debe asignarse correctamente durante el arranque. el archivo trapcnfg se encuentra en el directorio de trabajo de Tivoli Universal Agent. Aplicación SNMP-MANAGER La aplicación SNMP-MANAGER se compone de los siguientes siete grupos de atributos: v MANAGED-NODES v MIBNODATA v MIBSTATUS v NETSUMMARY v NETWORK v ROUTER v TRAP Los atributos de dichos grupos se describen en el Apéndice C. Puede modificar este archivo o utilizar un archivo de configuración distinto. No obstante. De forma predeterminad. convierte las condiciones de excepción de SNMPv2 al formato SNMPv1 antes de enviarlas para realizar otros procesos. Recepción de condiciones de excepción Hay tres requisitos esenciales para que el proveedor de datos de SNMP pueda recibir condiciones de excepción: 1. El proveedor de datos de SNMP puede recibir tanto condiciones de excepción de SNMPv1 como SNMPv2. “Atributos de SNMP”. pero el valor se puede alterar temporalmente con la variable de entorno KUMP_SNMP_TRAP_PORT=nnn. 2. Sin embargo. Cuando se están recopilando los datos de condiciones de excepción. el número de puerto de escucha es 162. De forma predeterminada. 78 IBM Tivoli Universal Agent: Guía del usuario . Los espacios de trabajo basado en estos grupos se describen en “Espacios de trabajo de la aplicación SNMP-MANAGER” en la página 84.Activación del archivo El proveedor de datos de SNMP lee el archivo de nombres simbólicos durante el arranque. Envío de condiciones de excepción de SNMP al proveedor de datos El espacio de trabajo de SNMP-MANAGER TRAP contiene información acerca de las condiciones de excepción recibidas por el proveedor de datos. suprimir o modificar entradas en cualquier momento y activar el archivo editado utilizando el mandato de consola LOADNAME: KUMPCON LOADNAME Este mandato también está disponible desde la interfaz de Actuación. puede añadir. Consulte el Apéndice E. puede definir situaciones contra la tabla SNMP-MANAGER TRAP y especificar acciones reflejas y otras formas de automatización en respuesta a dichas alertas recibidas. Deberá configurar los agentes SNMP para que envíen las condiciones de excepción al nombre de host en el que se está ejecutando el proveedor de datos de SNMP de Tivoli Universal Agent para recibir datos en este espacio de trabajo. en la página 229 para obtener más información. estatus e ID de fuente a las condiciones de excepción. gravedades. Archivo de configuración de condiciones de excepción El proveedor de datos de SNMP utiliza un archivo de configuración llamado trapcnfg para representar información de condiciones de excepción en un formato de sencilla lectura y para asignar categorías. en la página 191. La variable de entorno KUMP_SNMP_MONITOR_TRAP=Y debe estar especificada.

Las condiciones de excepción recibidas se visualizan en el espacio de trabajo TRAP debajo del sistema gestionado NombreHostLocal:SNMP-MANAGER00 en Tivoli Enterprise Portal Navigator. Si necesita realizar más procesos en las condiciones de excepción recibidas. consulte “Metarchivos SNMP sólo de condición de excepción” en la página 34 debajo de “Aplicaciones SNMP de Tivoli Universal Agent” en la página 32. La función de recepción de condiciones de excepción se ha desplazado a un proceso separado en los sistemas UNIX para evitar la necesidad de iniciar siempre el proveedor de datos de SNMP con autorización de usuario root. mientras que en los sistemas UNIX hay un proceso receptor de condiciones de excepción distinto que se denomina kumstrap. para analizar campos individuales fuera de la columna Value_List. espera a recibir condiciones de excepción. En los sistemas Windows." Redirección de los datos de condición de excepción De forma predeterminada./itmcmd agent start um: "Nota: El proceso de Universal Agent. No es necesario emitir un mandato de inicio por separado para el proceso kumstrap. redirige una copia de la condición de excepción al grupo de atributos. Para poderse ver correctamente. con el proveedor de datos de SNMP activado y el proceso kumstrap todavía puede tener autorización a nivel root para asignar el puerto 162 y la escucha de condiciones de excepción entrantes. kumstrap no se ha iniciado. puede definir un grupo de atributos de condición de excepción especial en cualquier metarchivo SNMP. Durante la instalación de Tivoli Universal Agent en los sistemas UNIX. Como el puerto 162 es un puerto cuyo número es bajo. si es así. el script SetPerm concede al archivo binario kumstrap permiso Set-User-ID. el proveedor de datos de SNMP explora a ver si existen aplicaciones de metarchivo que tengan un grupo de atributos y. la columna Value_List en el espacio de trabajo TRAP muestra los nombres de variables de condición de excepción en lugar de los valores OIS asociados. Este permiso permite que un ID de usuario no root inicie Tivoli Universal Agent en los sistemas UNIX. Cada vez que se recibe una condición de excepción. Los agentes de SNMP deben estar configurados para enviar las condiciones de excepción al host donde se ejecuta el proveedor de datos de SNMP. las condiciones de excepción recibidas deben estar definidas en el archivo trapcnfg. a continuación. por ejemplo./itmcmd agent start um y el proveedor de datos de SNMP es uno de los proveedores de datos configurados. Para obtener más información sobre cómo definir variables de condición de excepción en metarchivos SNMP. Diferencias en la recepción de condiciones de excepción entre los sistemas UNIX y Windows La recepción de condiciones de excepción funciona de un modo un poco distinto en los sistemas UNIX y en Windows. sólo un proceso de nivel root puede asignarlo. búsqueda de archivos trapcfng y actualización de espacios de trabajo TRAP. el receptor de condiciones de excepción se ejecuta como un subproceso dentro del proceso principal de Universal Agent. La lógica del proveedor de datos de SNMP que se ejecuta dentro de Universal Agent se registra ella misma como una parte interesada en kumstrap. por lo que siempre que kumstrap recibe una nueva condición de excepción. Cuando se ejecuta el mandato . si ha importado un metarchivo SNMP que define las variables de condición de excepción individuales.3. el script itmcmd inicia automáticamente el proceso kumstrap junto con el proceso kuma620 principal. Si el proceso kumstrap no se inicia correctamente. el proveedor de datos de SNMP no puede recibir condiciones de excepción y se visualiza el siguiente mensaje después de emitir el mandato . y consta de un pequeño programa autónomo que asigna el puerto de escucha de condiciones de excepción y. las condiciones de excepción recibidas sólo se incluyen en la tabla TRAP y el espacio de trabajo que forma parte de la aplicación SNMP-MANAGER de Universal Agent. El grupo de atributos de condición de excepción requiere una sentencia //SOURCE TRAP para habilitar la característica de redirección de condición de excepción. Como mejora añadida de legibilidad. tal como se muestra en el siguiente metarchivo SNMP simple: Capítulo 4. Acerca de los proveedores de datos 79 . la reenvía al proveedor de datos de SNMP para la descodificación de condiciones de excepción.

1.3.’ -Time_Stamp T 16 -Object_ID D 64 -Generic_Trap C 999999 -Specific_Trap C 999999 Source_Name D 64 -Source_Type D 32 -Source_Status D 32 Enterprise_Name D 64 Alert_Name D 64 -Cat D 32 -Sev D 32 -Description D 256 Situation_Name D 32 DLMSTRBGN=’{sitName=’ DLMSTREND=’}’ Origin_Node D 32 DLMSTRBGN=’{sitCurrStat-OriginNode=’ DLMSTREND=’}’ LocalTimeStamp T 16 DLMSTRBGN=’{sitCurrStat-LocalTimeStamp=’ DLMSTREND=’}’ Severity C 999999 DLMSTRBGN=’{sitCurrStat-Severity=’ DLMSTREND=’}’ Category C 999999 DLMSTRBGN=’{sitCategory=’ DLMSTREND=’}’ Attributes D 256 DLMSTRBGN=’{sitAttributeList=’ DLMSTREND=’}’ Supervisión de las aplicaciones SNMP Este apartado describe cómo supervisar los datos de SNMP utilizando Tivoli Enterprise Portal.3.1.1.6.3.1.2.0 Agent_Name D 64 KEY 0.2.2.1.1.2.5.0 * //NAME ITM_TRAPS K 3600 //SOURCE TRAP //ATTRIBUTES ’. Las definiciones de atributo están pensadas para procesar condiciones de excepción de IBM Tivoli Monitoring.6.6.4.’ Time_Stamp T 16 Object_ID D 64 Generic_Trap C 999999 Specific_Trap C 999999 Source_Name D 64 Source_Type D 32 Source_Status D 32 Enterprise_Name D 64 Alert_Name D 64 Category D 32 Severity D 32 Description D 256 Value_List Z 1024 @Varbind data En el siguiente ejemplo de metarchivo.2. Tivoli Enterprise Portal presenta un conjunto de espacios de trabajo para cada aplicación MIB de SNMP que supervise.1. el primer grupo de atributos se utiliza para recopilar datos MIB.1.1.1.0 sysUpTime C 999999 1.1.0 sysDescr D 255 1.0 sysObjectID D 1024 1.3.2.1.2.1.0 sysContact N 255 1.7.3.0 sysName N 255 1.1 //NAME SYSTEM K 3600 //ATTRIBUTES Agent_Info D 128 0.0 sysServices C 127 1.1.2.6.0 sysLocation D 255 1.3.1.6.1.6.1.1.6.3.1.1.1.6.2.6.1. en el sentido de que determinados atributos están ocultos y otros se analizan utilizando delimitadores específicos de los atributos: //SNMP TEXT //APPL CUSTOM mib-2 1.3. El segundo grupo de atributos recibe condiciones de excepción redirigidas de la tabla SNMP-MANAGER TRAP. Cada espacio de trabajo se corresponde con un grupo de atributos definidos en el metarchivo 80 IBM Tivoli Universal Agent: Guía del usuario .1.//SNMP TEXT //APPL TRAPRCV @SNMP application for processing traps //NAME TRAPTABLE K 3600 //SOURCE TRAP //ATTRIBUTES ’.3.

1. Inicio de la recopilación de datos MIB Para que los espacios de trabajo MIB muestren datos y para que las situaciones evalúen los datos. Puede utilizar los atributos definidos en cada aplicación MIB de SNMP para crear situaciones que alerten acerca de los problemas con los dispositivos supervisados. puede iniciar la recopilación de datos MIB indicando al proveedor de datos de SNMP del que los agentes SNMP recopilan datos. puede utilizar combinaciones de nombres de host. rodee el par de nombre de host o la dirección IP y el nombre de comunidad de llaves.2 o 10.1. Pluto.1. Por ejemplo: Mars. especifique la parte de red de la dirección IP en lugar de la dirección de host. Consejo: Para recopilar datos para todos los agentes SNMP dentro de una red determinada. Si especifica un nombre de comunidad. primero debe importar el metarchivo de SNMP.1. direcciones IP y nombres de comunidad.1. 3.3. Si desea sondear un agente utilizando un puerto distinto de 161.1. 2.1.1 es el agente de destino primario de la solicitud de recopilación de datos MIB. Si no especifica un nombre de comunidad. utilice la opción Monitor Start de la característica Actuación en el cliente de Tivoli Enterprise Portal.3 como respuestas no válidas de hosts desconocidos.1. especifique los nombres de host o direcciones decimales separadas por puntos de los agentes SNMP que desea supervisar y. {198. puede entrar el siguiente parámetro: 10.1(10. Venus. Consulte “Aplicaciones SNMP de Tivoli Universal Agent” en la página 32 para obtener más información acerca de las aplicaciones SNMP.2 | 10. Por ejemplo. {Jupiter viewx}. Si no hubiera configurado estas direcciones alternativas. qué nombres de comunidad deben utilizar y con qué frecuencia se deben muestrear datos.57. con una solicitud de Actuación es posible especificar una serie de agentes SNMP para realizar consultas.2 y 10. pero el proveedor de datos de SNMP también acepta respuestas de 10.3) Este parámetro significa que 10. el puerto de recopilación de datos MIB predeterminado.1. Por Capítulo 4. Si va a recopilar datos MIB desde un agente de SNMP que se ejecuta dentro de un entorno en clúster.1.1. Consulte “Creación de situaciones con atributos de aplicaciones SNMP” en la página 94 para obtener detalles específicos de la creación de situación que desea utilizar con el proveedor de datos de SNMP. A continuación. Aparecerá la ventana Editar valores de argumentos. Inicio de la recopilación de datos: Utilice los siguientes pasos para utilizar la característica de Actuación para iniciar la recopilación de datos MIB: 1. el nombre de comunidad. y la dirección del agente de respuesta tal vez no sea necesariamente la misma dirección que la que el mandato Get de SNMP tenía prevista.210. Seleccione Actuación en el menú desplegable. 5.1.1. Pulse con el botón derecho del ratón en el elemento de Navigator. 4.37 co98x} Como puede verse en este ejemplo. suministre una serie de direcciones alternativas delimitadas por barras verticales después de la dirección del agente primario. En la ventana Editar valores de argumentos: v Para AgentData. Seleccione Monitor Start en la lista Nombre. opcionalmente.1. indique el puerto de destino delimitado entre llaves inmediatamente después del nombre de host o de la dirección decimal separada por puntos.1. se utilizará el valor predeterminado. Consulte “Especificación de nombres de comunidad” en la página 76 para obtener información acerca de la especificación de nombres de comunidad.de la aplicación y cada una de las columnas en el espacio de trabajo se corresponde con un atributo en dicho grupo. Seleccione el elemento de Navigator asociado con la aplicación SNMP en la que desea iniciar el mandato. Acerca de los proveedores de datos 81 . se omiten los datos MIB recibidos de 10.1. Para ello.

Para utilizar esta forma de especificación. 4. el archivo KUMSMIBI contiene un registro para cada grupo de atributos de metarchivo SNMP. 2. El espacio de trabajo UAGENT DPLOG contiene un mensaje KUMPL110I para cada solicitud Monitor Start que el proveedor de datos de SNMP ha recibido. en cualquier momento para ver una lista de aplicaciones y grupos de atributos SNMP cuyos datos se están recopilando en un host determinado. y a continuación. La dirección de red se ignorará si no se ha descubierto o no ha desactivado el descubrimiento de red (KUMP_SNMP_NET_DISCOVERY=NO). Para Sistemas de destino. 5. Si ha especificado un nombre simbólico para la red. 2. en el que desea que el proveedor de datos de SNMP sondee el agente SNMP.mdl. la recopilación tiene lugar para todos los grupos de atributos en la aplicación MIB seleccionada. Si desea empezar a recopilar datos MIB-2 desde un agente SNMP y ha cumplimentado la información de Interval y attrGroup apropiada. 7. Pulse con el botón derecho del ratón en el elemento de Navigator. si no empieza a ver los datos MIB visualizados en el espacio de trabajo de la aplicación. especifique el intervalo de muestreo. en segundos.210. si la red es una red de clase C y especifica 198.ejemplo. El registro RAS1 de Universal Agent contiene uno o más mensajes de error si el mandato Monitor Start ha encontrado un error de algún tipo. Para detener la recopilación de datos. Similar a MIBSTATUS. 3. Por ejemplo.210. 4. puede utilizar dicho nombre. el proveedor de datos inicia la recopilación de datos de todos los agentes SNMP correspondientes en los host en la red 198. accesible desde el sistema gestionado NombreHostLocal:SNMP-MANAGER00. El espacio de trabajo MIBSTATUS contiene una fila de datos para cada grupo de atributos en un metarchivo SNMP. El archivo KUMSMIBI se encuentra en el directorio de trabajo de Tivoli Universal Agent. el proveedor de datos debe haber descubierto ya la red. incluidos los nombres de host del agente de SNMP que se sondean y la información de estatus del último intervalo de muestreo. no será necesario iniciarla de nuevo cada vez que inicie el proveedor de datos de SNMP. v Para Intervalo. si ha importado el metarchivo MIB-2. 6. Detención de la recopilación de datos: 1. Seleccione Actuación en el menú desplegable. El proveedor de datos mantiene la información acerca de los agentes SNMP supervisados en el archivo de configuración KUMSMIBI para que la recopilación de datos perdure durante los reinicios. 3. especifique el nombre del grupo de atributos en la aplicación de metarchivo para la que desea recopilar datos. Comprobación del estado de un mandato Monitor Start: Tras emitir un mandato Actuación > Monitor Start. El espacio de trabajo UAGENT ACTION contiene un mensaje de estado para cada mandato de Actuación que se ha emitido en los últimos 30 minutos. Seleccione Monitor Stop en la lista Nombre. seleccione NombreHostLocal:MIB-200 en el recuadro de diálogo Sistemas de destino. dispone de un sistema gestionado en línea denominado NombreHostLocal:MIB-200. Seleccione el elemento de Navigator asociado con la aplicación SNMP en la que desea iniciar el mandato. Cuando haya iniciado la recopilación de datos MIB. Si no especifica un grupo de atributos en particular.57. debe emitir un mandato Actuación > Monitor Stop. Pulse en Aceptar. pulse Aceptar. Consulte “Asignación de nombres de red simbólicos” en la página 77 para obtener más información. v Para attrGroup (opcional). Puede examinar el espacio de trabajo MIBSTATUS. seleccione el nombre de sistema gestionado que corresponde a la aplicación de metarchivo SNMP cuyos datos desea recopilar. 82 IBM Tivoli Universal Agent: Guía del usuario . incluidos los nombres de host del agente de SNMP en el intervalo de muestreo. RFC1213_mib-2. hay varios lugares que se comprueban para determinar si el mandato se ha ejecutado o no correctamente: 1.57.

especifique el nombre del grupo de atributos para el que desea detener la recopilación de datos. El espacio de trabajo UAGENT DPLOG contiene un mensaje KUMPL111I para cada solicitud Monitor Stop que el proveedor de datos de SNMP ha recibido. El nombre de host de un agente de SNMP que era el destino de un mandato Monitor Stop se elimina del espacio de trabajo MIBSTATUS. puede utilizar dicho nombre. Puede especificar asignaciones de puertos alternativas mediante los valores de puerto delimitados por corchetes para tener como destino un agente de SNMP en un puerto no estándar. 5. así como en el campo TargetAgentAddr de la ventana SNMP Set. El espacio de trabajo MIBSTATUS contiene una fila de datos para cada grupo de atributos en un metarchivo SNMP. 2. Consejo: Para detener la recopilación de datos de todos los agentes SNMP en una red determinada. El nombre de host de los agentes de SNMP detenidos se elimina del archivo. Recopilación de datos MIB SNMP desde puertos no estándares: Determinados agentes de proveedores de SNMP de terceros pueden presentar requisitos especiales. seleccione el nombre de sistema gestionado que corresponde a la aplicación de metarchivo SNMP para la que desea detener la supervisión. La especificación de puerto delimitada por corchetes también funciona en el campo de la ventana Actuación de Monitor Stop. Similar a MIBSTATUS.57. Comprobación del estado de un mandato Monitor Stop: Para determinar el estado de un mandato Actuación --> Monitor Stop. Venus. 7. Por ejemplo.210. 4. Jupiter. el archivo KUMSMIBI contiene un registro para cada grupo de atributos de metarchivo SNMP. indique el puerto de destino entre llaves inmediatamente a continuación del nombre de host o de la dirección decimal separada por puntos. Si ha especificado un nombre simbólico para la red. como utilizar otros puertos distintos del puerto de supervisión predeterminado 161. incluidos los nombres de host del agente de SNMP en el intervalo de muestreo. 6. puede especificar la parte de red de la dirección IP en lugar de la dirección del host. v Para attrGroup (opcional). si la red es una red de clase C y se especifica 198.57. hay varios lugares que hay que comprobar: 1. el puerto predeterminado. para indicar que el proveedor de datos de SNMP deberá sondear un agente en el puerto 333 de un host llamado. Pulse en Aceptar.Aparecerá la ventana Editar valores de argumentos.210. el proveedor de datos de SNMP detiene la recopilación de datos de todos los agentes SNMP correspondientes en la red 198. Por ejemplo. se detendrá la recopilación de todos los grupos de atributos en la aplicación MIB seleccionada. Mars. y a continuación. Acerca de los proveedores de datos 83 . especifique: goby[333] en el campo de la ventana Monitor Start. El espacio de trabajo UAGENT ACTION contiene un mensaje de estado para cada mandato de Actuación que se ha emitido en los últimos 30 minutos. Consulte “Asignación de nombres de red simbólicos” en la página 77 para obtener más información. escriba una lista separada por comas de los nombres de host o de direcciones IP de los agentes SNMP para los que desea detener la recopilación de datos. incluidos los nombres de host del agente de SNMP que se sondean y la información de estatus del último intervalo de muestreo. Por ejemplo. 5. 3. pulse Aceptar. Pluto v Si desea detener el sondeo de un agente utilizando un puerto distinto del 161. En la ventana Editar valores de argumentos: v Para el valor AgentData. El registro RAS1 de Universal Agent contiene uno o más mensajes de error si el mandato Monitor Stop ha encontrado un error. Para Sistemas de destino. Si no especifica un grupo de atributos determinado. Capítulo 4.

de proveedores o RFC estándares. Los metarchivos MIB. 84 IBM Tivoli Universal Agent: Guía del usuario . Incluya únicamente los metarchivos MIB necesarios en el archivo de inicialización de Tivoli Universal Agent KUMPCNFG para controlar la cantidad de recopilación de datos. Cuando se añade un recurso de red o se activa desde la lista de nodos gestionados. que quiere decir que no se recopilarán de forma automática los datos de ningún agente MIB-2. cualquier dispositivo identificado en una “lista de favoritos. en la página 191 para obtener descripciones completas de los atributos de SNMP-MANAGER. condiciones de excepción de SNMP recibidas y atributos para los cuales se estén recopilando datos en la actualidad. Consulte “Utilización de listas de nodos gestionados (listas de favoritos)” en la página 91 para obtener más información acerca de las listas de favoritos. La recopilación automática de MIB se aplica a los recursos en la lista de nodos gestionados.Recopilación automática de datos MIB de recursos de red descubiertos: A medida que se descubren recursos de red y se añaden a una lista de nodos gestionados. Espacios de trabajo de la aplicación SNMP-MANAGER La aplicación SNMP-MANAGER proporciona siete espacios de trabajo que presentan información acerca de las redes. Por lo tanto. Puede controlar la recopilación automática de datos MIB-2 estableciendo la variable de entorno KUMP_SNMP_AUTOSTART_COLLECTION_MIB2. se cargan para recopilar datos.” y todos los agentes de Tivoli Enterprise Monitoring en la empresa: v MANAGED-NODES v MIBNODATA v MIBSTATUS v NETSUMMARY v NETWORK v ROUTER v TRAP Los siguientes apartados proporcionan descripciones acerca de dichos espacios de trabajo. Consulte el Apéndice C. “Atributos de SNMP”. es posible recopilar dichos atributos para todos los agentes independientemente de su OID empresarial. Efectúe una doble pulsación sobre el elemento SNMP-MANAGER en la vista Física de árbol de navegación. Deberá satisfacer las siguientes condiciones para permitir la recopilación automática de MIB. Deberá precargar los MIB de proveedores correspondientes. el gestor SNMP de Tivoli Universal Agent Manager puede iniciar automáticamente la recopilación de datos de los MIB correspondientes. El valor predeterminado es Yes. El valor predeterminado es No. Tivoli Universal Agent comprueba entonces todos los metarchivos MIB cargados que pertenezcan al árbol OID empresarial del proveedor. el gestor SNMP recupera primero la identidad del recurso y determina el OID empresarial del fabricante. Variables de entorno de recopilación de datos MIB-2: Todos los agentes SNMP soportan los atributos RFC 1213 MIB-2. Puede añadir manualmente dichos recursos a la lista o que se añadan automáticamente durante el proceso de descubrimiento de Tivoli Universal Agent. Acceso a los espacios de trabajo de SNMP-MANAGER: Para acceder a los espacios de trabajo de SNMP-MANAGER: 1. Las recopilaciones de datos se inician automáticamente en este nodo para todos los grupos de atributos de todos los metarchivos MIB correspondientes. Variables de entorno de recopilación de datos MIB: La variable de entorno KUMP_SNMP_AUTOSTART_MIB_COLLECTION controla la recopilación automática de datos MIB.

2. La fecha y hora en que se comprobó el estatus del nodo por última vez. La descripción de las características del nodo como están definidas por un administrador de red o por el fabricante del dispositivo. El tipo de nodo gestionado.El elemento del espacio de trabajo de SNMP-MANAGER se visualiza a continuación del elemento SNMP-MANAGER. Si un espacio de trabajo está consistentemente vacío para un grupo de atributos determinado en uno de los metarchivos MIB SNMP. El nombre de empresa de la MIB de recopilación de datos. Por ejemplo. puede comprobar el espacio de trabajo MIBNODATA para ver si es normal y esperado que el grupo de atributos en cuestión no devuelva datos. Tabla 13. Observe que esta información sólo se visualiza si el dispositivo está habilitado para SNMP y responde a un mandato SNMP Get para la variable RFC 1213 System Group sysServices MIB. Descripción de nodo Estatus del nodo Tipo de nodo Indicación de la hora del estatus Espacio de trabajo MIBNODATA: Este espacio de trabajo identifica las tablas MIB para las que los agentes de supervisión no devuelven datos. nodo IP general. host de aplicaciones o pasarela. Columnas del espacio de trabajo MANAGED-NODES Columna Dirección Tiempo respuesta actual ms Nombre Descripción La dirección IP del host del nodo gestionado. De lo contrario. El tiempo de respuesta actual de la red para solicitudes SNMP o ICMP para el nodo gestionado tal como lo ve SNMP-MANAGER. El nombre de host del nodo gestionado. De lo contrario. la Descripción de nodo se lista como ″No disponible. Si no es posible resolver la dirección del nodo mediante DNS. Seleccione el elemento representando el espacio de trabajo que desea visualizar. tal y como se especifica en el archivo de configuración KUMSLIST. Aparecerá el espacio de trabajo predeterminado. Observe que esta información sólo se visualiza si el dispositivo está habilitado para SNMP y responde a un mandato SNMP Get para la variable RFC 1213 System Group sysDescr MIB. Los datos recopilados para un espacio de trabajo MANAGED-NODES sólo se muestran en los sistemas gestionados con el siguiente formato: NombreListaFavoritos:SNMP-MANAGER00. Una lista de tablas de empresa para las que el agente SNMP no devuelve datos.″ El estado operativo actual del nodo gestionado. Tabla 14. Permite supervisar información acerca de los nodos identificados en la lista de nodos gestionados. Espacio de trabajo MANAGED-NODES: Este espacio de trabajo contiene información acerca de los nodos identificados en la lista de favoritos. el tipo de nodo aparece listado como ″Desconocido″ si el dispositivo está fuera de línea e ″IP Node″ si el dispositivo está en línea. Acerca de los proveedores de datos 85 . se mostrará la dirección IP decimal separada por puntos. Columnas del espacio de trabajo MIBNODATA Columna Nombre de agente Módulo empresarial Tablas sin datos Descripción El nombre o dirección del agente de supervisión. Consulte la Tabla 12 en la página 75 para obtener más información acerca de los formatos de nombres de sistemas gestionados. Capítulo 4.

Es el intervalo más corto de todas las solicitudes de recopilación de datos pendientes. Tabla 16. se actualizará la información de este espacio de trabajo. El tiempo de respuesta de red máximo para todas las solicitudes SNMP o ICMP. en milisegundos. Tabla 15. La máscara de red de la red descubierta. Columnas del espacio de trabajo NETSUMMARY Columna Nodos activos Tiempo de respuesta actual en ms Descripción El número total de nodos de red activos en la actualidad. El nombre de empresa de la base MIB en la que se basa la aplicación supervisada. se visualiza un 0 en esta columna. en milisegundos. en milisegundos. tal como lo ve SNMP-MANAGER. La dirección de la red descubierta.Espacio de trabajo MIBSTATUS: Este espacio de trabajo permite averiguar en cualquier momento para qué MIB SMNP y grupos de atributos se están recopilando datos y desde qué agentes SNMP. tal como lo ve SNMP-MANAGER. tal como lo ve SNMP-MANAGER. También muestra el intervalo de supervisión activo en la actualidad y la última vez que se ha recopilado la muestra de datos. Si la variable de entorno está establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No. Columnas del espacio de trabajo MIBSTATUS Columna Grupo de atributos Empresa Info del agente de supervisión Intervalo de supervisión Indicación de la hora de la última muestra Descripción Nombre del grupo de atributos para el que se están recopilando datos. Indica si los nodos en la red se están gestionando o no de forma activa. Cuando ejecute un mandato como Actuación → Monitor Start o Actuación → Monitor Stop. se visualiza un 0 en esta columna. El intervalo de recopilación de datos actualmente activo. La indicación de la hora del conjunto de datos de atributos de MIB actualmente disponibles. El tiempo de respuesta de red mínimo para todas las solicitudes SNMP o ICMP. El tiempo de respuesta actual de red para solicitudes SNMP o ICMP. Una lista de nodos de agentes SNMP de destino y su correspondiente nombre de comunidad SNMP. Si la variable de entorno está establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No. La Tabla 16 lista las columnas en el espacio de trabajo y sus descripciones. Nodos inactivos Gestionado Tiempo de respuesta máx en ms Tiempo de respuesta mín en ms Dirección de red Máscara de red 86 IBM Tivoli Universal Agent: Guía del usuario . como el número de nodos activos e inactivos. Si la variable de entorno está establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No. El número total de nodos de esta red que están actualmente inactivos. Compruebe el espacio de trabajo NETWORK para ver los detalles acerca de la red gestionada. se visualiza un 0 en esta columna. se visualiza un 0 en esta columna. Espacio de trabajo NETSUMMARY: El espacio de trabajo NETSUMMARY proporciona información de alto nivel acerca de las redes en la empresa. Si la variable de entorno está establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No.

se muestra la dirección IP en formato decimal con puntos. Capítulo 4. Puede inhabilitar el valor predeterminado estableciendo KUMP_SNMP_MANAGE_LOCAL_NETWORK=N en el archivo de variables de entorno de Tivoli Universal Agent. Columnas del espacio de trabajo NETWORK Columna Dirección Descripción Descripciones La dirección de red de Internet de un nodo dentro de una red gestionada.Tabla 16. donde se está ejecutando el proveedor de datos de SNMP. Indica si hay o no un agente de SNMP activo en este nodo de red. Tabla 17. El nombre de host del nodo de red. Los estatus posibles se muestran en la tabla siguiente: On-line Inactive Tipo Se ha establecido contacto con el nodo y está operativo. sólo se descubre y gestiona de forma inicial la red local. Los nombres de sistemas gestionados tienen el siguiente formato si se define el nombre de red en el archivo de configuración KUMSNAME: dirección_ip:SNMP-MANAGER00 o bien nombrered:SNMP-MANAGER00 Cuando se selecciona un sistema gestionado. El nodo no está operativo y no responde a las solicitudes de SNMP Get o ping. La información de ubicación del nodo como está definida por un administrador de red. Ubicación Nombre Habilitado para SNMP Estatus El tipo de nodo de red. La descripción de las características del nodo como están definidas por un administrador de red o por el fabricante del dispositivo. El valor de este atributo corresponde a la especificación de la variable MIB sysDescr de RFC 1213 System Group. El estatus operativo actual del nodo de red. El valor de este atributo corresponde a la especificación de la variable MIB sysLocation de RFC 1213 System Group. tal como está definido en la especificación de la variable MIB sysServices de RFC 1213 System Group estándar de Internet. La Tabla 17 lista las columnas en el espacio de trabajo NETWORK y sus descripciones. Si la dirección de un direccionador no se puede resolver mediante DNS. De forma predeterminada. debe iniciar el descubrimiento de red tal y como se explica en “Descubrimiento de red” en la página 89. Espacio de trabajo NETWORK: El espacio de trabajo NETWORK presenta información detallada acerca de las redes individuales en la empresa. Columnas del espacio de trabajo NETSUMMARY (continuación) Columna Direccionadores de red Descripción Una lista de los direccionadores conectados a esta red. Acerca de los proveedores de datos 87 . el espacio de trabajo detallado que puede ver contiene la información específica de dicha red. Para descubrir y gestionar otras redes en la empresa.

La Tabla 18 lista las columnas en el espacio de trabajo ROUTER y sus descripciones. se muestra la dirección IP en formato decimal con puntos. El direccionador está activo y operativo El direccionador no está operativo El direccionador es un daemon y no está participando activamente en el funcionamiento de la red Nombre de direccionador Estatus de direccionador Espacio de trabajo TRAP: El espacio de trabajo TRAP contiene información acerca de las condiciones de excepción de SNMP de las que se han informado al proveedor de datos de SNMP. Si un Nombre de empresa. Columnas del espacio de trabajo ROUTER Columna Redes de destino Recuento de rutas Dirección de direccionador Descripción del direccionador Descripción Una lista de direcciones de red conocidas en este direccionador.″ Tabla 19. Es necesario configurar los agentes SNMP para que envíen las condiciones de excepción al nombre de host donde se está ejecutando el proveedor de datos de SNMP para recibir datos en este espacio de trabajo. La Tabla 19 lista las columnas en el espacio de trabajo TRAP. Este valor corresponde a la especificación de variable MIB sysDescr de RFC 1213 System Group. tal como las ha definido el fabricante del dispositivo. un número de Condición de excepción genérica y un número de Condición de excepción específica de una condición de excepción recibida no se puede encontrar en el archivo trapcnfg. La categoría de la condición de excepción. “Configuración de condiciones de excepción de SNMP”. El nombre de host del direccionador descubierto. la mayor parte de los valores de columna en el espacio de trabajo TRAP aparecen listados como ″No disponible. como su estatus actual y el número de subredes definidas en el direccionador. Si la dirección de un direccionador no se puede resolver mediante DNS. Los estatus posibles son: Verify On-line Off-line Passive El proveedor de datos de SNMP está en proceso de verificar el estatus del direccionador. El estado actual del direccionador descubierto.Espacio de trabajo ROUTER: El espacio de trabajo ROUTER contiene información pertinente a los direccionadores en las redes descubiertas. Consulte el Apéndice E. El proveedor de datos de SNMP utiliza un archivo de configuración llamado trapcnfg para representar información de condiciones de excepción en un formato de sencilla lectura y para asignar categorías. 88 IBM Tivoli Universal Agent: Guía del usuario . Puede modificar este archivo o utilizar un archivo de configuración distinto. en la página 229 para obtener más información. estatus e ID de fuente a las condiciones de excepción. Tabla 18. Una descripción de las características del direccionador. gravedades. Columnas del espacio de trabajo TRAP Columna Nombre de alerta Categoría Descripción El nombre de la condición de excepción. El número total de subredes direccionadas definidas en este direccionador. La dirección IP del direccionador descubierto. tal como está especificada en la definición del archivo de configuración de condiciones de excepción. tal como está especificado en la definición del archivo de configuración de condiciones de excepción.

El número de la condición de excepción genérica extraído de la condición de excepción recibida. El proveedor de datos mantiene un estado persistente entre reinicios. Los datos de vinculación de variable (VarBind) recibidos en la unidad de datos del protocolo de la condición de excepción (PDU). Los valores posibles son: 0 1 2 3 4 5 ID de objeto ColdStart WarmStart LinkDown LinkUp Error de autentificación EGPNeighborLoss Nombre de empresa Condición de excepción genérica El identificador de objeto SNMP que identifica de forma exclusiva la condición de excepción en la Base de información de gestión. deberá emitir un mandato Actuación → Manage Stop. tal como está especificado en el archivo de configuración de condiciones de excepción y tal como se busca mediante el identificador de objeto de la condición de excepción. no es necesario volver a iniciarla cada vez que inicie el proveedor de datos de SNMP. Acerca de los proveedores de datos 89 . Inicio del descubrimiento de red: 1. Sólo se aplica cuando Generic_Trap = 6. Indicación de la hora Lista de valores La fecha y la hora en que se ha producido una condición de excepción. Después de haber iniciado la supervisión de la red. El estatus del agente que ha originado la condición de excepción después de enviarla. SAAMMDDHHMMSSmmm. utilice la opción Actuación. La gravedad de la condición de excepción. Capítulo 4. El tipo de agente que ha originado la condición de excepción. En caso contrario. El ID de objeto se extrae de la condición de excepción recibida. utilice la opción Actuación → Manage Exclude. Seleccione el elemento de Navigator asociado con la aplicación o sistema en el que desea iniciar el mandato. Descubrimiento de red Para iniciar el descubrimiento de redes distintas de la red local. Pulse con el botón derecho del ratón sobre el elemento de Navigator o una fila en la vista de tabla. Gravedad Nombre de fuente Estatus fuente Tipo fuente Condición de excepción específica El número de la condición de excepción específica de la empresa extraído de la condición de excepción recibida. tal como está especificado en la definición de la condición de excepción en el archivo de configuración de condiciones de excepción. 2. Columnas del espacio de trabajo TRAP (continuación) Columna Descripción Descripción La descripción de la condición de excepción especificada en el archivo de configuración de condiciones de excepción. Para detener la supervisión de la red. El nombre de empresa de la condición de excepción.Tabla 19. La longitud máxima de la descripción es de 256 caracteres. Manage Start. Para excluir una red determinada del descubrimiento. se mostrarán como ID de objeto. tal como está especificada en la definición del archivo de configuración de condiciones de excepción. Los elementos VarBind se convierten a sus nombres de atributos de IBM Tivoli Monitoring si se ha cargado el metarchivo MIB correspondiente. El nombre de host o dirección IP del agente de SNMP que ha enviado la condición de excepción. El formato de la indicación de la hora es. tal como está especificado en la definición de la condición de excepción del archivo de configuración de condiciones de excepción.

5. Para inhabilitar de forma automática la gestión de la red local. Escriba la dirección de red en el campo SNMP. 8. Seleccione Actuación en el menú desplegable. Se recibirá una notificación de confirmación del sistema gestionado con la dirección de red seleccionada. a continuación. Escriba la dirección de red en el campo SNMP. con la que desea que se actualicen los datos de la red. Pulse con el botón derecho del ratón sobre el elemento de Navigator o una fila en la vista de tabla. Nota: Aquellas redes a las que se accede mediante interfaces de líneas serie de acceso telefónico como ppp o slip se excluyen de forma automática. Puede ver el nuevo nombre de sistema gestionado contrayendo y expandiendo el árbol de Navigator. 4. Pulse en Aceptar. Aparecerá la ventana Editar valores de argumentos. Cuando una red se está gestionando de manera activa. Exclusión de una red del descubrimiento: Puede excluir determinadas redes del descubrimiento.3. no se excluye. Seleccione Manage Stop en la lista Nombre. El nombre de sistema gestionado incluye la dirección de red para la que se ha iniciado la recopilación. la red local donde se esté ejecutando Tivoli Universal Agent siempre se gestiona cuando el proveedor de datos de SNMP esté activo. el nombre de sistema gestionado incluye dicho nombre en lugar de la dirección IP. pero deberá emitirse después de cada reinicios de Tivoli Universal Agent. Escriba la frecuencia. establezca la variable de entorno siguiente: KUMP_SNMP_MANAGE_LOCAL_NETWORK=N Nota: Si esta variable de entorno no está presente. De forma predeterminada. será posible ver los datos recopilados de los nodos en esa red. donde nombrehost es el nombre del host donde se está ejecutando el proveedor de datos de SNMP. en segundos. utilice la opción Actuación. Después de abrir el espacio de trabajo NETWORK. Si se ha especificado un nombre de red para la red. quizás porque son redes de respaldo o porque no desea cargarlas con consultas de descubrimiento de red. 3. Si desea gestionar dichas redes. 90 IBM Tivoli Universal Agent: Guía del usuario . Seleccione el elemento de Navigator asociado con la aplicación o sistema en el que desea iniciar el mandato. 2. Seleccione Manage Start en la lista Nombre. Seleccione Actuación en el menú desplegable. Aparecerá la ventana Editar valores de argumentos. aparecerá el indicador actualización de Navigator pendiente en Tivoli Enterprise Portal porque se ha insertado el nuevo sistema gestionado en la sección Universal Agent de Navigator. Seleccione el nodo nombrehost:SNMP-MANAGER00. En este caso. utilice la opción de Actuación Manage Exclude para excluir una red determinada. Detención del descubrimiento de red: Para finalizar la recopilación de los datos de red. la gestión de la red local será el valor predeterminado. 6. Se recibirá una notificación de confirmación del sistema gestionado con la dirección de red seleccionada. Después de recibir la confirmación. Pulse en Aceptar. pulse Aceptar. 9. 5. deberá emitir de forma manual consultas Actuación → Monitor Start para las mismas. Manage Stop. donde nombrehost es el nombre del host del proveedor o proveedores de datos que desea que recopilen los datos y. La gestión de la red puede detenerse de forma manual emitiendo el mandato Actuación → Manage Stop. Para detener el descubrimiento: 1. 6. 7. Seleccione el nodo nombrehost:SNMP-MANAGER00. 4.

Aparecerá la ventana Editar valores de argumentos. el subproceso de supervisión envía una solicitud de ping al dispositivo. seleccione el sistema gestionado SNMP-MANAGER y. para una utilización en particular. Se recibirá una notificación de confirmación del sistema gestionado con la dirección de red seleccionada. La aplicación SNMP-MANAGER permite definir y gestionar conjuntos de dispositivos críticos mediante listas de nodos gestionados o listas de favoritos. realizar acciones reflejas y ejecutar políticas de automatización. y una tercera que contenga los servidores que mantienen una aplicación distribuida en línea. 2. Escriba la dirección de red en el campo SNMP.com mercury[4500] us07 ishtar Definición LISTNAME Capítulo 4. a continuación. Seleccione Actuación en el menú desplegable. enviando primero un mandato SNMP Get para las variables RFC 1213 System Group MIB. Seleccione Manage Exclude de la lista Nombre. 7. este subproceso recorre en bucle cada dispositivo en la lista. definir situaciones. los demás valores de la columna se rellenan. el atributo Node_Status se establece en línea. La ventaja de una lista de nodos gestionados es que se puede supervisar el estatus on-line o bien off-line básicos de un conjunto de servidores o de otros dispositivos críticos en el entorno de una forma sencilla y con poca sobrecarga para el sistema. Seleccione el elemento de Navigator asociado con la aplicación o sistema en el que desea iniciar el mandato. gestionando por separado aquellos dispositivos críticos para determinada aplicación. servidor web y servidor alternativo. 6. En la lista Sistemas de destino. una ubicación geográfica o una parte de la red principal. Utilización de listas de nodos gestionados (listas de favoritos) Una red de tamaño medio puede contener cientos o miles de dispositivos. servidor de cortafuegos. puede definir una lista que contenga todo aquello que sea crítico para los servicios web: cortafuegos. En intervalos de 30 segundos. Si la solicitud ping supera el tiempo de espera.tivoli.Para excluir una red: 1. dispositivos. pulse Aceptar. 3. Un ejemplo sería definir una situación que busque un valor de atributo ″Off-line″ en cualquier dispositivo de la lista. Si el dispositivo no responde a SNMP Get. Desde la lista de nodos gestionados puede ver espacios de trabajo. del mismo modo que para cualquier otro sistema gestionado. escriba Sí para excluir la red seleccionada o No para restablecer una red una red anteriormente excluida. Si el dispositivo responde a SNMP Get. 5. y se consulta el siguiente dispositivo de la lista. podrá observar que este sistema gestionado pasa a estar fuera de línea en el árbol de Navigator de Tivoli Enterprise Portal. 4. Puede definir otra lista que contenga todos los direccionadores esenciales para mantener una determinada oficina operativa. Esto puede fácilmente provocar problemas de gestión y utilización. En el campo Sí/No. Creación de una lista de nodos gestionados: Una lista de nodos gestionados es un archivo de texto que contiene una definición LISTNAME (opcional) y una lista de dispositivos y nombres de host: LISTNAME=TivoliWeb www. Una manera de afrontar dichos problemas es compartimentalizar la gestión piezas mas pequeñas y bien entendidas. Acerca de los proveedores de datos 91 . el atributo Node_Status se establece en fuera de línea. Pulse con el botón derecho del ratón sobre el elemento de Navigator o una fila en la vista de tabla. Por ejemplo. De lo contrario se establece en On-line (en línea). Hay un subproceso de supervisión separado para cada lista de nodos gestionados activa. Si la red se está gestionando de manera activa en el momento de hacer esta solicitud.

se utilizará la última especificación como nombre de lista de nodos gestionados. la aplicación de Tivoli Universal Agent SNMP-MANAGER permite gestionar los recursos de red mediante ciertos criterios. Por ejemplo. la definición del nombre de lista deberá tener el siguiente formato: LISTNAME=nombrelista La especificación del nombre de lista no tiene que ser el primer registro de la definición de la lista de nodos gestionados. como una función comercial determinada y sus recursos correspondientes. Tivoli Universal Agent realiza un seguimiento de las listas de nodos gestionados colocando sus nombres de archivos en un archivo llamado KUMSLIST. No obstante. como en el ejemplo anterior de mercury[4500]. que se encuentra en el directorio de trabajo. especifique el puerto de aplicación rodeado de corchetes. cree un archivo que tenga el mismo nombre de lista pero que no contenga nombres de dispositivos y cargue dicho archivo con el mandato LOADLIST. actívela utilizando el mandato LOADLIST.El nombre de lista definido pasa a formar parte del nombre de sistema gestionado de la lista de nodos. No obstante. 92 IBM Tivoli Universal Agent: Guía del usuario . Activación de una lista de nodos gestionados: Se activa una lista de nodos gestionados utilizando el mandato de consola LOADLIST: kumpcon loadlist nombrearchivo_lista_nodos_gestionados o con el mandato Actuación → Control LoadList. Modificación de una lista de nodos gestionados: Para modificar una lista de nodos gestionados. un sistema de aplicación financiera. Para supervisar sólo una aplicación en particular ejecutándose en un nodo de red. Es posible especificar uno o más dispositivos de red en cada registro. Por ejemplo. si se define el nombre de lista más de una vez en la definición. El proveedor de datos de SNMP comprueba KUMSLIST sólo durante el arranque. a continuación. Durante el arranque. Puede haber tantas listas de nodos gestionados definidas como sean necesarias para gestionar la red de forma eficiente. una lista de nodo gestionado podría contener las identidades de todos los recursos de red que pertenecen a un departamento. Ubicación del archivo de lista de nodos gestionados: Debe almacenar el archivo de lista de nodos gestionados en el directorio de trabajo de Tivoli Universal Agent. Si es así. Si aparece el nombre de lista. Nombres de dispositivos y de host: No hay límite en el número de dispositivos de red y de hosts que pueden incluirse en la lista de nodos gestionados. una ubicación geográfica o un grupo de servidores de red que soporten las operaciones comerciales. Tivoli Universal Agent lee KUMSLIST y activa todas las listas en el mismo. edítela y. se trunca por la derecha. el nombre de lista del ejemplo anterior es TivoliWeb:SNMP-MANAGER00. Un nombre de sistema gestionado no puede ser mayor de 32 caracteres por lo que si el nombre de la lista es mayor de 17 caracteres. Pueden surgir dificultades a la hora de obtener un estatus en cada dispositivo en el intervalo de supervisión de 30 segundos. El mandato comprueba si ya está activa una lista con el mismo nombre. se utilizará el nombre del archivo de lista de nodos gestionados. se contradice la idea de tener una lista de dispositivos críticos de destino y aumentará la carga de trabajo general. si se incluyen demasiadas entradas. Desactivación de una lista de nodos gestionados: Es posible desactivar una lista de nodos gestionados editando el archivo KUMSLIST. Si no se define ningún nombre de lista. Agrupamiento automático de recursos mediante criterios: Para facilitar la creación y mantenimiento de las listas de recursos de red. se desactiva la lista en ejecución y se activa la nueva lista. por lo que sólo es necesario activar cada lista una vez. Para desactivar una lista de nodos gestionados dinámicamente.

2) Siempre que una aplicación SNMP-MANAGER descubre un nuevo dispositivo de red. TYPE tipo – Busca recursos de red del tipo definido. DESC cadena. Los tipos válidos son: A – Aplicaciones B – Puentes G – Pasarelas H – Hosts R – Direccionadores EOID cadena-oid – Seleccione el recurso de red del OID empresarial definido en la respuesta de atributo sysObjectID MIB-2 del agente SNMP. puentes y pasarelas de red descubiertas. Sólo puede utilizar un filtro de recursos por nada archivo de lista de nodos gestionados. Los siguientes cuatro ejemplos ilustran la utilización del filtrado de lista de nodos gestionados. *cadena Cadena* *cadena* Coincide con los nombres que terminen con la cadena de caracteres. Acerca de los proveedores de datos 93 . Explora aquellos nombres que contengan la cadena de caracteres. comprueba todos los filtros activos de la lista de nodos gestionados. Coincide con los nombres que comiencen con la cadena de caracteres.1. v La lista de nodos gestionados de NetWare incluye todos los dispositivos en los que la respuesta del atributo sysDescr contiene Novell. Un dispositivo que satisfaga un filtro se añade automáticamente a la lista de nodos gestionados correspondiente. Ya que SNMP-MANAGER examina todos los filtros. Cuando se utiliza el filtro. LISTNAME=NetCorporate FILTER=(TYPE RBG) v La lista de nodos gestionados CISCO contiene todos los direccionadores y conmutadores CISCO.3. LISTNAME=NewYorkOffice FILTER=(NAME NY*l) v La lista de nodos gestionados NetCorporate contiene todos los direccionadores.9. Capítulo 4.En el archivo de lista de nodos gestionados. puede definir un filtro de recursos.Explora sysDescr MIB-2 del agente SNMP.4. Tivoli Universal Agent automáticamente incluye los recursos de red descubiertos en la lista de nodos gestionados. LISTNAME=CISCO FILTER=(EOID 1. podría añadirse un dispositivo descubierto a varias listas de nodos gestionados.1. en lugar de entrar una lista con elementos de recursos de red. Los siguientes filtros son válidos: NAME [*]cadena[*] – Filtra los nombres de recursos de red que coincidan o incluyan la cadena de caracteres definida. LISTNAME=NetWare FILTER=(DESC Novell) v La lista de nodos gestionados NewYorkOffice incluye todos los nodos de red con un nombre de host que comience por NY.6.

No obstante. pero cada fila procedente de un host de agente de SNMP distinto. es posible que reciba varias filas de los mismos datos de atributos.Los recursos de red descubiertos y el contenido de la lista de nodos gestionados perduran entre los reinicios del proveedor de datos de SNMP de Tivoli Universal Agent. v Cambio en el estatus de los nodos de red. establezca la variable KUM_UMC en No: KUM_UMC=No Creación de situaciones con atributos de aplicaciones SNMP Puede crear situaciones utilizando cualquier atributo que vea en un espacio de trabajo. Se reenviarán todas las condiciones con la gravedad especificada o superior. Una gravedad 2 es un aviso. En la situación puede incluir acciones que desee iniciar en el host donde se encuentre el proveedor de datos de SNMP y puede incorporar también políticas. Agent_Name es útil en aquellos casos en los que se haya iniciado una recopilación de datos en particular para varios hosts. o desactivar los informes. La solicitud de Actuación MNL Remove Node elimina un recurso de red de la lista. si inicia la recopilación de datos MIB y especifica una dirección de red para recopilar todos los hosts en una red. Especificación de qué condiciones de excepción enviar: Utilice la variable KUMP_SNMP_TRAP_CONSOLE_SEV para especificar qué condiciones de excepción se reenvían a la UMC. pero desee que la situación sea evaluada en un host determinado. Atributo de propósito especial.Agent_Name *EQ athens 94 IBM Tivoli Universal Agent: Guía del usuario . La gravedad predeterminada es 2: KUMP_SNMP_TRAP_CONSOLE_SEV=2 Inhabilitación de los informes de la UMC: Para desactivar los informes de la UMC completamente. El estatus pasa de on-line a off-line. pero desea que la situación sólo evalúe los datos del host athens. v Cambios en el estatus de cualquier host o dispositivo en una lista de nodos gestionados. Utilización de la Consola de mensajes universales (consola de favoritos) De forma predeterminada. la red conectada localmente y cualquier red para la que se haya emitido una solicitud de Actuación Manage Start. a continuación. Puede cambiar qué condiciones de excepción se reenvían. Puede manipular de forma manual el contenido de la lista de nodos gestionados con solicitudes de Actuación. puede volver a añadir un recurso de red eliminado utilizando una solicitud de Actuación MNL Add Node. llamado Agent_Name. El atributo Agent_Name se utiliza para identificar el nombre de host que origina una fila de datos determinada. Como es posible especificar más de un host desde el que recopilar los datos MIB. Agent_Name: Cada grupo de atributos MIB tiene un atributo KEY de propósito especial. La solicitud de Actuación MNL Add Node añade un recurso de red a la lista de nodos gestionados. Puede utilizar el filtro de lista de nodos gestionados durante un corto periodo de tiempo para crear la lista de nombres de dispositivos de red coincidentes y. Durante el proceso de descubrimiento no se añadirá de nuevo a la lista un recurso de red eliminado. y de off-line a on-line. Tivoli Universal Agent envía la siguiente información a la consola de mensajes universales (UMC): v Condiciones de excepción de SNMP con una gravedad de 2 o superior. Por ejemplo. incluya el siguiente texto en el predicado de situación: *SCAN MIB-2IFTABLE. es decir. El gestor de SNMP realiza un seguimiento de los dispositivos eliminados. Nota: Esto sólo es válido para aquellas redes que se estén gestionando. eliminar o comentar la definición de filtro y utilizar la lista de nodos gestionados “como tal”.

MIB-2IFTABLE00. o bien el número de paquetes de entrada que se han elegido para su eliminación. Utilice una lista de sistemas gestionados sólo si está ejecutando más de un proveedor de datos de SNMP y desea distribuir una situación a todos ellos. Situaciones proporcionadas por el producto Nombre de la situación MB2_interfaceDown Descripción de la situación. Acerca de los proveedores de datos 95 . para cada aplicación que se importe en el proveedor de datos de SNMP. utilice nombres de sistemas gestionados específicos siempre que sea posible. Agent_Name es también un atributo ATOMIC. que le permite ver qué host de agente en particular ha provocado que se active la situación. Situaciones SNMP predefinidas: El proveedor de datos de SNMP ofrece un conjunto de situaciones predefinidas que responden a la mayoría de las condiciones de excepción comunes de redes.Además de ser un atributo KEY. es de 100 o más. descripciones. Distribución de situaciones: Es posible distribuir situaciones a un sistema gestionado por un proveedor de datos de SNMP o a una lista de sistemas gestionados de SNMP. lógica y valores de comparación de las situaciones proporcionadas por el producto. El intervalo de situación debe ser menor de 1 hora o nunca se cumplirá. lo cual les impide que sean entregables a un protocolo superior. Por ejemplo. ha sido de 20 o más. “Definiciones de atributos”. El intervalo de muestreo especifica con qué frecuencia debe el proveedor de datos de SNMP sondear los agentes SNMP en busca de datos MIB. Por razones de rendimiento. No tiene relación directa con el intervalo de muestreo que se especifica cuando se utiliza Actuación → Monitor Start. La Tabla 20 en la página 95 proporciona los nombres. Esto quiere decir que los datos MIB permanecen disponibles para la evaluación de espacios de trabajo y situaciones durante una hora a partir de la hora en que fueron recibidos de los agentes SNMP. lógica y valores Una interfaz de red está inactiva MIB-2IFTABLE00. incluso sin detectarse errores. Todos los grupos de atributos de aplicaciones SNMP tienen un tiempo de vida (TTL) De 3600 segundos (1 hora).ifInErrors *GE 20 OR MIB-2IFTABLE00. Consulte el Apéndice B. en la página 169 para obtener una descripción del atributo KEY. Puede utilizar dichas situaciones para comenzar la supervisión de forma casi inmediata o como plantillas para crear sus propias situaciones. Especificación de intervalos de supervisión para situaciones: El intervalo de supervisión de situaciones especifica con qué frecuencia el servidor de Tivoli Enterprise Monitoring evalúa los datos de la situación.ifOutErrors *GE 20 OR MIB-2IFTABLE00.ifInDiscards *GE 100 MB2_interfaceOutError El número de paquetes de salida que no ha podido transmitirse debido a errores es de 20 o más o bien el número de paquetes de salida seleccionados para ser descartados es de 100 o más MIB-2IFTABLE00. Puede definir Agent_Name como un Elemento de visualización en el Editor de situaciones.ifOutDiscards *GE 100 Capítulo 4.ifOperStatus *EQ 2 MB2_interfaceInError El número de paquetes de entrada que contenían errores. Los datos muestreados de los agentes se ponen en cola para su posterior evaluación por parte de las situaciones y serán los datos que vea en los espacios de trabajo de las aplicaciones MIB. donde aaa es el nombre de la aplicación y vv es el número de versión de la aplicación. se obtiene una lista de sistemas gestionados llamada *CUSTOM_aaavv. Tabla 20.

es de 20 o más. MIB-2IP00.ipOutDiscards *GE 20 OR MIB-2IP00.tcpInErrs *GE 10 MB2_udpError El número de datagramas UDP recibidos que no se han podido distribuir por motivos que no son la falta de una aplicación en el puerto de destino es de 10 o más.udpInErrors *GE 10 MB2_egpError El número de mensajes EGP recibidos que se ha comprobado que son erróneos es de 10 o más.egpOutErrors *GE 10 MB2_egpNeighError El número de mensajes de EGP recibidos desde este similar EGP que se ha probado que es erróneo es de 10 o más o bien el número de mensajes de EGP generados localmente no enviados a este similar EGP debido a limitaciones de recursos dentro de una entidad EGP es de 10 o más MIB-2EGP00. o el número de datagramas IP descartados porque no se ha podido encontrar ninguna ruta para transmitirlos a su destino es de 20 o más. Situaciones proporcionadas por el producto (continuación) Nombre de la situación MB2_ipInError Descripción de la situación.ipInDiscards *GE 20 MB2_ipOutError El número de datagramas IP de salida para los que no se ha encontrado ningún problema que impidiera transmitirlos a su destino. MIB-2IP00.icmpOutErrors *GE 20 MB2_tcpError El número total de segmentos recibidos con errores es de 10 o más MIB-2TCPCONNTABLE00. o cuando el número de mensajes EGP generados localmente que no se han enviado debido a limitaciones de recursos en una entidad EGP es de 10 o más. pero que se han descartado. pero se han descartado es de 20 o más.egpNeighOutErrs *GE 10 96 IBM Tivoli Universal Agent: Guía del usuario . v El número de datagramas IP de entrada para los que no se han encontrado problemas que impidieran que continuara el proceso. v El número de datagramas dirigidos localmente que se han recibido satisfactoriamente pero que se han descartado debido a un protocolo desconocido o no soportado es de 20 o más. MIB-2UDP00.ipInUnknownProtos *GE 20 OR MIB-2IP00.Tabla 20.ipFragFails *GE 10 MB2_icmpError El número de mensajes ICMP que la entidad ha recibido pero ha determinado que tengan errores específicos de ICMP es de 20 o más o bien el número de mensajes ICMP que dicha entidad no ha enviado debido a problemas descubiertos dentro de ICMP (como la falta de almacenamientos intermedios) es de 20 o más MIB-2ICMP00. MIB-2EGP00. lógica y valores Esta situación supervisa tres tipos de errores de datagramas IP de entrada: v El número de datagramas de entrada descartados debido a errores en sus cabeceras de IP es de 5 o más.icmpInErrors *GE 20 OR MIB-2ICMP00.ipInHdrErrors *GE 5 OR MIB-2IP00.egpNeighInErrs *GE 10 OR MIB-2EGP00.ipOutNoRoutes *GE 20 MB2_ipFragmentationError El número de datagramas IP que se han eliminado porque se tenían que fragmentar en esta entidad pero no se ha podido es de 10 o más.egpInErrors *GE 10 OR MIB-2EGP00. MIB-2IP00.

lógica y valores El número total de Mensajes SNMP entregados a la entidad del protocolo SNMP que han utilizado un nombre de comunidad SNMP desconocido para dicha entidad ha superado los 10 o el número total de mensajes de SNMP entregados a la entidad del protocolo SNMP que representaba una operación SNMP que no estaba permitida por la comunidad SNMP nombrada en el mensaje ha superado los 10 MIB-2SNMP00.Severity *EQ Critical OR *SCAN SNMP-MANAGERTRAP00. el metarchivo de SNMP que define la variable MIB debe estar activado.Tabla 20. Situaciones proporcionadas por el producto (continuación) Nombre de la situación MB2_snmpOperationViolations Descripción de la situación.Router_Status *EQ Off-line Se ha recibido una condición de excepción de SNMP con la categoría “error” *SCAN SNMP-MANAGERTRAP00. La sentencia de lectura-escritura ACCESS de la variable MIB ipForwarding en la siguiente figura es un ejemplo de una definición MIB de una variable que permite acceso de escritura.Category *EQ ‘Error Events’ TRAP_severity_errors Se ha recibido una condición de excepción de SNMP con la gravedad “error:” *SCAN SNMP-MANAGERTRAP00. la definición MIB de la variable debe tener permiso de escritura y el agente de SNMP debe estar programado para gestionar operaciones SET en dicha variable. Requisitos: Una operación SET requiere de la siguiente información: v El nombre de host del agente de SNMP de destino v El nombre de comunidad de lectura-escritura que acepta el agente de SNMP v El nombre de la variable MIB que desea cambiar v El nuevo valor Para que la operación SET sea satisfactoria. Tivoli Universal Agent permite realizar operaciones SET utilizando la opción Actuación.Category *EQ ‘Major Error’ HOTLIST_offline Un elemento de lista de nodos gestionados muestra el estado “fuera de línea” *SCAN SNMP-MANAGERMANAGED-NODES00.Node_Status *EQ Off-line TRAP_category_errors Operaciones SNMP SET Una operación SET de SNMP es una manera de cambiar el valor de una variable MIB. Acerca de los proveedores de datos 97 .snmpInBadCommunityUses *GE 10 NETWORK_not_responding Una red no ha respondido durante una cantidad razonable de tiempo *VALUE SNMP-MANAGERNETSUMMARY00. Capítulo 4.snmpInBadCommunityNames *GE 10 OR MIB-2SNMP00.Max_Resptime_ms *GT 500 Un direccionador está fuera de línea ROUTER_status_offline *SCAN SNMP-MANAGERROUTER00.

98 IBM Tivoli Universal Agent: Guía del usuario . 7. 3. Tenga en cuenta que para algunos nodos gestionados. Aparecerá la ventana Editar valores de argumentos. Los hosts IP no (excepto aquellos indicados como destino mediante el host)." ::= {ip 1} Figura 11. Seleccione SNMP SET de la lista Nombre. Seleccione el elemento de Navigator asociado con la aplicación o sistema en el que desea iniciar el mandato.actuando como pasarela not-forwarding (2) -. El valor de AttributeName es sensible a mayúsculas y minúsculas y debe especificarse tal y como aparece en el metarchivo. Seleccione Actuación en el menú desplegable. SetToValue El nuevo valor del atributo. En el archivo de informes puede ver el nombre exacto utilizando por Tivoli Universal Agent para el atributo. es apropiado que un agente devuelva una respuesta 'badValue' si una estación de gestión intenta cambiar este objeto a un valor inapropiado.ipForwarding OBJECT-TYPE SYNTAX INTEGER { forwarding (1). Consejo: Para determinar la ortografía exacta y las mayúsculas o minúsculas del atributo. Las pasarelas IP reenvían datagramas. Comunidad El nombre de comunidad que el agente acepta para las operaciones de escritura. Pulse con el botón derecho del ratón sobre el elemento de Navigator o una fila en la vista de tabla. Por lo tanto. esta entidad.NO actuando como pasarela } ACCESS read-write STATUS mandatory DESCRIPTION "La indicación de si esta entidad está actuando como una pasarela IP con respecto al reenvío de datagramas recibidos por. AttributeName El nombre del atributo que desea modificar. Seleccione el sistema gestionado correspondiente a la aplicación MIB en la que aparece la variable. 4. indique el puerto de destino entre corchetes inmediatamente después del nombre de host o de la dirección decimal separada por puntos. Especificación de acceso de escritura en la definición de variable MIB-2 Realizar una operación SET: 1. Pulse Aceptar para regresar a la ventana Actuación. ejecute el mandato de consola KUMPCON VALIDATE en el metarchivo cifrado para crear un archivo de informe de salida. pero no dirigidos a. Nota: Recuerde que siempre puede comprobar el espacio de trabajo UAGENT ACTION para obtener información detallada acerca de cualquier mandato de Actuación que emita. el puerto predeterminado. -. Rellene los campos como se muestra a continuación: TargetAgentAddr El nombre o dirección del host del agente de SNMP cuya variable desea modificar. 2. 6. 5. Este nombres es generalmente distinto del nombre de comunidad utilizado para las operaciones de lectura. este objeto sólo puede tomar un subconjunto de los posibles valores. Si desea utilizar como destino un agente con un puerto distinto del 161.

8. Pulse en Aceptar. Acerca de los proveedores de datos 99 . Capítulo 4.

100 IBM Tivoli Universal Agent: Guía del usuario . Como la mayoría de los sistemas operativos dan soporte a una pila TCP. no hay necesidad de instalar un paquete del cliente u otro software de Tivoli en el sistema de destino. el proveedor de datos de socket amplía la gama de plataformas soportadas en las que Tivoli Universal Agent puede utilizarse.Proveedor de datos de socket En los sistemas operativos en los que Tivoli Universal Agent no se puede instalar. La Figura 12 muestra el rol del proveedor de datos de socket. el proveedor de datos de socket permite que los datos se sigan recopilando y procesando en Tivoli Universal Agent implementando la comunicación programa a programa utilizando el paradigma de transporte de sockets. Y a diferencia del proveedor de datos de servidor de API.

v Abre un socket UDP y envía datos a la dirección del host del proveedor de datos de socket. también denominado como un programa cliente de socket. Capítulo 4. se pone en contacto con el proveedor de datos de socket de dos maneras: v Abre un socket TCP y lo conecta al host del proveedor de datos de socket.Figura 12. Acerca de los proveedores de datos 101 . Rol del proveedor de datos de socket Establecimiento de contacto con el proveedor de datos de socket Un programa remitente.

NombreAplic El nombre de valor especificado en la aplicación de metarchivo.Nota: La mayoría de los lenguajes de script. Generalmente. no sólo en un lenguaje de alto nivel como C++ o Java. Si prefiere que el tráfico del proveedor de datos utilice otra interfaz. UDP o ambos. poder implementar el programa de envío en una amplia variedad de maneras. Función SETSOURCENAME También puede personalizar la parte NombreHost del nombre de sistema gestionado enviando un registro //SETSOURCENAME. ofrecen API de sockets para la recopilación y envío de datos para. Consulte “Sentencia SOURCE” en la página 140 para obtener más información. establezca la variable de entorno KUMP_DP_PORT en el puerto de escucha correcto. puede establecer la variable de entorno KUM_DP_HOSTNAME o KUM_DCH_HOSTNAME al nombre de host preferido. El sistema en el que se encuentra el proveedor de datos de socket debe estar correctamente configurado para utilizar el servicio de nombres de red para resolver nombres de hosts y para convertir direcciones de red TCP/IP. Puede personalizar la parte NombreHost del nombre de sistema gestionado con el parámetro NombreSistemaGestionado en la sentencia //SOURCE del metarchivo. Conversión de nombres de host y de direcciones TCP/IP La conversión de nombres de host y de direcciones TCP/IP es vital para el funcionamiento del proveedor de datos de socket. Modificación del puerto de escucha predeterminado De forma predeterminada. VV El sufijo de dos dígitos de la versión. como REXX y Perl. Si el puerto de socket 7500 no está disponible o si desea que el proveedor de datos utilice otro puerto. Nota: El sistema gestionado de una aplicación de metarchivo de socket no pasa a estar en línea en el Navigator de Tivoli Enterprise Portal hasta que el programa cliente de socket se haya conectado al proveedor de datos de socket. Puede utilizar esta función si una aplicación de socket recopila datos de una serie 102 IBM Tivoli Universal Agent: Guía del usuario . Este host es diferente de host donde se está ejecutando Tivoli Universal Agent si el cliente de socket está conectándose desde un sistema remoto. Consulte “Sentencia SOURCE” en la página 140 para obtener más información. un sistema resuelve su propio nombre de host en la primera interfaz de red instalada. el proveedor de datos de socket escucha en el puerto 7500. Nombres de sistemas gestionados de aplicaciones del proveedor de datos de socket El nombre del sistema gestionado de una aplicación de metarchivo de socket tiene el siguiente formato: NombreHost:NombreAplicVV donde: NombreHost El host donde el programa cliente de socket se está ejecutando. se ignorará la sentencia SOURCE. de esta manera. Puede comprobar el espacio de trabajo UAGENT DPLOG del proveedor de datos de socket después de que el proveedor haya comenzado a verificar que el estatus del mensaje identifica claramente el número de puerto de escucha correspondiente para TCP. Varias máquinas host La ejecución de un proveedor de datos de socket en un sistema con más de una interfaz de red. requiere una consideración especial. Si el nombre de host especificado en la sentencia SOURCE de un metarchivo de definición de datos no puede resolverse.

2. Acerca de los proveedores de datos 103 . Envíe un registro //SETSOURCENAME=xxxxxx al proveedor de datos de socket después de que se conecte el programa cliente. Los programas cliente de socket son las fuentes de datos de las aplicaciones de socket y debe asociar el programa cliente correcto con el metarchivo correcto o los datos de entrada no se procesarán correctamente. La primera sentencia de nombre de host //SOURCE SOCK que coincida se considerará como el metarchivo correcto para asociar con el programa cliente. Los siguientes dos pasos son necesarios para habilitar la característica SETSOURCENAME: 1. el siguiente sistema gestionado pasa a estar en línea: APPSERVER1:THREADMONITOR00 Asociación de fuentes de datos con metarchivos Es importante entender cómo se asocia un programa cliente de socket con un metarchivo en particular. Puede especificar una o más sentencias SOURCE para cada grupo de atributos (sentencia //NAME) en un metarchivo de socket. Generalmente se proporcionan varias sentencias SOURCE si hay varios sistemas host que pudiesen potencialmente conectarse y enviar datos para una aplicación de metarchivo determinada. el proveedor de datos explora los valores de nombre de host de todas las sentencias //SOURCE SOCK del metarchivo que estén activados. Añada un parámetro SETSOURCENAME=y en la sentencia de metarchivo //SOURCE SOCK. el proveedor de datos de socket sólo conoce la dirección IP y el número de puerto del programa cliente. Consulte “Sentencia SOURCE” en la página 140 para obtener información adicional acerca de la sentencia //SOURCE. En dicho caso. existe una ambigüedad potencial para determinar a qué metarchivo asociar los datos de entrada. el sistema gestionado de una aplicación de socket no pasa a estar en línea en el Navigator de Tivoli Enterprise Portal hasta que el programa cliente de socket se hayan conectado al proveedor de datos de socket y se haya producido la asociación con el metarchivo. si envía un registro //SETSOURCENAME=AppServer1 al proveedor de datos de socket para la aplicación de metarchivo ThreadMonitor. el proveedor de datos de socket confía en uno de los siguientes métodos para asociar el programa cliente con su metarchivo: v Sentencia SOURCE del metarchivo v Especificación explícita del metarchivo Asociación mediante la sentencia SOURCE del metarchivo La manera más simple y directa de asociar un programa de cliente socket con su metarchivo es mediante la sentencia //SOURCE SOCK nombrehost. Si sólo se ha activado un metarchivo de socket. Este parámetro indica al PD de socket que puede esperar un registro //SETSOURCENAME durante el inicio de la conexión. Por ejemplo: //SOURCE SOCK HostA //SOURCE SOCK HostB //SOURCE SOCK HostC Nota: No puede listar varios nombres de host en la misma sentencia //SOURCE SOCK. haga una sentencia //SOURCE SOCK independiente para cada host. Capítulo 4. el proveedor de datos de socket sabrá claramente qué metarchivo utilizar. Cuando un programa cliente se conecta y el proveedor de datos de socket ha determinado la dirección IP y el número de puerto del programa que se conecta.de servidores de aplicación y tiene más sentido si el nombre del servidor de aplicación formase parte del nombre del sistema gestionado y no del nombre de host en el que se está ejecutando el programa cliente. Además. El parámetro de nombre de host de la sentencia //SOURCE SOCK indica el origen del programa remitente en formato de una dirección decimal separada por puntos o de nombre de host para resolver. En el momento de la conexión. Cuando un cliente de socket se conecta por primera vez al proveedor de datos de socket. Pero si hay varios metarchivos de socket. El valor xxxxxx se utiliza cuando se registra el sistema gestionado. Por ejemplo.

De forma predeterminada.' . //SOURCE SOCK HostA[7500] porque esto significa que el programa cliente de socket se está vinculando en el puerto 7500 en su propio sistema local. los números de puertos ayudan a asociar los datos de entrada con determinadas aplicaciones. Si el programa cliente de socket utiliza algún puerto en el sistema local y se conecta al proveedor de datos de socket en el puerto 7500 de un sistema remoto. lo cual no es lo que desea. especifique //SOURCE SOCK HostA en el metarchivo y conecte el programa cliente al proveedor de datos de socket en el puerto 7500. Metarchivos de socket con un grupo de atributos El parámetro de número de puerto sólo es necesario para resolver la ambigüedad si el proveedor de datos de socket está gestionando varios programas cliente de socket y varias aplicaciones del mismo host. . no hay necesidad de especificar números de puertos ya que no existe ambigüedad alguna. No obstante.147 se permite que un programa vinculado a cualquier puerto en el host 198. por ejemplo.37. . los datos procedentes de cualquier puerto en dicho host serán aceptados. En este caso. el proveedor de datos de socket escucha las conexiones cliente en el puerto 7500. .210. este intento de conexión falla porque el proveedor de datos de socket sólo acepta una conexión cliente de socket del puerto 7500 en HostA. cuando el proveedor de datos de socket conoce varias aplicaciones de metarchivo de socket y es posible la entrada de datos desde varios programas clientes desde el mismo host. Por ejemplo. Por consiguiente.147 se conecte y envíe datos al proveedor de datos de socket. En este ejemplo. //APPL NCANET //NAME ALERT E 300 //SOURCE SOCK ENG1[3301] //SOURCE SOCK ENG2[3301] //SOURCE SOCK ENG3[3301] //SOURCE SOCK TEST1[3301] 104 IBM Tivoli Universal Agent: Guía del usuario . Si el nombre de host especificado no puede resolverse en una dirección IP. como se ilustra en el ejemplo a continuación: //APPL NCASYS //NAME Process P 300 //SOURCE SOCK ENG1[4500] //SOURCE SOCK ENG2[4500] //SOURCE SOCK MIS2[4500] //ATTRIBUTES '@' . . no especifique. Nota: El parámetro [número de puerto] en la sentencia //SOURCE SOCK no debe confundirse con el número del puerto de escucha que el proveedor de datos de socket utiliza. El NCARPT de aplicación sólo tiene un grupo de atributos y es la única aplicación activa que proporciona datos al proveedor de datos de socket en el siguiente ejemplo: //APPL NCARPT //NAME Overview P 900 //SOURCE SOCK JOHN //SOURCE SOCK BOB //ATTRIBUTES '. No puede haber ningún espacio en blanco entre los parámetros de nombre de host y [número de puerto]. Especificando sólo la dirección 198.210. HostA. Un programa cliente de socket del host JOHN o BOB puede conectarse y enviar datos.37. Si se omite el número de puerto. se ignorará la sentencia SOURCE. También puede especificar //SOURCE SOCK localhost como una manera de indicar que el programa cliente de socket se está ejecutando en el mismo sistema host que el proveedor de datos de socket.seguido opcionalmente por un número de puerto. FIN1[4500] identifica datos procedentes del host FIN1 en el puerto 4500.

son aceptados desde cualquier puerto en el host JOHN o BOB como se muestra en el ejemplo anterior. . Del mismo modo. por ejemplo. Si este ejemplo no utilizase especificaciones de número de puerto y un programa cliente vinculado a cualquier puerto en ENG2. Metarchivos de socket con varios grupos de atributos Si un metarchivo de socket tiene varios grupos de atributos y uno o más programas clientes de socket del mismo host proporcionan datos para dichos grupos de atributos. El proveedor de datos de socket necesita una manera de saber a qué grupo de atributos pertenece cada registro de datos. . . . .. los datos de entrada del grupo de atributos. Del mismo modo. se conectase al proveedor de datos de socket.//SOURCE SOCK TEST2[3301] //SOURCE SOCK TEST3[3301] //ATTRIBUTES ' ' . . Un programa cliente de socket vinculado a un puerto 4500 en su sistema host local (ENG1. un programa cliente vinculado al puerto 3301 se asocia con la aplicación NCANET. Capítulo 4. Overview. respectivamente. Acerca de los proveedores de datos 105 . La alternativa es utilizar un prefijo auto-identificativo en cada registro de datos enviado al proveedor de datos de socket. Prefijado de registros de datos La desventaja de asociar grupos de atributos con números específicos de puertos es que no es muy flexible y generalmente requiere planificación y atención.. //NAME RedEvent E 3600 //SOURCE SOCK JOHN[1001] //SOURCE SOCK BOB[2001] //ATTRIBUTES ' ' . En este ejemplo. se seleccionaría la aplicación de metarchivo equivocada para los datos de entrada. Hay dos maneras de resolver la ambigüedad: Parámetro de número de puerto Ampliando el ejemplo anterior. //NAME RunStat S 120 //SOURCE SOCK JOHN[1002] //SOURCE SOCK BOB[2002] //ATTRIBUTES ' ' . sólo pueden ser recibidos desde un programa cliente que se conecte vinculado al puerto 1001 desde el JOHN o al puerto 2001 desde el host BOB. El formato del prefijo es el siguiente: <NombreAplic=xxxx><GrupoAtrib=yyyy>el resto de los datos. es posible que surja otro tipo de ambigüedad. si la aplicación NCARPT incluye más de un grupo de atributo. Los datos de entrada el grupo de atributos RedEvent. . ENG2 o MIS2) que se conecta al proveedor de datos de socket se asocia automáticamente con la aplicación NCASYS. los datos de entrada del grupo de atributos RunStat pueden ser recibidos desde programas vinculados al puerto 1002 y 2002 en los hosts JOHN y BOB. las especificaciones de número de puerto pueden aclarar a qué grupo de atributos pertenece cada registro: //APPL NCARPT //NAME Overview S 900 //SOURCE SOCK JOHN //SOURCE SOCK BOB //ATTRIBUTES ' ' . no obstante. .

Si el proveedor de datos de socket encuentra una coincidencia en el nombre de aplicación. a continuación se suministra un metarchivo de proveedor de datos de socket con tres grupos de atributos: //APPL SockEvent @Socket Provider application //NAME Events1 E 300 AddSourceName //SOURCE SOCK HOSTB //ATTRIBUTES ’ ’ Date D 8 Time D 8 LogFile D 20 DLM=’(’ Code D 20 DLM=’)’ Severity D 30 DLM=’:’ Message Z 512 //NAME Events2 E 300 AddSourceName //SOURCE SOCK HOSTB //ATTRIBUTES ’ ’ Date D 8 Time D 8 LogFile D 20 DLM=’(’ Code D 20 DLM=’)’ Severity D 30 DLM=’:’ Message Z 512 //NAME Events3 E 300 AddSourceName //SOURCE SOCK HOSTB //ATTRIBUTES ’ ’ Date D 8 Time D 8 LogFile D 20 DLM=’(’ Code D 20 DLM=’)’ Severity D 30 DLM=’:’ Message Z 512 Las sentencias //SOURCE SOCK no tienen especificaciones [port#]. lo que significa que el programa cliente de socket debe asignar como prefijo a cada registro de datos el nombre de aplicación y el nombre de grupo de atributos. Como ejemplo de utilización de esta función. Si encuentra una coincidencia. Si el proveedor de datos de SNMP recibe una fila que comienza con este encabezado. A continuación. el nombre de grupo de atributos y el nombre de host de conexión. que envía datos a cada uno de los tres grupos de atributos: #!/usr/bin/perl -w # SockEvent. todos los datos entrantes se asocian con el primer grupo de atributos en el metarchivo. implementado en un script Perl.donde: xxxx yyyy El valor del nombre especificado en la sentencia //APPL del metarchivo. Nota: Es muy importante cuando se utiliza la función de prefijado del registro de datos que haya una sentencia //SOURCE SOCK &nombre de host para el host del programa cliente de socket remitente. el proveedor de datos de socket asocia la fila de datos recibidos con dicho grupo de atributos. busca una aplicación correspondiente y un grupo de atributos en su lista almacenada de aplicaciones en línea. De lo contrario. Por lo tanto. el proveedor de datos de socket busca una sentencia //SOURCE SOCK bajo dicho grupo de atributos con un nombre de host que coincida con el nombre de host del programa cliente de socket. se muestra un programa cliente de socket. utilícela para todas las filas de datos que envíe el programa cliente de socket. no es necesario especificar un parámetro [puerto#] en la sentencia //SOURCE SOCK.pl # a simple UA client using IO:Socket 106 IBM Tivoli Universal Agent: Guía del usuario . Si decide utilizar esta característica de prefijación de registro de datos. El valor del nombre especificado en la sentencia //NAME del metarchivo.

$sock or die "no socket :$!". PartList. seguidas por el nombre del metarchivo. # Initialize socket connection to UA #---------------my $host = ’myuahost’. "//SockEvent\n". El proveedor de datos detecta automáticamente la necesidad de conversión de código incluso aunque no se conozca aún el metarchivo o la sentencia SOURCE. Asociación mediante una especificación explícita También puede asociar los programas clientes de socket y los metarchivos mediante el uso de los registros de asociación explícitos de metarchivo. indica que debería utilizarse el metarchivo JOBCNTL. un programa desde el host MVSA se pone en contacto con el proveedor de datos de socket en el sistema FIN1. Por ejemplo: //miAplic Este ejemplo indica que existe un archivo llamado miAplic. el proveedor de datos puede asociar rápidamente el programa con el grupo de atributos PartList de la aplicación NCAJOB. v El registro de asociación debe comenzar con dos barras inclinada. "<ApplName=SockEvent><AttrGroup=Events1>20061107 02:21:34 listener131(117)INFO:Test Event 2\n". "<ApplName=SockEvent><AttrGroup=Events1>20061107 02:22:02 listener131(101)WARNING:Test Event 3\n". No es necesario especificar la extensión . "<ApplName=SockEvent><AttrGroup=Events3>20061107 02:39:46 listener133(316)WARNING:Test Event 7\n". serán necesarias sentencias SOURCE y su especificación no debe resultar en ambigüedad alguna. no debe preocuparse de las posibles diferencias de representación de código de caracteres entre el host del programa cliente de socket y el host del proveedor de datos de socket. use IO::Socket. "//END-DP-INPUT\n". "<ApplName=SockEvent><AttrGroup=Events3>20061107 02:41:34 listener133(317)INFO:Test Event 8\n". Envíe el registro de asociación explícita antes que //SETSOURCENAME. syswrite $sock. Este método presenta las siguientes reglas: v El primer registro de datos recibido por el proveedor de datos de socket de un programa cliente debe contener una asociación de aplicación explícita empezando por el desplazamiento cero. PeerPort => $port. syswrite $sock. my $port = 7500. v Si el metarchivo define una aplicación que incluye sólo un grupo de atributos. "<ApplName=SockEvent><AttrGroup=Events2>20061107 02:29:46 listener132(216)WARNING:Test Event 4\n". syswrite $sock. Proporcione este registro en un mandato de envío de socket separado porque los datos restantes en el almacenamiento intermedio de registros no se examinarán y se omitirán.mdl porque se sobrentiende. Capítulo 4. Por lo tanto. El primer registro de datos recibido por el proveedor de datos. syswrite $sock. puede utilizar el método de número de puerto o el método del prefijado de registros de datos descritos anteriormente como sistema para resolver la ambigüedad. La aplicación NCAJOB incluye sólo un grupo de atributos. Por ejemplo. my $sock = new IO::Socket::INET( PeerAddr => $host. "<ApplName=SockEvent><AttrGroup=Events2>20061107 02:32:02 listener132(201)WARNING:Test Event 6\n". la sentencia SOURCE es opcional. //JOBCNTL. Además.mdl en el directorio de metarchivos.#---------------use strict. # Finalization Processing #--------------syswrite $sock. "<ApplName=SockEvent><AttrGroup=Events2>20061107 02:31:34 listener132(217)INFO:Test Event 5\n". syswrite $sock. Si el metarchivo no se ha cargado ya. syswrite $sock. el proveedor de datos de lo cargará y descubrirá que no hay ninguna definición de sentencia SOURCE. Acerca de los proveedores de datos 107 . close $sock. syswrite $sock.mdl. v El metarchivo debe estar disponible para el proveedor de datos de socket localmente o debe poderse recuperar desde un servidor de metarchivos centralizado. //SOCKET-COMMAND-ENABLED y que cualquier otra directriz de socket especial. "<ApplName=SockEvent><AttrGroup=Events1>20061107 02:19:46 listener131(116)WARNING:Test Event 1\n". Si el mismo nombre de host está emitiendo datos de entrada para varios grupos de atributos. v Si la aplicación incluye más de un grupo de atributos. syswrite $sock. Proto => ’tcp’). syswrite $sock.

Por ejemplo. no en el sistema remoto donde se esté ejecutando el programa cliente de socket. muestreados y con clave. sería necesaria una sentencia SOURCE.mdl //APPL NCAJOB //NAME PartList P 900 //ATTRIBUTES’. x’0D’). pero únicamente para evitar la ambigüedad dentro del ámbito de la aplicación NCAJOB. El carácter de nueva línea sirve de delimitador de fila de datos en caso de que el almacenamiento intermedio recibido por el proveedor de datos de socket contenga varias filas de datos. al final de cada fila de datos que envíe al proveedor de datos de socket. v Para los datos de sucesos.’ . Envío de mandatos de acción a clientes de socket De forma predeterminada. Tiempo de espera excedido La comunicación UDP no proporciona información de estado ni al remitente ni al destinatario. o combinaciones de caracteres no se reconocen y se tratan como datos de entrada regulares. Otros caracteres de retorno de carro y salto de línea. Si la sentencia ATTRIBUTE especifica un delimitador de ″. cualquier acción refleja u otro mandato de automatización que se haya distribuido a un sistema gestionado de aplicación de socket será ejecutado en el sistema local en el que se está ejecutando el proveedor de datos de socket. el valor del segundo atributo como segunda señal y el valor del tercer atributo como tercera señal. . Formato de un almacenamiento intermedio de sockets para la transmisión El programa que envía datos a un proveedor de datos de socket debe formatear el almacenamiento intermedio de datos de acuerdo con las definiciones del metarchivo. al especificar explícitamente un metarchivo. Los únicos caracteres de línea nueva que el proveedor de datos de socket acepta son \n (o el equivalente hexadecimal. . el almacenamiento intermedio de envío deberá tener el valor del primer atributo como primera señal en el almacenamiento intermedio. Si la aplicación NCAJOB contuviese más de un grupo de atributos.Metafile: JOBCNTL.) entre cada señal de valor. el ámbito de la resolución se restringe a una única definición de metarchivo.″. el proveedor de datos de socket emplea las siguientes reglas para determinar el estado del programa remitente: v Para aquellos datos sondeados. el almacenamiento intermedio de envío debe colocar un punto y coma (. no se ve afectado por otros programas activos conocidos por el proveedor de datos de socket al mismo tiempo porque. El método de asociación explícita es menos rígido y más sencillo de utilizar que el método de sentencia SOURCE. el proveedor de datos de socket espera indefinidamente la entrada del programa. El orden de los valores en el almacenamiento intermedio de envío debe coincidir con el orden de los atributos definidos en el metarchivo y el delimitador de registro utilizado debe ser el especificado en el metarchivo. o un retorno de carro si es una plataforma EBCDIC. Añada un carácter de línea nueva. Además. el proveedor de datos de socket excede el tiempo de espera del programa remitente después de cinco intervalos de TTL sin recibir datos y notifica a IBM Tivoli Monitoring de que el sistema gestionado está fuera de línea. Cuando se utiliza la comunicación UDP. x’0A’) y \r (o el equivalente hexadecimal. si el metarchivo tiene tres atributos. Puede solicitar que las acciones se envíen al programa cliente de socket enviando el siguiente registro después de que se conecte el programa cliente: //SOCKET-COMMAND-ENABLED=Y 108 IBM Tivoli Universal Agent: Guía del usuario .

Conversión de código de caracteres La utilización del transporte de sockets presupone que el programa remitente se encuentra en un host distinto del host donde se está ejecutando el proveedor de datos de socket.El recibo de este registro hace que el proveedor de datos de socket dirija cualquier mandato de automatización al sistema de destino del programa cliente de socket. La necesidad de la conversión de código de caracteres se indica de una de tres maneras: v Especificación del tipo de código en la sentencia SOURCE v Especificación del entorno local y la página de códigos en la sentencia SOURCE del metarchivo v Asociación explícita de metarchivos Especificación del tipo de código en sentencias SOURCE de metarchivos El parámetro opcional code-type en la sentencia SOURCE es sólo válido para aquellas fuentes del tipo SOCK. Registro CLEAR-PRIOR-DATA De forma predeterminada. Los programas que utilizan un socket UDP pero omiten enviar el mensaje de final de transacción. El registro //CLEAR-PRIOR-DATA sólo se aplica al grupo de atributos asociados a la conexión actual. Si el tipo de código del host del programa remitente difiere del tipo de código del host del proveedor de datos de socket. Por lo tanto. si el metarchivo de socket tiene grupos de atributos y cada uno tiene su propia conexión separada con un parámetro [port#] exclusivo. indicando la normal finalización de una sesión: //END-DP-INPUT v El programa cierra el socket TCP. puede enviar un registro //CLEAR-PRIOR-DATA al proveedor de datos de socket. Los programas que envían datos de tipo Suceso deberán enviar el mensaje de final de transacción o permanecer en línea para IBM Tivoli Monitoring hasta que haya una conclusión del sistema o hasta que el programa vuelva a contactar con el proveedor de datos. las filas de datos que el proveedor de datos de socket ha recibido para un grupo de atributos se mantienen en la memoria caché de Universal Agent hasta que se depuren filas de datos cuando caduque el intervalo TTL. lo cual resulta en la detección de la terminación de la conexión por parte del proveedor de datos. es posible que la representación de datos del programa remitente difiera de aquella del proveedor de datos de socket. Capítulo 4. exceden el tiempo de espera después de cinco intervalos TTL. el programa remitente puede elegir entre dos maneras de finalizar la sesión y permitir que el proveedor de datos indique el estatus fuera de línea a IBM Tivoli Monitoring: v El programa envía al proveedor de datos el mensaje de final de transacción mostrado a continuación como un único registro. el proveedor de datos convierte los datos que recibe en el tipo de datos de caracteres de su propio host local. Fin de sesión de la entrada de datos Al final de una sesión de datos de entrada. El valor predeterminado es ASCII. como ya se ha mencionado anteriormente en “Tiempo de espera excedido” en la página 108. Nota: La habilitación de esta característica presupone que el programa cliente ha abierto un socket de lectura que está esperando recibir mandatos de acción desde el proveedor de datos de socket. Si desea eliminar las filas de datos de socket recopiladas anteriormente sin esperar la caducidad TTL. Acerca de los proveedores de datos 109 . El proveedor de datos debe poder detectar la diferencia y manejar la conversión entre las dos representaciones. Por ejemplo. Este parámetro define el tipo de código de caracteres del host del programa remitente como ASCII o EBCDIC. debe enviar un registro //CLEAR-PRIOR-DATA para cada conexión para depurar todas las filas de datos recopiladas anteriormente para dicha aplicación.

si el programa se ejecuta en un tipo de plataforma del SO diferente del proveedor de datos de socket. Cuando el proveedor de datos de socket analiza los datos recibidos como atributos individuales. Por lo tanto. Si la especificación del tipo de código en la sentencia SOURCE del metarchivo SOURCE no coincide con el tipo de código determinado durante el tiempo de ejecución. especialmente. incluya el parámetro ’E’ en la sentencia SOURCE del metarchivo de socket para indicar que el sistema remitente está utilizando EBCDIC. En este caso. el programa cliente deberá enviar datos numéricos en formato de caracteres en lugar de en la representación binaria del sistema. Por ejemplo. Estos dos parámetros le dicen al proveedor de datos de socket qué codificación de caracteres utilizar al procesar los datos de entrada. Consulte “Sentencia SOURCE” en la página 140 para obtener información acerca de la utilización de los parámetros LOCALE y CODEPAGE. No obstante. Utilización del formato de caracteres para los datos numéricos El proveedor de datos de socket y el programa cliente remitente pueden estar situados en sistemas con arquitecturas diferentes con distintas representaciones internas de los datos numéricos. el valor determinado durante el tiempo de ejecución altera temporalmente la definición de la sentencia SOURCE. Si se encuentra un registro y el metarchivo está satisfactoriamente cargado. si un sistema socio conectado experimenta una interrupción de alimentación. Un programa cliente de socket basado en z/OS no siempre envía datos EBCDIC. Si no utiliza la asociación explícita de metarchivos. por ejemplo. si se especifica el parámetro ’E’ en la sentencia //SOURCE SOCK se generarán datos incorrectos en la aplicación. El problema se puede corregir si el cliente de Java convierte primero los datos a UTF-8 antes de enviarlos al proveedor de datos de socket y si se omite el parámetro ’E’ del metarchivo. la representación de caracteres de valores numéricos se convierte al formato numérico local. Utilización de un registro de asociación explícita El proveedor de datos de socket proporciona el primer registro de datos que recibe de un nuevo programa remitente para un registro de asociación explícita de aplicación. Especificación del entorno local y página de códigos en la sentencia SOURCE del metarchivo Si el idioma y la página de códigos de los datos que el programa cliente de socket está emitiendo como entrada no es el idioma y página de códigos predeterminado del sistema en el que se está ejecutando Tivoli Universal Agent. el tipo de código del programa que se conecta se ha determinado y verificado. algunos clientes de Java que se ejecutan en z/OS Java Virtual Machine envían datos UTF-16 Big Endian de forma predeterminada. Siempre es importante determinar la representación de caracteres de los datos que el programa cliente de socket envía. si un programa cliente de socket se está ejecutando en un sistema operativo z/OS y se está comunicando con el proveedor de datos de socket en un sistema operativo AIX.A modo de ejemplo. //SOURCE SOCK MVSA E Nota: Si la plataforma del programa cliente es EBCDIC pero el programa está enviando datos UTF-8 para una aplicación globalizada. deberá asegurarse de que se haya especificado el tipo de código correcto para el host del programa remitente en la sentencia SOURCE o asegurarse de que el programa y el proveedor de datos de socket se ejecutan en sistemas con arquitecturas similares. 110 IBM Tivoli Universal Agent: Guía del usuario . su socio de sesión no puede detectar la interrupción ya que no ha habido notificación de desconexión de sesión ni por parte del socio de conexión ni por parte del servicio de red. Los socios de sesión conectados detectan inmediatamente las desconexiones de sesión causadas por un socio desconectándose o por una interrupción de red. deberá especificar los parámetros de palabra clave CODEPAGE y LOCALE en la sentencia //SOURCE SOCK del metarchivo. Detección de interrupciones TCP TCP es un protocolo de transporte orientado a conexiones. no incluya el parámetro E.

Un valor más corto aumenta la carga de proceso de Tivoli Universal Agent. Puede aumentar el periodo de ventana de detección estableciendo KUMP_TCP_OUTAGE_WINDOW en un valor superior a 180. Detección de errores limitada con UDP Con la programación UDP. puede inhabilitar esta característica especificando un valor de 0. No obstante. la detección y la recuperación de errores son limitados porque no se realiza ninguna comprobación del estatus o del latido entre un programa UPD remitente y el proveedor de datos de socket. Especifique el requisito de reconocimiento utilizando la sentencia CONFIRM. Investigue las características de las aplicaciones supervisadas y de la configuración de red antes de cambiar los valores predeterminados. un grupo de atributos has especificado un TTL de 180 segundos (3 minutos). Un valor más largo retrasa la notificación de las interrupciones de red. está sujeto a un número de limitaciones. Capítulo 4. El proveedor de datos de socket no notifica a IBM Tivoli Monitoring que el programa cliente de socket se ha desconectado hasta tres minutos después de haber detectado la desconexión de la sesión TCP. Consulte “Sentencia NAME” en la página 134 para obtener más información acerca de TTL. La Tabla 3 en la página 12 proporciona el nombre y ubicación del archivo de variables del sistema operativo. Por ejemplo. se presenta una notificación de sistema gestionado fuera de línea inmediatamente a Tivoli Enterprise Portal. El valor predeterminado de esta variable es de 180 segundos. La utilización de un protocolo produce una complejidad de programación reducida. establezca la variable de entorno KUMP_TCP_DISCONNECT_BY_TTL en No. Para inhabilitar el retraso de la notificación TCP. Esto permite que el programa de socket y el proveedor de datos detecten problemas de comunicación inmediatamente y que inicien procedimientos correctivos. De forma predeterminada. las partes sólo pueden confiar en tiempos de espera excedidos y enviar errores para determinar el estatus.La variable de entorno KUMP_TCP_OUTAGE_WINDOW permite que el proveedor de datos de socket detecte dichas interrupciones de sistema. es posible retrasar la notificación de IBM Tivoli Monitoring para proporcionar una oportunidad adecuada para el proceso de los datos recibidos. Con UDP. hay definido un protocolo mínimo entre el proveedor de datos de socket y el programa remitente. lo que permite a Tivoli Universal Agent detectar cualquier interrupción de la sesión de conexión en una ventana de 3 minutos. Si no necesita la detección de interrupciones. Consulte “Sentencia CONFIRM” en la página 157 para obtener más información. Cuando se detecta una interrupción. Limitaciones del proveedor de datos de socket Debido a que el proveedor de datos de socket está pensado para extender la gestión de sistemas y aplicaciones a sistemas operativos desconocidos utilizando herramientas comunes con un mínimo de inversión en esfuerzo de programación. Consulte “Sentencia CONFIRM” en la página 157 para obtener más información. Acerca de los proveedores de datos 111 . Retraso de la notificación de desconexión TCP El proveedor de datos de socket detecta inmediatamente la desconexión de la sesión del programa cliente de la sesión TCP. a menos que utilice la función CONFIRM. la notificación de desconexión TCP se retiene hasta que haya caducado el intervalo de tiempo de vida (TTL). No obstante. o bien reducir la ventana estableciendo un valor inferior de 180. lo que facilita el desarrollo de aplicaciones de Tivoli Universal Agent. Reconocimiento de datos Puede seleccionar hacer que el proveedor de datos de socket reconozca la recepción de los datos de un programa cliente de socket. La utilización de TCP permite a la aplicación y al proveedor de datos detectar problemas de conectividad inmediatamente e iniciar un procedimiento de recuperación de problemas.

112 IBM Tivoli Universal Agent: Guía del usuario . ya que no hay un protocolo definido entre el proveedor de datos de socket y un programa remitente para implementar esta construcción lógica.Modalidad de bloque no soportada El proveedor de datos de socket no da soporte a bloques de datos de ejemplo como la modalidad COPY de los archivos o la llamadas a API dp_BeginSample y dp_EndSample.

espacios de trabajo y grupos de atributos de Tivoli Universal Agent. un nuevo sistema gestionado pasa a estar en línea y el antiguo pasa a estar fuera de línea. Cubre los siguientes aspectos: v Nombres de los sistemas gestionados. la aplicación de Tivoli Universal Agent correspondiente y la versión del metarchivo. 2007 113 . v Recopilación de datos históricos Supervisión de los datos de Tivoli Universal Agent Con Tivoli Enterprise Portal. puede supervisar datos de Tivoli Universal Agent del mismo modo en que es posible supervisar varios agentes de Tivoli Enterprise Monitoring. Supervisión de aplicaciones Este capítulo trata sobre cómo utilizar Tivoli Enterprise Portal para supervisar las aplicaciones de Tivoli Universal Agent. Cuando cambia el número de versión del metarchivo. v Espacios de trabajo personalizados para la supervisión de aplicaciones de Tivoli Universal Agent v Espacios de trabajo de UAGENT para la supervisión del estado operativo de los proveedores de datos y las acciones a las que dan soporte v Creación de situaciones y políticas de automatización para aplicaciones de Tivoli Universal Agent. Sistemas gestionados por Tivoli Universal Agent Sistema gestionado hostname:UA hostnameASFSdp:UAGENT00 hostnameSNMPdp:UAGENT00 hostname:SNMP-MANAGER00 localSubnet:SNMP-MANAGER00 hostnameHTTPdp:UAGENT00 hostname:INTERNET00 hostnameODBCdp:UAGENT00 hostname:APPLICATIONvv Tipo _Universal Agent Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Número de sistemas gestionados 1 por cada Tivoli Universal Agent 1 por cada proveedor de datos ASFS 1 por cada proveedor de datos de SNMP 1 por cada proveedor de datos de SNMP 1 por cada proveedor de datos de SNMP 1 por cada proveedor de datos HTTP 1 por cada proveedor de datos HTTP 1 por cada proveedor de datos de ODBC 1 por cada aplicación © Copyright IBM Corp. El nombre asignado a un sistema gestionado permite identificar la ubicación de los datos. En la Tabla 21 se muestra este convenio de nomenclatura. 2003. Tabla 21. Tivoli Enterprise Portal permite realizar las siguientes tareas: v Ver espacios de trabajo actuales e históricos para cada grupo de atributos que se esté supervisando v Supervisar el estado operativo de los proveedores de datos v Crear situaciones que utilicen los atributos definidos v Crear políticas para automatizar respuestas a los sucesos en los sistemas supervisados Sistemas gestionados por Tivoli Universal Agent Cada Tivoli Universal Agent y cada aplicación supervisada por Tivoli Universal Agent está representada en Tivoli Enterprise Portal como un sistema gestionado. Tivoli Universal Agent tiene un método específico para nombrar los sistemas gestionados que registra con el servidor de Tivoli Enterprise Monitoring.Capítulo 5.

El nodo de latido vital de Tivoli Universal Agent se utiliza estrictamente para gestionar la conexión con el servidor de Tivoli Enterprise Monitoring. El primer sistema gestionado en la Tabla 21 en la página 113 es el nodo de latido vital de Tivoli Universal Agent. se truncará por la izquierda hasta que el nombre completo del sistema gestionado sea igual a 32 caracteres.Existe un sistema gestionado UAGENT para cada proveedor de datos activo y existe un sistema gestionado para cada aplicación de Tivoli Universal Agent que se ha activado al iniciarse Tivoli Universal Agent o mediante un mandato de importación. el nombre de fuente se truncará por la derecha. el nombre del sistema gestionado del grupo de atributos es FIN1:LOGS00. los únicos sistemas gestionados por Tivoli Universal Agent que sean relevantes son los subnodos. si un proveedor de datos de archivo se está ejecutando en el sistema FIN1 dando soporte a una aplicación y grupo de atributos de Tivoli Universal Agent definidos como //APPL LOGS //NAME SYSLOG E //SOURCE FILE /syslog tail y se trata de la primera versión del metarchivo.” Todos los demás sistemas gestionados son subnodos de tipo “Universal Data Provider. nombreaplic VV Por ejemplo. Especifica el número de versión del metarchivo. nodos y subnodos se suelen emplear indistintamente. Envío y SNMP. registra el siguiente sistema gestionado: nombre_host:UA donde: nombre_host El nombre del host en el que se ha iniciado Tivoli Universal Agent. de tipo “Universal Agent. si un proveedor de datos de socket se está ejecutando en un host llamado PRDSRV1 y un programa cliente de socket está enviando datos desde el host newyork.” Los términos sistemas gestionados. HTTP. sólo los subnodos tienen datos de aplicación que se pueden visualizar en un espacio de trabajo y a los que se hace referencia en una situación. nombrefuente es el host del proveedor de datos. Con Tivoli Universal Agent. Para otros proveedores de datos (Socket. El prefijo nombreinst_ sólo se incluye si se inicia una copia no primaria de Tivoli Universal Agent. Por ejemplo. el componente del nombre de la fuente del nombre de sistema gestionado es newyork. El número de versión completa registrado con el servidor de supervisión adopta el formato siguiente: 114 IBM Tivoli Universal Agent: Guía del usuario . Truncamiento de los nombres de sistemas gestionados Si la longitud del nombre completo del sistema gestionado supera los 32 caracteres. Para los proveedores de datos archivo. Nombres de sistemas gestionados Cuando se inicia Tivoli Universal Agent. Cada aplicación de Tivoli Universal Agent supervisada aparece en la vista de Navigator de Tivoli Enterprise Portal como: nombreinst_nombrefuente:nombreaplicVV donde: nombreinst nombrefuente Especifica el nombre de instancia de Tivoli Universal Agent. ODBC. Servidor de API). Números de versión de sistemas gestionados A cada sistema gestionado se le asigna un número de versión. el nombre de la fuente es la ubicación de red del cliente que envía los datos. Identifica la ubicación de los datos. Desde el punto de vista de un usuario. Especifica el nombre de la aplicación definida en el metarchivo. Si se está utilizando un nombre de instancia. script.

Supervisión de aplicaciones 115 . El número de versión del metarchivo. como los departamentos de ventas y nóminas. Los sistemas gestionados con el número de versión anterior pasan a estar fuera de línea. Incluye todos los sistemas en la organización donde se han instalado agentes de supervisión. Navigator ofrece una vista de alto nivel de la empresa que se está supervisando. Consulte “Nombres de atributos y grupos de atributos” en la página 120 para obtener más información. Es posible acceder a los espacios de trabajo de Tivoli Universal Agent desde el nivel Grupo de atributos de la vista Navigator. Cambios de versión de sistemas gestionados Cuando el número de versión (RR) de un metarchivo cambia.VV. 2. no es necesario volver a crear y redistribuir las situaciones o políticas existentes. Los nombres de los espacios de trabajo y de los grupos de atributos también cambiarán. Lo mismo se aplica a las políticas. Deberá crear nuevas situaciones o editar las ya existentes para utilizar los nuevos nombres de grupos de atributos y distribuirlos a las nuevas versiones de los sistemas gestionados. Los separadores Física y Lógica en la parte inferior de Navigator permiten alternar entre ambas vistas. Cambie una situación existente sólo si desea utilizar un atributo recién añadido como uno de sus predicados. intente realizar cambios en los metarchivos que sólo modifiquen el número de modificación y no el número de versión. Espacios de trabajo de aplicaciones Tivoli Enterprise Portal incorpora un espacio de trabajo para cada grupo de atributos definido en una aplicación de metarchivo. Puede mostrar la empresa como una correlación física de sistemas y aplicaciones o como una vista lógica de entidades.RR. Tenga en cuenta que Universal Agent utiliza la parte RR del prefijo de versión de 2 dígitos cuando se construyen nombres de sistemas gestionados. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27 para obtener información adicional acerca de los cambios que hacen que cambie una versión de un metarchivo. Los sistemas gestionados con el nuevo número de versión pasan a estar en línea. 3. se produce lo siguiente. Las entradas en la lista de sistemas gestionados aparecen con el nuevo número de versión. Física La vista predeterminada de Navigator es Física. Cuando el número de modificación (MM) de un metarchivo cambia. con los siguientes niveles: Empresa El nivel superior. 4. 1. Consulte “Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent” en la página 27 para obtener una lista de aquellos cambios que no afectan al número de versión.MM donde: VV RR MM El número de versión de Tivoli Universal Agent. El release actual es la versión 06. Por este motivo. Nota: No es posible simplemente reiniciar las situaciones distribuidas a una versión anterior de un sistema gestionado. Cualquier situación en ejecución que se haya distribuido a versiones anteriores de los sistemas gestionados se detendrá de forma automática. El número de modificación del metarchivo. Capítulo 5.

Los objetos gestionados y los sistemas gestionados que representan se definen en Tivoli Enterprise Portal. puede acceder a ella en Tivoli Enterprise Portal de las siguientes maneras: v Para obtener información acerca de un grupo de atributos específico. Pulse sobre la pestaña Lógica para ver la vista lógica. por ejemplo. Agente El agente de supervisión está instalado en el sistema. como una serie de datos en un diagrama o como una condición en una situación. Algunos agentes de Tivoli Enterprise Monitoring se agrupan en una carpeta. v Para obtener información acerca de las columnas que representan atributos en los espacios de trabajo. Windows. CICSplex. Algunos productos de IBM Tivoli Monitoring tienen agentes y subagentes. Grupo de atributos La categoría de atributos que supervisa el agente. como los sistemas operativos z/OS. En tales casos. UNIX o Linux. Acceso a la ayuda para grupos de atributos y atributos Si se ha definido la ayuda en un metarchivo de Tivoli Universal Agent. El objeto de visión general asignado aparece en el nivel superior de la vista lógica.Plataforma operativa La plataforma operativa en la que se está ejecutando el agente de supervisión. Esta vista refleja la jerarquía de los objetos gestionado. Cualquier objeto gestionado en el objeto de visión general aparece en el siguiente nivel. Lógica La vista Lógica agrupa agentes en objetos gestionados. se añade otro nivel para incluir los subagentes en la carpeta del agente de gestión. con las acciones siguientes: v Crear espacios de trabajo que contengan datos de sólo un subconjunto de sistemas o atributos gestionados v Clasificar columnas basándose en el valor de las entradas v Incluir o excluir datos de acuerdo con los criterios especificados v Cambiar el orden de las columnas en el espacio de trabajo Consulte la publicación Tivoli Enterprise Portal Administrator’s Guide y la ayuda en línea de Tivoli Enterprise Portal para obtener instrucciones acerca de cómo personalizar los espacios de trabajo. MQSeries y SAP R/3. Sistema El nombre del sistema o imagen de z/OS donde se encuentran instalados los agentes de supervisión. cada uno de los cuales se utiliza como una columna en una tabla. MQSeries y Tivoli Universal Agent. de la misma manera que puede personalizar el contenido de otros espacios de trabajo. Si el nombre del agente está atenuado. Es posible ver algunos grupos de atributos agrupados bajo un título. el texto de ayuda del grupo de atributos aparece listado en el recuadro Descripción en la parte inferior de la ventana. En esta ventana seleccione un Elemento de atributo para ver el texto de ayuda en el recuadro Descripción correspondiente a dicho atributo. Un grupo de atributos se compone de varios o muchos atributos individuales. en particular aquellos que tienen varios agentes del mismo tipo en el mismo sistema. seleccione el nombre del grupo de atributos en el Editor de situaciones. Por ejemplo. quiere decir que el agente está fuera de línea. con varios espacios de trabajo disponibles. 116 IBM Tivoli Universal Agent: Guía del usuario . Al definir condiciones para incluir en la situación. desplace el ratón sobre los encabezados de columnas que representan cada atributo. Personalización del contenido de espacios de trabajo Puede personalizar el contenido de espacios de trabajo de Tivoli Universal Agent.

Supervisión de aplicaciones 117 . durante el inicio. Envío. Este espacio de trabajo ofrece un seguimiento de auditoría detallado para el proveedor de datos. El espacio de trabajo DPLOG contiene siete columnas. Las categorías de registro actualmente implementadas se describen en la Tabla 23. Espacios de trabajo UAGENT Cada proveedor de datos registra la aplicación de propósito especial UAGENT. se pueden desarrollar situaciones y políticas para ella. Nombres de sistemas gestionados de UAGENT Los nombres de sistemas gestionados para las aplicaciones de UAGENT se construyen de la misma manera que los nombres de sistemas gestionados de las aplicaciones de Tivoli Universal Agent. Por ejemplo. que permite gestionar todos los proveedores de datos de una empresa desde Tivoli Enterprise Portal y conseguir la supervisión automática y dinámica de operaciones en tiempo de ejecución de Tivoli Universal Agent. y acciones automáticas de situaciones y políticas. Los tipos incluyen: ASFS. Espacio de trabajo DPLOG El espacio de trabajo DPLOG es similar a un registro de consola de sistema. que siempre es 00. El tipo de proveedor de datos. El propósito del grupo de atributos ACTION es proporcionar información acerca del proceso de mandatos de Actuación. del mismo modo que para cualquier otro sistema gestionado. El propósito del grupo de atributos DPLOG es traer a la superficie información de estatus de un proveedor de datos en particular. La hora local del mensaje de suceso del proveedor de datos. El número de versión actual del proveedor de datos. Por ejemplo FILEdp. errores y mensajes de aviso.Consulte “Creación de ayuda para aplicaciones. UAGENT contiene los grupos de atributos DPLOG y ACTION. HTTPdp o ASFSdp. El texto de mensaje detallado del registro del proveedor de datos. Tabla 22. TIPODP TipoPD VV Nombre de host en el que se encuentra el proveedor de datos. Tipo de proveedor de datos. Archivo. Columnas del espacio de trabajo DPLOG Nombre de la columna Categoría de registro de DP Texto de registro de DP Nombre de DP Hora del DP Tipo de DP Versión de DP Descripción La categoría de la entrada de registro. El formato es SAAMMDDHHMMSSmmm. Tienen el siguiente formato: NombreHostLocalTIPODPdp:UAGENTVV donde: NombreHostLocal Host donde se ejecuta el proveedor de datos. servidor de API. ODBCdp. Número de versión de la aplicación UAGENT. grupos de atributos y atributos” en la página 19 para obtener información adicional. que se describen en la Tabla 22 en la página 117. socket. SNMP. el nombre de sistema gestionado de un proveedor de datos de archivo ejecutándose en un sistema llamado ENG1 es ENG1FILEdp:UAGENT00. script. Puesto que cada aplicación UAGENT se registra como un sistema gestionado. incluidos los sucesos principales. Capítulo 5. El nombre del sistema gestionado del proveedor de datos que emite el mensaje de registro. HTTP y ODBC. SOCKdp.

actividades de definición de aplicaciones y motivos para un retraso en la supervisión de un archivo. estatus operativo con Tivoli Universal Agent. Puede crear situaciones y políticas basadas en atributos de ACTION de la misma manera que puede hacerlo con cualquier otro atributo de espacio de trabajo. nuevo socio UDP reconocido. Ejemplos: se han cargado las definiciones de configuración de condiciones de excepción. error de conexión y estatus de reintento automático o desconexión detectada por alguna de las partes. conclusión. Ejemplos: proceso de una solicitud de metarchivo por parte del servidor. errores de definición de configuración y errores internos de proceso. dp_Redefine. 118 IBM Tivoli Universal Agent: Guía del usuario . Entradas de registro informativas pertinentes a actividades del proveedor de datos de servidor de API. solicitud de inicio de recopilación de datos MIB para el agente. Mensajes informativos relacionados con el proveedor de datos de SNMP. como por ejemplo. o se ha iniciado la gestión de red SNMP Mensajes informativos relacionados con interacciones con el servidor centralizado de metarchivos del proveedor de datos. Tabla 23. Categorías del espacio de trabajo DPLOG Categoría SYSTEM Descripción Entradas pertinentes a operaciones generales del proveedor de datos como inicio. Mensajes correspondientes a situaciones no críticas. como E/S irrecuperable de archivo. como definiciones de datos de aplicación no definidas o una aplicación ya registrada con Tivoli Universal Agent. Ejemplos: el cliente de metarchivos del proveedor de datos conectado correctamente al servidor. ERROR WARNING INFO APIINFO APICOMM SNMPINFO METAINFO METACOMM SOCKCOMM Espacio de trabajo ACTION El espacio de trabajo ACTION contiene 8 columnas. conexión abandonada debido a una discrepancia en la configuración o tiempo de espera excedido del socio UDP debido a la inactividad. no es posible utilizar reiteradamente la automatización o los mandatos de Actuación en el grupo de atributos ACTION. información de salida de una recuperación de metarchivo. como mandatos de consola recibidos y resultados de proceso. registro DP Descripción El ID de mensaje asociado con el texto del mensaje de DPLOG. Columnas del espacio de trabajo DPLOG (continuación) Nombre de la columna ID mens. Ejemplos: nueva conexión TCP aceptada. Ejemplos: llamadas a API de dp_Define. errores en el entorno de ejecución. Estas columnas se describen en la Tabla 24. dp_BeginInput.Tabla 22. llamadas a API dp_OpenSession y dp_CloseSession. No obstante. Entradas relacionadas con condiciones de error significativas. y estadísticas periódicas del sistema. dp_EndInput. Actividades de comunicación relacionadas con proveedores de datos de socket. Actividades de comunicación entre el cliente de metarchivos del proveedor de datos y el servidor de metarchivos del proveedor de datos. Actividades de comunicación entre el proveedor de datos de servidor de API y los programas cliente. o circunstancias en las que se han emprendido acciones predeterminadas o se han suministrado valores predeterminados durante el proceso normal. actividades de subprocesos. Seguimientos detallados de auditoría de actividades de proceso. Representan el estatus general del proveedor de datos y solicitudes de trabajo.

Una acción puede incluir un número de etapas y el estatus refleja el progreso de la acción a medida que varios componentes de operación la manejan. Puede realizar las siguientes tareas cuando utilice el Editor de situaciones: Capítulo 5. Las situaciones se utilizan para supervisar la condición de los sistemas en la red. pero debe asignarlas a los sistemas gestionados en lo que desea que se ejecuten. Todas estas situaciones se utilizan con el proveedor de datos de SNMP. que pueden utilizar tal y como se incluyen o modificarlas para cumplir sus requisitos. Columnas del espacio de trabajo ACTION Columna ID de acción Descripción El número de secuencia de la acción generada internamente por Tivoli Universal Agent utilizado para realizar un seguimiento de las actividades y el progreso de la acción. Los primeros 256 caracteres de la salida del procesado de la acción. El nombre de la acción o mandato a ejecutar. Supervisión de aplicaciones 119 . Nota: La columna/atributo ID de acción forma parte del grupo de atributos ACTION pero está oculta y no se visualiza en el espacio de trabajo ACTION. La utilización de situaciones predefinidas puede mejorar la velocidad con la que comenzar a utilizar los productos de IBM Tivoli Monitoring. Una situación es una expresión lógica con una o más condiciones del sistema. Las situaciones predefinidas contienen atributos que comprueban condiciones del sistema comunes a muchas empresas. Tipo de acción Propietario de la acción Nodo de acción Nombre de acción Parámetros de la acción Estatus de la acción Resultados de la acción Hora de la acción Situaciones de Tivoli Universal Agent Este apartado trata información específica acerca de la creación de situaciones de Tivoli Universal Agent. El estatus de la solicitud de acción. El tipo de acción. Todas las situaciones predefinidas están configuradas para activarse durante el inicio. Los parámetros exactos de entrada que desea pasar al programa de acción o mandato. si fuese necesario. La indicación de la hora en que se desencadenó la acción. Puede examinar y. también denominadas situaciones proporcionadas con el producto. Hay otras 20 situaciones predefinidas que se instalan junto con Tivoli Universal Agent. cambiar las condiciones o valores que se están supervisando mediante una situación predefinida para que se adecue más correctamente a su empresa. Acerca de las situaciones predefinidas Los agentes de Tivoli Enterprise Monitoring a utilizar para supervisar el entorno del sistema incluyen un conjunto de situaciones predefinidas. Consulte la publicación Tivoli Enterprise Portal Administrator’s Guide o la ayuda en línea proporcionada con Tivoli Enterprise Portal para obtener instrucciones detalladas sobre la creación de situaciones. Por ejemplo. Utilización de situaciones Modifique situaciones desde Tivoli Enterprise Portal utilizando el Editor de situaciones.Tabla 24. Consulte la Tabla 20 en la página 95 para obtener una lista completa de situaciones de SNMP. El nombre del sistema gestionado que procesa la acción. Nota: Antes de modificar una situación predefinida. realice una copia como reserva en caso de que fuese necesario. El nombre del objeto (situación o política) que ha iniciado la acción. automatización de Reflejo o Política. Es posible gestionar situaciones desde Tivoli Enterprise Portal utilizando el Editor de situaciones. Los elementos de actuación se ven de la misma manera que las políticas.

El nombre del grupo de atributos es el mismo que el espacio de trabajo que contiene los datos de dicho grupo. el marco izquierdo lista inicialmente las situaciones asociadas con el elemento de Navigator seleccionado.v v v v v v Crear una situación Guardar una situación Visualizar una situación Editar una situación Iniciar. Como alternativa. 120 IBM Tivoli Universal Agent: Guía del usuario . Si desea utilizar atributos de distintos grupos en la situación. Los nombres de los atributos en el grupo son los mismos que los encabezados de las columnas en el espacio de trabajo. Distribución de situaciones a sistemas gestionados Después de crear una situación. detener o suprimir una situación Investigar el espacio de trabajo de sucesos de una situación Cuando se abre el Editor de situaciones. o bien crear mandatos de actuación y guardarlos para su posterior uso. Es posible distribuir la situación a cualquier sistema gestionado cuyo nombre contenga el nombre de aplicación. el marco derecho del Editor de situaciones se abrirá para proporcionar información acerca de la situación o para dejarle definir más en detalles dicha situación: Condición Distribución Consejo experto Acción Ver. Siempre es posible distribuir la situación a la lista de sistemas gestionados *CUSTOM_AAARR. añadir a y editar la condición que se está probando Ver los sistemas a los que se ha asignado la situación y asignar la situación a los sistemas Escriba comentarios o instrucciones para leerlas en el espacio de trabajo de sucesos Especificar un mandato a enviar al sistema. Al pulsar sobre un nombre de situación o crear una nueva situación. puede considerar crear un nuevo grupo que contenga todos los atributos que desee incluir en la situación. deberá crear otra situación e incluirla en la primera. Por ejemplo. donde: AAA RR El nombre de la aplicación El número de versión del metarchivo Utilice nombres de sistemas gestionados específicos para obtener un mejor rendimiento. seleccionando Actuación en el menú emergente para un elemento de la vista física de Navigator. puede distribuir la situación a cualquier sistema gestionado cuyo nombre tenga el formato nombrehost:UL300. Hasta Restablece una situación verdadera cuando otra situación pasa a ser verdadera o transcurre un intervalo de tiempo especificado Nombres de atributos y grupos de atributos Los atributos que haya definido aparecen en la ventana Seleccionar atributo que se visualiza cuando se coloca un objeto de predicado en el espacio de trabajo del Editor de situaciones. Creación de situaciones con atributos de distintos grupos Sólo es posible crear situaciones que utilicen atributos del mismo grupo de atributos. se distribuye a los sistemas gestionados en los que desea que se ejecute. si el nombre del grupo de atributos es UL3SYSLOG00. También puede escribir mandatos de actuación añadiendo una vista de actuación a un espacio de trabajo.

y el intervalo con que se deben guardar los datos en el depósito. es decir. Para evitar esto. sondeado (P) o con clave (K). El valor de TTL que elija afecta a cómo se evalúan las situaciones y a qué puede filas de datos se ven en los espacios de trabajo de aplicación de Tivoli Universal Agent. Esto significa que si se especifica un TTL pequeño en comparación con el intervalo de muestreo de la situación. v Si selecciona utilizar el almacén. Es posible encontrar más información acerca de la utilización de la función de recopilación de datos históricos en la ayuda en línea de Tivoli Enterprise Portal y en la publicación Tivoli Enterprise Portal Administrator’s Guide. Tivoli Universal Agent ignora cualquier fila de datos que tenga una TTL caducada. Supervisión de aplicaciones 121 . Especifique un TTL para indicar cuánto tiempo deben los datos proporcionados por los proveedores de datos considerarse válidos para su evaluación. Después de que caduque el TTL. Recopilación de datos históricos Puede utilizar los recursos de la función de recopilación de datos históricos de Tivoli Enterprise Portal para almacenar y guardar los datos recopilados por Tivoli Universal Agent o los agentes. a saber. está indicando que las muestras contienen varias filas de datos. donde se almacenan los datos recopilados. donde la edad de los datos sea mayor que el TTL. ninguna de las filas individuales que componen el conjunto de muestras disponibles para los espacios de trabajo o para la evaluación de situaciones. v El intervalo durante el que se recopilan datos. si está utilizando el proveedor de datos de archivo y especifica la modalidad Copy (Copia) en la sentencia SOURCE. Cada vez que el proveedor de datos de archivo muestrea un archivo de registro.Intervalo de situación y valor de tiempo de vida (TTL) Si un grupo de atributo de aplicación está definido como tipo de datos de suceso (E) en la sentencia NAME del metarchivo. es evaluada por Tivoli Universal Agent. Reglas especiales para conjuntos de muestras de varias filas Un conjunto de muestras es una muestra de datos que consta de varias filas de datos. Si el grupo de atributos es de los tipos muestreado (S). necesitará tener en cuenta el valor de tiempo de vida (TTL) al establecer el intervalo de situación. v La ubicación. en el agente o en el servidor de Tivoli Enterprise Monitoring. Cuando se crea una situación y se distribuye a un sistema gestionado. Tivoli Universal Agent trata el conjunto de muestras como una muestra. lo que significa que el TTL que especifique se aplica a todo el conjunto de muestras. genera un conjunto de muestras que consta de todos los registros en el archivo de registro. la situación no activarse cuando debería. elija un intervalo de muestre de situación mas pequeño que el TTL o aumente el TTL. Por ejemplo. el contenido entero del archivo. La función de recopilación de datos históricos permite especificar lo siguiente: v El grupo o grupos de atributos para los que se recopilan datos. no se puede especificar un intervalo para las situaciones utilizando atributos de dicho grupo. Capítulo 5.

122 IBM Tivoli Universal Agent: Guía del usuario .

El emisor de SNMP envía condiciones de excepción en el formato de SNMP versión 1. © Copyright IBM Corp. Envía datos de sucesos de situación supervisados por los productos de IBM Tivoli Monitoring. Introducción al emisor de SNMP Este capítulo proporciona la siguiente información acerca del emisor de SNMP de Tivoli Universal Agent: v Una introducción al emisor de SNMP de Tivoli Universal Agent. Puede utilizar el Emisor de SNMP para emitir condiciones de excepción para otros productos de agente además de Tivoli Universal Agent. Si existe una política de Tivoli Universal Agent con el emisor de SNMP. v Utilización de los datos del emisor de SNMP. 2003. en forma de condiciones de excepción de SNMP. Mejora el rendimiento del sistema y la disponibilidad Correlaciona información de distintas herramientas de gestión para gestionar de manera más eficaz los sistemas de red. El emisor de SNMP está soportado en todos los sistemas operativos soportados por Tivoli Universal Agent. No tiene ninguna dependencia con ningún servicio de SNMP del sistema operativo y puede coexistir con otros servicios de SNMP del sistema operativo. no es necesario ejecutar también el servicio SNMP proporcionado por Microsoft o el servicio de condiciones de excepción de SNMP en dicho sistema para poder utilizar el Emisor de SNMP. 2007 123 . se reenvía una condición de excepción de SNMP a un gestor de SNMP designado. Utilice las situaciones para asegurarse de que recibe únicamente las alertas que considere importantes. v Establecimiento de parámetros. El emisor de SNMP integra la información de los productos de IBM Tivoli Monitoring y los datos de productos de terceros en un único sistema. a un gestor de terceros. sistemas operativos y recursos en todo el entorno informático desde un único punto focal seleccionado por el usuario. si Universal Agent se ejecuta en un sistema Windows. El emisor de SNMP utiliza los servicios nativos del sistema operativo para comunicar sucesos a una aplicación de gestión de SNMP designada que se ejecute en cualquier host. cuando el estatus de una situación supervisada por un producto de IBM Tivoli Monitoring cambia de Falso a Verdadero. El emisor de SNMP proporciona lo siguiente: Simplifica la gestión del sistema y de las aplicaciones Permite la visualización de alertas de aplicaciones. Por ejemplo. independientemente de dónde se ha recopilado. El emisor de SNMP es una interfaz entre IBM Tivoli Monitoring y gestores de SNMP de terceros como HP OpenView y CA-Unicenter. Aumenta la eficacia Permite el acceso a la información para poder resolver problemas del sistema de manera más eficaz. es decir. el servidor de Tivoli Enterprise Monitoring recopila y almacena la información acerca del suceso. Proporciona flexibilidad Permite a los administradores y a los operadores utilizar las herramientas de gestión con las que están familiarizados para supervisar información. Cuando se produce un suceso. Visión general del emisor de SNMP Cada vez con mayor frecuencia. v Instrucciones para la instalación e integración del emisor de SNMP. los administradores de sistemas afrontan el reto de gestionar información en entornos distribuidos y heterogéneos con varios puntos focales y distintas herramientas de gestión.Capítulo 6.

atr. La información estructural se almacena en los archivos CANBASE. El archivo de atributos del emisor de SNMP. como por ejemplo. debe estar situado en el directorio central ATTRLIB del servidor de Tivoli Enterprise Monitoring. De forma predeterminada. 4. especifique la variable de entorno. HP OpenView y la consola. Para incluir información de predicado de la situación que ha hecho que se emitiera la condición de excepción. La característica del emisor de SNMP está completamente integrada en la instalación de Tivoli Universal Agent y el emisor de SNMP arranca automáticamente cuando se inicia Tivoli Universal Agent. Estos dos archivos MIB se encuentran en el directorio \TMAITM6 en los sistemas Windows y en el directorio /um/mib en los sistemas UNIX. puede utilizar la variable de entorno KUMP_TRAP_DESTINATION. v Como alternativa a KUMP_TRAP_DESTINATION. 124 IBM Tivoli Universal Agent: Guía del usuario . De hecho. Puede utilizar el emisor de SNMP sin activar el proveedor de datos de SNMP. De forma predeterminada. Instalación e integración del emisor de SNMP Utilice los siguientes procedimientos para instalar e integrar el emisor de SNMP. El archivo de catálogo del Emisor de SNMP. 2.cat. El archivo ODI del Emisor de SNMP dockum tiene que estar situado en el directorio \cnps o /cq/data de servidor de Tivoli Enterprise Portal.Variables de entorno del emisor de SNMP Una condición de excepción de SNMP contiene un nombre de comunidad de SNMP. 3. no inicie el proveedor de datos de SNMP si no va a utilizar ninguna de sus funciones porque requiere más sobrecarga que otros proveedores de datos de Tivoli Universal Agent. Para que el gestor de SNMP pueda interpretar correctamente y visualizar la información de condición de excepción. KUMP_TRAP_ADD_PREDICATES=Y. complete los pasos siguientes: 1.MIB y CANSYSSG. Nota: No hay conexión o dependencia necesaria entre el proveedor de datos de SNMP y el emisor de SNMP. kum. que se distribuyen con Tivoli Universal Agent. las cadenas de predicado de la situación no están incluidas en las condiciones de excepción que el Emisor de SNMP envía. kum. Deberá separar varios nombres de host mediante comas. Integración del emisor de SNMP en soluciones de terceros Las condiciones de excepción enviadas por el Emisor de SNMP necesitan estar integradas en un gestor de SNMP. que presenta las reglas siguientes: v No tiene valor predeterminado v Define los nombres de host en los que se están ejecutando los gestores de SNMP. puede utilizar el parámetro TrapDestination en la definición de política del Emisor de SNMP. Para designar los hosts que desea que reciban las condiciones de excepción de SNMP. debe encontrarse en el directorio RKDSCATL del servidor de Tivoli Enterprise Monitoring concentrador.MIB. un gestor de SNMP puede elegir utilizarlo. Si tiene un servidor de Tivoli Enterprise Monitoring basado en z/OS. Instale Tivoli Universal Agent. Puede cambiar el nombre predeterminado por otro nombre mediante la variable de entorno KUMP_TRAP_EMIT_COMMUNITY. necesitará instalar los archivos KUMATR y KUMCAT en PDS de RKANDATV. Instalación del emisor de SNMP Para instalar el Emisor de SNMP. debe anunciar la estructura de la condición de excepción. éste es el nombre de comunidad público.

consulte la siguiente descripción de condición de excepción en el archivo CANSYSSG. el Registro de sucesos de aplicaciones en el sistema HOSTABC estaba en una ocupación del 100%. consulte la documentación del producto del gestor de SNMP. Esta condición de excepción la ha generado el emisor de SNMP de Tivoli Universal Agent en respuesta a haber excedido un umbral de una situación.Max_Size=524288} Utilización del emisor de SNMP y sus datos Utilice la siguiente información para establecer los parámetros del emisor de SNMP y para utilizar los datos del emisor de SNMP. NT_Log_Space_Low. Por ejemplo.%_Usage=100.55. Una vez creadas las Capítulo 6. se seleccionaron los atributos Log_Name_U. Timestam y Max_Size para incluirse en la condición de excepción: Destinations-----------{192. Lo que aparece en sitAttributeList depende de qué atributos seleccione al editar los parámetros del emisor de SNMP en el editor de flujo de trabajo.MIB implementado en la macro TRAP-TYPE: candleEvent TRAP-TYPE ENTERPRISE candle-Alert-MIB VARIABLES { sitName. Es posible encontrar una descripción completa de dichas variables en el archivo CANSYSSG. algunos productos del gestor de SNMP requieren una importación de MIB o un paso de compilación. Establecimiento de los parámetros del emisor de SNMP Es posible acceder al emisor de SNMP desde el interior del Editor de flujos de trabajo de Tivoli Enterprise Portal. Visualización de los datos del emisor de SNMP La visualización de datos de condición de excepción del emisor de SNMP varía entre un producto de gestor de SNMP y otro. por lo tanto. Introducción al emisor de SNMP 125 . El formato de sitAttributeList es una cadena de pares de AttributeName=AttributeValue separados por comas.%_Usage >= 95} AttributeList-----------{NT_Monitored_Logs_Report.1. lo que causó que surgiera la situación y que la política asociada enviara una condición de excepción de SNMP al destino 192. Current_Size. En este ejemplo. En el siguiente ejemplo se muestra la salida de rastreo capturada cuando se utiliza el Emisor de SNMP para una situación de agente del SO Windows. Durante la definición de política.1. Current_Size=524288. Para ayudarle a comprender mejor qué datos de condición de excepción están previstos.18. %_Usage.MIB. sitCurrStat-Predicates. Para obtener instrucciones sobre cómo llevar a cabo esta tarea. Este archivo MIB depende de las definiciones del archivo CANBASE.El proceso de configurar información para un gestor de SNMP es diferente para cada producto de gestor.Timestamp=1070227071953000. sitCurrStat-OriginNode.”::= 8 Estos datos siempre se encuentran en la lista de enlaces de variable de la condición de excepción. ambos son necesarios. sitCurrStat-LocalTimeStamp.MIB. Cree primero las situaciones de IBM Tivoli Monitoring que desee supervisar.18.Log_Name_U=Application.55} SituationName--------{NT_Log_Space_Low} SituationTime---------{1070227071953999} ManagedSystem------{Primary:HOSTABC:NT} Severity----------------{Minor} Category---------------{Log_Only_Events} SituationPredicates---{NT_Monitored_Logs_Report. sitCategory. sitAttributeList } DESCRIPTION “Se ha excedido el umbral de una situación de IBM Tivoli Monitoring. sitCurrStat-Severity.

el cual tenga llamados todo sistemas gestionados: NombreHostTIPODPsp:UAGENT00 donde: NombreHost Host donde se ejecuta el proveedor de datos. Seleccione el icono SNMP_Event de entre los componentes de flujo de trabajo de la pestaña Actividades del emisor. Proporcione los siguientes parámetros en la ventana Valores del emisor: Destino del emisor Seleccione cualquier sistema gestionado del proveedor de datos de Tivoli Universal Agent en el menú desplegable. Gravedad Seleccione uno de los siguientes grados de gravedad predefinidos: v Eliminado v Indeterminado v Aviso (valor predeterminado) v Error_menor v Crítico v Grave De forma predeterminada. este valor de gravedad definido por esta política se visualiza como el valor de Gravedad de la condición de excepción en el sistema receptor. puede crear una o más políticas donde la actividad inicial sea la evaluación de la situación y una actividad siguiente sea la actividad SNMP_Event. debe elegir uno de los sistemas gestionados UAGENT. 2. TIPODP Tipo de proveedor de datos de 4 caracteres. establezca la siguiente variable de entorno: KUMP_TRAP_USE_POLICY_SEVERITY=N Categoría Seleccione una de las siguientes categorías predefinidas: v v v v v v v v v v Threshold_Events (valor predeterminado) Network_Topology_Events Error_Events Status_Events Node_Configuration_Events Application_Alert_Events All_Category_Events Log_Only_Events Map_Events Ignore_Events TrapDestination Escriba una o más direcciones IP/nombres de hosts para que reciban las condiciones de 126 IBM Tivoli Universal Agent: Guía del usuario . Algunos ejemplos de proveedores de datos incluyen: ASFS o HTTP. Si desea que la gravedad definida por la política sólo aparezca en la información de vinculación de la variable de condición de excepción en el sistema receptor. seguido del literal dp. tenga en cuenta que para obtener mejores resultados.situaciones. Sin embargo. Lleve a cabo los siguientes pasos para establecer los parámetros del emisor de SNMP: 1.

Si se especifican ambos. Pero si el destino siempre es el mismo grupo de una o varias direcciones IP y tiene que crear muchas políticas. Invocar emisor una vez para cada fila de datos No es necesario realizar ninguna acción con la selección predeterminada del botón de selección. deberá separarlas con comas. entonces la política también necesitaría ser distribuida a un sistema gestionado asociado al agente del SO Linux.53. se obtendrá más granularidad si existe la necesidad de enviar distintas condiciones de excepción a distintos gestores de SNMP. Capítulo 6.60. Introducción al emisor de SNMP 127 . Los valores de los atributos que seleccione se reenvían como parte de la condición de excepción de SNMP en la lista de vinculación de variable. Si se especifica más de una entrada. puede especificar la variable de entorno KUMP_TRAP_DESTINATION en el archivo de variables de entorno de Tivoli Universal Agent. Atenas. Si el parámetro TrapDestination se deja con el valor _DEFAULT. debe ser un nombre capaz de resolverse mediante DNS. las alertas se envían a los nombres de host identificados mediante KUMP_TRAP_DESTINATION.152.excepción. Por ejemplo. Atributos Seleccione los atributos asociados con la situación que se está supervisando en la segunda ventana emergente. Si se especifica el parámetro TrapDestination en la definición de Política. entonces es más conveniente establecer la variable de entorno KUMP_TRAP_DESTINATION en Tivoli Universal Agent y dejar los valores de política de TrapDestination como _DEFAULT. si la situación fuera para el agente del SO Linux y se distribuyera a uno de los sistemas gestionados relacionados. Pulse Aceptar para guardar las selecciones. 10. Esta variable sigue el mismo formato y normas que TrapDestination. Si utiliza un nombre de host. 3. Granito. Distribuya la política a un sistema gestionado que sea del mismo tipo que el sistema gestionado al que se ha distribuido la situación de la política. el parámetro TrapDestination tendrá prioridad. Nota: No es necesario especificar a la vez el parámetro TrapDestination en la ventana Valores del emisor y la variable de entorno KUMP_TRAP_DESTINATION. 4. Por ejemplo. El emisor de condiciones de excepción de SNMP puede enviar datos de atributos que no estén en inglés. Como un método alternativo.

128 IBM Tivoli Universal Agent: Guía del usuario .

v Un asterisco (*) en la columna 1 indica una línea de comentarios. Si están presentes. 2007 129 . Sentencias de control de definición de datos Este apéndice contiene las descripciones y sintaxis de las sentencias de control utilizadas para crear un metarchivo de definición de datos. v Se permiten las líneas en blanco en un metarchivo. Introducción Las sentencias de control que se describen en este apéndice se utilizan para crear el metarchivo de definición de datos que define una aplicación de Tivoli Universal Agent. 2003.Apéndice A. deberá entrar las sentencias en el metarchivo en el siguiente orden: //SNMP //APPL //NAME //SOURCE //INTERNAL //RECORDSET //CONFIRM //SQL //SUMMARY //ATTRIBUTES © Copyright IBM Corp. Algunas de las sentencias sólo son utilizadas por algunos proveedores de datos específicos. Las siguientes reglas se aplican a la sintaxis de un metarchivo: v Las sentencias de control deben comenzar con un // en la columna 1 seguido de uno o más parámetros separados por espacios en blanco.

130 IBM Tivoli Universal Agent: Guía del usuario . Sintaxis //SNMP TEXT Parámetro La sentencia SNMP debe contener el parámetro TEXT. Debe preceder a la sentencia APPL que da nombre a la aplicación.Sentencia SNMP Descripción Esta sentencia contiene la definición de datos para una aplicación SNMP personalizada y sólo se utiliza para el proveedor de datos de SNMP.

subrayados (_) y asteriscos (*). el segundo metarchivo no se carga. Si se activan dos metarchivos de Tivoli Universal Agent con los tres primeros caracteres iguales en su sentencia //APPL se pueden ocasionar resultados imprevisibles.Sentencia APPL Descripción La sentencia APPL especifica el nombre utilizado por IBM Tivoli Monitoring para la aplicación Tivoli Universal Agent. Los primeros tres caracteres no pueden coincidir con uno de los prefijos de la aplicación de Tivoli Universal Agent reservados: ″UAG″ indica UAGENT. ya que está reservado para los productos IBM Tivoli Monitoring. suponiendo que el agente de resumen y poda se haya configurado para la aplicación. No puede haber espacios en blanco incorporados en el nombre. El nombre de aplicación no puede comenzar con el carácter K. 6. Los nombres de sistema gestionado pueden tener un máximo de 32 caracteres. Una definición de datos de metarchivo siempre define una aplicación completa. El estándar de nomenclatura predeterminado para los sistemas gestionados es Nombrehost:NombreaplicVV. incluidos letras. Notas: 1. Si el nombre de host es relativamente largo. WHEN{<valor>} (opcional) Indica cuál es la opción de habilitación de almacén que el agente de resumen y poda utiliza para todos los grupos de atributos en la aplicación de metarchivo. guiones (-). Un carácter no válido se sustituye automáticamente por un subrayado. como informes vacíos y cambios de versión de aplicación frecuentes. A continuación se indican los valores válidos: R En bruto o inferior a una hora Apéndice A. 3. ″SNM″ indica SNMP-MANAGER e ″INT″ indica INTERNET. 4. específicamente. se activa la habilitación del almacén con la opción predeterminada de R. v Debe tener un nombre //APPL exclusivo. Si se omite el parámetro WHEN. Nota: El parámetro <valor> entre llaves es un código de un carácter que indica la opción de habilitación de depósito. números. aunque el contenido sea diferente. Los primeros tres caracteres deben ser exclusivos para toda la empresa. El primer carácter no debe ser un dígito y ninguno de los tres primeros caracteres puede ser un guión o un asterisco. Deben cumplirse los siguientes requisitos: v Escriba sólo una sentencia //APPL por cada metarchivo. Sentencias de control de definición de datos 131 . 2. Sólo se permiten caracteres ASCII. Un nombre de aplicación debe contener al menos 3 pero no más de 20 caracteres. Sintaxis //APPL <nombreaplic> [WHEN{<valor>}] [ProductCode=] [<afinidades-dinámicas>] [@<texto de ayuda>] Parámetros <nombreaplic> Nombre de la aplicación de Tivoli Universal Agent que desea supervisar. el nivel mínimo de resumen de datos hallado en los datos de fuente de aplicación. 5. Hay restricciones especiales con respecto a los tres primeros caracteres de un nombre de aplicación. Si dos metarchivos distintos incluyen definiciones de aplicaciones con el mismo nombre //APPL. El nombre de aplicación lo utiliza Tivoli Universal Agent cuando construye el nombre de sistema gestionado que está registrado con el servidor de supervisión. considere la posibilidad de elegir un nombre de aplicación corto para evitar el truncamiento del nombre de sistema gestionado.

LOTUSNOTES AFFSYMBOL=NOTES_SERVER AFFTEXT=’IBM Lotus Notes’ <texto de ayuda> (opcional) Define el texto de ayuda para esta aplicación. 132 IBM Tivoli Universal Agent: Guía del usuario . El texto no debe exceder los 245 caracteres. Debe haber como mínimo 1 carácter para el ID de proveedor y el ID de aplicación. Si el primer carácter es ’%’ o ’&’. <afinidades-dinámicas> (opcional) Permite habilitar la aplicación para el soporte de afinidades dinámicas en lugar de utilizar la afinidad de Universal Agent estándar predeterminada. El texto debe estar precedido por el signo ‘arroba’ (@). Tivoli Universal Agent registra ″AB. Se trata de una palabra clave opcional para las afinidades dinámicas.″ y ″AB″ se visualiza en la columna Product del espacio de trabajo Estatus de sistemas gestionados. Las comas (. Utilice el parámetro ProductCode únicamente si desea asignar un valor ProductCode que no sea un valor predeterminado. Los otros 23 caracteres representan el ID de proveedor y el ID de aplicación. 2. AFFDEF Declara la afinidad. El siguiente ejemplo de una sentencia //APPL utiliza los tres parámetros de afinidad dinámica: //APPL NOTES AFFDEF=%IBM. delimitados por un punto. AFFSYMBOL Declara un símbolo asociado a la afinidad. Puede especificar los tres parámetros de palabra clave siguientes en una sentencia //APPL para definir la información de afinidad dinámica. Esta palabra clave es obligatoria para las afinidades dinámicas. Puede tener hasta 24 caracteres.) se convierten a espacios en el texto de ayuda. La cadena AFFTEXT tiene un límite de 256 caracteres y debe estar delimitada por comillas simples. El valor AFFSYMBOL tiene un límite de 31 caracteres y el conjunto válido es A-Za-z0-9 más el carácter de subrayado. De forma predeterminada. Notas: 1. 3. los 2 primeros caracteres del nombre de aplicación se almacenan en la columna Product de la tabla de estatus de nodo del servidor de supervisión. AFFTEXT Proporciona una cadena de texto más descriptiva para la afinidad. por ejemplo: //APPL MONITOR ProductCode=AB En lugar de registrar ″MO″ como el código de producto de 2 caracteres. Se permiten blancos intercalados.H D W M Q Y Por hora Diario Semanal Mensual Por trimestre Anual ProductCode (opcional) Especifica un código de producto de 2 caracteres que se asigna cuando la aplicación se registra con el servidor de supervisión. cuando una aplicación de Universal Agent se registra con el servidor de supervisión. Este valor de 2 caracteres se visible en la columna Product del espacio de trabajo Estatus de sistemas gestionados en Tivoli Enterprise Portal. entonces se trata como una afinidad dinámica. lo que indica una longitud mínima de 4 caracteres.

Sentencias de control de definición de datos 133 . Si se especifica un texto de ayuda que no está en inglés.4. Apéndice A. deberá guardar el metarchivo en codificación UTF-8.

Los parámetros están separados por un espacio. la sentencia //ATTRIBUTES y sentencias de definición de atributos individuales. Sintaxis //NAME <nombre-grupo-atributos> método [tiempo de vida] [<AddSourceName>] +[<AddTimeStamp>] [Interval=] [SkipNonNumeric=Y/N] [ClearValues=Y/N] [@<texto de ayuda>] Parámetros Los parámetros nombre-grupo-atributos. v Cada sentencia NAME debe ir seguida de la sentencia SOURCE asociada (si se precisa de alguna). Un nombre de grupo de atributos puede contener hasta 32 caracteres. <nombre-grupo-atributos> Especifica el nombre de un grupo de atributos. método y tiempo-de-vida son posicionales. lo que significa que más de un conjunto de valores de datos de atributos puede estar disponible para su uso. v Deberá haber al menos una sentencia NAME.Sentencia NAME Descripción Una sentencia NAME define el nombre de un grupo de atributos. Notas: 1. El nombre identifica un conjunto de definiciones de datos. y un máximo de 64. <método> Especifica la naturaleza de los datos. Un carácter no válido se sustituye automáticamente por un subrayado. Si no se designa ningún atributo como KEY. 2. Sólo se permiten caracteres ASCII. Los datos muestreados se comportan de la misma manera que los datos sondeados excepto en que los datos muestreados son acumulativos. incluidos letras. 3. Puede designar hasta cinco atributos en cada grupo como atributos clave. en un metarchivo. El mismo nombre de grupo de atributos no puede aparecer más de una vez en un único metarchivo. Los datos de suceso se producen de forma imprevisible y se informa de los mismos de forma asíncrona en cuanto los datos están disponibles. subrayados (_) y asteriscos (*). Sin embargo. Muestreado. Con clave. Los datos con clave se comportan de la misma manera que los datos muestreados. pero le permiten correlacionar sucesos. el método de recopilación de datos y el periodo durante el cual son válidos los datos. Se soportan los siguientes cuatro métodos: P Sondeado (predeterminado). 4. guiones (-). números. Este parámetro es obligatorio. deberá entrarlos en la secuencia mostrada anteriormente. Si se especifica. Suceso. puede utilizar el mismo nombre de grupo de atributos en metarchivos distintos. se presupone que el primer atributo del grupo es KEY. No puede utilizar espacios en blanco incorporados en el nombre. S E K 134 IBM Tivoli Universal Agent: Guía del usuario . Los datos sondeados están disponibles periódicamente y sólo la última fila de datos recopilada está disponible para la supervisión e informe de situaciones. El nombre de grupo de atributos lo utiliza Tivoli Enterprise Portal para nombrar el espacio de trabajo en el árbol de Navigator.

Este valor permite que Tivoli Universal Agent mantenga siempre una muestra actual de los datos. o posiblemente incluso datos con clave si alguno de los atributos funciona como clave exclusiva o como índice. una aplicación comprueba el estado del sistema como la utilización de la CPU y la velocidad del tráfico de red cada 30 segundos.Por ejemplo. <AddSourceName> (opcional) Ordena a Tivoli Universal Agent que añada automáticamente el atributo DataSourceName al grupo de atributos definido. 6. si hay nuevas muestras de datos cada minuto. deben definirse en el metarchivo como datos de suceso. No obstante. No obstante. Estos son datos sondeados o muestreados. el valor de TTL sirve un propósito adicional.. el estatus fuera de línea no se notifica a IBM Tivoli Monitoring hasta las 4:00 p. “Referencia de variables de entorno”. Asegúrese de que existe un equilibrio entre un valor de TTL lo suficientemente grande como para capturar los intervalos de situación o muestras de datos. Normalmente. Tivoli Universal Agent descarta los datos antes de que llegue la nueva muestra de datos y por lo tanto no tiene datos que evaluar. 2. El valor predeterminado de TTL es de 300 segundos. Para aplicaciones del proveedor de datos de socket. El mismo retraso basado en TTL se aplica a las aplicaciones que suministran datos a un proveedor de datos de servidor de API utilizando la llamada a la API. Este atributo contiene el nombre de host del Apéndice A. En este caso. 4. Por ejemplo. en la página 241 para obtener más información. Puede modificar este valor con la variable de entorno KUMA_MAX_EVENT_ENTRIES. 3. las 100 filas más recientes de datos de suceso también permanecerán en la memoria caché de Tivoli Universal Agent. Sentencias de control de definición de datos 135 . después de una desconexión entre el programa cliente de socket y el proveedor de datos de socket. TTL se especifica en segundos. Consulte el Apéndice G. Después del intervalo TTL. los datos se descartan o llega una nueva muestra. TTL determina el retraso antes de que el estatus de una fuente de datos pase de estar en línea a estar fuera de línea en Tivoli Enterprise Portal. las alertas de red o los mensajes de consola. Las filas de datos de suceso no son datadas y eliminadas como las filas de datos sondeados. un gran número de filas de datos recopilados permanecerán en la memoria caché de Tivoli Universal Agent. De forma predeterminada. El valor de TTL también es mayor que la frecuencia con la que se recopilan los nuevos datos para el grupo de atributos. dp_EndInput. el valor de TTL es importante para los datos de suceso en un metarchivo del proveedor de datos de socket. pero no tan grande tan grande como para que la utilización de memoria crezca porque las filas de datos antiguas no se estén eliminando. una aplicación de Tivoli Universal Agent suministra datos a IBM Tivoli Monitoring utilizando un socket de TCP y especifica un TTL de 30 minutos. Por ejemplo. En general. Notas: 1. Si el programa cliente cierra el socket y se desconecta del proveedor de datos a las 3:30 p. por parte de Tivoli Universal Agent. muestreados y con clave. puede especificar un valor de TTL de 90 segundos. Los datos muestreados están disponibles antes de que caduque su intervalo TTL publicado. si establece un valor de TTL demasiado alto.m. que se producen a intervalos imprevisibles. Si el valor de TTL es inferior al intervalo de disponibilidad de los datos. el valor de TTL en el metarchivo es mayor que el intervalo mayor de cualquier situación definida con respecto al grupo de atributos. se omite el valor de TTL para los datos de suceso. lo que provocaría un aumento en la utilización de memoria de los procesos. Los atributos clave se identifican como candidatos para la correlación si la diferencia entre la llegada de los últimos valores de datos y sus nuevos valores de datos es inferior al valor de TTL. el valor de TTL especificado en el metarchivo determina la cantidad de tiempo que la aplicación permanece en línea en Tivoli Enterprise Portal. <tiempo de vida (TTL)> (opcional) Define el intervalo de tiempo durante el que estarán disponibles los datos. 5. Para los datos con clave. Por el contrario. El mismo retraso basado en el valor de TTL se aplica a los datos de suceso en un metarchivo del proveedor de datos de servidor de API. para la visualización de espacios de trabajo y para la evaluación de situaciones.m.

Nota: El atributo DataSourceName siempre se añade al final de un grupo de atributos. los nuevos atributos que añada se insertan antes que el último atributo. este tipo de actualización de metarchivo constituye un cambio de versión de aplicación de menor importancia. Tivoli Enterprise Portal muestra esta indicación de la hora de 16 bytes en un formato MM/DD/AA HH:MM:SS. este tipo de actualización de metarchivo constituye un cambio de versión de aplicación de menor importancia. <AddTimeStamp> (opcional) Permite insertar un atributo de indicación de la hora. Especifica los milisegundos después del valor ss. Normalmente. SAAMMDDhhmmssuuu. lo que hace que Tivoli Universal Agent marque la actualización como un cambio de versión de aplicación de mayor importancia. Pero como LocalTimeStamp siempre está registrado como el último atributo. donde: S uuu Especifica el siglo. Tivoli Universal Agent genera dinámicamente durante el tiempo de ejecución un valor de atributo LocalTimeStamp para cada nueva fila de datos recopilada. Este es un punto importante a tener presente si actualiza un metarchivo para añadir uno o más atributos al final de un grupo de atributos existente que utiliza AddSourceName. Por ejemplo. En aquellos casos en los que los datos de entrada de la aplicación no incluyan un campo de atributo temporal. Este parámetro sólo se aplica a los metarchivos del proveedor de datos de script y de ODBC. tenga en cuenta que la siguiente sentencia está especificada en un metarchivo ODBC: //NAME EMPLOYEES K 300 Interval=60 136 IBM Tivoli Universal Agent: Guía del usuario . Por ejemplo: //NAME CUSTOMERDATA E AddTimeStamp Cuando se especifica este parámetro. si un programa cliente de socket se está ejecutando en un servidor PROD1 y conectándose a Tivoli Universal Agent en HQ1 y //APPL Sock se ha especificado en el metarchivo de socket. Pero como DataSourceName siempre está registrado como el último atributo. los nuevos atributos que ha añadido se insertan antes que el último atributo. y se omite en otros metarchivos del proveedor de datos. De forma predeterminada. Este es un punto importante a tener presente si actualiza un metarchivo para añadir uno o más atributos al final de un grupo de atributos existente que utiliza AddTimeStamp. Si prefiere el formato AAAA/MM/DD HH:MM:SS uuu. los sucesos de aplicación están relacionados frecuentemente con actividades de red específicas o con estatus de sistemas operativos. Utilice 1 para el siglo XXI. El ejemplo siguiente muestra cómo especificar AddTimeStamp=YearMonth en la sentencia NAME: //NAME CUSTOMERDATA E AddTimeStamp=YearMonth Nota: El atributo LocalTimeStamp siempre se añade al final de un grupo de atributos. lo que hace que Tivoli Universal Agent marque la actualización como un cambio de versión de aplicación de mayor importancia. Por ejemplo. Por ejemplo. Los datos de aplicación deben con frecuencia correlacionarse con otros datos basados en indicaciones de la hora. Interval (opcional) Especifica un intervalo de muestreo en segundos que se utiliza para la recopilación de datos de grupo de atributos. El formato siguiente es el formato de la indicación de la hora. el atributo DataSourceName tiene un valor de PROD1:SOCK00.nodo desde el que se originan los datos. Normalmente. especifique AddTimeStamp=YearMonth en la sentencia NAME y Tivoli Universal Agent generará un atributo de 24 bytes LocalTimeStamp. Tivoli Universal Agent soporta la inserción automática de una atributo LocalTimeStamp cuando el parámetro AddTimeStamp se incluye en a sentencia NAME. La presencia de un parámetro Interval=nn en un metarchivo de ODBC o de script significa que se utiliza la recopilación a intervalos.

ClearValues (opcional) Si falta algún valor de atributo en una fila de datos para un grupo de atributos Sondeado o Muestreado. y se accede a los datos del espacio de trabajo con poca frecuencia. se omitirá toda la fila.sh . El valor de intervalo mínimo permitido es de 30 segundos. Si hay muy pocas. y si existe alguna fila de datos que contenga un carácter no numérico en el atributo Attr2. El comportamiento predeterminado de IBM Tivoli Universal Agent es grabar un cero en un atributo numérico cuando se detectan datos no numéricos. Sentencias de control de definición de datos 137 . como por ejemplo C o G. un mandato de recopilación de datos que tarda más de 15 segundos en completarse muestra un espacio de trabajo vacío o un conjunto parcial de filas de datos. los valores de los mismo atributos procedentes de la fila de datos Apéndice A. se habilita la recopilación de datos bajo demanda. Por ejemplo. un grupo de atributos bajo demanda ahorra la sobrecarga del sistema al no ejecutar el mismo script. el subproceso de supervisión para el grupo de atributos EMPLOYEES se activa cada 60 segundos y emite el mandato Select de SQL para recopilar datos. “Definiciones de atributos”. sentencia Select de SQL o procedimiento almacenado a un intervalo fijo incluso cuando no exista la necesidad de recopilar los datos. Si se establece en un valor entre 1 y 29. tenga en cuenta lo siguiente: (1) cuánto tiempo suele tardar en completarse un mandato de recopilación de datos y (2) el número y la frecuencia de situaciones y accesos al espacio de trabajo para el grupo de atributos.Si la sentencia de la línea anterior se ha especificado en un metarchivo ODBC. Consulte el Apéndice B. Bajo demanda quiere decir que los datos sólo se recopilan cuando se produce un intervalo de situación para el grupo de atributos o cuando se emite un mandato de apertura o renovación de un espacio de trabajo de Tivoli Enterprise Portal para el grupo de atributos. especifique siempre un parámetro Interval=nn. en la página 169 para obtener más información acerca de los tipos de atributos soportados. y desea que se omitan las filas de datos recopiladas si contienen un valor no numérico en cualquier atributo numérico.sh //ATTRIBUTES Attr1 D 32 Attr2 C 999999 Attr3 D 16 A medida que el proveedor de datos de script procesa las filas de salida del script monitor. //NAME Process K 300 Interval=60 SkipNonNumeric=Y //SOURCE SCRIPT /home/myscripts/monitor. Pero si el número de situaciones y accesos a espacios de trabajo es bastante alto. Nota: La combinación de recopilación de datos bajo demanda y grupos de atributos invisibles no está soportada (consulte “Grupos de atributos invisibles” en la página 138 para obtener más información). Si se mote el parámetro Interval en la sentencia NAME para un grupo de atributos de ODBC o de Script o si se especifica Interval=0. se reasigna automáticamente a 30. pero no omitir toda la fila. entonces la recopilación bajo demanda es más eficaz porque significa que un ciclo de recopilación de datos puede satisfacer varias evaluaciones de situaciones y se pueden producir accesos a espacios de trabajo durante el intervalo de tiempo especificado. Por consiguiente. En un metarchivo del proveedor de datos de ODBC o de Script con un primer grupo de atributos invisible. La recopilación bajo demanda es una buena opción para el grupo de atributos que se utiliza poco. A la hora de decidir si un grupo de atributos de ODBC o de Script utiliza la recopilación de bajo a intervalos o bajo demanda. Las solicitudes de informes bajo demanda tienen un valor de tiempo de espera excedido de 15 segundos (nota: este valor se puede modificar con la variable de entorno KUMA_REPORT_REQUEST_EXPIRATION). Si el script. la recopilación bajo demanda es una buena opción porque significa que el usuario no tiene que esperar mucho tiempo a que se visualicen filas de datos del espacio de trabajo de Tivoli Enterprise Portal. sentencia Select de SQL o procedimiento almacenado pueden finalizar con rapidez. SkipNonNumeric (opcional) Especifique SkipNonNumeric=Y en la sentencia NAME si el grupo de atributos contiene tipos de atributo. o ninguna situación definida contra dicha opción.

La finalidad de un grupo de atributos invisible es recopilar datos puros. se muestra un metarchivo de proveedor de datos de socket que ilustra cómo se podría utilizar un grupo de atributos invisible: //APPL EXAMPLE //NAME ~RawSocketData E 300 //SOURCE SOCK HostX 138 IBM Tivoli Universal Agent: Guía del usuario . El texto debe estar precedido por el signo ‘arroba’ (@). Notas: 1. Si falta algún valor de atributo en la fila de datos actual. 3. resumir y manipular los datos de diferentes maneras para proporcionar información más significativa. a continuación. Al definir un grupo de atributos como invisible.anterior se traspasan a la fila de datos actual. El grupo de atributos invisible se oculta desde un punto de vista exterior. especifique ClearValues=N. Anteponga al nombre del grupo de atributos un símbolo de tilde (~) para hacerlo invisible. si desea sustituir los valores de atributo anteriores por valores que faltan en la fila de datos actual. puede ocultar las definiciones de atributos y espacios de trabajo innecesarios. Utilice la función de grupo de atributos invisibles junto con una sentencia //INTERNAL OUTPUT. deberá guardar el metarchivo en codificación UTF-8. Consulte “Sentencia INTERNAL” en la página 150 para obtener más información. Las comas (. que es válido para los cuatro tipos de grupos de atributos. Tivoli Enterprise Portal y del usuario final. Grupos de atributos invisibles La sentencia NAME proporciona soporte para grupos de atributos invisibles. y no se pueden definir situaciones para él. <texto de ayuda> (opcional) Define el texto de ayuda de este grupo de atributos. como por ejemplo. Siempre borran todos los valores de atributo anteriores antes de llenar una fila de datos nueva.running)} JOB D 12 USER D 12 PERCENT C 999999 El parámetro ClearValues=Y no es necesario para los grupos de atributos de suceso y por clave porque borran de forma predeterminada los valores anteriores. por ejemplo: //NAME RUNNINGQUEUE S 300 ClearValues=Y //INTERNAL INPUT QUEUEDATA //ATTRIBUTES QUEUE D 8 STATUS D 16 +FILTER={SCAN(0. 4. Un grupo de atributos invisible no forma parte de la aplicación del cliente desde la perspectiva del servidor de Tivoli Enterprise Monitoring. Si desea que un grupo de atributos sondeado o muestreado se comporte como los grupos de atributos de suceso y por clave. No hay ningún espacio de trabajo de Tivoli Enterprise Portal para el grupo de atributos invisible. Si se especifica un texto de ayuda que no está en inglés. Observe que los grupos de atributos de suceso (E) y con clave (K) no presentan este comportamiento. Y viceversa.) se convierten a espacios en el texto de ayuda. especifique ClearValues=Y en la sentencia NAME. datos de un programa cliente de archivo o de socket y. El texto no debe superar los 230 caracteres. 2. Por ejemplo: //NAME ~INPUTDATA S 600 A continuación. se asigna un valor predeterminado de acuerdo con el tipo de atributos que se describe en la Tabla 25 en la página 171. redirigir los datos a otros grupos de atributos visibles en el mismo metarchivo donde se pueden filtrar. que es la razón por la que ocasionalmente se ve un valor de atributos anterior sustituido por un valor que falta en un espacio de trabajo.

Error)} Message Z 512 * //NAME WARNINGS E 300 //INTERNAL INPUT RAWDATA //ATTRIBUTES ’ ’ Date D 8 Time D 8 LogFile D 20 DLM=’(’ Code D 20 DLM=’)’ Severity D 30 DLM=’:’ +FILTER={MATCH(0. desea crear dos grupos de atributos separados para la visualización de espacios de trabajos: ERRORS y WARNINGS. mientras que otros contienen ″Aviso″. Determinados registros enviados por el programa cliente de socket contienen ″Error″ en el atributo Gravedad.Warning)} Message Z 512 En este ejemplo. Al designar el grupo de atributos RawSocketData como invisible. Sentencias de control de definición de datos 139 . los dos grupos de atributos redirigidos pueden aplicar filtros diferentes para organizar y presentar los datos de un modo más significativo. Apéndice A. A continuación. su única finalidad es leer en todos los datos de entrada de socket.//INTERNAL OUTPUT RAWDATA //ATTRIBUTES ’ ’ RawData D 1024 * //NAME ERRORS E 300 //INTERNAL INPUT RAWDATA //ATTRIBUTES ’ ’ Date D 8 Time D 8 LogFile D 20 DLM=’(’ Code D 20 DLM=’)’ Severity D 30 DLM=’:’ +FILTER={MATCH(0.

Si se especifican. v La sentencia SOURCE no es necesaria para los metarchivos de API y SNMP. La excepción es cuando hay varias sentencias //SOURCE SOCK y cada una especifica un nombre de host diferente. <ubicación>. No obstante. <tipo> Especifica el formato de la fuente de datos. si se omite la sentencia SOURCE. Los parámetros de la sentencia SOURCE restantes utilizan un formato palabra_clave=<valor> y se pueden colocar en cualquier orden después de los parámetros de posición. <intérprete-script>. SCRIPT Indica que la fuente de datos es un script o programa local. Por ejemplo. deberá proporcionar un parámetro de intérprete de script antes de entrar el nombre de Indica que la fuente de datos en un archivo de local. v Cada sentencia SOURCE especifica una fuente. <intérprete-script> (opcional) Para fuentes del tipo SCRIPT. debe ir inmediatamente a continuación de la sentencia NAME. el programa cliente de socket debe enviar un registro de asociación de aplicación explícito que identifica el metarchivo correspondiente. Algunos ejemplos de intérpretes de script son Perl. especifica el programa intérprete de script necesarios para ejecutar el script. SNMP Indica que la fuente de datos es un agente SNMP. <argumentos-script>. v No se pueden combinar tipos diferentes de sentencias SOURCE en el mismo metarchivo.Sentencia SOURCE Descripción La sentencia SOURCE define la ubicación y las características de los datos que se están recopilando. v La sentencia SOURCE no es necesaria para los metarchivos de socket que sólo tienen un grupo de atributos. SOCK Indica que la fuente de datos es un script o programa cliente de socket. TRAP Indica que la fuente de datos es la tabla SNMP-MANAGER TRAP. <tipo-código>. 140 IBM Tivoli Universal Agent: Guía del usuario . si tiene una fuente de archivo de registro y una fuente de script. REXX y VBScript. <modalidad-archivo>. FILE ODBC Indica que la fuente de datos es una tabla relacional. v Cuando se especifica la sentencia SOURCE. deben definirse en dos metarchivos distintos. v Como norma. deben colocarse en la secuencia que se muestra arriba en la sección Sintaxis. <número-de-registros-archivo> y <método-comparación-archivos> son de posición. Si el proveedor de datos de script no puede encontrar el programa intérprete durante el tiempo de ejecución. Sintaxis //SOURCE <tipo> [<intérprete-script>] <ubicación> [<argumentos-script>] [<tipo-código>] [<modalidad-archivo>] [<número-de-registros-archivo>][<método-comparación-archivos>] [User=] [Pswd=] [Database=] [Server=] [Maxrows=] [Locale=] [Codepage=] [Envfile=] [Runtime=] [Interval=] [SetSourceName=Y/N] [RunOnce=Y/N] [Hostaddr=] [Hostinfo=] [ManagedSystemName=] Parámetros Los parámetros <tipo>. sólo puede tener una sentencia SOURCE por cada sentencia NAME a no ser que utilice el parámetro ManagedSystemName para identificar exclusivamente a cada una de las diversas sentencias SOURCE que se asocian con un grupo de atributos.

exe’ myscript. sp2n03[4500] identifica una fuente de datos del host sp2n03. – Si se especifica un nombre de host pero no se puede resolver en una dirección. La función de nombre de archivo dinámico. no es posible hacer una sustitución de los parámetros simbólicos o variables en el nombre de archivo. – Es más conveniente especificar ″localhost″ para designar que el cliente de socket se ejecuta en el mismo sistema que el proveedor de datos de socket. rodee el nombre de archivo de comillas simples. – Como regla.archivo de script en el campo <ubicación>. – Si el nombre de fuente de datos contiene cualquier espacio en blanco. El parámetro {LOCALHOST} que sustituye el nombre de host local en el nombre de archivo. Consulte “Soporte de nombres de archivo dinámicos” en la página 46 para obtener información adicional. Por ejemplo. – Si se omite el número de puerto.inv tail – Si un nombre de archivo calificado al completo contiene cualquier espacio en blanco incorporado. – El nombre de archivo supervisado calificado al completo se puede especificar utilizando la letra de unidad o un nombre de vía de acceso absoluto. Sentencias de control de definición de datos 141 . por ejemplo: //SOURCE FILE /opt/IBM/ITM/logs/{LOCALHOST}_um. que permite especificar un patrón de nombre de archivo. En general. //SOURCE SCRIPT ’C:\Archivos de programa\ObjREXX\rexx. – El nombre de archivo puede ser sensible a mayúsculas y minúsculas en algunos sistemas operativos. – Ya debe estar configurada en el applet de fuentes de datos ODBC en el sistema operativo Windows donde se ejecuta el proveedor de datos de ODBC. puerto 4500. seguido opcionalmente por un número de puerto. se asumirá que el primer programa cliente de socket que se conecte desde la ubicación del host especificado. el número de puerto sólo es necesario si hay varios programas clientes de socket conectándose desde el mismo host a la misma aplicación de metarchivo. sin tener que actualizar el parámetro de ubicación //SOURCE SOCK en cada uno. por ejemplo: //SOURCE SOCK localhost El uso de localhost permite implementar el mismo metarchivo de socket exacto en varios sistemas Universal Agent. por ejemplo: //SOURCE FILE |$SYSTEMROOT|\WindowsUpdate. No puede haber ningún espacio en blanco entre el valor de host y el número de puerto. v Para las fuentes de tipo ODBC. Si la vía de acceso completa del intérprete de script contiene cualquier espacio en blanco incorporado. Las siguientes excepciones se aplican a esta regla: 1. 2. Por ejemplo. rodéelo lo de comillas simples. Apéndice A.rex <ubicación> v Para los tipos de archivos FILE. – Si el archivo supervisado existe en un directorio distinto de aquel donde se encuentra el archivo binario del proveedor de datos de archivo.log tail 3. o bien puede especificar el nombre de archivo Convenio universal de nomenclatura (UNC). utilizando la sintaxis |$var_ent|. La inclusión de una o más variables de entorno. deberá calificar al completo el nombre de archivo. se omite la sentencia SOURCE. Debe escribir el nombre completo de archivo. v Para aquellas fuentes del tipo SOCK. la <ubicación> es la dirección decimal separada por puntos de Internet o un nombre de host que pueda resolverse. Especifique el nombre de acuerdo con los requisitos del sistema local donde se está ejecutando el proveedor de datos de archivo. <ubicación> es el nombre de archivo. <ubicación> es el nombre de la fuente de datos. rodéelo de comillas simples. del script o programa cliente de socket que esté funcionando como fuente de datos.

vbs "/S mihost /U miIDusuario" De forma predeterminada.exe listfreespace. pero no se puede resolver en una dirección.bat "arg1 arg2" Interval=60 – Si el nombre de archivo calificado al completo contiene algún espacio en blanco. Deberá rodear todo el conjunto de argumentos del script en comillas dobles inmediatamente después del nombre de archivo del script. <argumentos-script> (opcional) Para aquellas fuentes del tipo SCRIPT. cada señal separada por un espacio en blanco dentro de las comillas dobles se trata como un argumento independiente. el sistema gestionado seguirá registrándose y visualizándose en el árbol de Navigator. – El nombre de archivo supervisado calificado al completo se puede especificar utilizando la letra de unidad o un nombre de vía de acceso absoluta. como en el siguiente ejemplo: //SOURCE SCRIPT |$SYSTEMROOT|\scan. – Deberá calificar al completo el archivo de script si no existen en el directorio de scripts de Tivoli Universal Agent. recopila los mismos datos de aplicación MIB de 10 servidores diferentes en la red y desea registrar 10 sistemas gestionados distintos (que incluyen el nombre de host del servidor específico) y visualizarlos en el árbol de Navigator. colóquelas entre comillas simples. utilizando la sintaxis |$env_var|. donde se ejecuta el agente SNMP. Registrar un sistema gestionado separado puede resultar útil si. <ubicación> es el nombre de archivo de script – El nombre de archivo de script es sensible a mayúsculas y minúsculas en algunos sistemas operativos. Si necesita agrupar una o más señales separadas por espacios en blanco en un argumento. – El nombre de archivo de script puede incluir una o más variables de entorno. <ubicación> es la dirección IP decimal con puntos o un nombre de host que puede resolverse. independientemente de cuántos agentes SNMP se están sondeando para dicha aplicación determinada. Especifique el nombre de acuerdo con los requisitos del sistema local donde se está ejecutando el proveedor de datos de script. el proveedor de datos de SNMP registra un sistema gestionado separado que empieza por el valor nombrehost.sh "aaa bbb ’ccc ddd’" <tipo-código> (opcional) Especifica una de las siguientes representaciones de caracteres de los datos fuente. – Si se incluye la sentencia //SOURCE SNMP nombrehost y actualmente no recopila datos MIB de dicho host de agente SNMP. v Para fuentes de tipo SNMP. o bien puede especificar el nombre de archivo de script utilizando el Convenio universal de nomenclatura (UNC). como en el ejemplo siguiente: //SOURCE SCRIPT monitor. //SOURCE SCRIPT cscript. Si incluye esta sentencia. La única razón por la que se utiliza es personalizar cómo se registran las aplicaciones SNMP con el servidor de supervisión y cómo se visualizan en el cliente del portal. – La sentencia //SOURCE SNMP nombreshost es opcional en los metarchivos SNMP. por ejemplo. pero el espacio de trabajo de aplicación asociado está vacío. – Si se omite la sentencia //SOURCE SNMP nombrehost. 142 IBM Tivoli Universal Agent: Guía del usuario . El valor predeterminado es ASCII. utilizando el formato nombrehost:NombreAplicVV. especifica uno o más argumentos que pasar al script. rodee el nombre de archivo de comillas simples.v Para las fuentes de tipo SCRIPT. se utiliza el convenio de nomenclatura del sistema gestionado predeterminado para las aplicaciones de metarchivo SNMP. Por ejemplo. – Si se especifica nombrehost. se omite la sentencia SOURCE. para la sustitución en tiempo de ejecución. que registra un sistema gestionado del formato NombreHostLocal:NombreAplicVV.

En cada intervalo de muestreo. Si el contenido del archivo no se aprueba. se comprueba el número total de registros en cada intervalo de muestreo para determinar cuando se añaden nuevos registros. En su lugar. El parámetro <tipo-código> sólo es válido para el tipo de fuente SOCK. los datos no aparecerán en Tivoli Enterprise Portal.rst donde: <NombreAplic> Especifica el valor de la sentencia del metarchivo //APPL. TAIL Indica que el archivo es acumulativo. pero que se mantiene un archivo de reinicios en el directorio de trabajo de Tivoli Universal Agent. COPY Indica que debe procesarse el archivo en modalidad de bloque. Como alternativa al suministro de un valor de <tipo-código>. //SOURCE SOCK MVSA CODEPAGE=ibm-37_P100-1995 <modalidad-archivo> (opcional) Especifica la modalidad de copia COPY. Consulte “Espacio de archivo preasignado” en la página 49 para obtener información adicional sobre los tipos de archivos que conviene utilizar con TailByRecord. TAILBYRECORD. TAIL. Cada vez que se sondea o muestrea el archivo. La modalidad de copia no es válida para el tipo de datos de suceso. <NombreFuente> Especifica el nombre del sistema gestionado asociado con la fuente de datos de archivo. Por ejemplo. TAILRESTART Indica que debe supervisarse el archivo en modalidad TAIL. la modalidad TAIL es el valor predeterminado. 3. 2. <NombreTabla> Especifica el valor en la sentencia //NAME del metarchivo. Apéndice A. se lee el contenido completo del archivo como varias filas de datos. Para garantizar la exclusividad. Se ignora para el resto de tipos de fuente. puede especificar “E” para EBCDIC o la página de códigos predeterminada del sistema principal.A E ASCII EBCDIC Notas: 1. TAILRESTARTFROMTOP o TAILBYCOUNT. La modalidad de copia requiere que el archivo supervisado tenga un mínimo de dos filas de datos porque funciona en modalidad de bloque y necesita un registro inicial y otro final. TAILBYRECORD Indica que el archivo es acumulativo pero que la marca de final de archivo no cambia. Si no se especifica este parámetro. el nombre de archivo de reinicio utiliza el siguiente convenio de nomenclatura: <NombreAplic>_<NombreTabla>_<NombreFuente>. también puede especificar un parámetro CODEPAGE en la sentencia SOURCE SOCKu Por ejemplo. se volverán a entrar los mismos registros de archivo. Esta modalidad no es tampoco apropiada para el tipo de datos con clave ya que anula el comportamiento de correlacionar filas de datos de los datos con clave. Si el <tipo-código> de la fuente difiere de la representación de datos donde se ejecuta el proveedor de datos de socket. Sentencias de control de definición de datos 143 . En caso contrario. el proveedor de datos convierte los datos de aplicación que recibe en la representación del sistema local. sólo los registros nuevos añadidos al final del archivo se procesan como entrada. TAILRESTART. si el programa cliente de socket se está ejecutando en una plataforma EBCDIC OS/390.

Utilice TailRestart si está supervisando un archivo crítico. lo que hace que la supervisión se reinicie desde el principio del archivo. En este caso. como un registro de transacciones o de auditoría. Dichos registros se procesan como si se hubiesen acabado de añadir al final del archivo. y es vital que no pierda ningún registro de archivo. Y viceversa. no se utilizará el archivo de reinicio ya que las discrepancias indican que el archivo supervisado se ha alterado y. especifique el parámetro CompareBySize como el <método-comparación-archivos>. Si el tamaño ha aumentado. lo que implica una sobrecarga adicional del sistema.Cada vez que se añaden nuevos registros al archivo supervisado y su tamaño de archivo aumenta. por lo que TailRestart probablemente no sea una buena elección en todos los casos de supervisión de archivos. se está indicando que desea que el proveedor de datos de archivo maneje una discrepancia detectada durante el arranque. Si hay un par de archivos en un directorio que cumple un criterio de patrón determinado. El proveedor de datos del archivo utiliza este parámetro para contar hacia atrás el <número-de-registros-archivo> desde el final del archivo. y si siempre desea supervisar el mayor de los dos archivos. Deberá utilizar un entero entre 1 y 5000 para este parámetro. TAILBYCOUNT Indica que debe supervisarse el archivo en modalidad TAIL. fecha de creación del archivo y la hora de la última modificación. cada nuevo registro añadido al archivo supervisado requiere que la entrada y la salida reinicien el archivo. Nota: Para TailRestart. TAILRESTARTFROMTOP Idéntico TailRestart excepto en que maneja las discrepancias cuando comienza la supervisión de archivo. el proveedor de datos de archivo procesa el delta entre los dos tamaños como si los registros se hubiesen añadido mediante un proceso de TAIL corriente. por lo tanto. Si se detiene y vuelve a iniciar la supervisión del archivo por cualquier motivo. se crea un nuevo archivo de reinicio y se activa la modalidad TailRestart normal. Indica el número de registros de archivo anteriores a procesar cuando comience la supervisión del archivo. el proveedor de datos de archivo compara el tamaño de archivo actual con el valor del tamaño almacenado en el archivo de reinicio. incluso si se recicla Tivoli Universal Agent. Si se especifica TailRestartFromTop. si siempre 144 IBM Tivoli Universal Agent: Guía del usuario . Los siguientes son dos ejemplos de discrepancias: v El nombre del archivo o la fecha de creación del archivo han cambiado v El tamaño de archivo actual es menor que el tamaño almacenado en el archivo de reinicio v La hora de la última modificación es anterior a la hora de la última modificación almacenada en el archivo de reinicio Si se identifica alguno de estos tipos de discrepancias en la modalidad TailRestart. Una discrepancia se define como una divergencia entre la información actual acerca del archivo supervisado y la información almacenada en el archivo de reinicio. Este parámetro debe ir seguido del parámetro <número-de-registros-archivo>. el proveedor de datos de archivo almacena el valor del tamaño actualizado en el archivo de reinicio junto con el nombre del archivo. <número-de-registros-archivo> (opcional) Sólo válidos para aquellas fuentes de tipo FILE que estén utilizando la modalidad TailByCount. pero que deben procesarse un número fijo de registros anteriores cuando se inicie la supervisión del archivo. <método-comparación-archivos> (opcional) Sólo es válido para fuentes de tipo FILE que utilizan la función de nombre de archivo dinámico. el proveedor de datos de archivo no puede tener certeza de la exactitud de la información del archivo de reinicio. como una conmutación de archivo.

Este cambio requiere que se reinicie un sistema Universal Agent.desea supervisar el archivo actualizado más recientemente de los dos archivos. //SOURCE ODBC teps2 user=Admin pswd=xyz maxrows=1000 Si se devuelven más filas del límite de maxrows de la sentencia Select de SQL del metarchivo. Este parámetro sólo es necesario si la base de datos/servidor de conexión predeterminada no es apropiada para las tablas de usuario a las que desea acceder. Si se han definido varios ID de usuarios en la fuente de datos de ODBC. Debe anteponer al parámetro pswd= un parámetro user=. Proporcione este parámetro si desea conectarse a un contexto de base de datos distinto del predeterminado. Este parámetro sólo es válido para los tipos de fuente ODBC y SCRIPT. v Utilice KUMP_ODBC_MAX_ROWS para cambiar el valor de maxrows globalmente para que maxrows se lo suficientemente grande para manejar el número de filas devueltas. El parámetro maxrows= sólo es válido para el tipo de fuente ODBC. La desventaja de aumentar maxrows a un número muy superior para manejar grandes volúmenes de datos de tablas SQL devueltos es la mayor sobrecarga del sistema causada por almacenar todas esas filas en la memoria de Universal Agent hasta que el valor de tiempo de vida haya Apéndice A. Pswd= (opcional) Especifica la contraseña a utilizar con el parámetro user= asociado cuando se esté conectando con la fuente de datos de ODBC o ejecutando el script. Este parámetro sólo es válido para el tipo de fuente ODBC y se ignora para el resto de tipos de fuente. //SOURCE ODBC SAMPLE user=db2admin pswd=tivoli Database= (opcional) Indica un contexto de base de datos específico para que los parámetros user= y pswd= se conecten. Este parámetro sólo es válido para el tipo de fuente ODBC y se ignora para el resto de tipos de fuente. Se ignora para el resto de tipos de fuente. sólo se utilizarán las primeras filas <nnn> hasta alcanzar dicho límite para la visualización de espacios de trabajo y la evaluación de situaciones. Maxrows= (opcional) Especifica el número máximo de filas procesadas por el proveedor de datos de ODBC después de ejecutar la sentencia Select o procedimiento almacenado listado en la sentencia //SQL. Si tiene una situación con respecto a una tabla de ODBC que no se está activando cuando debería. El siguiente ejemplo le dice al proveedor de datos de ODBC que procese hasta 1000 filas para este grupo de atributos. Este parámetro sólo es necesario para aquellos productos de base datos que soporten con varias asociaciones de bases de datos para una única fuente de datos. puede que signifique la fila o filas que hacen que la situación se active vienen después del límite de maxrows. Se ignora para el resto de tipos de fuente. El valor predeterminado de maxrows= es 100. Puede hacer un cambio global con la variable de entorno KUMP_ODBC_MAX_ROWS. v Utilice una cláusula Where más calificada en la sentencia Select de SQL para que el número de filas devueltas se ajuste al límite de maxrows actual. Este parámetro sólo es válido para los tipos de fuente ODBC y SCRIPT. Consulte “Soporte de nombres de archivo dinámicos” en la página 46 para obtener información adicional. El siguiente es un ejemplo que utiliza el parámetro database=: //SOURCE ODBC teps2 user=db2admin pswd=tivoli database=pubs Server= (opcional) Especifica el nombre del servidor utilizado con el parámetro database= asociado. Se ignora para el resto de tipos de fuente. especifique el parámetro CompareByLastUpdate. Sentencias de control de definición de datos 145 . seleccione un ID de usuario con suficiente autoridad como para realizar las selecciones de tabla especificadas en la sentencia //SQL. Por ejemplo. User= (opcional) Especifica un ID de usuario que conecta la fuente de datos de ODBC o ejecuta el script. Las siguientes son soluciones posibles a este problema: v Aumente el valor de maxrows para dicha tabla en particular utilizando maxrows=<nnn>. Es un punto importante a recordar.

si el proveedor de datos de socket se está ejecutando en un sistema que no es japonés. Se ignora para el resto de tipos de fuente. pero recibe datos de un programa cliente de socket ejecutándose en un sistema japonés. No es necesario especificar el valor en ambos lugares Codepage= (opcional) Permite especificar que la fuente de datos en la sentencia SOURCE está proporcionando datos en una página de códigos distinta de la página de código predeterminada del sistema donde se está ejecutando Tivoli Universal Agent. Algunos valores típicos de Codepage son UTF-16BE. Por ejemplo. Locale= (opcional) Permite especificar que la fuente de datos en la sentencia SOURCE está proporcionando datos en un idioma distinto del idioma predeterminado del sistema en el que se está ejecutando Tivoli Universal Agent. el proveedor de datos de script lee el contenido de envfile en la memoria y pasa los valores de configuración de la variable de entorno al proceso del script Antes de cada ejecución del script. ISO-8859-15. US o JP. windows-1252 y ibm037. es necesario encontrar un equilibro entre establecer maxrows lo suficientemente alto como para procesar todas las filas que sean de interés y también lo suficientemente bajo como para no colocar una carga innecesaria sobre la memoria y la CPU en Universal Agent. el proveedor de datos de script comprueba la indicación de la hora de la última modificación de envfile. De acuerdo con el estándar Unicode>.im=INPUT-METHOD-NAME El valor de <Codepage> en el parámetro Locale= es similar al parámetro Codepage= en la sentencia SOURCE. sólo es necesario especificar el <Territorio_Idioma> en el parámetro Locale.caducado. El parámetro envfile= sólo es válido para el tipo de fuente SCRIPT. GB-2312. Por ejemplo. Por ejemplo. Si se ha modificado. ISO-8859-15.bat "/temp 10" envfile=C:\endpoint9001. En general. Por ejemplo.Codeset@Modifiers donde: <Idioma> Especifica el código de idioma de dos o tres caracteres. Opcionalmente puede proporcionar el valor de Codeset@Modifiers para indicar el conjunto de caracteres codificados a utilizar junto con una o mas de los modificadores de palabras_clave=<valor. los valores de entorno local se especifican de la siguiente manera: <Idioma>_<Territorio>. y utiliza los valores de la nueva variable de entorno para la ejecución del script siguiente. El siguiente es un ejemplo de la codificación de envfile: //SOURCE SCRIPT 79001.env La primera vez que se va a ejecutar un script. puede modificar el contenido de envfile mientras el script está activo y los cambios se incluirán en la siguiente ejecución del script sin que sea necesario renovar el metarchivo o reciclar Tivoli Universal Agent. puede especificar lo siguiente: //SOURCE SOCK Host1 locale=ja_JP codepage=ibm-943_P15A-2003 Envfile= (opcional) Permite especificar una o más variables de entorno a establecer cuando se ejecuta un script. <Territorio> Especifica el código de región o país. Como envfile se comprueba antes de cada ejecución del script. En caso contrario se utilizarán los valores leídos anteriormente. en o ja. Por lo tanto. 146 IBM Tivoli Universal Agent: Guía del usuario . el proveedor de datos de script vuelve a leer el contenido de envfile en la memoria.

se supone que la ubicación predeterminada es el directorio de script en Tivoli Universal Agent. utilice la especificación Interval en la sentencia NAME. Especifique el nombre de archivo de acuerdo con los requisitos del sistema local en el que se esté ejecutando el proveedor de datos de script. 6. Sentencias de control de definición de datos 147 . ENDPOINT_CLASS=ENDPOINT LCF_DATDIR=C:\endpoint\dat LCF_BINDIR=C:\endpoint\bin\w32-ix86\mrt Runtime= (opcional) Permite asignar tiempo adicional de ejecución a un script de larga ejecución. también deberá ajustar el parámetro Interval=nnn de forma acorde. El parámetro Runtime= sólo es válido para el tipo de fuente SCRIPT. Sólo debe especificar habitualmente este parámetro si tiene varias sentencias //SOURCE SCRIPT o //SOURCE ODBC codificadas para un sólo grupo de atributos. el valor de SOURCE tiene preferencia. Si el nombre de envfile calificado al completo contiene cualquier espacio en blanco. SetSourceName=Y/N (opcional) Si se establece en Y (Sí). De lo contrario. una por línea. 4. Interval= (opcional) Permite especificar el intervalo de muestreo en segundos que se utiliza para la recopilación de datos del grupo de atributos. Las variables de entorno establecidos en envfile sólo se aplican al proceso de script iniciado. para que el valor de Interval del script sea mayor o igual al valor de Runtime. Las variables de entorno se codifican en el archivo envfile en una serie de sentencias VARIABLE=<valor>.Notas: 1. //SOURCE ODBC testSource Interval=120 El propósito del parámetro Interval en la sentencia SOURCE es alterar temporalmente el parámetro Interval en la sentencia NAME. si existe una configuración especial de PATH que el script necesite. rodee el nombre de archivo de comillas simples. Por ejemplo. Por ejemplo. el proveedor de datos de script otorga a un script un máximo de 60 segundos solamente en completarse. En el siguiente ejemplo se muestra cómo codificar el parámetro Runtime: //SOURCE SCRIPT avail_media. El nombre de envfile es sensible a mayúsculas y minúsculas en algunos sistemas operativos. no afecta al valor de PATH del proceso de Tivoli Universal Agent. Por ejemplo. El proveedor de datos de script no espera ningún convenio de nomenclatura. Además. Si a veces un script tarda más de 60 segundos en finalizar una ejecución típica. 5. indica que el programa cliente de socket altera temporalmente la parte del nombre de host del sistema gestionado cuando el programa cliente de Apéndice A. 3. Este parámetro sólo es válido para los metarchivos del proveedor de datos de script y de ODBC. donde nnn es el número de segundos. Si se especifica el parámetro Interval en las sentencias NAME y SOURCE. podrá añadirla al archivo envfile para dicho script y no alterar así el valor de PATH de otros scripts que se estén ejecutando. El valor de intervalo mínimo permitido es de 30 segundos. Este parámetro se ignora para los otros tipos de fuente. De forma predeterminada.sh Runtime=200 Interval=300 Tenga presente que si establece un valor de Runtime en más de 60 segundos. Puede utilizar cualquier nombre o extensión de archivo para el nombre de envfile. Cualquier script que exceda el límite de tiempo de 60 segundos termina para impedir una acumulación gradual de procesos de script que se encuentran en un bucle sin fin o una espera indefinida. 2. puede otorgar al script tiempo adicional especificando un parámetro Runtime=nnn. utilizando un valor exclusivo ManagedSystemName para cada una y desea implementar un intervalo de muestreo diferente para cada fuente de datos. Si el nombre envfile se especifica sin información completa de nombre de vía de acceso.

para utilizar el nombre de host de un programa cliente de socket remoto como el valor HOSTADDR registrado. Se ignora para el resto de tipos de fuente. La columna HOSTADDR suele contener el protocolo de comunicaciones y la dirección de red del agente que ha registrado el sistema gestionado.25.118.″ (Nota: la lista de nombres de plataformas soportados se puede encontrar en el archivo osnames que está instalado con Tivoli Enterprise Portal Server). Se ignora para el resto de tipos de fuente. El servidor del portal utiliza HOSTADDR y Tivoli Enterprise Console para ayudar a identificar el agente que está asociado a un sistema gestionado específico. Sin embargo. Normalmente. De forma predeterminada. HostAddr= (opcional) Cada sistema gestionado registrado incluye información HOSTADDR. Este parámetro sólo es válido para el tipo de fuente SOCK. basándose en el valor de TTL especificado en la sentencia //NAME. inicializando un entorno en tiempo de ejecución para otros scripts. Si desea especificar un valor HOSTINFO para una aplicación de Universal Agent. SNMP o TRAP. el sistema gestionado asociado permanece en línea en TEMS (Tivoli Enterprise Monitoring Server o servidor de supervisión) y TEPS (Tivoli Enterprise Portal Server o servidor del portal) durante un tiempo limitado. creando un directorio temporal o habilitando la supervisión adicional. puede especificar un parámetro HostAddr= como en la siguiente sentencia SOURCE: //SOURCE SOCK 192. por ejemplo. debe añadir un parámetro RunOnce=Y para un script especial que realiza algún tipo de actividad de configuración que tiene que realizarse solamente una vez. SOCK. xxxxxx se utiliza cuando se construye y se registra el sistema gestionado. identificando de forma exclusiva cada fuente de datos. Por ejemplo. por ejemplo. que se inserta en la tabla Estatus del nodo TEMS. por ejemplo. Si desea alterar temporalmente este fragmento del nombre de sistema gestionado a un valor más significativo para la aplicación de socket. Si desea personalizar este valor para una aplicación de Universal Agent. Cuando existe HOSTINFO. la columna HOSTINFO no es necesaria para cada sistema gestionado. De forma predeterminada. para designar una plataforma del SO de un programa cliente de socket remoto. Cuando el script se completa.3 HostAddr=Linux01 HostInfo= (opcional) Al igual que con HOSTADDR. en la siguiente definición de metarchivo: 148 IBM Tivoli Universal Agent: Guía del usuario . se utiliza para identificar la plataforma del SO del agente que ha registrado el sistema gestionado. debe añadir un parámetro SetSourceName=Y en la sentencia //SOURCE SOCK. El parámetro RunOnce sólo es válido para el tipo de fuente SCRIPT. ODBC. indica que el proveedor de datos de script especificado sólo ejecuta una vez el script especificado. SCRIPT. Consulte “Nombres de sistemas gestionados de aplicaciones del proveedor de datos de socket” en la página 102 para obtener más información. debe renovar el metarchivo de script o reiniciar Tivoli Universal Agent. Universal Agent llena el valor HOSTADDR con la dirección IP y nombre de sistema del sistema local donde se ejecuta Universal Agent. Si más adelante necesita ejecutar de nuevo este script. también hay una columna HOSTINFO en la tabla Estatus de nodo TEMS. puede especificar un parámetro HostInfo= como en la siguiente sentencia SOURCE: //SOURCE SOCK elsun01 HostInfo=SunOS ManagedSystemName= (opcional) Permite especificar varias fuentes para datos de tipo FILE. ″HP-UX″ o ″WinXP.socket se conecta. RunOnce=Y/N (opcional) Si se establece en Y. y a continuación enviar un registro //SETSOURCENAME=xxxxxx al proveedor de datos de socket después del que el programa cliente se conecte. el siguiente es el nombre de sistema gestionado de una aplicación socket: <NombreHost:NombreAplicVV> NombreHost en este contexto es sinónimo del nombre de fuente.

Por ejemplo. el siguiente metarchivo es incorrecto: //APPL MVS //NAME SYSTEM //SOURCE FILE //SOURCE FILE /home/logs/abc.log /home/logs/xyz. Apéndice A. Pero con este formato. Sentencias de control de definición de datos 149 . se puede definir una sola situación y distribuirse a los tres sistemas gestionados. No es posible tener dos valores de ManagedSystemName idénticos en el mismo grupo de atributos. Mediante valores exclusivos de ManagedSystemName. los valores de ManagedSystemName deben ser exclusivos. Si cada uno de los tres archivos supervisados en los ejemplos anteriores tiene su propia sentencia //NAME. se permite que el proveedor de datos identifique de forma correcta a qué fuente pertenecen los datos de entrada.log tail tail tail ManagedSystemName=Boston ManagedSystemName=Chicago ManagedSystemName=LosAngeles procesa tres archivos distintos que todos tienen el mismo formato de atributo bajo el grupo de atributos SYSTEM.log tail tail ManagedSystemName=Boston ManagedSystemName=Boston Para mantener exclusivas las fuentes de varios archivos. v No es necesario crear varias sentencias de definición //NAME y //ATTRIBUTES para diferentes instancias de los mismos datos de entrada. permitiendo así que un metarchivo sea más conciso. El metarchivo resulta en la creación de tres sistemas gestionados: Boston:MVS00 Chicago:MVS00 LosAngeles:MVS00 El parámetro ManagedSystemName ofrece los siguientes beneficios: v Reduce el número de situaciones que debe definir.log /home/logs/xyz.log /home/logs/mno.//APPL MVS //NAME SYSTEM //SOURCE FILE //SOURCE FILE //SOURCE FILE /home/logs/abc. deben definirse tres situaciones separadas.

. . puede utilizar la redirección de datos en situaciones en las que se reciban los datos una vez.Sentencia INTERNAL Descripción La redirección de datos es muy útil para aquellos datos de aplicación que contengan tipos de datos variables. Además. se lee una vez el archivo de registro de detalles de la reclamación. Todas las fuentes de datos de aplicación son soportadas como programa de archivo. de socket o de API. Tivoli Universal Agent redirecciona los datos de un grupo de atributos exactamente como si hubieran llegado de una fuente de datos estándar como un archivo. * 150 IBM Tivoli Universal Agent: Guía del usuario . Éste es un punto importante que hay que recordar y por qué generalmente el usuario desea que el primer grupo de atributos de metarchivo.’ RecType D 1 -FILTER={MATCH(0. tanto si son invisibles como no. . Sintaxis //INTERNAL [INPUT | OUTPUT] nombre-simbólico Parámetros Sentencia OUTPUT La sentencia INTERNAL OUTPUT define la fuente de la redirección de datos. un grupo de atributos de destino no puede él mismo ser la fuente de otra redirección. No obstante. . pero que se redireccionan a varios destinos para ser manipulados de distintas maneras. . incluidos los filtros. . como un archivo de registro de transacciones que incluya varios tipos de registros de datos.’ RecData R 4096 * //NAME ClaimInquiry e AddTimeStamp //INTERNAL INPUT ClaimDetailRec //ATTRIBUTES ’. . Es posible redireccionar los datos de aplicación desde el grupo de atributos de aplicación otros grupos de atributos de aplicación. //NAME TransactionLog e //SOURCE FILE /users/Claim/DETAILS. el cual debe ser exclusivo para todas las aplicaciones activas en la actualidad. La sentencia //INTERNAL define la redirección de la fuente de datos o de los grupos de atributos de destino. como filtros de atributos.log //INTERNAL OUTPUT ClaimDetailRec //ATTRIBUTES ’. Sólo puede identificar un grupo de atributos de fuente por cada redirección mediante el nombre simbólico. para su posterior procesamiento. . . ClaimInquiry y ClaimRequest. . Los registros de archivo se redireccionan a dos definiciones de grupos de atributos siguientes. . Sentencia INPUT La sentencia INTERNAL INPUT define el destino de la redirección de datos. o para aquellos datos de aplicación que son demasiado complejos para construir una única definición de grupo de atributos que pueda manejarlos de forma fiable. lea todos los datos sin ningún filtro aplicado. . socket. . intervalos de resumen u claves de resumen. programa API o agente SNMP.3)} ClaimID C 9999 ClaimType C 99 CustomerSSN D 9 . Los datos de aplicación redireccionados se identifican por el nombre-simbólico. Todas las características y servicios de Tivoli Universal Agent se encuentran disponibles. Está soportado tener varios grupos de atributos de destino partiendo una salida de fuente redireccionada. . Los datos del grupo de atributos son aptos para la redirección después de pasar todos los filtros de atributos definidos. En el siguiente ejemplo.

Dichos atributos derivados son TotalBytes y PercentReceived. .0)} BytesSend C 99999999 ServiceStatus C 99999999 WindowsStatus C 99999999 OperationName D 32 OperationObject D 256 -FILTER={MATCH(0. o sin datos que transferir. . .’ ClientLocation D 32 SkipField1 K Date D 12 Time D 12 Service D 32 SkipField2 K SkipField3 K SkipField4 K SkipField5 K SkipField6 K ServiceStatus C 99999999 –FILTER={NUMBER=(0. . En el siguiente ejemplo. Selecciona los datos excluyendo los registros de archivo sin ubicación de cliente o contenido de solicitud. Sentencias de control de definición de datos 151 .-)} RequestParameters D 256 * //NAME Error_STAT e //INTERNAL INPUT InternetLog //ATTRIBUTES ’. Todos los demás atributos se definen como de tipo SKIP (tipo de atributo K) de modo que no son visibles para el usuario final. solicitudes y el número de bytes. . Los registros de archivo seleccionados se pasan entonces a los grupos de atributos Error_STAT y DataTransfer_STAT.’ ClientLocation D 32 -FILTER={MATCH(0.’ RecType D 1 -FILTER={MATCH(0.2)} CustomerName D 64 CustomerSSN D 9 CustomerAddr D 100 . El grupo de atributos DataTransfer_STAT muestra los bytes intercambiados entre el cliente y el servidor. . . .log tail //INTERNAL OUTPUT InternetLog //ATTRIBUTES ’. . el registro del servidor de Internet es el primero en ser procesado por el grupo de atributos WEB_W3C_Log. . Sólo está interesado en la identidad del cliente. .-)} ClientUserName D 32 Date D 12 Time D 12 Service D 32 ComputerName K 64 ServerAddress D 32 RequestElapsedTime C 99999999 BytesReceived C 99999999 –FILTER={NUMBER<=(0.200)} WindowsStatus C 99999999 OperationName D 32 OperationObject D 256 RequestParameters D 256 * Apéndice A. . Error_STAT sólo está interesado en códigos de error mayores que 200 y algunos atributos seleccionados. .//NAME ClaimRequest e //INTERNAL INPUT ClaimDetailRec //ATTRIBUTES ’. //NAME WEB_W3C_Log e //SOURCE FILE d:\web\server. . Se definen dos atributos derivados adicionales para mostrar el número total de bytes y el porcentaje de datos de entrada del número total de datos.

’ ClientLocation D 32 SkipField1 K Date D 12 Time D 12 Service D 32 SkipField1 K SkipField2 K SkipField3 K BytesReceived C 99999999 BytesSend C 99999999 TotalBytes (BytesReceived + BytesSend) PercentReceived (BytesReceived % TotalBytes) SkipField4 K SkipField5 K SkipField6 K OperationObject D 256 * 152 IBM Tivoli Universal Agent: Guía del usuario .//NAME DataTransfer_STAT e //INTERNAL OUTPUT InternetLog //ATTRIBUTES ’.

en el que un punto y coma (. el proveedor de datos lee y concatena todos los registros de archivo hasta que encuentre 1) un registro que contenga el patrón delimitador especificado (diez guiones). Sintaxis Formato A: patrón delimitador de final de registro //RECORDSET ‘patrón_delimitador’ Formato B: número máximo de registros en el conjunto //RECORDSET número_máximo_registros Formato C: número máximo de registros y regla de identificación //RECORDSET número_máximo_registros NEW(offset.log tail //RECORDSET ‘----------’ //ATTRIBUTES NONE Error_Message R 2048 El ejemplo 2 muestra la definición de un grupo de atributos llamado CONSOLELOG. permite que el proveedor de datos extraiga datos de atributo de varios registros.== | !=. //NAME ERRORLOG E //SOURCE FILE C:\error. En este caso. que sólo es para metarchivos del proveedor de datos de script y de archivo. No debe contener datos válidos de atributos.cadena_comparación) o bien //RECORDSET número_máximo_registros END(offset. La sentencia RECORDSET especifica la siguiente información sobre conjuntos de registros: v Un patrón delimitador que indica el final de un conjunto de registros v El número máximo de registros que componen el conjunto de registros v El número máximo de registros que componen el conjunto de registros y una regla para identificar el conjunto de registros inicial o final Sólo puede haber una sentencia RECORDSET para cada grupo de atributos. Apéndice A.) delimita los atributos. el proveedor de datos lee varios registros para extraer los valores de cinco atributos definidos hasta que realiza una de las siguientes acciones: v Encuentra un patrón de final de registro v Rellena los cinco atributos v Alcanza la condición de final de archivo. o 2) la condición de final de archivo. El delimitador de final de registro se utiliza únicamente para delimitar un conjunto de registros y se descartará. Los datos que excedan el tamaño de atributo definido se truncarán hasta alcanzar el tamaño definido. El delimitador debe estar rodeado por comillas simples (‘ ‘). utilizando el delimitador de conjunto de registros.== | !=. Sentencias de control de definición de datos 153 .Sentencia RECORDSET Descripción La sentencia RECORDSET. El ejemplo 1 muestra la definición de un grupo de atributos llamado ERRORLOG.cadena_comparación) Parámetros <parámetro_delimitador> Especifica el patrón para el final de un conjunto de registros. En este ejemplo.

//NAME CONSOLELOG E //SOURCE FILE C:\console. El valor más amplio que se puede especificar para un número máximo de registros es 32767. el proveedor de datos utiliza el delimitador de archivo (un espacio en blanco) para extraer los valores de los siete atributos leyendo los registros de archivo hasta haber realizado una de las siguientes acciones: v Ha leído cuatro registros v Ha rellenado los siete atributos v Alcanzar el final del archivo //NAME NETALERT E //SOURCE FILE C:\net. el operador de comparación (igual [==] o no igual [!=]) y la cadena de comparación. //NAME APPLALERT E //SOURCE FILE C:\alert. o hasta que se produzca una de las siguientes situaciones: v Se ha procesado el número máximo especificado de registros v Se han rellenado todos los atributos v Se ha alcanzado el final de archivo o el almacenamiento intermedio de salidas estándar 154 IBM Tivoli Universal Agent: Guía del usuario . En este caso.log tail //RECORDSET 4 //ATTRIBUTES NONE Alert_Description R 2048 En el ejemplo 4. La regla de identificación define el desplazamiento en una fila de salida estándar de registro de archivo o script. lo que suceda primero. El registro delimitador se considera como parte del conjunto de registros y no se descarta.log tail //RECORDSET 4 //ATTRIBUTES ’ ’ Alert_Date D 12 Alert_Time D 8 Alert_ID D 16 Alert_Type C 99 Alert_Severity C 99 Alert_Origin D 64 Alert_Text D 256 <máximo de registros y regla de identificación> Especifica el número máximo de registros en el conjunto de registros y una regla para identificar el inicio o el final del conjunto.log tail //RECORDSET ‘----------’ //ATTRIBUTES ‘. El proveedor de datos lee y concatena todos los registros de archivo hasta un máximo de 4 o hasta que alcance el final del archivo.’ Message_Date D 12 Message_Time D 8 Message_ID D 8 Message_Text D 512 Message_Action D 512 <número_máximo_registros> Indica el número máximo de registros que el proveedor de datos lee en un conjunto de registros. En el ejemplo 3. el registro que satisfaga el criterio de comparación. el grupo de atributos APPLALERT sólo contiene un atributo de tipo R para Registro. pero sin incluir. el proveedor de datos procesa los registros desde la posición actual del archivo hasta. La palabra clave NEW indica una regla para iniciar u conjunto de registros.

un conjunto de registros consiste en un máximo de 100 filas de salida de script y cada conjunto de registros nuevo se identifica con una serie de guiones. //APPL ERRPT //NAME AIX_ERRPT K 600 Interval=180 //SOURCE SCRIPT /usr/bin/errpt "-a" //RECORDSET 100 NEW(0. cada nuevo conjunto de registros empieza por la fecha.----------------) //ATTRIBUTES Label D 24 DLMSTRBGN=’LABEL:’ DLMSTREND=’IDENTIFIER:’ Identifier D 16 DLMSTR=’Fecha/hora:’ Date D 32 DLMSTR=’Número de secuencia:’ SeqNumber N 8 KEY DLMSTR=’ID de máquina:’ MachineID D 16 DLMSTR=’ID de nodo:’ NodeID D 16 DLMSTR=’Clase:’ Class D 16 DLMSTR=’Tipo:’ Type D 24 DLMSTR=’Nombre de recurso:’ ResourceName D 24 DLMSTR=’Descripción’ Description D 64 DLMSTR=’Causas probables’ ProbableCauses D 64 DLMSTR=’Acciones recomendadas’ RecommendedActions D 256 DLMSTR=’Datos detallados’ DetailData Z 512 En la definición de datos del ejemplo 6. se leen todos los registros hasta la siguiente fecha en el atributo Status_Record. //NAME STATUS_LOG E //SOURCE FILE C:\status. FIX: (OS/2 or Windows) Verify that you have configured for remotely attachable programs correctly.!=. y cada conjunto de registros nuevo se identifica por un carácter que no está en blanco en el desplazamiento 0.DAT No such file or directory Sat Jun 29 18:47:42 2002 Msg #KA3129E Error occurred while testing for remote initiation Msg #KA1709E Error occurred during a GET ALLOCATE verb There was an error checking for a remote request of UPDATE functions. Primary return code = f0040000 Apéndice A. o hasta que suceda una de las siguientes opciones: v Se ha procesado el número máximo especificado de registros v Se han rellenado todos los atributos v Se ha alcanzado el final de archivo o el almacenamiento intermedio de salidas estándar En la definición de datos del ejemplo 5. un conjunto de registros consiste entre uno y veinte registros de archivo. Sentencias de control de definición de datos 155 . En este caso.==. (0. Como no hay delimitador de atributos. Las cadenas de valores de máximo de fila. ) //ATTRIBUTES NONE Status_Record R 2048 Sat Jun 29 18:47:41 2002 Msg #UM12751 Entering UPDATE Mode Sat June 29 18:47:41 2002 Msg #UM1202E Error in parameter file FIX: See additional messages.log tail //RECORDSET 20 NEW(0.2) STATUS. regla de comparación y delimitador de atributos en este metarchivo se obtienen examinando la salida de un mandato ″errpt -a″ en un sistema AIX. el proveedor de datos procesa registros desde la posición de archivo actual hasta e incluido el registro que satisfaga el criterio de comparación.La palabra clave END indica una regla para el final del conjunto de registros. Tal como se puede ver en los siguientes registros de archivo de muestra.

Jack Thomas A (555) 323-5656 156 IBM Tivoli Universal Agent: Guía del usuario .Delimitadores de atributos ausentes Para entradas de varios registros.’ First_Name D 24 KEY Last_Name D 24 KEY Grade D 1 Telephone D 14 Los siguientes registros son aceptables: Bob.@Smith.@(555) 323-1919 Susan.(555) 323-1919 Susan.@Barber @B (555) 323-2346.@B.log //RECORDSET 4 //ATTRIBUTES ’@. Jack Thomas A (555) 323-5656 Si una definición de atributo especifica los delimitadores iniciales y finales como se muestra en la siguiente definición: //APPL NewClass //NAME CHILD_PSYCHOLOGY221 K //SOURCE FILE C:\psy221.B.’ First_Name D 24 Last_Name D 24 Grade D 1 Telephone D 14 KEY KEY Los siguientes registros son aceptables: Bob. el proveedor de datos de archivo está programado para acomodar delimitadores de atributos ausentes u omitidos en la parte inicial o final de un registro.Smith.Barber B (555) 323-2346. Para la siguiente aplicación: //APPL NewClass //NAME PHYSICS101 K //RECORDSET 4 //ATTRIBUTES ’.

X<nn> El proveedor de datos reconoce la recepción de los datos enviando el carácter hexadecimal <nn>. <’mensaje’> El proveedor de datos reconoce la recepción de los datos enviando la cadena de caracteres del mensaje. ‘Datos recibidos. Sintaxis tipo_confirmación //CONFIRM Parámetros <tipo_confirmación> Especifica uno de los siguientes tipos de confirmación requerida: SIZE SEQ El proveedor de datos reconoce la recepción de los datos devolviendo la longitud de datos como un entero sin signo de 32 bits.Sentencia CONFIRM Descripción La sentencia CONFIRM proporciona un vehículo para especificar los requisitos de reconocimiento de datos y es sólo para metarchivos del proveedor de datos de socket. el proveedor de datos convierte el mensaje al formato del sistema del cliente antes de la transmisión. Por ejemplo. Apéndice A. en orden de bytes de red. Sentencias de control de definición de datos 157 . Debe entrar esta sentencia después de las sentencias //NAME y //SOURCE y antes de la sentencia //ATTRIBUTES. Por ejemplo. X70. el número de secuencia comienza desde uno y se reinicia. en orden de bytes de red. Debe delimitar el mensaje por comillas simples.’ Si el programa cliente y el proveedor de datos están en sistemas distintos. El proveedor de datos reconoce la recepción de los datos devolviendo el número de secuencia de registro de datos como un entero sin signo de 32 bits. Para cada nueva conexión TCP o nuevo intercambio UDP.

funciones incorporadas. <proc=procedimiento almacenado> En lugar de una sentencia Select. puede especificar un procedimiento almacenado que ejecuta una SQL Select con respecto a la fuente de datos a la que se está accediendo. Es necesaria una sentencia //SQL para cada sentencia //SOURCE ODBC. deberá ir entre comillas simples. Observe que una sentencia de metarchivo //SQL puede tener un máximo de 2048 bytes. En ese momento. debe utilizar comillas dobles para delimitar los parámetros de cadena y no utilizar ninguna comilla para los parámetros de tipo entero. Puede seleccionar columnas individuales así como columnas de varias tablas. Selects anidados. por ejemplo. Una consecuencia de este método es que si existen errores de sintaxis en la sentencia //SQL Select. no hay nada que impida explotar características adicionales de SQL. no se detectarán hasta que el metarchivo de ODBC se haya importado y el proveedor de datos de ODBC haya realizado el primer intento de ejecutar la sentencia. etc. Notas: 1. como ORDER BY. En la mayoría de los casos. La cadena incluida en la sentencia se pasa al controlador ODBC y es el controlador de software el que hace el trabajo de analizar la sentencia y prepararla para el tiempo de ejecución. los errores de sintaxis se graban en el registro RAS1 de Tivoli Universal Agent. El analizador del metarchivo de Tivoli Universal Agent no examina en contenido de la sentencia //SQL Select en busca de posibles errores de sintaxis. por ejemplo: //SQL Select proc=SP0001 "ABC" "ITM" 4 557 158 IBM Tivoli Universal Agent: Guía del usuario . deberán ser señales separadas por espacios en blanco después del nombre de procedimiento almacenado.Sentencia SQL Descripción La sentencia SQL le dice al proveedor de datos de ODBC qué tabla seleccionar desde el fuente de datos especificado en la sentencia //SOURCE. //SQL Select * from sysxlogins Aunque este ejemplo utiliza una sentencia Select simple. GROUP BY. los controladores de ODBC dan soporte a toda la sintaxis de consulta SQL estándar. compruebe la sentencia Select mediante una herramienta de consulta ad hoc SQL o el programa de utilidad de la línea de mandatos antes de insertarla en el metarchivo. Sintaxis //SQL [sentencia Select] [proc=procedimiento almacenado] Parámetros <Sentencia Select> Especifica una sentencia Select de SQL de cualquier tipo o formato que está soportada por la fuente de datos a la que se accede. Si existen parámetros de entrada para el procedimiento almacenado. Para ayudar a distinguir entre parámetros de cadena y de entero. 2. Además. Determinadas sentencias SQL pueden ser bastante largas. Puede utilizar cualquier sintaxis de Select en un metarchivo de ODBC siempre y cuando el controlador de ODBC dé soporte a la función. 3. Si el nombre de procedimiento almacenado contiene cualquier espacio en blanco.

No obstante. Aceptar filtros o Rechazar filtros. Tivoli Universal Agent inserta automáticamente un atributo LocalTimeStamp durante el tiempo de ejecución. Esta sentencia se entra después de la sentencia //NAME y antes de la sentencia //ATTRIBUTES. claves de clasificación definidas. El resumen de ocurrencias de datos es especialmente útil en los casos en que la frecuencia de la entrada es más importante que los detalles de los datos de entrada. La salida resultante para un grupo de atributos de resumen consiste en cualquier atributo de clave de clasificación que se haya definido junto con seis atributos de resumen reservados: _LocalTimeStamp.Sentencia SUMMARY Descripción La sentencia //SUMMARY define los requisitos para reunir la frecuencia de entrada de datos durante la supervisión. Otros atributos definidos en el grupo de atributos de resumen sin la designación de la clave de clasificación no forman parte del espacio de trabajo de salida. Por ejemplo. Es útil utilizar las opciones de filtrado. Y a continuación. Sólo se permite una sentencia //SUMMARY por cada sentencia //NAME. para la supervisión detallada de los datos de aplicación. El valor de El intervalo mínimo es de 60 (1 minuto) y el valor de intervalo máximo es de 86400 (1 día). Los atributos que no estén definidos como claves de clasificación de resumen no se incluyen en la salida. El grupo de atributos de resumen debe incluir el atributo LocalTimeStamp. _Date_Time. para limitar el ámbito de la resumen. El valor del atributo LocalTimeStamp y el intervalo definido en la sentencia //SUMMARY activan el proceso de resumen. sin embargo. Sintaxis //SUMMARY [<intervalo>] [Force] nombre-atributo tipo-atributo tamaño máximo SKEY=n Parámetros <intervalo> Especifica el periodo de resumen en segundos. Esto no quiere decir. El valor de intervalo especificado en la sentencia //SUMMARY se utiliza para determinar cuándo grabar como salida una nueva fila de datos al grupo de atributos de resumen. independientemente de si se han recopilado nuevos datos durante dicho intervalo. _Interval_Unit. con o sin filtros. si corresponde. los requisitos incluyen un intervalo definido y. no se añadirá una fila al grupo de atributos de resumen para dicho Apéndice A. Si los datos de aplicación no incluyen este atributo. podrá añadirlo especificando el parámetro AddTimeStamp en la sentencia //NAME. podría definir un grupo de atributos. _Interval. todas las alertas tendrán su importancia. es el número total de alertas recibidas en un periodo de tiempo es que puede indicar tendencias o problemas. El resumen tiene lugar después de filtrar los datos de entrada. y _Occurrences. puede redirigir dichos datos de aplicación a uno o más grupos de atributos en el metarchivo para el resumen. En caso contrario. que los atributos de aplicación de detalles no estén disponibles en un metarchivo que incluye un grupo de atributos de resumen. _Interval_Unit_Name. Como mínimo. cuando Tivoli Universal Agent esté supervisando las alertas recibidas desde un dispositivo. puede definir una combinación de grupos de atributos de resumen y no resumen. si no se recopilan nuevos datos durante un intervalo de resumen. Sentencias de control de definición de datos 159 . No obstante. Por ejemplo. Se utilizará el valor predeterminado de 300 si no se especifica ningún intervalo. En un metarchivo individual. Force (opcional) Permite ver siempre una fila de resumen en cada intervalo.

Un grupo de atributos con claves de clasificación es resumido por el intervalo LocalTimeStamp y se divide en cada clave de clasificación. segundo y tercero).en la primera posición del atributo Request) son inmediatamente rechazados. los únicos atributos que están presentes para el grupo de atributos RequestSummary incluyen los seis atributos de resumen reservados siguientes: 160 IBM Tivoli Universal Agent: Guía del usuario . Ejemplo 1 El siguiente metarchivo de ejemplo especifica un resumen de solicitud horaria: //APPL eLog //NAME ServerLog e //SOURCE FILE /var/log/apache/access. . Un grupo de atributos sin una definición de clave de clasificación sólo es resumido por el intervalo LocalTimeStamp. 3 para el primero. La salida consiste en una fila de datos por intervalo de resumen. Un grupo de atributos puede no incluir ninguna clave de clasificación o claves de clasificación que representen todos los atributos del grupo de atributos. Los registros sin información de solicitud (indicados por un guión. El número de secuencia <n> especifica el orden de clasificación (como 1. incluso si la fila contiene ceros como ocurrencias y otros atributos de resumen. SKEY=<n> Identifica un atributo como una clave de clasificación de resumen. Puede convertir cualquier atributo de visualización o numérico en una clave de clasificación de resumen.intervalo. Su salida incluye tantas filas como combinaciones de claves de clasificación haya por intervalo de resumen. El comportamiento predeterminado de la característica de resumen es orientado a datos en lugar de orientado a intervalos. 2.log tail //INTERNAL OUTPUT InternetLog //ATTRIBUTES *-------------------------------------------* * Apache Server Log Record Format Layout * *-------------------------------------------* ClientLocation D 256 ClientUserName D 32 Authorized_User K 32 Date_Time DL 20 Time_Zone K 5 Request D 256 DLM=’’ –FILTER={MATCH(0.-)} ServiceStatus C 99999999 BytesReceived C 99999999 Referral D 256 DLM=’/"’ Browser D 256 DLM=’""’ Service D 32 ServerName D 256 RequestParameters D 256 BytesSent C 99999999 RequestElapsedTime C 99999999 * //NAME RequestSummary e //INTERNAL INPUT InternetLog //SUMMARY 3600 Force //ATTRIBUTES LogRecord R 2048 Los registros de detalle se procesan en el grupo de atributos ServerLog y a continuación. se redirigen al grupo de atributos RequestSummary. Como LogRecord no es una clave de clasificación. A continuación se muestra un ejemplo de la utilización del parámetro Force: //SUMMARY 900 Force Esta sintaxis de metarchivo quiere decir que se graba como salida una nueva fila en el grupo de atributos de resumen cada 15 minutos. que cuenta el número de registros por hora.

400)} BytesReceived C 99999999 Referral D 256 DLM=’/"’ Browser D 256 DLM=’""’ Service D 32 ServerName D 256 RequestParameters D 256 BytesSent C 99999999 RequestElapsedTime C 99999999 * Tivoli Universal Agent acumula los datos de registro de entrada durante el intervalo de resumen. Otros atributos de los datos de entrada. los datos acumulados se clasifican en base a las claves de clasificación definidas y. _Interval_Unit.400)}) ya se han filtrado en la entrada. Los seis atributos de resumen reservados: _LocalTimeStamp. Las dos claves de clasificación de resumen: ServiceStatus y Request 2. 10 _Interval_Unit_Name El valor de _Interval mostrado en un formato de visualización. _Interval_Unit_Name y _Occurrences. _Date_Time. A continuación. Los atributos de salida de un grupo de atributos que se hayan resumido siempre constan de atributos clave. a continuación. por ejemplo. se obtiene como salida una fila de datos con 0 en la columna Ocurrencias si no se reciben registros coincidentes en el grupo de atributos durante la hora anterior. se resumen. LocalTimeStamp. por ejemplo 10 AM Occurrences El total de resumen calculado en el intervalo anterior Al haber especificado el parámetro Force. se muestran los siguientes atributos de salida: 1. Los atributos que no estén definidos como atributos clave no están incluidos en la salida. //NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES ClientLocation D 256 ClientUserName D 32 Authorized_User K 32 Date_Time DL 20 Time_Zone K 5 Request D 256 SKEY=2 DLM=’’ ServiceStatus C 99999999 SKEY=1 +FILTER={NUMBER>=(0. que Apéndice A. Ejemplo 2 La siguiente definición de grupo de atributos muestra el resumen de registro de un servidor de Internet de todas las solicitudes que han resultado en un estatus de error mayor que 400. Sentencias de control de definición de datos 161 . Observe que las solicitudes de error de interés (+FILTER={NUMBER>=(0._LocalTimeStamp Indicación de la hora de 16 bytes que indica el principio de un intervalo de resumen _DateTime El valor de atributo _LocalTimeStamp mostrado en un formato de visualización _Interval_Unit El valor de intervalo definido en la sentencia //SUMMARY (3600) _Interval El intervalo de resumen anterior expresado en horas desde el principio del día. _Interval. Al final de un intervalo. Ejemplo 3 Sólo necesita definir los metarchivos con tanto detalle como sea necesario para extraer correctamente y analizar los atributos clave de clasificación para el resumen. Interval y Occurrences.

Pero sin el análisis correcto de los atributos SKIP. Las tres claves de clasificación de resumen: ClientLocation. //SUMMARY [intervalo] [Force] nombre-atributo tipo-atributo tamaño-máximo SKEY=SUM Ejemplo 4 En el siguiente ejemplo. Es muy útil mostrar el resultado del número total de un intervalo de resumen. se pueden marcar como marcadores y se designan con el tipo de atributo SKIP. Puede sumar cualquier campo de atributo numérico especificando el parámetro clave SKEY=SUM. número de procesos y bytes enviados o recibidos.400)} 99999999 Si se han definido más datos de entrada que atributos. Número total de un intervalo de resumen Los datos de aplicación incluyen frecuentemente campos de números totales como el número de sucesos. 162 IBM Tivoli Universal Agent: Guía del usuario . La definición del grupo de atributos abreviado que viene a continuación genera la misma salida que el ejemplo anterior: //NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES PlaceHolder1 K 4 PlaceHolder2 K 4 PlaceHolder3 K 4 PlaceHolder4 K 4 PlaceHolder5 K 4 Request D 256 ServiceStatus * C SKEY=2 DLM=’-’ SKEY=1 +FILTER={NUMBER>=(0. los valores de atributos de la clave de ordenación no son correctos.no están incluidos en el grupo de atributos de resumen de salida. ClientLocation suma los totales de bytes enviados y recibidos son sumados cada hora. Este grupo de atributos genera la salida que contiene los atributos siguientes: 1. BytesReceived y BytesSent. aunque el contenido de dichos atributos SKIP no tengan consecuencia alguna. //NAME DataTransferByLocation e //INTERNAL INPUT InternetLog //SUMMARY 3600 Force //ATTRIBUTES ClientLocation D 256 SKEY=1 PlaceHolder1 K 4 PlaceHolder2 K 4 Date_Time DL 20 PlaceHolder3 K 4 PlaceHolder4 K 4 DLM=’:’ PlaceHolder5 K 4 BytesReceived C 99999999 SKEY=SUM PlaceHolder6 K 4 DLM=’/"’ PlaceHolder7 K 4 DLM=’""’ PlaceHolder8 K 4 PlaceHolder9 K 4 PlaceHolder10 K 4 BytesSent C 99999999 SKEY=SUM PlaceHolder11 K 4 * Observe cómo los delimitadores de atributos especiales (mediante el parámetro DLM=-) son necesarios para la correcta interpretación de los datos de entrada. por lo que respecta al grupo de atributos de resumen de salida. Tivoli Universal Agent deja de interpretar los datos de entrada en el último atributo definido. BytesReceived y BytesSent capturan la suma de los valores de atributo respectivos durante el intervalo anterior.

BytesTransferPerSecond y BytesTransferPerRequest para cada ubicación de cliente: //NAME DataTransferByLocation e //INTERNAL INPUT InternetLog //SUMMARY 3600 //ATTRIBUTES ClientLocation D 256 SKEY=1 PlaceHolder1 K 4 PlaceHolder2 K 4 Date_Time DL 20 PlaceHolder3 K 4 PlaceHolder4 K 4 DLM=’ ’ PlaceHolder5 K 4 BytesReceived C 99999999 SKEY=SUM PlaceHolder6 K 4 DLM=’/"’ PlaceHolder7 K 4 DLM=’""’ PlaceHolder8 K 4 PlaceHolder9 K 4 PlaceHolder10 K 4 BytesSent C 99999999 SKEY=SUM PlaceHolder11 K 4 * RequestsPerSecond (_Occurrences / _Interval_Unit) * TotalBytesTransfer (BytesReceived + BytesSent) * BytesTransferPerSec (TotalBytesTransfer / _Interval_Unit) * BytesTransferPerReq (TotalBytesTransfer / _Occurrences) Apéndice A. seguirá incluida en el grupo de atributos de resumen de salida porque procede como mínimo de uno de los atributos de resumen reservados. _Interval_Unit_Name y _Occurrences. TotalBytesTransfer. Puede utilizar los siguientes atributos para crear atributos derivados: _Occurrences El número rotal de resumen _Interval_Unit El intervalo de resumen definido Resultado del resumen del atributo numérico Un atributo numérico definido con SKEY=SUM Por ejemplo. _Interval_Unit. Ejemplo 5 El siguiente ejemplo amplía la definición de metarchivo anterior especificando los atributos de RequestsPerSecond.2. Sentencias de control de definición de datos 163 . incluidos los atributos de resumen reservados. Los seis atributos de resumen reservados: _LocalTimeStamp. a continuación se muestran dos definiciones de atributos en un grupo de atributos de resumen: ErrorCount C 999999 Average_Errors (_Occurrences / ErrorCount) Aunque Average_Errors no sea una clave de ordenación de resumen. _Date_Time. _Interval. Creación de nuevos atributos Los atributos derivados permiten crear atributos nuevos basados en los atributos definidos existentes.

Tivoli Universal Agent utiliza el delimitador especificado en la sentencia ATTRIBUTES para analizar los datos de entrada. //ATTRIBUTES ’’’ v Al utilizar caracteres delimitadores simples. es a veces necesario especificar caracteres delimitadores que no estén en inglés. No obstante. “John” “Doe” “Analista sistemas” “Ingeniería” Los delimitadores iniciales y finales no tienen que ser el mismo carácter. un delimitador de espacio no es una buena elección porque divide "Sistema" y "Analista" en dos valores de atributo diferentes en el espacio de trabajo de Tivoli Enterprise Portal. v Una especificación de delimitador de doble. Todas las formas de la especificación de delimitadores en la sentencia ATTRIBUTES aceptan caracteres que no estén en inglés.Analista sistemas. v Si no se especifica ninguna cadena.Sentencia ATTRIBUTES La sentencia ATTRIBUTES incluye las siguientes definiciones de atributo. deberá guardar el metarchivo en la codificación UTF-8. finales o intermedios no se eliminarán de la fila de datos. no es necesario tener un carácter delimitador después de último valor del atributo en la fila de datos porque el carácter de final de registro o de nueva línea sirve para el mismo propósito que el delimitador. También permite la especificación de los delimitadores de atributos en la cadena de datos. En el siguiente ejemplo. se asume que los atributos están separados por un espacio en blanco. como ‘””’. se descarta el delimitador antes de utilizar los datos para la evaluación de informes o de situaciones. John.’ indica que los campos de atributos en una fila de datos están separados por un punto y coma. //ATTRIBUTES ‘. v Si la fuente de datos está proporcionando datos de entrada que no están en inglés.Doe. querrá decir que los espacios iniciales.Ingeniería Nota: Los caracteres delimitadores no aparecen en los valores de atributos que se muestran en el espacio de trabajo de Tivoli Enterprise Portal. v Debe rodear los caracteres delimitadores de comillas simples. Después de analizar los datos de entrada. Por ejemplo. Siempre que el carácter delimitador especificado no sea un espacio. Cada registro que sigue a la sentencia ATTRIBUTES contiene una definición de atributo. como en el siguiente ejemplo de fila de datos. Por ejemplo. no existe punto y coma después de "Ingeniería" pero se entiende que se ha alcanzado el final del registro por lo que el delimitador de punto y coma no es necesario. Tivoli Universal Agent sólo puede leer los formatos de metarchivos ASCII y UTF-8. tres comillas simples indican que los campos del atributo en una fila de datos están separados por una comilla simple. Sintaxis //ATTRIBUTES [<‘cadena-delimitadora’>] [DLM=] [DLMSTR=] [DLMSTRBGN=] [DLMSTREND=] Parámetros <’cadena-delimitadora’> Identifica los caracteres opcionales delimitadores que separan los datos de atributos en la entrada. indica que los campos del atributo están rodeados por delimitadores de inicio y de fin. En el ejemplo de fila de datos anterior. puede especificar los delimitadores de atributo como ‘$?’ para el archivo: $John? $Doe? $Analista sistemas? $Ingeniería? 164 IBM Tivoli Universal Agent: Guía del usuario . En el ejemplo de fila de datos anterior.

Por ejemplo. DLM (opcional) Como alternativa al formato <‘cadena-delimitadora’>. también puede utilizar esta forma basada en palabras claves de especificación del delimitador. incluido el último atributo del registro de datos. por lo que los valores de atributos pueden finalizar visualizándose incorrectamente en el espacio de trabajo de Tivoli Enterprise Portal. Por lo tanto. Los datos se copian directamente desde los registros de entrada a la memoria. la especificación de delimitador basado en la palabra clave da soporte a caracteres delimitadores simples así como especificaciones de delimitadores dobles en las que los dos caracteres indican delimitadores iniciales y finales. son necesarios delimitadores iniciales y finales para cada atributo. No se hace ninguna interpretación o conversión de datos de los valores de datos. debe guardar el metarchivo en codificación UTF-8.Con delimitadores dobles. ya que el tamaño del entero y su representación de datos de memoria interna no se interpretan. utilice el siguiente formato si va a supervisar un archivo que no esté en inglés y desea especifica el carácter delimitador utilizando el formato DLM= : //ATTRIBUTES DLM=’†’ Nota: Si hay algún carácter que no está en inglés en un metarchivo de Tivoli Universal Agent. Nota: No utilice NONE como delimitador de atributo cuando procese datos de entrada que contienen atributos numéricos definidos como Contador o Indicador. Debe asegurarse de que los tipos de valores de datos y tamaños coinciden exactamente con la especificación de atributos en el metarchivo de aplicación. v La palabra clave TAB especifica el carácter de tabulación horizontal como el delimitador de atributos: //ATTRIBUTES //ATTRIBUTES TAB NEWLINE v La palabra clave NEWLINE especifica el carácter de línea nueva como delimitador del atributo: v El parámetro 0xnn indica que un carácter hexadecimal es el delimitador de atributo. El número de dígitos necesarios para representar el valor numérico en los datos de entrada no coincide necesariamente con la representación de 2 o 4 bytes del número que el proveedor de datos debe almacenar. es importante asegurarse de que la aplicación remitente y el proveedor de datos se inician en sistemas con arquitecturas similares. Esta opción suele utilizarse si los datos de entrada contienen un carácter delimitador no visualizable que no se puede especificar de otra manera en un metarchivo. los valores de datos de atributos se recuperan mediante el desplazamiento del campo y la longitud de datos del atributo definida. Sentencias de control de definición de datos 165 . tal como se muestra en el siguiente ejemplo de metarchivo: //ATTRIBUTES NONE First-Name D 12 Last-Name D 12 Job D 20 Department D 16 Este es un registro de datos típico que muestra cómo los desplazamientos de campo deben coincidir exactamente con los tamaños de atributos: John[8 espacios]Doe[9 espacios]Analista sistemas[6 espacios] Ingeniería[5 espacios] La entrada de datos no delimitados también soporta los tipos de datos de enteros cortos y largos binarios. por ejemplo: //ATTRIBUTES 0xFB NONE v La palabra clave especial NONE indica que no se utilizará ningún delimitador: //ATTRIBUTES Si se utiliza NONE. Al igual que el formato de <‘cadena-delimitadora’>. DLMSTR (opcional) Si la fila de datos que se está analizando contiene un patrón de delimitación que Apéndice A. título o texto de ayuda. ya sea un delimitador.

log //ATTRIBUTES DLMSTR=’ ’ Date D 24 CustomerName D 32 CustomerPO D 32 CustomerContact D 24 CustomerLocation D 24 OrderNumber D 12 OrderTotal C 9999999 Tail DLMSTRBGN y DLMSTREND (opcional) Como extensión al soporte de especificaciones de delimitación dobles en las que los dos caracteres indican los delimitadores iniciales y finales. mientras se analiza un registro de muestra del archivo Orders. en la página 169 para obtener información adicional. Por ejemplo. los caracteres de delimitación no se incluyen en los datos del atributo. utilice el parámetro de palabra clave DLMSTR en lugar del formato de cadena delimitadora. puede también especificar que hay varios caracteres que marcan el inicio y el final de cada valor de atributo. No obstante. se da cuenta de que siempre hay tres espacios en blanco entre cada uno de los campos de un registro de archivo: May 24 2005 Acme Corp AE47938 John Doe Denver 9583759374 998123 Utilice una especificación DLMSTR en la sentencia //ATTRIBUTES tal como se indica a continuación.consiste de uno o más caracteres. //ATTRIBUTES DLMSTRBGN=’***’ DLMSTREND=’!!!’ Al igual que con todas las especificaciones de delimitación. //APPL OrderInfo //NAME CustomerData S 300 //SOURCE FILE C:\CustomerData\Orders. “Definiciones de atributos”. o cadena inicial o final que se especifique a nivel de //ATTRIBUTES tiene efecto sobre cada atributo individual definido bajo dicha sentencia //ATTRIBUTES. si los datos de entrada no son completamente consistentes en su utilización de los delimitadores. Consulte el Apéndice B. no tendrá la certeza de que la sintaxis de metarchivo de Tivoli Universal Agent pueda alterar temporalmente el valor del delimitador en el ámbito del atributo individual.log. Cualquier carácter de delimitación. Esta característica recibe el nombre de delimitadores-específicos-de-atributo. El siguiente ejemplo indica que cada valor de atributo en la fila de datos que se está procesando comienza con tres asteriscos y termina con tres signos de exclamación. 166 IBM Tivoli Universal Agent: Guía del usuario . Se descartan antes de que se genere la fila de datos para la visualización de espacios de trabajo y la evaluación de situaciones.

Sentencias de control de definición de datos 167 . El ejemplo consta de un sólo grupo de atributos denominado ConLog. “Definiciones de atributos”. en la página 169. UXsysSta. consulte el Apéndice B. denominada UXstat. que utilizan datos sondeados con un TTL de 150 segundos.Ejemplos de metarchivos Este apartado proporciona ejemplos que ilustran varios metarchivos creados de acuerdo con las directrices presentadas en apartados anteriores. UXsysSta contiene 22 atributos. No se necesita una sentencia SOURCE en esta definición de datos ya que los datos se envían a través de las API. //APPL UXstat @help text //NAME UXsysSta p 150 @help text //ATTRIBUTES SystemName D 16 @help text OSversion D 16 @help text PendingIOwaitRate C 100000 @help text IOstartRate C 100000 @help text IOcompleteRate C 100000 @help text AvgWaitThreadQueueSize C 4096 @help text AvgRunThreadQueueSize C 4096 @help text AvgNumbActivePageFrames C 100000 @help text AvgNumbFreePageFrames C 100000 @help text PageInRate C 65000 @help text PageOutRate C 65000 @help text DevInterruptRate C 65000 @help text SystemCallRate C 65000 @help text ThreadContentSwitchRate C 65000 @help text AvgUserCPUPercent C 100 @help text AvgSystemCPUPercent C 100 @help text AvgIdleCPUPercent C 100 @help text AvgWaitCPUPercent C 100 @help text UDPpktInRate C 100000000 @help text UDPpktOutRate C 100000000 @help text TCPpktInRate C 100000000 @help text TCPpktOutRate C 100000000 @help text Ejemplo 2 de metarchivo Este segundo metarchivo de ejemplo ilustra la definición de datos extraídos a partir de un archivo de registro para una aplicación llamada SysEvent. que utiliza los datos de sucesos recopilados en modalidad TAIL. //APPL SysEvent @help text //NAME ConLog E @help text //SOURCE FILE e:\system\event.log TAIL //ATTRIBUTES MessageID D 12 MessageNumb C 999999 MessageType D 1 ProcessNumb C 9999 TimeMonth D 3 TimeDay C 31 T TimeYear C 9999 TimeHour C 24 TimeMinute C 60 TimeSecond C 60 MessageText D 100 Apéndice A. compuesta por un grupo de atributos. Ejemplo 1 de metarchivo En este ejemplo se muestra una aplicación del proveedor de datos de servidor de API. Para obtener más información acerca de la creación de definiciones de atributos.

168 IBM Tivoli Universal Agent: Guía del usuario .

2003. Los parámetros restantes utilizan un formato palabra_clave=< valor> o palabra_clave{<valor>} y se pueden colocar en cualquier orden después de los parámetros de posición. Presenta el valor del atributo como la diferencia entre muestras. El parámetro <texto de ayuda> siempre debe ser el último parámetro en una definición de atributo. 2007 169 . Un carácter incorrecto se sustituye automáticamente por un subrayado. En un grupo de atributos individual. incluidos letras. el tipo de atributo y el tamaño máximo del atributo.Apéndice B. denominado Node_Name. Definiciones de atributos Este apéndice contiene la descripción. deben colocarse en la secuencia mostrada arriba. en este apéndice se describen las características de definición de atributos especiales que se utilizan para derivar y filtrar atributos. CAPTION. números. 2. <tamaño-máximo>. también hay muchos parámetros opcionales que pueden ofrecer funcionalidad y valor añadidos a las definiciones de atributos. (Los atributos derivados son una excepción y utilizan un formato diferente. El parámetro FILTER= debe ir detrás de todos los otros parámetros opcionales. etcétera. Sintaxis <nombre-atributo> <tipo-atributo> <tamaño-máximo> [KEY] [ATOMIC] [ENUM{<texto>}] [CAPTION{<texto>}] [SCALE{<nn>}] [PRECISION{<mm>}] [<comportamiento-agregado>] [<delimitador-específico-atributo>] [SEQ=<nn>] [SKEY=<nn>/SUM] [DEFAULT=] [+/-FILTER={<texto>}] [@<texto de ayuda>] Parámetros Los parámetros <nombre-atributo>. que Universal Agent genera automáticamente como el primer atributo en cada grupo de atributos. Notas: 1. <tipo-atributo>. subrayados (_) y asteriscos (*). y se anteponen de forma inmediata a cualquier texto de ayuda opcional. Además. No puede haber espacios en blanco incorporados en el nombre. puede haber un máximo de 127 definiciones de atributos. Sólo se permiten caracteres ASCII. con las dos excepciones siguientes: 1. Si se especifican. Además de los tres parámetros necesarios. Tenga en cuenta que también hay un atributo reservado. SCALE. <tipo-atributo> Especifica uno de los siguientes tipos de atributos válidos: # Valor delta. Consulte “Derivación de atributos” en la página 179 para obtener más información). Los nombres de atributos pueden contener hasta 200 caracteres. mejorar la utilización y crear información más significativa a partir de los datos de entrada suministrados a la aplicación de metarchivo. Por ejemplo. Explora las características de definiciones de atributos que pueden mejorar el rendimiento. guiones (-). <nombre-atributo> Especifica el nombre de un atributo. KEY y ATOMIC son posicionales. ENUM. la sintaxis y los parámetros de las definiciones de atributos que se utilizan para crear un metarchivo de definición de datos. Definición de atributos Descripción Todas las definiciones de atributos deben especificar un mínimo de tres parámetros: el nombre de atributo. © Copyright IBM Corp. 2. como por ejemplo.

aunque las últimas filas de datos recopiladas procedan de Host1. que pueden incluir dígitos así como separadores decimales. se presupone un valor predeterminado. y el tiempo transcurrido entre las muestras 1 y 2 es de 5 segundos. y ?) en un grupo de atributos con clave. Hora. el delta es 20. Serie de caracteres. cambio de porcentaje y tasa de cambio se realizan entre el valor de atributo actual y el valor de atributo de la fila de datos anterior con claves coincidentes. Una serie de caracteres globalizados. Lee el todo el registro hasta encontrar un carácter de control de carro/salto de línea. pero el proveedor de datos omite los atributos de Skip sin realizar ningún otro proceso en ellos. Ignora el delimitador especificado y trata todos los datos de entrada de la posición actual hasta el final de los datos de entrada como un único campo. y el proveedor de datos de archivo los detecta cuando analiza cada registro utilizando el delimitador y el tamaño máximo designados del atributo.si el valor de la muestra 1 es 100 y el de la muestra 2 es 120. puede definir los otros cuatro atributos como de tipo Skip. No tiene interés y se omite. Unicode. Un valor delta puede ser un número negativo si el valor muestreado actual es menor que el valor muestreado anterior. Último. Por ejemplo. Registro. Medidor. el valor de la segunda muestra es 120. tal como se muestra en la Tabla 25. El formato es SAAMMDDHHMMSSmmm (donde S=1 para el siglo XXI). y se ha definido un atributo delta denominado IPpacketErrors. Entero positivo. Por ejemplo. recuerde que los cálculos de delta. y otros caracteres que no son dígitos. Este tipo de atributo es una representación de serie de caracteres de un número y no un entero. el cálculo delta para una fila de datos Host2 sólo se realizará con respecto al número total IPpacketErrors en la fila de datos Host2 anterior. Serie de caracteres. Si no se proporciona valor alguno para un atributo cuando los datos se muestrean. pero sólo desea externalizar seis de dichos campos para la visualización de espacios de trabajo y la evaluación de situaciones. Los cuatro atributos están físicamente en el archivo. el valor de la primera muestra es 100. un atributo de NumericString no es idóneo para visualizar en diagramas y gráficos en Tivoli Enterprise Portal. Por lo tanto. Contador. ? A C D G K N R S T U Z Nota: Cuando se utiliza uno de los tres atributos de tipo de tasa (#. comas. Presenta el valor del atributo como la diferencia entre las muestras expresada como porcentaje. DisplayString. Entero positivo o negativo. el valor de atributo de tipo de tasa será cero. Si no hay ninguna fila de datos anterior con claves coincidentes. Conmutar. Por ejemplo. Tasa de cambios. Como ejemplo. Omitir. Entra un campo posicional. Media de datos en todas las recopilaciones. NumericString. %. signos de porcentaje y menos. el nombre de host es el atributo KEY en el grupo de atributos. si un registro de archivo tiene diez campos. El valor predeterminado depende del tipo de atributo. si ReceiveCount se define como tipo de datos % y el valor de la muestra 1 es 100 y el valor de la muestra 2 es 120. la tasa de cambio es de 4 por segundo. Promedio. Presenta el valor del atributo como delta por segundo entre muestras. 170 IBM Tivoli Universal Agent: Guía del usuario . % Porcentaje de cambio. si ReceiveCount se define como el tipo de datos ?. Booleano 0 o 1. si recopila datos MIB de agentes SNMP que se ejecutan en Host1 y Host2. el porcentaje de cambio es 20.

Valores predeterminados para diferentes tipos de atributos Tipo de atributos A (Promedio) C (Contador) D (DisplayString) G (Medidor) K (Omitir) N (NumericString) R (Registro) S (Conmutar) T (Hora) U (Unicode) Z (Último) Valor predeterminado Sin cambios del promedio actual 0 ^ 0 No aplicable ^ No aplicable 0 Hora actual ^ ^ Puede cambiar estos valores de atributos predeterminados especificando un parámetro DEFAULT= en la definición de atributo. Apéndice B. <tamaño-máximo> Especifica el tamaño máximo esperado de los datos. A medida que Tivoli Universal Agent recibe las filas de datos de los datos de atributos con clave. KEY (opcional) Indica que un atributo es un atributo clave. Tivoli Universal Agent utiliza atributos clave para determinar si varios sucesos tienen la misma causa. este parámetro especifica el número máximo esperado. Los atributos clave ayudan a correlacionar las filas de datos con valores de atributos con clave idénticos. 2. R. la sustitución sólo se produce si la diferencia de hora entre la nueva fila de datos y la fila de datos existente es menor que el TTL especificado. y también se envían al servidor de supervisión como datos UTF-8. Definiciones de atributos 171 . el atributo se define como entero de 4 bytes. El tamaño máximo permitido es de 4000 bytes. De lo contrario. Esto sólo se aplica si el método de muestreo en la sentencia NAME está especificado como K. dado que UTF-8 requiere entre 2 y 4 bytes para representar un carácter Unicode que no está en inglés. los datos globalizados se representan internamente en Tivoli Universal Agent como UTF-8. Para aquellos atributos numéricos como Contador o Medidor. Un atributo Contador para el número total de paquetes recibidos puede esperar un valor máximo de 1. Tivoli Universal Agent sólo soporta valores de atributos numéricos de hasta 2 gigabytes. la especificación de tamaño máximo de todos los atributos U se multiplica automáticamente por 3 cuando Tivoli Universal Agent importa un metarchivo. por lo tanto no especifique un tamaño máximo para ningún atributo numérico que sea mayor de 2. Por ejemplo. Es más.Tabla 25. este parámetro especifica el número máximo de bytes del atributo.000. U y Z. Para el tipo de atributo Unicode. N. Si es así. El número máximo previsto elegido para un atributo numérico como el Contador o Indicador determina si el atributo está definido ante el servidor de supervisión y servidor del portal como entero de 4 bytes o corto de 2 bytes. un atributo para la utilización de CPU expresado como porcentaje podría tener un valor máximo de 100. los nuevos datos sustituyen a los existentes.147. 4. K.647. Para los tipos de atributos D. Si el valor especificado en la definición de atributo es mayor que 32767 (el número máximo de 16 bits con signo). Vea la descripción de parámetro DEFAULT más adelante en este apartado.483. 3.000 paquetes por implementación de sistema. Generalmente. se define como corto de 2 bytes. Notas: 1. comprueba si ya tiene una fila de datos con valores coincidentes para el atributo con clave.

″Atomic″ es similar a la palabra clave ″Key″ en lo referente a seguir la especificación de tamaño. Debe haber al menos un espacio en blanco separando ambas palabras. ATOMIC (opcional) Tivoli Universal Agent permite atomizar los atributos en los metarchivos. Nota: Aunque no existe límite para el número de atributos que puede atomizar en un metarchivo. ENUM (opcional) Para los atributos de tipo numérico. sólo es posible especificar un atributo de elemento de visualización por situación. Si no se designa ningún atributo como clave en el grupo de atributos clave. 2. Por ejemplo. se activan sucesos de situación independientes y se restablecen para cada proceso que provoca que la situación sea cierta.Notas: 1. En distintos intervalos. diferentes procesos pueden estar causando el problema. Esta característica puede reducir enormemente el número de definiciones de situaciones y también ayudar en la determinación de problemas. Los tipos de atributos numéricos como Contador y Medidor no pueden utilizarse con el parámetro Atomic. v Visualizar de forma sencilla el valor que ha provocado que la situación sea cierta. Puede designar hasta cinco atributos como atributos clave. El formato de cada cadena de caracteres de enumeración es el siguiente: enumString(valor_numérico) 172 IBM Tivoli Universal Agent: Guía del usuario . Para activar esta característica. Si sólo se activa un suceso de situación. una situación puede activarse para uno o más procesos en un sistema. La atomización se suele utilizar en casos de integración de Tivoli Enterprise Console en los que se desea que cada ocurrencia individual de una situación cierta se notifique a Tivoli Enterprise Console. si process_cpu > 10 por ciento representa una situación. Nota: La adición de la palabra ″atomic″ a un atributo existente sólo provoca un cambio de versión de menor importancia en la aplicación de Tivoli Universal Agent asociada. Nota: Puede especificar ″Atomic″ en mayúsculas o en minúsculas. el proceso “responsable” es ambiguo. Tivoli Universal Agent utiliza el primer atributo como el atributo clave. puede especificar una o más cadenas de caracteres de enumeración para facilitar la lectura de los valores de datos numéricos. La atomización de un atributo permite la utilización de la opción de elemento de visualización durante la definición de situación. Si atomiza la situación utilizando la opción de elemento de visualización para el atributo process_cpu. Esto permite que las situaciones que hacen referencia a dichos atributos utilicen la capacidad de elemento de visualización. Puede incluir tanto ″key″ como ″atomic″ en el mismo atributo. EmployeeName D 20 Atomic EmployeeExt N 4 EmployeeID D 8 El atributo ″EmployeeName″ está atomizado. La opción de elemento de visualización permite realizar lo siguiente: v Generar sucesos independientes para una única condición verdadera. añada la palabra clave ″Atomic″ en la parte derecha del atributo que desea atomizar en el metarchivo de Tivoli Universal Agent. Varios atributos proporcionados por Tivoli Universal Agent en la aplicación SNMP-MANAGER del proveedor de datos de SNMP y en la aplicación INTERNET del proveedor de datos de HTTP están ya atomizados de forma predeterminada.

Nota: Para garantizar la correcta definición y evaluación de situaciones. lo que no es compatible con definiciones de situaciones que utilizan cadenas de caracteres de enumeración. Tivoli Universal Agent permite especificar un factor de escala (Scale) y precisión (Precision) cuando se define un atributo numérico. Por ejemplo. Definiciones de atributos 173 . Si se han definido cadenas de enumeración que no están en inglés. AvgDiscarded C 999999 descartados por segundo Caption{Promedio\nDescartados} @Promedio paq La presencia del carácter de línea nueva. Por ejemplo. A este nombre alternativo se le conoce como Caption. en el parámetro Caption especifica que el encabezado de la columna AvgDiscarded aparece en Tivoli Enterprise Portal como: Promedio Descartados SCALE y PRECISION (opcional) Para dar soporte a números de separador flotante en Tivoli Enterprise Portal. si especifica un atributo tal como se muestra en el siguiente ejemplo. El siguiente es un ejemplo de cómo especificar un título (caption). especifique SCALE{<nn>} PRECISION{<mm>} a la derecha de una definición de atributo. Para habilitar esta función. No se permiten comas dentro de parámetros ENUM porque Tivoli Universal Agent utiliza internamente la coma como carácter separador. el editor de situaciones no acepta valores de cadenas de caracteres como por ejemplo. deberá guardar el metarchivo en codificación UTF-8. Es necesario poner un espacio en blanco después del ″{″ inicial y otro antes del final ″}″.″ y no se puede guardar la situación: JobStatus C 299 ENUM{ Submitted(201) WaitingForRes(202) ResourceAllocation(203) JobNotExecuted(204) } Tal como se ha mencionado anteriormente. El nombre debe constar de uno o más caracteres de texto delimitados por llaves. el atributo se define como corto de 2 bytes. se visualizan up o down.Puede incluir tantas cadenas de caracteres de enumeración como desee dentro de un bloque ENUM{ }. Estos números de separador flotante son entonces aptos para gráficos y diagramas y otras características de representación de Tivoli Enterprise Portal basadas en números. También puede definir situaciones que comparan la cadena de caracteres de enumeración en vez del valor de entero puro. ″Submitted″ o ″JobNotExecuted. El analizador de metarchivos omite las comas encontradas en un parámetro ENUM. Si el valor especificado en la definición de atributo es menor o igual a 32K. \n. debe establecer el tamaño máximo en más de 32. El aumento del tamaño máximo del atributo JobStatus a un valor de más de 32K permite definir y guardar la fórmula de la situación. si define el atributo ifOperStatus del modo siguiente: ifOperStatus C 999999 ENUM{ up(1) down(2) } @El estatus de la interfaz En lugar de visualizar 1 o 2 en el espacio de trabajo de Tivoli Enterprise Portal. Tivoli Enterprise Portal utiliza el valor de Scale para saber cuántas posiciones desplazar la coma decimal hacia la izquierda y el valor de Precision para determinar el ancho total del número de separador flotante. pero el resto de la definición ENUM se procesa. Por ejemplo.767 (32K) para cualquier atributo numérico con cadenas de caracteres de enumeración. el tamaño máximo de un atributo numérico determina si el atributo se ha definido ante el servidor de supervisión y el servidor del portal como entero de 4 bytes o corto de 2 bytes. los valores de parámetro Apéndice B. CAPTION (opcional) Tivoli Enterprise Portal permite especificar un nombre alternativo para un atributo. Generalmente se especifica un parámetro CAPTION en la definición del atributo para proporcionar una versión más legible de un atributo en los encabezados de las columnas del espacio de trabajo.

FloatAttr1

C

999999

SCALE{2}

PRECISION{5}

SCALE y PRECISION deben ir delimitados por llaves. NOTA IMPORTANTE: Para garantizar unos resultados de escalado correctos, debe establecer el tamaño máximo en los metarchivos para tipos numéricos en un máximo de 32.767 (32K). Por ejemplo,
FloatAttr2 C 99999 SCALE{1} PRECISION{5}

De lo contrario, los valores de datos se visualizan de forma incorrecta en el portal. Como alternativa, puede elegir especificar SCALE{<nn>} PRECISION{<mm>} en un atributo derivado. Por ejemplo,
PktReceivedPerSec C 1000000 PktDiscardedPerSec C 1000000 DiscardedRatio (PktDiscardedPerSec / PktReceivedPerSec) SCALE{3} PRECISION{6}

El valor de SCALE máximo permitido es 10 y el valor de PRECISION máximo permitido es 12. <comportamiento-agregado> (opcional) Permite especificar detalles para agregar datos que el Agente de resumen y podado utilizará más adelante. Tenga presente que Tivoli Universal Agent sólo hace referencia a estos parámetros de agregación con el fin de generar las sentencias ODI de aplicación que el Agente de resumen y poda requiere: AGPRF Indica la columna o atributo que se está visualizando cuando el Editor de consultas realiza el post-filtrado de los datos resumidos. Cuando se define un post-filtrado en el Editor de consultas, la columna que se suministra en el filtro es una columna de tiempo real. Este nombre de columna exacto es probable que no exista en la tabla de datos resumidos sino que aparece como xxx_min, xxx_max o xxx_avg. Esta palabra clave se utiliza a nivel de columna. AGTIM Indica una columna alternativa en la tabla que se utilizará como indicación de la hora durante la agregación en lugar de la columna Writetime predeterminada. Sólo puede especificar la palabra clave AGTIM para un atributo de tipo Time. Cada tabla puede tener sólo una palabra clave AGTIM. La columna o atributo que contiene AGTIM contiene una indicación de la hora de recopilación los datos de la medida o punto en el tiempo. Esta palabra clave se utiliza a nivel de columna. BEHAV{<valor>} Describe el contenido de los datos. Sólo puede especificar la palabra clave BEHAV para un tipo de atributo numérico, como Contador o Medidor. Esta palabra clave se utiliza a nivel de columna. La siguiente lista muestra los valores válidos: Gauge Número basado en rangos (como un percentil). State Lista enumerada de opciones que se refiere a la condición del recurso, como activo o inactivo.

Count Número de iteraciones que se han producido. El contador puede restablecerse. Property Característica del recurso que raramente cambia, como la cantidad de memoria o velocidad del procesador. Low Peak Valor más bajo informado durante un periodo determinado de tiempo. Valor más grande informado durante un periodo determinado de tiempo.

174

IBM Tivoli Universal Agent: Guía del usuario

PDel

Deltas precalculados por la aplicación medidos durante un determinado periodo de tiempo.

SampleCount Número de lecturas promediadas por el Agente de resumen y poda. De forma predeterminada, SampleCount se almacena en la columna SAMPLECOUNT. DEPRECATED Indica las columnas o atributos en una tabla que ya no se soportan. Evite nuevos usos de dichas columnas. Esta palabra clave se utiliza a nivel de columna. OPTION{HISTORICALTIMESTAMP} Identifica los atributos de indicación de la hora que desea que se visualicen en la ventana Intervalo de tiempo de Tivoli Enterprise Portal. Sólo es posible especificar la palabra clave OPTION{HISTORICALTIMESTAMP} para un atributo de tipo Time. OPTION{PRIMARYKEY=<n>} Utilizado para designar un atributo clave. Necesario para cada tabla. La variable n comienza en 0 para cada atributo y aumenta en incrementos de 1 según sea necesario. Utilice PRIMARYKEY=0 para la clave del identificador exclusivo en una tabla de varias filas. Por ejemplo, si una tabla describe unidades de disco, debería especificar PRIMARYKEY=0 con cada atributo que contenga el ID exclusivo para cada unidad de disco. Esta palabra clave se utiliza a nivel de columna. WHSC{<atributo>} Indica la columna que contiene el contador de muestras del registro para que puedan calcularse los promedios. Esta palabra clave puede ser una lista separada por espacios en blanco de columnas que especifica la columna y la medida a la que se aplica el contador de muestras. Si una tabla tiene varias palabras clave WHSC, cada contador de muestras se aplica sólo a las columnas especificadas en la lista atributos. Si el valor de atributo es ALL, la columna en que la que se proporciona el código WHSC es el campo de contador de muestras de todas las medidas en la tabla. El siguiente es un ejemplo de cómo puede utilizar los parámetros de agregación en un metarchivo:
//APPL Disk_Monitor WHEN{H} //NAME Physical_Disk S 300 Interval=60 //SOURCE ODBC mydatasource //SQL Select * from Physical_Disk //ATTRIBUTES TMZDIFF N 12 @attimezone difference from GMT WRITETIME D 16 AGTIM Disk_Name D 64 OPTON{PRIMARYKEY=0} Timestamp T 16 OPTION{HistoricalTimestamp} @hora últ compr disco User_Name D 64 BEHAV{PROPERTY} OS_Type D 16 BEHAV{PROPERTY} Avg_Disk_Bytes_Read C 999999 BEHAV{GAUGE} Disk_Bytes_Sec C 999999 BEHAV{GAUGE} System_Up_Time C 999999 BEHAV{COUNT}

<delimitador-específico-atributos> (opcional) Permite alterar temporalmente el delimitador de grupo de atributos que está definido en la sentencia //ATTRIBUTES. El delimitador definido en la sentencia //ATTRIBUTES se aplica a todos los atributos en el grupo de atributos. No obstante, los datos de aplicación no siempre se delimitan de manera uniforme. Si este fuera el caso, es necesario alterar temporalmente el delimitador normal con un delimitador especial que se utilice a nivel de atributos individuales. Por ejemplo, las siguientes sentencias de metarchivo,
//APPL XYZ //NAME TransactionLog E //SOURCE FILE /home/logs/transaction.log tail //ATTRIBUTES ’’ ClientName D 32
Apéndice B. Definiciones de atributos

175

Date_Time DL 20 Time_Zone D 5 Transaction D 256 TransactionSize C 999999

no pueden analizar correctamente el siguiente registro de muestra:
JohnDoe [01/Sep/2005:02:06:31 -0700] „GET /ITM05.html” 5914

El delimitador en efecto a nivel del grupo de atributos es un único espacio. Esto generalmente funciona para separar cada valor de atributo en este registro, excepto el valor del atributo Transaction que está delimitado por comillas dobles. Puede analizar correctamente el valor de Transaction en el registro de ejemplo (como GET/ITM05.html) redefiniendo el atributo Transaction con el delimitador inicial y final específico del atributo:
Transaction D 256 DLM=’””’

Los tipos y sintaxis de los parámetros del delimitador específico del atributo que defina a nivel de atributos individuales son los mismos parámetros que puede especificar en la sentencia //ATTRIBUTES: DLM, DLMSTR y DLMSTRBGN combinados con DLMSTREND. Consulte “Sentencia ATTRIBUTES” en la página 164 para obtener más información sobre los parámetros DLM, DLMSTR, DLMSTRBGN y DLMSTREND. Al igual que con las especificaciones de delimitadores en la sentencia //ATTRIBUTES, deberá rodear el delimitador específico del atributo de comillas simples. Si incluyen algún carácter que no esté en inglés, deberá guardar el archivo en la codificación UTF-8. No existe ninguna restricción acerca del número de delimitadores específicos de atributos dentro de un grupo de atributos. SEQ (opcional) Permite alterar temporalmente la secuencia de atributos normal, que de forma predeterminada es simplemente el orden en el que los atributos aparecen listados debajo de la sentencia //ATTRIBUTES. La razón principal para utilizar el parámetro SEQ=<nn> es evitar cambios principales de versión de la aplicación cuando se modifica un metarchivo. Consulte “Secuenciado de definiciones de atributos” en la página 186 para obtener más información.

SKEY (opcional) Identifica un atributo como una clave de clasificación de resumen. Este parámetro sólo es válido en un grupo de atributos de resumen. Consulte “Sentencia SUMMARY” en la página 159 para obtener más información. DEFAULT (opcional) Permite asignar un valor predeterminado a un atributo cuando a la fila de datos recopilados le falta un valor de atributo determinado. Por ejemplo, en determinados casos de supervisión de registros, hay algunos registros en los que no se han rellenado todos los campos. Si no se ha especificado el parámetro DEFAULT y falta un valor de atributos, Tivoli Universal Agent asigna un valor predeterminado de acuerdo con el tipo de atributo, según se describe en la Tabla 25 en la página 171. El valor especificado en el parámetro DEFAULT= debe ir delimitado por comillas simples. Las siguientes sentencias de metarchivo muestran cómo utilizar el parámetro DEFAULT:
//SOURCE FILE /opt/logs/employee_list.txt TailByCount 500 //ATTRIBUTES ’;’ EmployeeName D 32 EmployeeExt C 999999 DEFAULT=’0000’ EmployeeDept D 16 DEFAULT=’N/A’

FILTER (opcional) Permite establecer criterios que incluyen o excluyen una fila de datos basada en una subcadena de caracteres o número encontrado en un valor de atributo determinado. Consulte “Filtrado de atributos” en la página 181 para obtener más información. <texto de ayuda> (opcional) Define la ayuda que se visualiza cuando el cursor se mueve encima de un encabezado de columna dentro de una vista de espacio de trabajo. Este texto de ayuda del atributo también

176

IBM Tivoli Universal Agent: Guía del usuario

se visualiza en el Editor de situaciones del cliente de Tivoli Enterprise Portal cuando se seleccionan condiciones para incluir en una situación. Notas: 1. El texto debe ir precedido del signo de “arroba” (@). 2. El texto no puede superar los 245 caracteres. 3. Las comas (,) se convierten en espacios. 4. Si se especifica un texto de ayuda que no está en inglés, el metarchivo deberá tener la codificación UTF-8.

Exploración de las características de los atributos
A continuación, se indican algunas otras características de atributos que hay que tener en cuenta: v Duplicación de atributos v Atributos invisibles v Truncamiento por la izquierda/derecha

Duplicación de atributos
Dentro de un grupo de atributos, tal y como se define en una sentencia NAME, no están permitidos los atributos duplicados. Los siguientes procedimientos manejan atributos duplicados. Atributos con el mismo nombre y tipo. Los atributos subsiguientes se suprimen y el mensaje de validación KUMPV15W identifica el atributo suprimido. El tamaño del atributo ayuda a determinar si los atributos son duplicados. Si dos atributos tienen el mismo nombre y tipo pero difieren en tamaño, Tivoli Universal Agent guardará el atributo de mayor tamaño. Por ejemplo, en las siguientes definiciones de atributos:
InventorySum . . . InventorySum C10000

C 9999

se suprime la definición InventorySum C 9999. Atributos con el mismo nombre pero de distinto tipo. Un número de secuencia se añade a los atributos duplicados y el mensaje de aviso KUMPV16W indica que el nombre de atributo ha cambiado. Por ejemplo, las siguientes definiciones de atributos:
InventorySum . . . InventorySum D 12

C 10000

se modifican como:
InventorySum D 12 . . . InventorySum2 C 10000

Nota: Las definiciones de atributos exclusivas pueden acabar duplicadas si se trunca el nombre. Para garantizar que se resuman los datos personalizados, especifique la opción PRIMARYKEY en los campos de atributos clave para indicar al Agente de resumen y poda cómo distinguir entre varias instancias. Utilice la siguiente opción para designar un atributo clave:
OPTION{PRIMARYKEY=n}

Apéndice B. Definiciones de atributos

177

Esta opción es necesaria para cada uno de los grupos de atributos. La variable n empieza por 0 para cada atributo y aumenta de 1, según convenga. Utilice PRIMARYKEY=0 para la clave del identificador exclusivo en un grupo de atributos de varias filas. Por ejemplo, si un grupo de atributos describe unidades de disco, debe especificar PRIMARYKEY=0 con cada atributo que contenga el ID exclusivo para cada unidad de disco. Esta palabra clave se utiliza a nivel de columna.

Atributos invisibles
-nombre-atributo tipo-atributo tamaño-máximo

Puede utilizar un atributo como intermediario para derivar otros atributos. Debe definir el atributo en un metarchivo ya que forma parte de los datos de aplicación de entrada o quizás porque sirve como marcador de posición. La eliminación de este atributo de la salida, no obstante, reduce la complejidad del grupo de atributos y simplifica su utilización. Los atributos ClientAddress, Date, Time y Date_Time listados en el siguiente ejemplo son invisibles en la salida. No es posible tener ningún espacio en blanco entre el guión y el nombre de atributo.
//NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES -ClientAddress D 256 ClientLocation (ipAddressToName = ClientAddress) ClientUserName D 32 Authorized_User K 32 -Date D 10 -Time D 10 -Date_Time (Date + Time) LocalTimeStamp (TivoliTimeStamp = Date_Time) Time_Zone K 5 Request D 256 SKEY=2 ServiceStatus C 999 SKEY=1 +FILTER={NUMBER>=(0,400)} BytesReceived C 99999999 Referral D 256 DLM=’/"’ Browser D 256 DLM=’""’ Service D 32 ServerName D 256 RequestParameters D 256 BytesSend C 99999999 RequestElapsedTime C 99999999 *

Los atributos ClientLocation y LocalTimeStamp proporcionan información de una manera adecuada para la salida sin pérdida de información alguna. Consulte “Funciones de atributos derivados” en la página 180 para obtener más información acerca de este ejemplo.

Truncamiento por la izquierda de atributos de visualización
De forma predeterminada, un atributo de carácter de tipo de visualización cuyo tamaño de datos supera el tamaño de los datos definido se trunca por la derecha. Por ejemplo, un valor de datos de atributo de ABCDEFGHIJK para la definición de atributo
TestName D 8

resultará en un valor de datos de ABCDEFGH. El mismo atributo definido utilizando la especificación de truncamiento por la izquierda DL
nombre-atributo DL tamaño-máximo

resulta en un valor de datos de DEFGHIJK.

178

IBM Tivoli Universal Agent: Guía del usuario

Derivación de atributos
Puede definir atributos que deriven de otros atributos utilizando la siguiente especificación:
nombre_atributo (atributo_1 operador atributo_2)

Los operadores soportados son: Operador + * / % Significado atributo_1 menos atributo_2 atributo_1 más atributo_2 atributo_1 multiplicado por el atributo_2 atributo_1 dividido por el atributo_2 atributo_1 dividido por el atributo_2 y multiplicado por cien

Ambos atributos en la fórmula deben ser numéricos y de entrada o derivados. Por ejemplo,
//APPL NewType //NAME NewTable K 3600 //SOURCE FILE C:\test.log //ATTRIBUTES ‘;’ Item_Name D 24 KEY Width C 1000000 Depth C 1000000 Difference (Width - Depth) Sum (Width + Depth) Area (Width * Depth) Factors (Width / Depth) Percent (Width % Depth) Height C 1000000 Volume (Area * Height)

Los atributos numéricos derivados pueden utilizar valores numéricos codificados de forma fija. Por ejemplo,
BytesSent C 999999 KilobytesSent (BytesSent/ 1024)

También puede crear un atributo numérico derivado partiendo de dos valores numéricos codificados de forma fija.

Atributos derivados incorporados como números reales
Los atributos derivados a menudo son más útiles si se visualizan como número reales que como enteros. Por ejemplo, los atributos derivados como RequestsPerSecond o BytesTransferPerSecond pueden dar lugar a números demasiado pequeños para que se puedan mostrar como enteros. Si sólo se reciben 100 solicitudes en un intervalo de 3600 segundos, el resultado es 0.03. El número se redondea a cero para un atributo de entero. Para visualizar los valores de salida como números reales, utilice el siguiente formato:
nombre-atributo REAL(derivar fórmula de atributo)

La palabra clave REAL especifica que el valor de salida del atributo aparezca como un número de separador flotante con una precisión de hasta tres decimales. Nota: Un atributo que utiliza la palabra REAL está definido en Tivoli Enterprise Portal como una cadena de caracteres y no un entero. Por lo tanto, el atributo no es apto para diagramas o gráficos o para comparaciones numéricas en situaciones. Si tiene un atributo de separador flotante que debe manejarse como datos numéricos, utilice los parámetros SCALE y PRECISION en la definición de atributo, según se describe en “SCALE y PRECISION” en la página 173 en “Parámetros” en la página 169.
Apéndice B. Definiciones de atributos

179

Funciones de atributos derivados Las funciones de atributos derivados son funciones definidas de Tivoli Universal Agent que funcionan en valores de atributos de entrada y producen valores de atributos derivados. Las cadenas de caracteres de atributos concatenados pueden utilizar valores de cadenas de caracteres literales. SystemName D 32 FullSystemName (SystemName + "_Prod") También es posible crear un atributo de cadena derivado partiendo de dos cadenas de caracteres literales. Las funciones de atributos derivados modifican o reformatean un atributo determinado para que su valor sea más intuitivo para la visualización. 2006 10:31:21”. Por ejemplo. Convierte la hora universal coordinada a la hora GMT en una indicación de la hora estándar de 16 dígitos. Tipo de entrada Visualización TivoliTimeStamp Convierte la cadena de caracteres de entrada de fecha y hora Visualización en formato libre en una indicación de la hora ITM estándar de 16 dígitos. almacenada en un registro de IBM Tivoli Monitoring. nombre-atributo (atributo_carácter_1 + atributo_carácter_2) Por ejemplo. Si no es posible resolver la dirección. a una indicación de la hora estándar de 16 dígitos. Ambos atributos de entrada son atributos de tipo carácter unidos por el operador más (+). el nombre de host mostrado es la dirección IP decimal de entrada.Concatenación de cadenas de caracteres de atributos derivados La característica de atributos derivados dicta que los atributos de entrada deben ser atributos numéricos. Si el atributo Date tiene el valor “Sep 15. nombre-atributo (función = de nombre_atributo_derivado) La siguiente tabla contiene descripciones de las funciones de atributos derivados. Visualización Entero Entero Visualización Visualización NetWareTimeToText UTCtoLocalTime UTCtoGMT GetEnvValue TivoliLogTime El siguiente ejemplo incluye funciones de atributos derivados: 180 IBM Tivoli Universal Agent: Guía del usuario . Tabla 26. si un grupo de atributos contiene el atributo Date y el atributo Time. La excepción a esta regla es la concatenación de cadenas de caracteres. podrá combinarlos en un único atributo Date_Time para su utilización. Convierte una representación hexadecimal de la hora actual. Convierte la hora universal coordinada a una hora local en una indicación de la hora estándar de 16 dígitos. Obtiene el valor actual para una variable de entorno especificada. Convierte el valor de hora hexadecimal especial de Netware en un formato de hora de visualización estándar. También hay una función que recupera el valor de una variable de entorno y almacena el valor en el atributo especificado. Descripciones de funciones de atributos derivados Nombre de función ipAddressToName Descripción Convierte la dirección IP en formato decimal al nombre de host. 2006 ” y el atributo Time contiene “10:31:21” el atributo Date_Time resultante es “Sep 15.

Apéndice B. debe especificar la función de atributo derivado TivoliLogTime del modo siguiente: -LogTime D 16 DLM=’-’ +FILTER={MATCH(0.. Esta característica se conoce como “filtrado” de atributos.//NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES ClientAddress D 256 ClientLocation (ipAddressToName = ClientAddress) ClientUserName D 32 Authorized_User K 32 Date D 10 Time D 10 Date_Time (Date + Time) LocalTimeStamp (TivoliTimeStamp = Date_Time) Time_Zone K 5 Request D 256 SKEY=2 ServiceStatus C 999 SKEY=1 +FILTER={NUMBER>=(0.exe "use" Envfile=netuse. por ejemplo: //APPL NETUSE //NAME DriveMappings K 300 AddTimeStamp Interval=60 //SOURCE Script C:\windows\system32\net.The) \ OR SCAN(0. Definiciones de atributos 181 . como por ejemplo. Aunque está disponible para todos los tipos de proveedores de datos. la función de atributo derivado GetEnvValue se suele utilizar en los metarchivos del proveedor de datos de script para suministrar más información de contexto.400. El filtrado de atributos puede mejorar el rendimiento de la solución reduciendo la cantidad de datos que Tivoli Universal Agent procesa. que tiene las propiedades de cualquier atributo Time en Tivoli Enterprise Portal.Status) OR SCAN(0.″CTBLD″) y captura ″(44B61A87.0000″ en el atributo ″LogTime″ invisible. Esta sintaxis de metarchivo lee un registro de archivo. (44B61A87.()} Timestamp (TivoliLogTime = LogTime) otras definiciones de atributos .00001:RAS1.New)} DriveLetter D 4 KEY DLM=’:’ Mapping D 32 Network Z 64 Filtrado de atributos Para controlar la cantidad de datos que pueden verse en los espacios de trabajo.env //ATTRIBUTES ComputerName (GetEnvValue = COMPUTERNAME) Path (GetEnvValue = PATH) Status D 16 -FILTER={SCAN(0. puede especificar la cantidad de datos que desea incluir o excluir.------) OR SCAN(0. A continuación.0000″ en una indicación de la hora de 16 bytes y la almacena en el atributo Timestamp.400)} BytesReceived C 99999999 Referral D 256 DLM=’/"’ Browser D 256 DLM=’""’ Service D 32 ServerName D 256 RequestParameters D 256 BytesSend C 99999999 RequestElapsedTime C 99999999 * Si supervisa un registro de IBM Tivoli con un metarchivo del proveedor de datos de archivo. la función de atributo derivado TivoliLogTime convierte ″(44B61A87..

Las funciones de cadenas de caracteres se utilizan para la definición de filtros para tipos datos de atributos de caracteres. La especificaciones de los filtros Accept y Reject deben ir delimitadas por llaves { }. el valor de desplazamiento no puede ser equivalente al tamaño máximo del atributo o el filtro no es válido. Por consiguiente. pero debe ser cero.Sintaxis nombre-atributo {filter1 OR|AND nombre-atributo {filter1 OR|AND tipo-atributo tamaño-máximo +FILTER= filter2 OR|AND filter3. Debe poner en mayúsculas -FILTER. desplazamiento de datos y valor-filtro.. Para aquellas funciones de filtro numéricas. El siguiente ejemplo no está soportado: nombre-atributo tipo tamaño +FILTER={filter1 OR filter2 AND filter3} Cada atributo en un grupo de atributo puede tener su propia definición de filtros. desplazamiento-datos se basa en cero.. y los operadores lógicos OR y AND. Debe definir cada especificación de filtro con el siguiente formato: función-filtro(desplazamiento-datos.} tipo-atributo tamaño-máximo -FILTER= filter2 OR|AND filter3. REPLACEALL. que sólo son válidos cuando se utilizan con SCANREGEX o MATCHREGEX.REPLACEFIRST|REPLACEALL(cadena-sustitución) OR|AND MATCHREGEX|SCANREGEX(desplazamiento. Desplazamiento-datos define el desplazamiento desde el principio de los datos de atributo donde se hace la comparación para los datos-filtro.} Los parámetros REPLACEFIRST y REPLACEALL opcionales. Los primeros dos ejemplos nombre-atributo tipo-atributo tamaño-máximo +FILTER={filter1 OR filter2 OR filter3} nombre-atributo tipo-atributo tamaño-máximo +FILTER={filter1 AND filter2 AND filter3} están soportados. Si busca un carácter de finalización específico en un atributo. Si busca un carácter de inicio determinado en un atributo. 182 IBM Tivoli Universal Agent: Guía del usuario . y sólo con +FILTER. especifique un desplazamiento-datos que sea menor que el tamaño máximo del atributo. Para las funciones de filtro de caracteres. SCANREGEX.. +FILTER.} Descripción Puede definir un máximo de 50 filtros para un atributo. REPLACEFIRST. Debe haber al menos un espacio en blanco antes y después de los operadores OR y AND. patrón-regex). SCAN. contienen la siguiente sintaxis: nombre-atributo tipo-atributo tamaño máximo +FILTER={MATCHREGEX|SCANREGEX(offset.. Un filtro Accept y un filtro Reject no están soportados en el mismo atributo. el parámetro posicional desplazamiento-datos no puede omitirse. valor-filtro) La función-filtro consiste en funciones de cadenas de caracteres y funciones numéricas. Las funciones numéricas operan con datos de atributos numéricos. Si se especifica un texto que no está en inglés para cualquier función de filtro de cadena de caracteres. patrón-regex). como DisplayType o RecordType. rodeados de paréntesis. Los filtros de los atributos pueden estar conectados lógicamente mediante operadores OR u operadores AND. La función-filtro incluye dos operandos posicionales.. El filtro Accept (+FILTER) especifica que se aceptan los datos de aplicación como entrada.REPLACEFIRST|REPLACEALL (cadena-sustitución). como CounterType. El filtro Reject (-FILTER) especifica que los datos de aplicación se excluirán. MATCH. deberá guardar el metarchivo en codificación de UTF-8. MATCHREGEX. pero no mediante una combinación de operadores OR y AND.. NUMBER. especifique 0 como el desplazamiento-datos.

Z. Caracteres SCANREGEX Comprueba la ocurrencia de la cadena de D. Valor de filtro Caracteres Comprueba la ocurrencia de la cadena de D.T. #.N. NUMBER= NUMBER> NUMBER< NUMBER>= NUMBER<= Valor del atributo de comparación igual que el valor del filtro.T. Valor de atributo de comparación menor que el valor del filtro.N. Por lo tanto.?. Caracteres MATCHREGEX Comprueba la coincidencia exacta de la ocurrencia de la cadena de caracteres patrón de expresiones regulares en la cadena de caracteres de atributos empezando desde la posición de desplazamiento. consulte <modalidad-archivo> “Sentencia SOURCE” en la página 140.C.Z. D.log tail //ATTRIBUTES Apéndice B.C.?.?. Valor de atributo de comparación mayor que el valor del filtro. el primer registro del archivo empieza un bloque de registros. #.Z.R. Características de funciones de filtro Función SCAN Descripción Tipo de atributos Desplazamiento de datos 0<tamaño máx.% Nota: Si el proveedor de datos de archivo está supervisando un archivo en modalidad COPY. El filtro del atributo realiza un filtrado inicial aceptando únicamente aquellos registros de archivos que contengan la cadena de caracteres Procesando inicio de sesión o PRIMER INICIO DE SESIÓN.R. Comprueba la coincidencia exacta de la ocurrencia de la cadena de caracteres de filtro en la cadena de atributos desde la posición de desplazamiento. #.C.T. Tabla 27.U MATCH 0<tamaño máx. #. //APPL ABC //NAME SignOn S 900 //SOURCE FILE f:\IB. 0<tamaño máx. Definiciones de atributos 183 .% 0 0 0 0 0 Numérico Numérico Numérico Numérico Numérico Valor de atributo de comparación mayor o A.G.G.% A.?.G.N.U caracteres patrón de expresiones regulares empezando desde la posición de desplazamiento hasta el final de la cadena de datos de atributo.G. #.R.T. D.G.C.En la siguiente tabla se resumen las características de las diversas funciones de filtro. Caracteres A. o hasta el tamaño máximo de atributo definido.U 0<tamaño máx.U caracteres de filtro en la cadena de caracteres atributos desde la posición de desplazamiento hasta el final de la cadena de datos de atributos o hasta un tamaño de atributo máximo definido.% A.Z.?. Ejemplo 1 El proveedor de datos de archivo de Tivoli Universal Agent supervisa un archivo para actividades de inicio de sesión de un cliente.N. el registro siempre se selecciona y se visualiza en el espacio de trabajo.C. independientemente de si se debe haber excluido debido a un filtro. igual que el valor del filtro.% Valor de atributo de comparación menor o A. Para obtener una descripción completa de la opción COPY. igual que el valor del filtro.R.

PRIMER INICIO DE SESIÓN)} Ejemplo 2 Tivoli Universal Agent supervisa transacciones de aplicaciones. 2. Más específicamente. Puede combinar filtros de expresiones regulares y no regulares en la misma definición de atributo. también puede especificar patrones de expresiones regulares en los filtros de atributos mediante el uso de las funciones de filtro MATCHREGEX y SCANREGEX. Pero en los casos en los que necesita realizar exploraciones de subcadenas de caracteres más sofisticadas.Date D 4 Time D 8 Message Z 256 +FILTER={SCAN(0. //NAME Transaction_Stat e //ATTRIBUTES ’. Determinar en tiempo de ejecución si el valor de atributo que se está examinando coincide con el patrón especificado. y operaciones de búsqueda y sustitución que no sean posibles de otra manera. //NAME Status_Stat e //SOURCE FILE ’C:\Archivos de programa\WebServer\server. El filtro del atributo rechaza todos los datos de entrada con el atributo de transacción “-“ para eliminar los registros de aplicación que no son válidos.log’ //ATTRIBUTES ClientLocation D 256 ClientUserName D 32 Authorized_User K 32 Date_Time DL 20 Time_Zone K 5 Request D 256 ServiceStatus C 99999999 +FILTER={NUMBER>=(0. Tivoli Universal Agent ofrece soporte para filtro de expresiones regulares utilizando las bibliotecas de International Components for Unicode (ICU).Procesando inicio de sesión) OR SCAN(0. El filtrado basado en expresiones regulares está disponible para todos los proveedores de datos porque el filtrado de atributos es común a todos los tipos de metarchivos.’ CustomerName D CustomerAddress D Date D Time D TransactionName D TransactionParameters D 256 32 12 12 256 -FILTER={MATCH(0.-)} 256 Ejemplo 3 Tivoli Universal Agent supervisa un registro de servidor de Internet para códigos de estado del servidor de Internet mayores que 400. Compilar y comprobar la sintaxis del patrón de expresiones regulares suministrado en el metarchivo. que pueden manejar la mayoría de requisitos de filtrado. Estas dos funciones de filtro también dan soporte a parámetros opcionales REPLACEFIRST y REPLACEALL.400)} BytesReceived C 99999999 Referral D 256 Browser D 256 Utilización de expresiones regulares en filtros El lenguaje de metarchivo de Tivoli Universal Agent incluye su propio método patentado de coincidencia de patrones cuando se filtran valores de atributos. El programa de aplicación graba como salida un carácter de guión siempre que un cliente proporcione una solicitud de transacción que no sea válida. las bibliotecas de ICU realizan las siguientes funciones: 1. en las que se puede especificar una cadena caracteres de sustitución para todo o parte del valor de atributo de patrón coincidente. 184 IBM Tivoli Universal Agent: Guía del usuario .

también se puede utilizar el tipo de filtro MATCHREGEX. no utilice la expresión regular porque requiere más sobrecarga del sistema. que no es idéntico a cómo se implementa el soporte de expresiones regulares en regex4j de Perl.^.*$)} En este ejemplo. sed Java y otras implementaciones que tal vez hayan funcionado en su caso en el pasado. Consúltelas cuando codifique filtros de expresiones regulares en los metarchivos. “Expresiones regulares ICU”. a continuación se suministra un ejemplo de metarchivo simple: //APPL REGEX //NAME LOGMONITOR E 300 //SOURCE FILE /var/log/messages Tail //ATTRIBUTES ’. De nuevo. El atributo Message tiene un parámetro +FILTER que acepta cualquier valor de Message que consiste en cualquiera de las dos cadenas de caracteres patrones de expresiones regulares (porque el conector entre las dos condiciones de filtro es OR en lugar de AND). afectará a la salida del espacio de trabajo porque las filas de datos no se han incluido ni excluido de acuerdo con lo previsto.* número de canal fuera de rango. llama a una API de ICU para determinar si el valor de atributo de Message coincide con el patrón número 1 o el patrón número 2 del filtro de expresiones regulares. ’. Estos errores de sintaxis de ICU suelen indicar que no se puede utilizar una definición de filtro en el formato actual y se omite. estos tipos de avisos de validación de metarchivo suelen significar que necesita revistar y modificar el parámetro FILTER para garantizar que el funcionamiento es correcto. En el siguiente ejemplo. coincidencias cualquier carácter.html. Definiciones de atributos 185 . en la página 235 se han extraído de la publicación ICU User Guide en la dirección: http://icu. Por lo tanto.’ Timestamp T 16 Message Z 512 +FILTER={SCANREGEX(0.^. El analizador de metarchivos de Tivoli Universal Agent notifica los errores señalados durante la compilación de ICU de una expresión regular. y ’$’ indican que se tiene que realizar coincidencias al principio de una línea. en vez de una subcadena de caracteres dentro del valor. para transformar los datos de entrada.net/userguide/regexp. se muestra cómo se puede utilizar uno de los parámetros REPLACE de expresiones regulares. Supongamos que un campo de texto de mensaje típico en un archivo de registro contiene el siguiente valor: MSG1991E SYSTEMX encountered failure in Process ABC Y que desea que este valor se visualiza en el espacio de trabajo como: Apéndice B. Si se omite una definición de filtro debido a un problema de sintaxis. Si se devuelve un resultado TRUE para cualquiera de los dos patrones. El tipo de filtro SCANREGEX se ha especificado.*Error al asignar recurso.’ ’*’. pero como el patrón de expresión regular indica que se está buscando una coincidencia exacta de todo el valor de atributo. un metacarácter ’^’ de inicio de línea con un desplazamiento FILTER que no es igual a cero. Para utilizar de forma eficaz el soporte de expresiones regulares en Tivoli Universal Agent. Cuando el proveedor de datos de archivo lee y procesa cada registro nuevo en el archivo /var/log/messages. lo que significa que es idóneo para la evaluación de situaciones y la visualización de espacios de trabajo del portal. Para ilustrar cómo se implementar el soporte de expresiones regulares para filtros de atributos. Las tablas del Apéndice F. Nota: Un atributo FILTER que utiliza una expresión regular consume más CPU que un atributo FILTER que no lo hace. respectivamente. se acepta toda la fila de datos. si tiene una opción entre realizar el filtrado de atributos con o sin una expresión regular. Hay otros avisos de validación que indican un posible problema en un filtro de expresiones regulares.sourceforge. grep. el archivo /var/log/messages se supervisa en modalidad Tail. debe estar familiarizado con las especificaciones de cómo ICU implementa expresiones regulares. coincidencias 0 o más veces y coincidencias al final de una línea.Debe prestar especial atención a cualquier error de metarchivo o mensaje de aviso de los filtros de expresiones regulares. por ejemplo. Los metacaracteres de la expresión regular ^’.*$) OR SCANREGEX(0. junto con una combinación de números de grupo de captura y texto literal.

también se puede encontrar la subcadena de caracteres “03_BackupErr. Cuando la búsqueda de patrones de expresiones regulares se completa para un grupo de atributos RECORDSET. no es una coincidencia. Pero si. la lógica de filtrado de Universal Agent elimina los caracteres CR/LF para poder visualizar mejor los valores de atributo en Tivoli Enterprise Portal. por ejemplo. se suministran dos registros de archivo de varias líneas: <replication-status when="2006-01-18 16:15:11" lastStatus="SUCCESS03" src="C:\TivoliCDP006-01-18_16.*03_BackupErr. los caracteres de retorno de carro/salto de línea (CR/LF) se eliminan cuando se llenan valores de atributos para una fuente de datos de varias líneas.. En el primer registro con varias línea.(MSG199.*\n.==.*$)). en especial ante el servidor de supervisión y el servidor del portal.14. Normalmente. sin embargo.03_BackupLog.14. los caracteres CR/LF se conservan de tal modo que la lógica de filtrado de expresiones regulares pueda explorar todo el almacenamiento intermedio de atributos de varias líneas y buscar los caracteres CF/LF intercalados para cada especificación FILTER. la secuencia en la que los atributos se listan debajo de la sentencia //ATTRIBUTES del metarchivo es la misma secuencia que la que Tivoli Universal Agent utiliza cuando define la aplicación ante otros componentes de IBM Tivoli Monitoring.REPLACEFIRST($3 abended on $2)} A cada cadena de caracteres patrón especificada entre paréntesis se le asigna un número de grupo de captura en secuencia ascendente.replication-status) //ATTRIBUTES Date D 32 DLM=’""’ Message Z 512 DLMSTR=’/>’ +FILTER={ScanRegex(0. se insertan uno o más atributos en medio.14.xml” después del carácter \n coincide con +FILTER.*$)} Un único carácter \n de línea nueva forma parte del patrón +FILTER.03_BackupErr.xml”. por ejemplo. el parámetro REPLACEFIRST puede transformar los datos del atributo de entrada en un formato que sea más adecuado para sus finalidades. Hay consideraciones especiales cuando se utilizan filtros de expresiones regulares con fuentes de datos de varias líneas que especifican la sentencia RECORDET.xml" size="274" priority="3" time="1137622511" ID="568809902500042513"/> Y a continuación. Al asignar la subcadena de caracteres ″Process &processName″ al grupo de captura 3 y la subcadena de caracteres ″SYSTEMx″ al grupo de captura #2. Por lo tanto.*?) (SYSTEM. Secuenciado de definiciones de atributos De forma predeterminada. Si la secuencia del atributo cambia en un grupo de atributos existente.03_BackupErr.).xml" action="Copy" dst="\matrix26\temp\RealTimeBackup\Matrix33\BackupAdmin\Reports006-01-18_16.xml" action="Copy" dst="\matrix26\temp\RealTimeBackup\Matrix34\BackupAdmin\Reports006-01-18_16.14.Process ABC abended on SYSTEMX Puede codificar la definición de atributo del modo siguiente: Message Z 256 +FILTER={SCANREGEX(0. se muestran las sentencias de definición de metarchivo que buscan una subcadena de caracteres específica en el segundo registro: //RECORDSET 10 NEW(0. se supervisa un archivo de registro utilizando RECORDSET con el filtrado de expresiones regulares.03_BackupErr. va delante del carácter \n y por lo tanto. 186 IBM Tivoli Universal Agent: Guía del usuario . sólo el segundo registro de varias líneas. que contiene la subcadena de caracteres “03_BackupErr.xml" size="23043" priority="3" time="1137622511" ID="568809902500042503"/> <replication-status when="2006-01-18 16:15:11" lastStatus="SUCCESS04" src="C:\TivoliCDP006-01-18_16.*?(Process. Tivoli Universal Agent debe asignar un nuevo número de versión principal a la aplicación para que se les notifique al servidor de supervisión y al servidor del portal que la aplicación ha cambiado significativamente. Como ejemplo.

son necesarios tres metarchivos de tres nombres de aplicaciones exclusivos. Definiciones de atributos 187 . por no decir. El siguiente ejemplo representa una definición de metarchivo para un registro de servidor Apache y un registro Microsoft IIS.’ Attr1 D 8 Attr2 D 16 Attr3 D 4 Attr4 Z 128 Si en algún punto en el futuro.Attr2.La principal ventaja del secuenciado de definiciones de atributos con el uso del parámetro SEQ=nn es evitar cambios de versiones importantes para determinados tipos de actualizaciones de metarchivos. seguirá procesando correctamente el nuevo campo Attr5 que se ha insertado entre Attr3 y Attr4. Otra ventaja del secuenciado de atributos es que permite consolidar aplicaciones cuando se trabaja con varios conjuntos de entrada de datos que son muy similares. los registros del servidor WEB de un servidor Apache. como ejemplo sencillo. puede modificar el metarchivo del modo siguiente: Attr1 Attr2 Attr3 Attr5 Attr4 D D D D Z 8 16 4 12 128 Pero esta actualización de metarchivo desencadena una versión de aplicación importante porque Attr4 ya no va inmediatamente después de Attr3. que está supervisando un registro con el siguiente formato: Attr1. Sin la definición de secuencia de atributos. Desde el punto de vista del servidor de supervisión y del servidor del portal.Attr3. Las tres aplicaciones necesitan una cantidad considerable de trabajo para crear situaciones y políticas de Tivoli Monitoring y. el formato del registro de archivo cambia y se inserta un nuevo campo entre Attr3 y Attr4.Attr4 Podría codificar las definiciones de atributos del modo siguiente: //ATTRIBUTES ’. Pero tenga presente que cuando el proveedor de datos de archivo lee y analiza los registros del archivo de entrada. aumentan la complejidad de la gestión de aplicaciones. puede modificar el metarchivo del modo siguiente: Attr1 Attr2 Attr3 Attr5 Attr4 D D D D Z 8 16 4 12 128 SEQ=1 SEQ=2 SEQ=3 SEQ=5 SEQ=4 El uso de los parámetros SEQ permite alterar temporalmente la secuencia del atributo predeterminado. Por ejemplo. Cada metarchivo contiene atributos similares. los formatos de registros son distintos. un servidor Netscape o Microsoft IIS contienen información similar. No obstante. Supongamos. secuenciados en el orden correspondiente de formato del archivo de registro del servidor WEB. prácticamente idénticos. Los archivos de registro se visualizan como la misma aplicación eLog cuando se utilizan definiciones de secuencia de atributos para limar las diferencias: //APPL eLog //NAME ServerLog e //SOURCE FILE d:\Apache\logs\Apache. lo que hace que Tivoli Universal Agent añada el nuevo campo Attr5 al final del grupo de atributos. Para implementar esta actualización únicamente como un cambio de versión secundaria. y eso afecta a las situaciones. sólo se ha producido un cambio de versión de menor importancia. como resultado.log tail //ATTRIBUTES *-------------------------------------------* * Apache Server Log Record Format Layout * *-------------------------------------------* ClientLocation D 256 SEQ=1 Apéndice B. políticas y políticas personalizadas existentes.

’ MessageOrigin D 80 SEQ=5 188 IBM Tivoli Universal Agent: Guía del usuario . Definición de datos de aplicación antigua: //APPL DTY //NAME ConsoleMessage //ATTRIBUTEs ‘.’ MessageID D MessageSeverity C MessageCategory C MessageDescription Z e 12 99 99 255 Nueva definición de datos de aplicación: //APPL DTY //NAME ConsoleMessage e //ATTRIBUTEs ‘.ClientUserName Authorized_User Date_Time Time_Zone Request ServiceStatus BytesReceived Referral Browser Service ServerName RequestParameters BytesSend RequestElapsedTime * D K DL K D C C D D D D D C C 32 SEQ=2 32 20 SEQ=3 5 256 SEQ=9 99999999 SEQ=8 99999999 SEQ=6 256 SEQ=12 DLM=’/"’ 256 SEQ=13 DLM=’""’ 32 SEQ=4 256 SEQ=5 256 SEQ=10 99999999 SEQ=7 99999999 SEQ=11 A continuación. //APPL eLog //NAME ServerLog e //SOURCE FILE C:\Inetpub\logs\IIS. se muestra un metarchivo IIS implementado de una manera tal que conserva los números de secuencia de atributos comunes del metarchivo Apache.log tailbyrecord //ATTRIBUTES ’.’ *-------------------------------------------* * Microsoft IIS W3C Log Record Format Layout* *-------------------------------------------* ClientLocation D 256 SEQ=1 ClientUserName D 32 SEQ=2 Date_Time D 20 SEQ=3 Service D 32 SEQ=4 ComputerName K 64 ServerName D 256 SEQ=5 RequestElapsedTime C 99999999 SEQ=11 BytesReceived C 99999999 SEQ=6 BytesSend C 99999999 SEQ=7 ServiceStatus C 99999999 SEQ=8 WindowsStatus K 99999999 OperationName K 8 Request D 256 SEQ=9 RequestParameters D 256 SEQ=10 PadParm2 K 8 PadParm3 K 8 PadParm4 K 8 PadParm5 K 8 Referral D 256 SEQ=12 Browser D 256 SEQ=13 En el siguiente ejemplo. se evita un cambio de versión importante. un programa cliente de la API empieza a enviar tres nuevos atributos a la aplicación de metarchivo. Al utilizar definiciones de secuencias de atributos.

En el ejemplo anterior.MessageID MessageSeverity MessageCategory MessageAction MessageStatus MessageDescription D C C D D Z 12 SEQ=1 99 SEQ=2 99 SEQ=3 80 16 255 SEQ=4 Un atributo que no incluye una especificación de secuencia se visualiza después de los atributos con especificaciones de secuencias en el orden en que se define en el metarchivo. Apéndice B. el atributo MessageAction se visualiza después del atributo MessageOrigin y va seguido por el atributo MessageStatus. Definiciones de atributos 189 .

190 IBM Tivoli Universal Agent: Guía del usuario .

Correlación de variables MIB con atributos El proceso de convertir variables MIB en grupos de atributos de Tivoli Universal Agent consiste en descender por el árbol OID en busca de una MIB.1 a enteros o caracteres y también define los tamaños de atributo máximos en el metarchivo generado. Acerca de los atributos y los grupos de atributos Los atributos se utilizan para crear situaciones que definan reglas para la supervisión de alertas y excepciones. En la Tabla 28 se muestran los tipos ASN. Cuando los valores de los atributos de alertas enviados al servidor de Tivoli Enterprise Monitoring coinciden con los valores especificados en situaciones. los objetos gestionados asociados con las situaciones cambian su aspecto. Atributos de SNMP Este apéndice presenta información sobre los atributos definidos en las aplicaciones de Tivoli Universal Agent soportadas por el proveedor de datos de SNMP. el nombre del grupo de atributos que se corresponde con el espacio de trabajo SNMP-MANAGER TRAP: SNMP-MANAGERTRAP00 Determinación de las características de los atributos IBM Tivoli Monitoring reconoce sólo dos tipos de datos: entero y carácter. 2007 191 . Trata sobre cómo las variables MIB se correlacionan con atributos de IBM Tivoli Monitoring.1.1 a tipos de IBM Tivoli Monitoring Tipo ASN. puede crear situaciones que supervisen alertas de una gravedad específica o desde un dispositivo determinado. comenzando por un nombre de objeto MIB especificado. Se crea un nuevo grupo de atributos para cada nuevo grupo de variables escalares encontradas y uno para cada nueva tabla conceptual. Por ejemplo.1 INTEGER Definición INTEGER (-2147483648. Tabla 28. Cada vez que se crea un nuevo grupo de atributos. alertando sobre problemas o cualquier acción iniciadas en asociación con aplicaciones. También proporciona descripciones de los atributos en los siete grupos de atributos asociados con la aplicación SNMP-MANAGER.4294967295) Tipo de IBM Tivoli Monitoring INTEGER (-2147483648.2147483647) INTEGER (0. definidos en la especificación SMIV1 y los tipos de IBM Tivoli Monitoring correspondientes. cómo se denominan los grupos de atributos y cómo se determinan las características de los atributos.. 2003.2147483647) © Copyright IBM Corp. El proceso de conversión de MIB a metarchivo de Tivoli convierte tipos ASN.2147483647) INTEGER (0.... todas las variables MIB dentro del mismo ámbito del grupo se definen como atributos dentro del grupo.Apéndice C. Denominación de grupos de atributos Los nombres de los grupos de atributos tienen el formato AAANNNVV donde: AAA NNN VV es el nombre de la aplicación es el nombre del grupo de atributos es el número de versión de la aplicación Por ejemplo. Tabla de conversión de ASN.

Gauge y Counter.. Se trata como una cadena de caracteres con una longitud máxima de 1024.. Tabla de conversión de ASN.n)) Definición Una secuencia de cero o más octetos (bytes). se utilizará un valor predeterminado de 256 y puede producirse truncamiento.2147483647) Matriz de caracteres de tamaño 32 ENUM TimeTicks Gauge Counter IpAddress NetworkAddress Opaque Matriz de caracteres de tamaño 32 Matriz de caracteres de tamaño 256 Nota: Hay una discrepancia entre los tipos de IBM Tivoli Monitoring soportados y la especificación SMIv1.4294967295) INTEGER (0.. Esta es la dirección de entero de 4 bytes convertida a una cadena con un nombre de host o una dirección decimal separada por puntos. Igual que la anterior Cadena de octetos Tipo de IBM Tivoli Monitoring Matriz de caracteres de tamaño N OID Matriz de caracteres de un tamaño máximo de 1024 Entero con signo de 32 positivo INTEGER (0.2147483647) INTEGER (0... De acuerdo con SMIv1. que es el límite superior del entero sin signo de 32 bits.4294967295) INTEGER (0.2147483647) INTEGER (0. Sin embargo. los contadores de 32 bits tienen un valor máximo de 4294967295. Una secuencia de enteros no negativos en notación separada por puntos. Si el tamaño no está definido.1 a tipos de IBM Tivoli Monitoring (continuación) Tipo ASN. Grupos de atributos MIB-2 La aplicación MIB-2 consiste de 17 grupos de atributos: v ATTABLE v EGP v v v v v v v v v v v v v v EGPNEIGHTABLE GLOBALVARIABLES ICMP IFTABLE INTERFACE IP IPADDRTABLE IPNETTOMEDIATABLE IPROUTETABLE SNMP SYSTEM TCP TCPCONNTABLE UDP v UDPTABLE 192 IBM Tivoli Universal Agent: Guía del usuario .4294967295) Cadena de octetos SIZE((4)).Tabla 28. IBM Tivoli Monitoring sólo da soporte a enteros con signo de 32 bits. Una lista de enumeración INTEGER (0... y ésta es la razón por la que hay un máximo de 2147483647 para los tipos de atributos numéricos de Universal Agent como por ejemplo.1 OCTETS (SIZE(0.

Dónde encontrar más información acerca de los atributos MIB-2 Para obtener información sobre los atributos MIB-2. Tenga en cuenta que esta información sirve de complemento de las descripciones de espacio de trabajo de SNMP-MANAGER que figuran en “Espacios de trabajo de la aplicación SNMP-MANAGER” en la página 84. Atributos de SNMP 193 . Grupos de atributos SNMP-MANAGER La aplicación SNMP-MANAGER consiste en siete grupos de atributos: v MANAGED-NODES v MIBNODATA v MIBSTATUS v NETSUMMARY v NETWORK v ROUTER v TRAP Los atributos en estos grupos se tratan en detalla en los siguientes apartados. consulte la MIB RFC1213 correspondiente o vea las descripciones de atributos disponibles en el sistema de ayuda en línea de Tivoli Universal Agent. Apéndice C.

Grupo de atributos MANAGED-NODES Este grupo de atributos permite supervisar la información acerca de los nodos identificados en la lista de favoritos. Entradas válidas v Cadena de texto v Hasta 256 caracteres Ejemplo *SCAN SNMP-MANAGERMANAGED-NODES00.Node_Description *EQ hub Node_Status El estatus operativo actual del nodo. quizá desee crear una situación que le notifique siempre que uno de los dispositivos o hosts listados pase a estar fuera de línea.Name *EQ Everest Node_Description La descripción de las características del nodo como están definidas por un administrador de red o por el fabricante del dispositivo.0 Current_Response_Time_ms El tiempo de respuesta de viajes de ida y vuelta para solicitudes de ping enviadas desde el proveedor de datos de SNMP al nodo.Address *EQ 127.Current_Response_Time_ms *GE 500 Name El nombre de nodo resoluble Entradas válidas v Cadena de texto v De hasta 128 caracteres Ejemplo *SCAN SNMP-MANAGERMANAGED-NODES00. Ejemplo *SCAN SNMP-MANAGERMANAGED-NODES00. Address La dirección IP del nodo gestionado.0. Por ejemplo.0. Entradas válidas Una dirección IP decimal separada por puntos. Entradas válidas v On-line v Off-line 194 IBM Tivoli Universal Agent: Guía del usuario . Entradas válidas Milisegundos Ejemplo *SCAN SNMP-MANAGERMANAGED-NODES00.

Entradas válidas Los tipos válidos son: Repeaters Bridges Gateways Hosts Applications IP Node El nodo soporta los protocolos de capa 1 (capa física). El nodo soporta el funcionamiento de red de extremo a extremo. tal como está definido en la especificación de la variable MIB sysServices de RFC 1213 System Group estándar de Internet. Atributos de SNMP 195 .Hosts.Node_Type *EQ Gateways. El nodo soporta los protocolos de capa 2 (enlace de datos y subred).Ejemplo *SCAN SNMP-MANAGERMANAGED-NODES00. El nodo da soporte a protocolos de capa 3 (entre redes) como los direccionadores IP. Ejemplo *VALUE MANAGED-NODES00. El nodo es capaz de ejecutar aplicaciones de red como servidores de correo. Utilización Utilice una cadena delimitada por comas para especificar varios tipos.Node_Status *EQ Off-line Node_Type El tipo de nodo de red. Un host IP válido sin agentes SNMP activos.IP Node Status_TimeStamp La fecha y la hora en que se comprobó por última vez el estatus del nodo Entradas válidas El formato es aaaa/mm/dd hh:mm:ss mmm Ejemplo 2005/04/30 14:23:55 010 Apéndice C.

Grupo de atributos MIBNODATA Los atributos MIBNODATA identifican las tablas MIB de las cuales los agentes de supervisión no devuelven datos. Entradas válidas v Cadena de texto v Hasta 32 caracteres. Entradas válidas v Cadena de texto v Hasta 216 caracteres. No_Data_Tables Una lista de tablas de empresa para las que el agente no devuelve datos. 196 IBM Tivoli Universal Agent: Guía del usuario . Entradas válidas v Cadena de texto v Hasta 64 caracteres. Enterprise_Module El nombre de empresa de la MIB de recopilación de datos. Node_Name Nombre de nodo del sistema gestionado.

grupos de atributos y agentes para los que esté recopilando datos. Attribute_Group El nombre del grupo de atributos para el cual se están recopilando datos Entradas válidas v Cadena de texto v Hasta 32 caracteres Ejemplo *SCAN SNMP-MANAGERMIBSTATUS00.Grupo de atributos MIBSTATUS Los atributos MIBSTATUS permiten supervisar el estatus de las MIB.{sparta public} Monitor_Interval El intervalo de supervisión activo actualmente Entradas válidas v segundos Last_Sample_TimeStamp La fecha y la hora en que los datos se muestrearon por última vez Entradas válidas El formato es aaaa/mm/dd hh:mm:ss mmm Ejemplo 2005/04/30 14:23:55 010 Apéndice C.Attribute_Group *EQ MIB-2EGP00 Enterprise El nombre de la empresa en la MIB en la que se basa la aplicación supervisada Entradas válidas v cadena de texto v hasta 64 caracteres Monitor_Agent_Info Una cadena de pares de nombre de host–nombre de comunidad para los hosts que se están supervisando actualmente Entradas válidas v delimitados por llaves v separados por comas Ejemplo {athens public}. Atributos de SNMP 197 .

Grupo de atributos NETSUMMARY Los atributos del grupo de atributos NETSUMMARY proporcionan información de alto nivel para todas las redes de la empresa. de los paquetes de datos del proveedor de datos de SNMP que se encuentran en esta red Entradas válidas v entero Inactive_Nodes El número total de nodos de red que están inactivos. de los paquetes de datos del proveedor de datos de SNMP a los nodos que se encuentran en esta red Entradas válidas v entero Network_Address Dirección de Internet de 32 bits de la subred de la red TCP/I Entradas válidas v formato decimal separado por puntos 198 IBM Tivoli Universal Agent: Guía del usuario . incluidas las direcciones de red sin ocupar disponibles en esta red Entradas válidas v entero Managed Indica si una red en particular se está gestionando Entradas válidas v Sí v No Max_RespTime_ms El tiempo de respuesta máximo observado. en milisegundos. Active_Nodes El número total de nodos de red que están activos en la actualidad Entradas válidas v entero Curr_RespTime_ms El tiempo de respuesta actual. de los paquetes de datos del gestor SNMP a los nodos que se encuentran en esta red Entradas válidas v entero Min_RespTime_ms El tiempo de respuesta mínimo observado. en milisegundos. en milisegundos.

0.36.0 Network_Mask La máscara de red de una dirección de red descubierta Entradas válidas v formato decimal separado por puntos Ejemplo 127. Atributos de SNMP 199 .198.0.0 Network_Routers Una lista de direccionadores que sirven a esta red Entradas válidas v hasta 256 caracteres v separados por comas Ejemplo smbb7k-s23.0.wlbbags-s3.210.Ejemplo 127.1 Apéndice C.0.

tal como está definido en la especificación de la variable MIB sysServices de RFC 1213 System Group estándar de Internet.Grupo de atributos NETWORK El grupo de atributos NETWORK contiene atributos relativos a la topología de red. El valor de este atributo corresponde a la especificación de la variable MIB sysDescr de RFC 1213 System Group. El valor de este atributo corresponde a la especificación de la variable MIB sysLocation de RFC 1213 System Group. Address La dirección de red de Internet de un nodo dentro de una red gestionada Entradas válidas v dirección decimal separada por puntos Description La descripción de las características del nodo como están definidas por un administrador de red o por el fabricante del dispositivo. Entradas válidas v hasta 128 caracteres Name El nombre asignado a este nodo Entradas válidas v hasta 128 caracteres SNMP_Enabled Indica si un agente de SNMP MIB-2 está activo en el nodo de red Entradas válidas v Sí v No Status El estatus operativo actual del nodo de red Entradas válidas Los estatus posibles se muestran en la tabla siguiente: On-line Inactive Se ha establecido contacto con el nodo y está operativo El nodo no está operativo y no responde a las solicitudes SNMP Get o solicitudes ping Type El tipo de nodo de red. 200 IBM Tivoli Universal Agent: Guía del usuario . Entradas válidas v hasta 256 caracteres Location La información de ubicación del nodo como está definida por un administrador de red.

Ejemplo Applications. El nodo soporta el funcionamiento de red de extremo a extremo. Atributos de SNMP 201 . El nodo da soporte a protocolos de capa 3 (entre redes) como los direccionadores IP. Utilización Puede entrar una cadena delimitada por comas para especificar varios tipos. El nodo soporta los protocolos de capa 2 (enlace de datos y subred).Bridges Apéndice C.Hosts. El nodo es capaz de ejecutar aplicaciones de red como servidores de correo. Un host IP válido sin agentes SNMP activos.Gateways.Entradas válidas Los tipos válidos son: Repeaters Bridges Gateways Hosts Applications IP Node El nodo soporta los protocolos de capa 1 (capa física).

127.0.0. Destination_Networks Una lista de las direcciones de red servidas por un direccionadores Entradas válidas v direcciones decimales separadas por puntos v delimitas por comas Ejemplo 127. El valor de este atributo corresponde a la especificación de la variable MIB sysDescr de RFC 1213 System Group.0.0.0.0.0 Router_Description Una descripción de las características del direccionador. Entradas válidas v hasta 256 caracteres Router_Name El nombre asignado a este direccionador Entradas válidas v hasta 64 caracteres Router_Status El estatus actual del direccionador Entradas válidas Los estatus posibles son: Verify On-line Off-line El proveedor de datos de SNMP está en proceso de verificar el estatus del direccionador.0.Grupo de atributos ROUTER El grupo de atributos ROUTER contiene información relativa a los direccionadores en la empresa. tal como la ha definido el fabricante del dispositivo. El direccionador no está operativo 202 IBM Tivoli Universal Agent: Guía del usuario .1 Route_Count El número total de subredes direccionables definidas para este direccionador Entradas válidas v enteros Router_Address La dirección de red de Internet del direccionador Entradas válidas v formato decimal separado por puntos Ejemplo 127. El direccionador está activo y operativo.

Atributos de SNMP 203 .Passive El direccionador es un daemon y no está participando de forma activa en la operación de la red. Apéndice C.

Consulte el Apéndice E. El nombre es sensible a mayúsculas y minúsculas.Grupo de atributos TRAP El grupo de atributos TRAP describe toda la información conocida acerca de las condiciones de excepción recibidas por el proveedor de datos de SNMP. rodee los valores de comillas dobles (““). La mayoría de los valores de los atributos en este grupo pueden definirse en el archivo de configuración de condiciones de excepción. en la página 229 para obtener más información. “Configuración de condiciones de excepción de SNMP”. 204 IBM Tivoli Universal Agent: Guía del usuario . Description La descripción de la condición de excepción como se define en el archivo de configuración de condiciones de excepción. En la definición de situación. Alert_Name El nombre de alerta asociado con una condición de excepción como se define en el archivo de configuración de condiciones de excepción Entradas válidas v hasta 32 caracteres Category La categoría del suceso que ha generado la condición de excepción como se define en el archivo de configuración de condiciones de excepción Entradas válidas Las categorías predeterminadas son: v Sucesos de umbral v Sucesos de topología de red v Sucesos de error v Sucesos de estatus v Sucesos de configuración de nodo v v v v v Sucesos de alerta de aplicación (valor predeterminado) Sucesos de todas las categorías Registrar sólo sucesos Correlacionar sucesos Pasar por alto sucesos Utilización En la definición de situación. rodee los valores de comillas dobles (““). Entradas válidas v hasta 256 caracteres Enterprise_Name La forma textual abreviada del ID de objeto empresarial como se define en el archivo de configuración de condiciones de excepción Entradas válidas v hasta 64 caracteres Utilización Debe especificar el nombre exactamente como aparece en el archivo de configuración de condiciones de excepción.

Generic_Trap
En número de condición de excepción genérica

Entradas válidas
Uno de: 0 1 2 3 4 5 6 ColdStart WarmStart LinkDown LinkUp Error de autentificación EGPNeighborLoss Condición de excepción específica de la empresa

Ejemplo
*SCAN SNMP-MANAGERTRAP00.Generic_Trap *EQ 2

Object ID
El identificador que identifica exclusivamente la condición de excepción en el MIB

Entradas válidas
v cadena de texto v hasta 512 caracteres

Severity
La gravedad de la condición de excepción como se define en el archivo de configuración de condiciones de excepción

Entradas válidas
v cadena de texto v hasta 32 caracteres

Source_Name
El nombre de host o dirección IP del agente de SNMP que ha enviado la condición de excepción

Entradas válidas
v cadena de texto v hasta 64 caracteres

Source_Status
Identifica un estatus con una fuente como se define en el archivo de configuración de condiciones

Entradas válidas
v cadena de texto v hasta 32 caracteres

Source_Type
Especifica con más detalles una categoría fuente de condiciones de excepción de SNMP como se define en el archivo de configuración de condiciones de excepción
Apéndice C. Atributos de SNMP

205

Entradas válidas
v cadena de texto v hasta 32 caracteres

Specific_Trap
El número de condición de excepción específico de la empresa. Sólo se aplica cuando Generic_Trap = 6.

Entradas válidas
v entero

Time_Stamp
La fecha y la hora en que se ha producido la condición de excepción

Entradas válidas
El formato es SAAMMDDHHMMSSmmm, donde
S AA MM DD HH MM SS mmm = = = = = = = = Siglo (1 para el XXI) Año Mes Día Hora Minuto Segundo Milisegundo

Value_List
Una cadena con todos los datos de una lista de vinculación variable de condición de excepción

Entradas válidas
La cadena se construye de la siguiente manera:
{OID[tipo]=valor}{OID[tipo]=valor}{oid[tipo]=valor}...

donde: oid tipo valor define el identificador de objeto variable MIB es el tipo ASN.1 es el valor de la variable

Cada triplete está delimitado por llaves ({ }). Si se importa un metarchivo que contenga los nombres de las variables en la condición de excepción recibida, utilice nombres de variables en lugar de OID puros:
{nombreVariable=valor}

Ejemplo
*SCAN SNMP-MANAGERTRAP00.Value_List *EQ datagram=error

206

IBM Tivoli Universal Agent: Guía del usuario

Apéndice D. Mandatos de consola
Este apéndice contiene descripciones y sintaxis de los mandatos de consola que puede utilizar con los proveedores de datos de Tivoli Universal Agent.

Utilización de mandatos de consola
La interfaz de mandatos de consola permite controlar dinámicamente la configuración operativa de un sistema Tivoli Universal Agent. Este servicio es particularmente útil ya que permite que Tivoli Universal Agent dé soporte a aplicaciones sin interrupción cuando nuevas aplicaciones pasan a estar en línea o cambian los atributos. La interfaz se invoca utilizando el programa KUMPCON. Además, también existe la posibilidad de emitir mandatos de consola desde Tivoli Enterprise Portal. Para emitir mandatos desde Tivoli Enterprise Portal, pulse con el botón derecho del botón en un sistema gestionado de Tivoli Universal Agent, y seleccione la opción Actuación... . Para obtener más información acerca de los mandatos de actuación, consulte la publicación Tivoli Enterprise Portal Administrator’s Guide o la ayuda en línea de Tivoli Universal Agent. Los mandatos de consola se resumen en la Tabla 29 en la página 209 y se describen con mayor detalle en los siguientes apartados. Los mandatos disponibles mediante Actuación están marcados con un asterisco (*).

Invocación de la interfaz de mandatos de consola en el sistema operativo Windows
Los mandatos de consola se invocan desde la línea de mandatos mediante el programa KUMPCON:
mandato KUMPCON [parámetro]

También puede llamar al programa kumpcon desde dentro de un script, lo cual es útil para automatizar aquellas tareas que se realizan frecuentemente. Para que se ejecute el programa KUMPCON, deberá ser capaz de encontrar sus bibliotecas compartidas. En los sistemas operativos Windows, las bibliotecas compartidas se encuentran en el mismo directorio que el programa KUMPCON por lo que no tendrá problema alguno en encontrarlas. Puede obtener una lista de los mandatos de consola válidos entrando:
KUMPCON ?

Puede entrar un mandato de forma abreviada. Por ejemplo, puede entrar el mandato DELETE como DELETE o D y el mandato SHOW como SHOW o SHO. Se permiten caracteres tanto en mayúsculas como en minúsculas. El programa convierte todos los caracteres de mandato de entrada a mayúsculas para su validación.

Invocación de la interfaz de mandatos de consola en los sistemas operativos UNIX
En sistemas operativos UNIX, no es posible ejecutar el programa KUMPCON directamente. En su lugar, utilice el script de shell um_console, que sirve como contenedor para KUMPCON. El script um_console establece las variables de entorno correctas para que KUMPCON pueda encontrar las bibliotecas compartidas, los paquetes de recursos y otros archivos que necesita para ejecutar correctamente. En los sistemas operativos UNIX, escriba el siguiente mandato:
um_console -h <dir_instalación>

Nota: El parámetro -h es necesario si no ha establecido la variable de entorno <dir_instalación> con anterioridad.

© Copyright IBM Corp. 2003, 2007

207

Llame a um_console sin especificar ningún mandato de consola. Después de que el script invoque el programa KUMPCON, se le solicitará un mandato:
Entre el mandato de la consola <Nombre de aplicación o Nombre de metarchivo o nombre de archivo>

Especificación de nombres de metarchivo y de aplicación en los mandatos
Cuando se especifica un metarchivo, deber utilizar exactamente el mismo nombre utilizado cuando se definió dicho metarchivo por primera vez en Tivoli Universal Agent. Por ejemplo, si se ha importado un metarchivo en Tivoli Universal Agent utilizando su nombre calificado al completo, deberá utilizar el nombre calificado al completo en los otros mandatos de consola. Y de forma inversa, si se ha definido un metarchivo en Tivoli Universal Agent utilizando un nombre no calificado, deberá utilizarse dicho nombre no calificado en el resto de mandatos. Algunos mandatos de consola aceptan el nombre de aplicación de Tivoli Universal Agent como parámetro de entrada en lugar del nombre de metarchivo. En dichos casos, el nombre de la aplicación es sensible a mayúsculas y minúsculas y debe coincidir exactamente con el nombre de la aplicación especificada en la sentencia APPL en el metarchivo. Si ha creado subdirectorios en el directorio de trabajo, puede realizar la referencia a un metarchivo o a una aplicación utilizando una vía de acceso relativa:
kumpcon import .\SNMP\standard\RFC1213_mib-2.mdl

Si el nombre de metarchivo contiene blancos intercalados, debe delimitarlos con comillas simples y dobles; por ejemplo:
kumpcon refresh "’C:\Archivos de programa\test\myappl.mdl’"

Sistemas de varias interfaces
Si ejecuta kumpcon en un sistema con varias interfaces y ha configurado Tivoli Universal Agent para utilizar una interfaz en particular mediante la variable de entorno KUM_DCH_HOST_NAME, necesitará establecer la variable de entorno KUMP_API_DPAPI_HOST con el mismo valor si está enviando mandatos al proveedor de datos de ASFS o de servidor de API.

Códigos de retorno
Si emita mandatos de consola dentro de scripts y necesita comprobar los códigos de retorno, KUMPCON sólo tiene dos posibles códigos de retorno:
0 -1 - Mandato satisfactorio - Mandato erróneo

Envío de mandatos de consola a una instancia de Tivoli Universal Agent alternativa
La interfaz de la consola de mandatos de un Tivoli Universal Agent no primario requiere que se especifique la variable de entorno KUMP_DPCONSOLE_PORT para tener como destino el Tivoli Universal Agent correcto. De forma predeterminada, el Tivoli Universal Agent de destino es el primario y utiliza el puerto de consola 7700. Para impedir que emita parámetros de forma accidental para un Tivoli Universal Agent equivocado cuando se está accediendo a una instancia alternativa de Tivoli Universal Agent mediante la interfaz de consola, el Nombre de instancia aparece junto a cada proveedor de datos en el indicador para introducir el proveedor de datos de destino. La siguiente captura de pantalla muestra cómo al configurar KUMP_DPCONSOLE_PORT en 8700 se provoca que los proveedores de datos TEST aparezcan listados para que se sepa a qué instancia de Tivoli Universal Agent se está accediendo. Puede determinar el puerto correcto de escucha de la consola a utilizar comprobando el espacio de trabajo UAGENT DPLOG.

208

IBM Tivoli Universal Agent: Guía del usuario

La interfaz de actuación no tiene este problema de ambigüedad. Cuando distribuya una acción como Importar o Renovar, la lista de nombres de sistemas gestionados disponibles incluye el prefijo Nombre de instancia para que siempre pueda seleccionar el proveedor de datos adecuado.
Tabla 29. Resumen de los mandatos de consola Mandato de consola DELETE* GENERATE Descripción Elimina una especificación definida de datos de aplicación Crea un metarchivo de ODBC completo y sintácticamente correcto cuando se le proporciona un nombre de fuente de datos como entrada. Carga e inicializa una definición de datos de aplicación. Lista las aplicaciones definidas actualmente. Carga e inicializa la tabla de nombres de comunidad del agente, KUMSCOMM. Carga las listas de nodos gestionados (listas de favoritos). Carga e inicializa la tabla de nombres simbólicos de red, KUMSNAME. Añade una entrada en una lista de nodos gestionados. Elimina una entrada de una lista de nodos gestionados. Reinicia una definición de datos de aplicación. Permite redirigir los mandatos de consola a un Tivoli Universal Agent apropiado que esté ejecutándose en un host distinto del host desde el que se emiten los mandatos. Muestra los detalles de definición de datos de la aplicación. Inicia el procedimiento normal de conclusión. Ordena al proveedor de datos de SNMP que renueve el archivo de configuración de excepción de SNMP. Desempaqueta el metarchivo de SNMP de entrada y produce de salida la versión idéntica descomprimida del metarchivo en la misma ubicación del metarchivo de entrada. Ordena a Tivoli Universal Agent que valide el metarchivo especificado.

IMPORT* LIST LOADCOMM* LOADLIST* LOADNAME* MNL ADD NODE* MNL REMOVE NODE* REFRESH* SET

SHOW SHUTDOWN* TRAPCNFG* UNPACK

VALIDATE

* Estos mandatos también están disponibles utilizando una selección de actuación.

Apéndice D. Mandatos de consola

209

DELETE
El mandato DELETE elimina una aplicación definida del repositorio de Tivoli Universal Agent. Si la aplicación está activa, Tivoli Universal Agent desconecta la conexión de la aplicación y ″anula su registro″. Cualquier sistema gestionado por IBM Tivoli Monitoring asociado con la aplicación que se encuentre en línea pasará a estar fuera de línea. El nombre del metarchivo se elimina automáticamente del archivo de inicialización de configuración KUMPCNFG para que la aplicación no se active la próxima vez que se reinicie Tivoli Universal Agent.

Sintaxis
KUMPCON DELETE [nombre-aplicación | nombre-metarchivo]

Parámetros
Puede especificar el nombre de la aplicación de Tivoli Universal Agent o el nombre del metarchivo. <nombre-aplicación> Especifica la aplicación de Tivoli Universal Agent. El nombre de la aplicación de Tivoli Universal Agent se especifica en la sentencia APPL en el metarchivo de definición de datos. <nombre-metarchivo> Especifica el nombre de metarchivo

Utilización
Establezca la variable de entorno siguiente antes de invocar el mandato kumpcon delete para evitar un indicador de confirmación de supresión:
KUMP_DPCONSOLE_NOCONFIRM=Y

La emisión del mandato delete desde un script automatizado es un ejemplo de cuándo debe utilizarse esta variable de entorno.

210

IBM Tivoli Universal Agent: Guía del usuario

Los parámetros ″user=″ y ″pswd=″ son obligatorios para conectarse a dicha fuente de datos. y especificando una cadena inicial de caracteres para realizar una comparación de patrones con alguna de los tres tipos de tablas. No está disponible mediante actuación. puede indicar si desea incluir tablas de usuario. KUMPCON GENERATE teps2 user=TEPS pswd=abcdef Este mandato genera un metarchivo en el directorio de metarchivos denominado teps2. Si no se necesita ninguna combinación de ID de usuario/contraseña para esta fuente de datos específica. deberá rodearse de comillas simples. Mandatos de consola 211 . tablas del sistema o vista mediante las opciones de menú e indicadores de mandatos. vistas o una combinación de las tres. Después de aceptar la entrada de la consola. los valores de usuario y contraseña se insertan en cada sentencia //SOURCE en el metarchivo de ODBC generado. Ejemplos Los siguientes ejemplos ilustran maneras de invocar el mandato GENERATE: KUMPCON GENERATE nwind Este mandato genera un metarchivo en el directorio de metarchivos llamado nwind. Este mandato da soporte a la generación completa de tablas definidas por la fuente de datos especificada. El mandato GENERATE no da soporte a la creación de metarchivos para procedimientos almacenados. Sintaxis KUMPCON GENERATE NombreFuenteDatos user=IDusuario pswd=contraseña Parámetros <NombreFuenteDatos> Indica el nombre específico de la fuente de datos configurada utilizado para crear el metarchivo de ODBC. También puede limitar qué tablas se general seleccionando tablas de usuario. Apéndice D. Si la fuente de datos contiene espacios en blanco incorporados. puede omitir el parámetro user= del mandato GENERATE <contraseña> Contraseña asociada con el ID de usuario que se conectará con la fuente de datos ODBC. GENERATE sólo es accesible en los sistemas operativos Windows y únicamente mediante la interfaz de consola kumpcon. <IDusuario> ID de usuario necesario para conectar a la fuente de datos ODBC.GENERATE El mandato GENERATE crea automáticamente un metarchivo de ODBC completo y sintácticamente correcto cuando se le proporciona un nombre de fuente de datos como entrada.mdl que contiene todas las tablas y columnas en la fuente de datos nwind.mdl que contiene cada tabla y columna en la fuente de datos teps2. tal como se muestra en la Figura 13 en la página 212. tablas de sistema. Este parámetro es obligatorio. Puede iniciar este mandato incluso si Tivoli Universal Agent no se está ejecutando. Si se especifican.

Cada contexto de base de datos a puede tener un conjunto de tablas de usuario distinto asociado al mismo. Una generación completa de una fuente de datos ODBC puede resultar en cientos o incluso miles de sentencias //NAME. También es posible realizar una comparación de patrones en una cadena inicial en el nombre de tabla. considere la posibilidad de (1) establecer la variable de entorno KUMA_MAX_ATTRGROUPS_PER_APPL en un número mayor (se puede especificar un máximo de 256). conteste Y (Sí) en el indicador. de forma opcional. se le preguntará si desea sustituirlo. podrá crear un metarchivo más centrado y personalizado. Si desea generar un metarchivo para un contexto de base de datos no predeterminado. v Se permite hasta un máximo predeterminado de 127 atributos en un único grupo de atributos. Si ya existe un metarchivo con ese nombre en el directorio \TMAITM6\metafiles. (2) dividir las tablas en varios metarchivos y/o (3) crear sentencias SQL personalizadas en el metarchivo que seleccionen columnas de varias tablas para que no haya más de una relación de uno a uno entre las sentencias SQL Select y las tablas de fuentes de datos. Si este es el caso. 212 IBM Tivoli Universal Agent: Guía del usuario . como SQL Server y Sybase. v Se permite hasta un máximo de 64 tablas en un metarchivo. Ciertos productos de bases de datos. Es posible que 127 no sea suficiente si existen más columnas en una única tabla SQL. Ejemplo de KUMPCON GENERATE (en inglés) Si entra una opción de menú distinta de ″4) Todas las anteriores″. El mandato GENERATE utiliza el nombre de la fuente de datos para determinar el nombre de metarchivo de salida. el nombre de un servidor específico asociado con dicha base de datos. para una fuente de datos ODBC es que a veces puede reducir significativamente el tiempo que tarda en finalizar la generación de metarchivo. Si el contexto de base de datos predeterminado puede pasar por alto este indicador. Una ventaja importante de generar tablas específicas. Ninguna otra aplicación Tivoli Universal Agent con los mismos tres primeros caracteres deberá conectarse al mismo servidor de Tivoli Enterprise Monitoring. y suponiendo que necesita supervisar más de 64 tablas de la fuente de datos.Figura 13. Después de que haya finalizado KUMPCON GENERATE. todos las tablas de sistema que empiezan por ″sys″. Si es así. se le solicitará que entre una base de datos específica a utilizar. Si está generando un metarchivo para cualquiera de estos productos de bases de datos. aunque con toda probabilidad necesita de ciertos cambios. revise las siguientes áreas en el metarchivo para su posible modificación: v Es necesario cambiar los primeros tres caracteres del nombre //APPL para que sean exclusivos. permiten conectarse a una de varias bases de datos asociadas con una fuente de datos determinada. Utilización El metarchivo resultante proporciona un primer paso adecuado hacia la creación de un metarchivo de ODBC útil. entre el nombre de la base de datos y. por ejemplo. en lugar de todas las tablas.

ejecute VALIDATE contra el mismo para asegurarse de que no haya errores o mensajes de aviso que corregir. Los dos problemas anteriores podrían necesitar que se eliminen tablas y atributos no deseados."System". cambie //SQL SELECT * from Tivoli. Cada atributo KEY en cada fila de datos debe tener un valor no en blando y no NULO o bien no se enviará la fila al servidor de datos.’ se tratará como una representación de cadena de caracteres de un entero en lugar como un entero y las comparaciones de situaciones mayor/menor que no funcionarán tal como se ha previsto ni podrá utilizar el atributo en un diagrama o gráfico. Compruebe cualquier atributo numérico que desee utilizar para propósitos de comparación en situaciones o para crear atributos derivados. cambie el tipo de atributo 'D' o 'N' a 'U' para Unicode. Estos deben definirse con uno de los tipos de atributos alfanuméricos verdaderos. Si cualquier carácter de atributo en la tabla relacional contiene datos que no están en inglés.System por //SQL SELECT * from "Tivoli". requieren comillas dobles alrededor de los nombres de tablas que contengan caracteres en minúsculas o especiales. Mandatos de consola 213 . De forma predeterminada. como ’C’ para Counter (contador). Por ejemplo. El mandato GENERATE construye una sentencia //SQL Select * from &tableName para cada grupo de atributos. Revise las sentencias SELECT en el metarchivo generado para nombres de tablas que necesiten comillas dobles. cada sentencia //NAME utiliza el nombre de tabla SQL como su nombre de grupo de atributos. Revise cualquier atributo definido como KEY. Si la sentencia predeterminada “Select * from &tableName” captura demasiados datos.v v v v v v v v v v v v considere dividir el grupo de atributos en grupos de atributos más pequeños que seleccionen respectivamente un subconjunto de todas las posibles columnas SQL. Revise la corrección los tipos de datos de atributos y tamaños máximos en caso de que no sean exactamente lo que desea. que se corresponda con una columna indexada en la tabla SQL. cambie la sentencia //SQL Select por //SQL proc=&procedureName según convenga. elimine la designación KEY. Será necesaria una alteración temporal del parámetro maxrows=<nnn> en la sentencia //SOURCE si el valor predeterminado no es adecuado. por ejemplo. utilice una sentencia Select más calificada con columnas específicas listadas o mediante filtro con la cláusula Where. Después de hacer cambios en el metarchivo generado. Asegúrese de que el valor predeterminado de tiempo de vida de 300 segundos es apropiado. atributos derivados. en el metarchivo de una tabla Oracle. De forma predeterminada. AddTimeStamp y texto de ayuda sobre el atributo. Si se genera un atributo genérico. Puede insertar características de metarchivo de Tivoli Universal Agent opcionales. como por ejemplo DB2 y Oracle. Apéndice D. maxrows se establece con el valor 100 a no ser que sea alterado temporalmente mediante la variable de entorno KUMP_ODBC_MAX_ROWS. como tipo de atributo ’N. Algunos productos de base de datos. Si a la tabla que está supervisando suelen faltarle valores de un atributo KEY. Es posible cambiar algunos o todos estos atributos a nombres más significativos. Si desea utilizar un procedimiento almacenado en lugar de una sentencia Select. como filtros.

214 IBM Tivoli Universal Agent: Guía del usuario . Sintaxis KUMPCON IMPORT nombre-metarchivo Parámetros <nombre-metarchivo> Especifica un nombre de metarchivo existente accesible para el proveedor de datos. el nombre del metarchivo se añade al archivo de inicialización de configuración KUMPCNFG. sólo necesita importar un metarchivo una vez.IMPORT El mandato IMPORT añade una aplicación al repositorio de Tivoli Universal Agent. se cargará el metarchivo de forma automática cuando se reinicie el agente. Si se importa satisfactoriamente el metarchivo. A partir de entonces. Por lo tanto.

Se ignorará cualquier parámetro especificado.mdl TCPioQ.LIST El mandato LIST muestra una lista de aplicaciones de metarchivo conocidas por Tivoli Universal Agent.mdl Apéndice D.mdl CustInq. Sintaxis KUMPCON LIST Parámetros Este mandato no necesita parámetros de entrada. Mandatos de consola 215 . Salida La salida del mandato LIST puede parecerse a la siguiente: No se ha definido ninguna aplicación o bien Definiciones de la aplicación activa: vmstat.

El archivo KUMSCOMM relaciona los nombres de host con los nombres de comunidad SNMP. Sintaxis KUMPCON LOADCOMM Parámetros Este mandato no necesita parámetros de entrada. 216 IBM Tivoli Universal Agent: Guía del usuario .LOADCOMM El mandato LOADCOMM ordena al proveedor de datos de SNMP que vuelva a cargar el archivo KUMSCOMM. Se ignorará cualquier parámetro especificado.

Mandatos de consola 217 .LOADLIST Carga la lista de nodos gestionados de SNMP (también conocida como lista de favoritos). Apéndice D. Sintaxis KUMPCON LOADLIST nombre_lista_nodos_gestionados Parámetros <nombre_lista_nodos_gestionados> Nombre del archivo en el que está definida la lista de favoritos.

El archivo KUMSNAME define los nombres simbólicos de las redes.LOADNAME El mandato LOADNAME ordena al proveedor de datos de SNMP que vuelva a cargar el archivo KUMSNAME. 218 IBM Tivoli Universal Agent: Guía del usuario . Sintaxis KUMPCON LOADNAME Parámetros Este mandato no necesita parámetros de entrada. Se ignorará cualquier parámetro especificado.

Sintaxis KUMPCON MNL Add Node LIST=nombre_lista_nodos_gestionados NODE=nombre_nodo Parámetros <nombre_lista_nodos_gestionados> Nombre de un archivo existente de la lista de nodos gestionados SNMP.MNL ADD NODE Añade un recurso de red a la lista de nodos gestionados. Mandatos de consola 219 . <nombre_nodo> Nombre de recurso a añadir a la lista. Apéndice D.

<nombre_nodo> Nombre de nodo a eliminar de la lista. 220 IBM Tivoli Universal Agent: Guía del usuario . Sintaxis KUMPCON MNL Remove Node LIST=nombre_lista_nodos_gestionados NODE=nombre_nodo Parámetros <nombre_lista_nodos_gestionados> Nombre de un archivo existente de la lista de nodos gestionados SNMP.MNL REMOVE NODE Elimina un recurso de red de una lista de nodos gestionados.

Mandatos de consola 221 . Sintaxis KUMPCON REFRESH nombre-metarchivo Parámetros <nombre-metarchivo> Especifica un nombre de metarchivo existente accesible para el proveedor de datos. Apéndice D. Utilización Establezca la variable de entorno siguiente antes de invocar el mandato kumpcon refresh para evitar un indicador de confirmación de renovación: KUMP_DPCONSOLE_NOCONFIRM=Y La emisión del mandato refresh desde un script automatizado es un ejemplo de cuándo debe utilizarse esta variable de entorno.REFRESH El mandato REFRESH realiza las funciones combinadas de los mandatos DELETE e IMPORT.

Para dirigir los mandatos al Tivoli Universal Agent correspondiente en un host diferente. De forma predeterminada. Necesita emitir SET cada vez que desee emitir un mandato KUMPCON en un host remoto. KUMPCON presupone que debe comunicarse con Tivoli Universal Agent en el mismo host.SET Puede ejecutar el programa KUMPCON en un host diferente de aquel en el que está Tivoli Universal Agent. Se le preguntará qué mandato desea emitir en el host remoto. Sintaxis KUMPCON SET nombrehost Parámetros <nombrehost> Especifica el nombre de host del sistema al que desea dirigir el mandato. emita el mandato SET. 222 IBM Tivoli Universal Agent: Guía del usuario .

mdl Aplicación: UXstatus Grupo: UXsysSta Poll Data TTL=15 SOURCE: API SystemName Display Type Max Size 16 OSversion Display Type Max Size 16 PendingIOwaitRate Counter Type IOstartRate Counter Type OcompleteRate Counter Type AvgWaitThreadQueueSi Counter Type AvgRunThreadQueueSiz Counter Type AvgNumbActivePageFra Counter Type AvgNumbFreePageFrame Counter Type PageInRate Counter Type PageOutRate Counter Type DevInterruptRate Counter Type SystemCallRate Counter Type ThreadContentSwitchR Counter Type AvgUserCPU% Counter Type AvgSystemCPU% Counter Type AvgIdleCPU% Counter Type AvgWaitCPU% Counter Type UDPpktInRate Counter Type UDPpktOutRate Counter Type TCPpktInRate Counter Type TCPpktOutRate Counter Type Apéndice D. Mandatos de consola 223 . El nombre de la aplicación de Tivoli Universal Agent se especifica en la sentencia APPL en el metarchivo de definición de datos.SHOW El mandato SHOW muestra los detalles de una definición de datos de aplicación de Tivoli Universal Agent. Metarchivo: vmstat. <nombre-aplicación> Especifica la aplicación de Tivoli Universal Agent. Sintaxis KUMPCON SHOW [nombre-aplicación | nombre-metarchivo] Parámetros Puede especificar el nombre de la aplicación de Tivoli Universal Agent o el nombre del metarchivo. Mensajes La salida del mandato SHOW puede parecerse a la siguiente: El nombre de metarchivo entrado no está definido o bien Se ha aceptado la entrada de la consola. <nombre-metarchivo> Especifica el nombre de metarchivo.

Si no especifica IMMED. se le preguntará qué proveedor de datos desea detener.SHUTDOWN El mandato SHUTDOWN ordena a Tivoli Universal Agent que inicie el procedimiento de finalización. Sintaxis KUMPCON SHUTDOWN [IMMED] Parámetros IMMED o I (opcional) Inicia la conclusión inmediata de uno o todos los proveedores de datos sin más mensajes ni confirmaciones. 224 IBM Tivoli Universal Agent: Guía del usuario . Tivoli Universal Agent desconecta todas las conexiones de aplicación y realiza una ″anulación de registro″ para cada aplicación activa.

Apéndice D. “Configuración de condiciones de excepción de SNMP”. Consulte el Apéndice E.TRAPCNFG El mandato TRAPCNFG ordena al proveedor de datos de SNMP que renueve el archivo de configuración de condiciones de excepción de SNMP. Se ignorará cualquier parámetro especificado. Sintaxis KUMPCON TRAPCNFG Parámetros Este mandato no necesita parámetros de entrada. en la página 229 para obtener información adicional TRAPCNFG. Mandatos de consola 225 .

primero ejecute el mandato UNPACK.mdl En este mandato.UNPACK Algunos de los metarchivos SNMP más antiguos de Tivoli Universal Agent se han distribuido en un formato comprimido y cifrado. no es necesario incluir dicha parte del nombre de vía de acceso.mdl.mdl situado en el directorio \IBM\ITM\TMAITM6\metafiles\SNMP\vendor. 226 IBM Tivoli Universal Agent: Guía del usuario .\SNMP\vendor\Novel_nwServer. para desempaquetar el metarchivo Novell_nwServer. Por ejemplo.txt. con una extensión . en la misma ubicación de directorio que el metarchivo SNMP de entrada. Por lo tanto. Si necesita crear su propia versión personalizada de un metarchivo SNMP comprimido.txt en el mismo directorio que el metarchivo original. El mandato UNPACK lee el metarchivo SNMP de entrada y genera como salida la versión descomprimida idéntica del metarchivo. Un ejemplo es el metarchivo de MIB-2. Puede ejecutar UNPACK incluso cuando Tivoli Universal Agent no esté activo. RFC1213_mib-2. Sintaxis KUMPCON UNPACK nombre-metarchivo Parámetros <nombre-metarchivo> Nombre del metarchivo que desea desempaquetar. C:\IBM\ITM\TMAITM6>kumpcon unpack . se presupone automáticamente que el directorio de metarchivos local en un sistema operativo Windows es C:\IBM\ITM\TMAITM6\metafiles. puede emitir el siguiente mandato de consola que dará como resultado la creación del archivo de texto Novell_nwServer.

Sintaxis KUMPCON VALIDATE nombre-metarchivo Parámetros <nombre-metarchivo> Nombre del metarchivo que desea validar. con una extensión . Puede iniciar el mandato VALIDATE incluso si Tivoli Universal Agent no está activo.rpt. Nota: Para validar un metarchivo. Estas mismas rutinas se invocan durante el tiempo de ejecución por lo que es útil ejecutar VALIDATE antes de activar un metarchivo nuevo o modificado. en el mismo directorio donde se encuentra el metarchivo. deberá utilizar el programa KUMPCON o el script um_console en los sistemas operativos UNIX. Mandatos de consola 227 . Esto se debe a que debe realizarse la validación en el host donde se encuentran los metarchivos. Apéndice D. Se guardará un informe de validación del metarchivo de la aplicación.VALIDATE El mandato VALIDATE ordena a las rutinas del analizador y comprobador de sintaxis de Tivoli Universal Agent que validen el metarchivo especificado.

228 IBM Tivoli Universal Agent: Guía del usuario .

si es necesario.conf de HP OpenView El archivo trapcnfg tiene un formato muy similar. En ellos encontrará registros de definiciones empresariales y de condiciones de excepción que podrá copiar y pegar en el archivo de configuración de condiciones de excepción oficial. El propósito de estos archivos trapcnfg_Nombremib es ayudarle a construir el archivo trapcnfg. También puede utilizar su propio archivo de configuración. el Proveedor de datos de SNMP lee un archivo de configuración denominado trapcnfg. donde Nombremib es el nombre MIB de la empresa. El Proveedor de datos de SNMP determina la ubicación del archivo de la siguiente manera: si la variable de entorno KUMP_SNMP_TRAPCNFG_FILE está establecida.conf). ya que estas no están definidas por SNMP. 2003. Ubicación del archivo de configuración Es posible colocar el archivo de configuración de condiciones de excepción donde desee. Si esta variable no está establecida. utilice KUMP_SNMP_TRAPCNFG_FILE. El archivo de configuración de condiciones de excepción de SNMP. el proveedor de datos busca trapcnfg en el directorio de trabajo especificado en KUM_WORK_PATH. Por ejemplo: KUMP_SNMP_TRAPCNFG_FILE=C:\ibm\itm\tmaitm6\work\trapd.conf como base del archivo de configuración. Otro es asignar categorías. También contiene instrucciones para la modificación del archivo predeterminado o su sustitución por un archivo de configuración propio. niveles de gravedad e ID de fuente a condiciones de excepción específicas.Apéndice E. pero no idéntico. © Copyright IBM Corp. 2007 229 . al archivo de configuración de condiciones de excepción de HP OpenView Network Node Manager (trapd. Uno de los propósitos de este archivo es convertir la información de condiciones de excepción de SNMP en un formato más legible. estatus e ID de fuente a las condiciones de excepción. Si la base de información MIB en la que se basa un metarchivo de SNMP contiene definiciones de condiciones de excepción. niveles de gravedad. Para utilizar trapd. Es posible modificar el archivo trapcnfg para ajustarlo a las necesidades específicas del sitio añadiendo nuevas condiciones de excepción o definiciones de empresa o bien cambiando las ya existentes. el proveedor de datos busca el archivo especificado en la ubicación del directorio especificado. por lo que es posible copiar el archivo OpenView y reutilizar muchas de las sentencias de definición. trapcnfg Durante el arranque. Configuración de condiciones de excepción de SNMP Este apéndice documenta el archivo de configuración que el Proveedor de datos de SNMP utiliza para representar información de condiciones de excepción en un formato de lectura más sencilla y para asignar categorías. también se distribuirá junto con el metarchivo MIB un archivo denominado trapcnfg_Nombremib.conf Tipos de registros trapcnfg contiene tres tipos de registros o bloques de registros: comentarios Los registros de comentarios comienzan con un signo de número (#). Utilización del archivo trapd.

1. Las definiciones de condiciones de excepción son registros de bloques.1.3.1.1.1.1.6. Tenga en cuenta que la gravedad se expresa en formato decimal mientras que la categoría se expresa en formato textual. Tivoli Universal Agent utiliza la descripción larga delimitada por SDESC y EDESC. El siguiente registro del bloque de registros de tipo 3 es la descripción corta.1.3. El primer tipo se explica por sí mismo.311.4.311. donde la primera señal es un nombre y la segunda es un identificador de objeto (OID) delimitado por llaves ({ }).3. ya que cada definición puede componerse de varios registros. El segundo ejemplo muestra un registro de definición de condición de excepción que define trapName MSNTCOLD como asociado con el OID de empresa 1. El primer ejemplo en la Figura 14 muestra un registro de definición de empresa que define el OID de empresa 1.definiciones de empresa Las definiciones de empresa están formadas por dos señales delimitadas por espacios en blanco.1.1.1. Los niveles de gravedad se convierten en formato textual antes de visualizarse en los informes MIB. La Figura 14 en la página 231 muestra ejemplos del segundo y tercer tipo.1 como MS Windows NT. que Tivoli Universal Agent no utiliza. definiciones de condiciones de excepción Las definiciones de condiciones de excepción están formadas por 8 señales delimitadas por espacios en blanco. número de condición de excepción genérica 0 y número de la condición de excepción específica 0.3.1.6.4. 230 IBM Tivoli Universal Agent: Guía del usuario .

Configuración de condiciones de excepción de SNMP 231 . Ejemplos de tipos de registros de configuración 2 y 3 Apéndice E.Figura 14.

Niveles de gravedad soportados por el Proveedor de datos de SNMP Gravedad 0 1 2 3 4 5 Eliminado Indeterminado Aviso Error leve Crítico Error grave Representación textual Estatus soportados La Tabla 32 muestra los estatus definidos en el archivo de configuración de Tivoli Universal Agent. Categorías soportadas La Tabla 30 muestra las categorías soportadas por Tivoli Universal Agent. Categorías soportadas por el Proveedor de datos de SNMP Categoría 0 1 2 3 4 5 6 7 8 9 Sucesos de umbral Sucesos de topología de red Sucesos de error Sucesos de estatus Sucesos de configuración de nodo Sucesos de alerta de aplicación Sucesos de todas las categorías Registrar sólo sucesos Correlacionar sucesos Pasar por alto sucesos Representación textual La Tabla 31 lista los niveles de gravedad soportados por Tivoli Universal Agent. Estatus soportados por el Proveedor de datos de SNMP Estatus 0 1 2 3 4 5 6 7 Sin cambios Desconocido Activo Marginal Inactivo Sin gestionar Reconocer Usuario1 Representación textual 232 IBM Tivoli Universal Agent: Guía del usuario .Valores predeterminados del archivo trapcnfg Las tablas de este apartado indican los valores predeterminados soportados por el Proveedor de datos de SNMP. Tabla 31. Tabla 32. Tabla 30.

4.4. EDESC Apéndice E.1.6.3. se suministra un ejemplo de un pequeño archivo trapcnfg_mibName que se generó durante el proceso de conversión de MIB: naiAntiVirus {1. IDs de fuente que soporta el Proveedor de datos de SNMP ID de fuente a A C d D E I L m M n N O P r s S t T V ? Aplicación Agente Xnmcollect Demo Recopilador de datos Nvevents Ipmap LoadMIB Shpmon Topología de IP Relacionado con netmon Condiciones de excepción generadas por netmon OSI SA Condiciones de excepción no de IP Tralertd Spappld Agente de seguridad Xnmtrap Trapd Relacionado con proveedores Desconocido Descripción Modificación del archivo trapcnfg Puede añadir registros de definición de empresa o de condiciones de excepción a trapcnfg para ajustarse a sus necesidades de supervisión.1.3401} naiAntiVirusTrap {1.1. Estatus soportados por el Proveedor de datos de SNMP (continuación) Estatus 8 Usuario2 Representación textual ID de fuente soportados La Tabla 33 lista los ID de fuente soportados por trapcnfg. Para ilustrar el proceso de fusión de las definiciones de condiciones de excepción de un archivo trapcnfg_mibName con el archivo trapcnfg de Tivoli Universal Agent.1.6. Tabla 33. También puede modificar los registros existentes. Configuración de condiciones de excepción de SNMP 233 .Tabla 32.3.3401} 6 1 A 1 0 "Sucesos de estatus" SDESC La información de alarma NAI AntiVirus se muestra en el atributo Value_List.

emita el mandato de consola KUMPCON TRAPCNFG para volver a cargar el archivo Modificación de las definiciones predeterminadas Las definiciones predeterminadas se listan como comentarios en trapcnfg. kumpcon en Windows y um_console en UNIX. teniendo en cuenta los cambios. Mandato de consola TRAPCNFG La interfaz de consola de Tivoli Universal Agent. Para modificarlas. v O bien. acepta un argumento de TRAPCNFG que ordena al Proveedor de datos de SNMP que vuelva a cargar el archivo trapcnfg. suprima la señal de comentario (#) y cambie los valores.La primera línea es una sentencia de definición de empresa y debe copiarse en cualquier lugar debajo del siguiente bloque de comentario en trapcnfg: # # enterprises: # Las cuatro líneas siguientes son sentencias de definición de condiciones de excepción que se pueden copiar debajo del siguiente bloque de comentarios en trapcnfg: # # Formatos de condiciones de excepción añadidos por el usuario: # Cualquier cambio que realice en trapcnfg no surtirá efecto hasta que complete las acciones siguientes: v Reinicie el Proveedor de datos de SNMP. 234 IBM Tivoli Universal Agent: Guía del usuario .

Coincidencia con un carácter de salto de página. Coloca comillas entre los siguientes caracteres. El espacio en blanco se define como [\t\n\f\r\p{Z}]. Coincidencia con un carácter de salto de línea. Coincidencia con cualquier carácter que no tenga la propiedad Unicode especificada. Expresiones regulares ICU El siguiente apéndice se ha extraído de la publicación ICU User Guide. \u001B.Apéndice F.. LINE FEED. Coincidencia con un carácter de retroceso. Para obtener más información sobre los límites de palabras. Difiere de ^ en el sentido de que \A no coincide después de una línea nueva dentro de la entrada. \u0007. dígito decimal). Coincidencia con un carácter que no es un espacio en blanco. \E entre comillas. Coincidencia al principio de la entrada. fuera de un [Set] \b. Termina una sentencia \Q . dentro de un [Set] \B \cX \d \D \e \E \f \G \n \N{UNICODE CHARACTER NAME} \p{UNICODE PROPERTY NAME} \P{UNICODE PROPERTY NAME} \Q \r \s \S © Copyright IBM Corp. Esta información es esencial si utiliza la función de expresión regular de Tivoli Universal Agent porque los diferentes lenguajes de programación implementan expresiones regulares de forma ligeramente distinta. CARRIAGE RETURN. Coincidencia si la posición actual está al final de la coincidencia anterior. 2007 235 .. Coincidencia si la posición actual es un límite de palabra. BACKSPACE. omitiendo las marcas de combinación. \b. hasta \E. \u000C. vea ICU Boundary Analysis. Coincidencia con un carácter ESCAPE. \u0008. Coincidencia si la posición actual no es un límite de palabra. Coincidencia con un carácter de control-X. \u000A. Los límites se producen en las transiciones entre caracteres de palabra (\w) y no palabra (\W). FORM FEED. Este apéndice describe las características específicas de la implementación de expresiones regulares ICU. Coincidencia con un carácter de retorno de carro. 2003. \u000D. Metacaracteres de expresiones regulares Carácter \a \A Descripción Coincidencia con un BELL. Coincidencia con cualquier carácter con la categoría general Unicode de Nd (Número. Coincidencia con el carácter citado. Coincidencia con cualquier carácter con la propiedad Unicode especificada. Tabla 34. Coincidencia con un carácter de espacio en blanco. Coincidencia con cualquier carácter que no sea un dígito decimal.

Coincidencia de exactamente n veces. Coincidencia si la posición actual está al final de la entrada. Deben facilitarse exactamente ocho dígitos hexadecimales. tales como ###BOT_TEXT###12 no están soportados en las expresiones regulares ICU. Coincidencia de cero o una vez. Coincidencia de 0 o más veces. \u0009. Pueden suministrarse desde uno hasta seis dígitos hexadecimales. 236 IBM Tivoli Universal Agent: Guía del usuario . Metacaracteres de expresiones regulares (continuación) Carácter \t \uhhhh \Uhhhhhhhh Descripción Coincidencia con un carácter de tabulación horizontal. Coincidencia de 1 o más veces. Coincidencia con el carácter con el valor hexadecimal hhhh. Los caracteres que deben tener comillas delimitadoras que se tratarán como literales son * ? + [ ( ) { } ^ $ | \ . Coincidencia al principio de una línea. Coincidencia con un carácter que no es de palabra. A|B coincide con A o con B. Consulte UnicodeSet para obtener una descripción completa de lo que puede aparecer en el patrón Coincidencia con cualquier carácter. si existe alguno. aunque el punto de código Unicode más largo es \U0010ffff.Tabla 34. Referencia inversa. ^ $ \ Tabla 35. Nota: Los valores de escape octal. n debe ser un número > 1 y < número total de grupos de captura del patrón. Coincidencia con el carácter con el valor hexadecimal hhhhhhhh. Coincidencia con un Grapheme Cluster. pero antes del terminador de la línea final. Es preferible una vez. Hacer coincidir las veces que sea posible. Coincidencia con cualquier carácter individual del grupo. Operadores de expresiones regulares Operador | * + ? {n} Descripción Alternancia. Coincide con aquello que coincida el grupo de captura número n. Los caracteres de palabra son [\p{Ll}\p{Lu}\p{Lt}\p{Lo}\p{Nd}]. Hacer coincidir las veces que sea posible. Coincidencia del carácter con el valor hexadecimal de dos dígitos hh. Coincidencia si la posición actual está al final de la entrada. Colocar comillas entre los caracteres siguientes. / \w \W \x{hhhh} \xhh \X \Z \ \z \n [patrón] . HORIZONTAL TABULATION. Coincidencia al final de una línea. Coincidencia con el carácter con el valor hexadecimal hhhh. Coincidencia con un carácter de palabra.

si no conduce a una coincidencia global de patrones... Hacer coincidir cuantas veces sea posible cuando se encuentra por primera vez. Coincidencia de exactamente n veces. ) (?= . Coincidencia de al menos n veces. Operadores de expresiones regulares (continuación) Operador {n. Es un poco más eficaz que la captura de paréntesis.m}+ ( .. Coincidencia de al menos n veces. Expresiones regulares ICU 237 . Coincidencia de 0 o más veces.. ) Apéndice F. Hacer coincidir las menos veces que sea posible. Coincidencia de cero o una vez.. Hacer coincidir todas las veces que sea posible. ++ ?+ {n}+ {n. Afirmación de lectura anticipada. Coincidencia posesiva. Captura de paréntesis. pero no proporciona la captura del texto coincidente. Hacer coincidir las veces que sea posible.m}? *+ Descripción Coincidencia de al menos n veces. pero no más de las necesarias para la coincidencia global de patrones. Coincidencia posesiva. Coincidencia de 1 o más veces. Afirmación de lectura anticipada negativa. No captura de paréntesis. Hacer coincidir las menos veces que sea posible. ) (?: . Hacer coincidir las menos veces que sea posible. ) (?! .. Coincidencia de entre n y m veces.. no intentar con menos veces aunque la coincidencia global falle (coincidencia posesiva) Coincidencia de 1 o más veces. La primera coincidencia de la subexpresión entre paréntesis es la única vez que se intenta. El rango de entradas que coincidía con la subexpresión entre paréntesis está disponible después de la coincidencia. ) (?# .. No avanza la posición de entrada. Es preferible cero..}? {n.} {n. Coincidencia de exactamente n veces. Coincidencia de cero o una vez. Agrupa el patrón incluido. El valor es verdadero si el patrón entre paréntesis coincide en la posición de entrada actual.. realice una copia de seguridad de la búsqueda de una coincidencia en una posición antes de ″(?>″ Comentario en formato libre (?# comentario ). El valor es verdadero si el patrón entre paréntesis no coincide en la posición de entrada actual. Coincidencia posesiva. Coincidencia de entre n y m veces. pero no más de m. Coincidencia de 0 o más veces.}+ {n.. Coincidencia posesiva.Tabla 35.m} *? +? ?? {n}? {n. Coincidencia de entre n y m veces. pero no avanza la posición de entrada.. pero no menos de n. Paréntesis de coincidencias atómicas. ) (?> .

. siendo el último carácter de la coincidencia el carácter de entrada justo antes de la posición actual. Afirmación de lectura postergada negativa... (?<!.) (?ismx-ismx: . y se visualiza en el texto de sustitución como sí mismo. La longitud de las posibles cadenas de caracteres que coinciden con el patrón de lectura postergada no deben estar desenlazadas (ningún operador * o +). Operadores de expresiones regulares (continuación) Operador (?<= ... Evalúe la expresión entre paréntesis con los distintivos especificados habilitados o inhabilitados. Tabla 36. Los cambios se aplican en la parte del patrón que viene a continuación del valor. Cambie los valores de distintivo. (?i) cambia a una coincidencia que no distingue las mayúsculas de las minúsculas. Valores de distintivo. ) (?ismx-ismx) Texto de sustitución El texto de sustitución de las operaciones de búsqueda y sustitución puede contener referencias al texto del grupo de capturas de la búsqueda. No altera la posición de entrada. un símbolo $. Tratar este carácter como un literal. \ 238 IBM Tivoli Universal Agent: Guía del usuario . Caracteres del texto de sustitución Carácter $n Descripción El texto del grupo de captura n se sustituye por $n. Las referencias son de tipo $n. suprimiendo cualquier significado especial. n debe ser >= 0 y no mayor que el número de grupos de captura. pero se pueden utilizar en cualquier otro carácter sin que tenga ningún efecto adverso. El valor es verdadero si el patrón entre paréntesis coincide con el texto que precede a la posición de entrada actual. Las barras inclinadas invertidas de escape en el texto de sustitución sólo son necesarias para ’$’ y ’\’.Tabla 35.. donde n es el número del grupo de captura. Un símbolo $ que no va seguido de un dígito no tiene ningún significado especial. Por ejemplo. Valores de distintivo. siendo el último carácter de la coincidencia el carácter de entrada justo delante de la posición actual. La longitud de las posibles cadenas de caracteres que coinciden con el patrón de lectura postergada no deben estar desenlazadas (ningún operador * o +). No altera la posición de entrada. ) Descripción Afirmación de lectura postergada. El valor es verdadero si el patrón entre paréntesis no coincide con el texto que precede a la posición de entrada actual.

permite utilizar espacios en blanco y #comentarios dentro de patrones. De forma predeterminada. del texto de entrada. Si este distintivo está establecido. Tabla 37. Observe que un par de retorno de carro / salto de línea en el texto se comporta como un terminador de línea individual y coincide con un sólo signo ″. respectivamente. De forma predeterminada. Si este distintivo está establecido. un signo ″. no coincide. Los valores de distintivo se pueden especificar en el momento en que se compila una expresión en un objeto RegexPattern o se pueden especificar dentro del propio patrón utilizando las opciones de patrón (?ismx-ismx). Opciones de distintivo Distintivo (patrón) i Distintivo (constante API) UREGEX_CASE_INSENSITIVE Descripción Si está distintivo establecido.″ en un patrón coincide con un terminador de línea en el texto de entrada. la coincidencia tiene lugar sin tener en cuenta las mayúsculas y minúsculas.″ en un patrón RE.Opciones de distintivos Los siguientes distintivos controlan los diversos aspectos de la coincidencia de expresiones regulares. Expresiones regulares ICU 239 . Controla el comportamiento de ″^″ y ″$″ en un patrón. ″^″ y ″$″ también coinciden al principio y al final de cada línea dentro del texto de entrada. estos signos sólo coinciden al principio y al final. Si este distintivo está establecido. x UREGEX_COMMENTS s UREGEX_DOTALL m UREGEX_MULTILINE Apéndice F.

240 IBM Tivoli Universal Agent: Guía del usuario .

Apéndice G.1.16. Referencia de variables de entorno Este apéndice documenta las variables de entorno de Tivoli Universal Agent y de sus proveedores de datos. así como cada uno de los proveedores de datos. Utilice esta variable de entorno si Tivoli Universal Agent enlaza los puertos de escucha con una dirección de interfaz de red no predeterminada. No es posible establecerlo más de 256. 128 © Copyright IBM Corp. No puede establecer esta variable de entorno en un valor superior a 128. En la siguiente tabla se describen las variables de entorno de Tivoli Universal Agent.49. Misma finalidad que KUM_DP_HOSTNAME Controla el número máximo de aplicaciones que pueden estar activas en un único Universal Agent. Tivoli Universal Agent y las variables de entorno del proveedor de datos Las variables de entorno de Tivoli Universal Agent y sus proveedores de datos permiten alterar temporalmente los valores de ubicación. Tivoli Universal Agent KUMA_DCH_PORT Altera temporalmente el puerto predeterminado de datos del agente.63 KUM_DCH_HOSTNAME 172. 64 10. Nombre de la primera interfaz de red instalada. puertos. 1919 6134 KUM_DP_HOSTNAME Establece el nombre de host Nombre de la preferido (interfaz de red) en un primera interfaz de sistema con varios hosts. Tabla 38.7 KUMA_MAX_APPLICATIONS 128 KUMA_MAX_ATTRGROUPS_ PER_APPL Controla el número máximo de 64 grupos de atributos que puede haber en un único metarchivo. red instalada.18. 2007 241 . Y N KUM_UMC Controla el envío de información de condiciones de excepción de SNMP y de red a la Consola de mensajes universales. directorios de trabajo y semejantes. 2003. Variables de entorno de Tivoli Universal Agent Variable de entorno KUM_WORK_PATH Descripción Establece el directorio de trabajo predeterminado para Tivoli Universal Agent. Valor predeterminado Ejemplo El directorio donde home/MyWork Tivoli Universal Agent almacena los archivo de configuración y archivos de trabajo.

Se utiliza para establecer la cantidad de tiempo. ODBC 30 KUMA_ENUMINT_FORMAT Define atributos enumerados N como enteros en lugar de como cadenas de caracteres en Tivoli Enterprise Portal. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMA_MAX_EVENT_ENTRIES Descripción Controla el número máximo de filas de datos de suceso en un espacio de trabajo de Tivoli Enterprise Portal. Sólo es necesario especificar esta variable de entorno si desea utilizar una página de códigos no predeterminada. Y Todos los proveedores de datos AGENT_LOCALE Especifica una configuración El entorno local del ja_JP local en el formato sistema local Idioma_Territorio. así como en comparaciones numéricas en situaciones. en segundos. Todos los proveedores de datos de Tivoli Universal Agent utilizan este entorno local. Cuando la petición supera el tiempo de espera. se muestran las últimas filas disponibles para dicha tabla. el atributo se puede utilizar en diagramas y gráficos. Especifica un valor de página de códigos utilizado para todos los proveedores de datos de Tivoli Universal Agent. Al definir un atributo enumerado en el portal como un entero. Especifica qué proveedores de datos iniciar.Tabla 38. La página de GB-18030 códigos predeterminada del sistema KUMP_DEFAULT_CODEPAGE 242 IBM Tivoli Universal Agent: Guía del usuario . Sólo necesita esta variable de entorno local si desea utilizar un entorno local distinto del predeterminado. Valor predeterminado 100 500 Ejemplo KUMA_WRITE_OPTLOG Y N KUMA_STARTUP_DP KUMA_REPORT_REQUEST_ EXPIRATION ASFS 15 SNMP. que esperar una respuesta de una solicitud de informe de bajo demanda. Esta variable de entorno sólo afecta al modo en que Tivoli Universal Agent genera la sentencia *TYPE: en el archivo ODI de aplicación de metarchivo que el portal utiliza. Controla la grabación de los datos de acción en el registro de operaciones de Tivoli Enterprise Portal.

Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_DCH_HOST Descripción Valor predeterminado fin1 Ejemplo Dirige el proveedor de datos a El mismo host que un Tivoli Universal Agent que el proveedor de reside en un lugar diferente que datos el host del proveedor de datos. Referencia de variables de entorno 243 .Tabla 38. Especifica la ubicación del archivo de configuración del proveedor de datos si se encuentra en otro sitio distinto del directorio de trabajo. 25000 Apéndice G. Establezca esta variable de entorno cuando resuelva un problema que afecta a datos ausentes o incorrectos en un espacio de trabajo. KUMP_INIT_CONFIG_PATH directorio de trabajo /Tivoli/ MiConfig KUMP_OUTPUT_DEBUG Se utiliza para depurar la N recopilación de datos y la lógica relacionada con la salida. Y Y KUMP_ENABLE_DPLOG N KUMP_META_PATH directorio de metarchivos /home/ metafiles/ test KUMP_META_SERVER Sin servidor de metarchivos fin1 KUMP_META_SERVER_PORT Altera temporalmente el puerto 7800 de escucha predeterminado para el servidor de metarchivos de Tivoli Universal Agent. Especifica la ubicación de los metarchivos del proveedor de datos si se encuentran en otro sitio distinto del directorio de metarchivos. Esta variable se suele utilizar para un proveedor de datos autónomo que se conecta a un Tivoli Universal Agent que se ejecuta en un sistema diferente. Establezca esta variable de entorno en N si no desea utilizar las tablas DPLOG y ACTION asociadas a la aplicación UAGENT. Dirige el proveedor de datos para que utilice un servidor de metarchivos centralizado. Especifica si Tivoli Universal Agent registra la aplicación UAGENT durante el arranque.

Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMA_ATOMIC_SITUATIONS Descripción Identifica atributos atomizados específicos dentro de situaciones para su uso en la supresión de acciones duplicadas en intervalos de muestreo sucesivos. El número de columna equivale a la secuencia numérica del atributo en el metarchivo.. Utilice el siguiente formato: KUMA_ATOMIC_ SITUATIONS=nombresit1:#.. Establece la frecuencia de muestreo para los datos de suceso. 2 10 Valor predeterminado Ninguno Ejemplo CICS_ Abend:2 KUMP_DP_EVENT 5 KUMP_DP_FILE_EXIST_WAIT Y N 244 IBM Tivoli Universal Agent: Guía del usuario . Proveedor de datos de archivo KUMP_DP_SAMPLE_FACTOR Para los datos sondeados. que junto con el valor de tiempo de vida determina la frecuencia de muestreo. nombresit2:#. en segundos. a su vez va seguido del número de columna del atributo atómico utilizado por la situación. deberá ir separadas por comas. e inicia o reinicia la supervisión cuando el archivo pasa a estar disponible. vuelve a realizar una comprobación al cabo de unos segundos. donde cada entrada consiste de un par de NombreSit:Atributo NúmeroColumna. establece el factor de muestreo en segundos. El subproceso espera hasta que esté el archivo. Si especifica más de una situación. 5 muestreados y con clave. que. Cada nombre de situación atomizada debe ir seguido de un delimitador de punto y coma..Tabla 38. Especifica que el subproceso de supervisión del archivo continúe ejecutándose si detecta que el archivo supervisado está ausente o vacío.

Altera temporalmente el puerto 7600 de escucha predeterminado del servidor de API. Utilice esta variable de entorno únicamente si el archivo supervisado recibe ráfagas de gran volumen de registros nuevos y existe la preocupación de que algunas actualizaciones de registro se puedan perder. N Y KUMP_API_DPAPI_HOST Identifica el host del servidor de Mismo host que el API si no es el mismo que el cliente de API cliente. 5028 Apéndice G. TCP/IP atlantis KUMP_API_DPAPI_PORT 5028 KUMP_API_TRANSPORT IPC KUMP_API_REQUEST_WAIT Decide cuánto tiempo esperará 30 el cliente de API una respuesta de una solicitud del proveedor de datos de servidor de API (en segundos). Conmuta el rastreo detallado de cliente de API. N 60 KUMP_API_VERBOSE Proveedor de datos de socket KUMP_DP_PORT Y Altera temporalmente el puerto 7500 de escucha predeterminado del proveedor de datos de socket. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_DP_FILE_SWITCH_ CHECK_INTERVAL Descripción Especifica la frecuencia en segundos que el proveedor de datos de archivo busca un archivo de supervisión distinto para conmutar al mismo cuando se utilice el soporte de nombres de archivos dinámico.Tabla 38. Referencia de variables de entorno 245 . Especifica cuántos registros de archivo se deben leer antes de que el subproceso de supervisión de archivo se ponga en pausa brevemente para permitir que se procesen las actualizaciones anteriores. Valor predeterminado 600 120 Ejemplo KUMP_FILE_ROW_PAUSE_ INCREMENT Ninguno 100 Proveedor de datos de servidor de API KUMP_API_BYPASS_VAL Pasa por alto la validación de parámetros para llamadas a API. Elige uno de los tres modos de comunicación entre el cliente y el servidor de API.

Informes de red KUMP_SNMP_NETDATA_TTL Controla la frecuencia a la que 14400 segundos se actualizan el descubrimiento de red y los informes de gestión. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_TCP_DISCONNECT_BY_TTL Descripción Decide si Tivoli Universal Agent Y retrasará la notificación a IBM Tivoli Monitoring acerca de una desconexión TCP hasta que haya caducado el TTL. 12200 Proveedor de datos de SNMP . Altera temporalmente el nombre del grupo de atributos definido en el metarchivo KUMPOST. Controla el tiempo que Tivoli Universal Agent tiene para detectar una interrupción de alimentación de red o del sistema causando una conexión perdida de un programa de cliente de socket. Un intervalo más corto aumenta la velocidad de los mensajes de descubrimiento y la cara general de la red. el sistema gestionado de la aplicación de metarchivo de socket permanecerá en línea incluso después de que el programa cliente de socket se haya desconectado. 180 Valor predeterminado N Ejemplo KUMP_TCP_OUTAGE_WINDOW 90 Proveedor de datos de envío KUMP_POST_DP_PORT Altera temporalmente el puerto 7575 de escucha predeterminado del proveedor de datos de envío. Altera temporalmente el nombre de aplicación definido en el metarchivo KUMPOST. Altera temporalmente el valor de tiempo de vida del grupo de atributos.Tabla 38. Si este valor está establecido en N.Descubrimiento de red 246 IBM Tivoli Universal Agent: Guía del usuario . MAS 5028 KUMP_POST_APPL_NAME MSG KUMP_POST_GROUP_NAME dpPost mensajes KUMP_POST_APPL_TTL 3600 1800 KUMP_POST_CATEGORY Consulte “Proveedor de datos de envío” en la página 60 Consulte “Proveedor de datos de envío” en la página 60 Proveedor de datos de SNMP . Redefine las categorías predeterminadas de envío o añade nuevas. pero se asegura de que los informes reflejan el estatus actual de recursos de la red de forma más exacta.

en segundos. Establezca el valor en N para inhabilitar automáticamente la gestión de la red local. varios de los atributos del espacio de trabajo NETSUMMARY muestran un valor de cero para redes distintas de la red local del proveedor de datos de SNMP. Especifica el nombre de comunidad predeterminado de toda la empresa para los agentes SNMP. Se utiliza para depurar el proceso de descubrimiento del direccionador.Tabla 38. Sirve de conmutador indicando Y si se debe o no gestionar la red local. Esta variable sólo tiene sentido si KUMP_SNMP_NET_ DISCOVERY se establece en Y. y el espacio de trabajo NETSUMMARY sólo muestra datos para la red local. N 3600 Y KUMP_SNMP_DEBUG_ DISCOVERY_ROUTE Y Apéndice G. Si se establece en N. Referencia de variables de entorno 247 . el espacio de trabajo ROUTER sólo muestra datos para las pasarelas y direccionadores predeterminados. Sirve de conmutador indicando N si el descubrimiento de red determina el estatus de toda la red de la empresa. el proveedor de datos de SNMP sólo tendrá conocimiento de las pasarelas. direccionadores predeterminados y del segmento de red local del cual forma parte del proveedor de datos. public Valor predeterminado N Ejemplo KUMP_SNMP_MANAGE_ LOCAL_NETWORK N KUMP_SNMP_NET_ DISCOVER_ENTERPRISE Y KUMP_SNMP_NET_COMMUNITY Tivoli KUMP_SNMP_CHECK_ CONFIG_INTERVAL KUMP_SNMP_USE_ICMPD Especifica la ventana de 1800 descubrimiento base (BDW). Especifica si el proveedor de N datos de SNMP intenta utilizar un daemon ICMP en el sistema UNIX local para realizar solicitudes ping. Si esta variable se establece en N. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_SNMP_NET_DISCOVERY Descripción Sirve de conmutador indicando Y si se debe o no realizar un descubrimiento de los recursos de red.

Se utiliza para depurar el descubrimiento de recursos dentro de una red. establezca esta variable de entorno en Y. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_SNMP_DEBUG_ DISCOVERY_ENTERPRISE KUMP_SNMP_DEBUG_ DISCOVERY_NETWORK Descripción Se utiliza para depurar el proceso general de descubrimiento de red. lo que ahorrará alguna sobrecarga del sistema. Esta variable de entorno funciona junto con KUMP_SNMP_ DEBUG_MIB_MANAGER.Recopilación de datos MIB KUMP_SNMP_DEBUG_MIB_ MANAGER KUMP_SNMP_DEBUG_MIB_IO Se utiliza para depurar el flujo de solicitudes de recopilación de datos MIB. Establezca esta variable de entorno en N si no está interesado en ver esta información. Se utiliza para depurar el flujo de solicitudes de recopilación de datos MIB.Tabla 38. Si desea ver el valor de índice de cada fila de datos tabular recopilada. Especifica si el espacio de trabajo MIBNODATA en la aplicación SNMP-MANAGER se llena con las tablas MIB para las cuales los agentes SNMP no devuelven datos. Se añade un nuevo atributo denominado _ObjectInstance al final de cada grupo de atributos tabular en la aplicación de metarchivo SNMP. N Y N Y KUMP_SNMP_MIBNODATA Y N KUMP_SNMP_HIDE_COMMUNITY Y N KUMP_SNMP_ADD_ OBJECTINSTANCE Las variables MIB tabulares N incluyen una instancia de objeto suministrada por un agente SNMP que sirve de índice en la tabla MIB para identificar de forma exclusiva una fila en la tabla. Especifica si el espacio de trabajo MIBSTATUS en la aplicación SNMP-MANAGER lista el nombre de comunidad de cada agente SNMP supervisado.Gestión de condiciones de excepción 248 IBM Tivoli Universal Agent: Guía del usuario . Y Proveedor de datos de SNMP . Valor predeterminado N Y Ejemplo N Y Proveedor de datos de SNMP .

Si establece esta variable de entorno en Y. Actúa como un conmutador N para habilitar o inhabilitar los mensajes de depuración detallados que pueden ayudar en la determinación de problemas relacionados con las condiciones de excepción.Tabla 38. en base a su gravedad. suministre también el nombre del archivo de registro detallado donde se redirigen los mensajes de depuración. trapcnfg 1952 KUMP_SNMP_TRAP_VERBOSE Y>/opt/IBM/ITM/logs/ kumstrap.cfg KUMP_SNMP_TRAPCNFG_ CATEGORY Especifica la palabra clave en CATEGORY el archivo de configuración de condiciones de excepción que señala las definiciones de categoría de las condiciones de excepción de SNMP. Especifica el nombre del archivo de configuración donde se definen las condiciones de excepción específicas de la instalación. Y KUMP_SNMP_MONITOR_TRAP N KUMP_SNMP_TRAP_CONSOLE_SEV 2 3 KUMP_SNMP_TRAP_PORT Especifica un puerto de destino Ninguno de condiciones de excepción específico de la instalación que el proveedor de datos de SNMP debe supervisar en lugar del puerto de escucha estándar de condiciones de excepción 162. Referencia de variables de entorno 249 .log KUMP_SNMP_TRAPCNFG_FILE trapd. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_SNMP_DEBUG_TRAP Descripción Valor predeterminado Y Ejemplo Se utiliza para depurar la lógica N de recepción y proceso de condiciones de excepción de SNMP. Controla qué condiciones de excepción se reenvían a la Consola de mensajes universales. Importancia Apéndice G. Sirve de conmutador indicando si la supervisión de las condiciones de excepción de red SNMP es necesaria. SEVERITY cat KUMP_SNMP_TRAPCNFG_SEVERITY Especifica la palabra clave en el archivo de configuración de condiciones de excepción que contiene las definiciones de las gravedades de condiciones de excepción de SNMP.

Y 250 IBM Tivoli Universal Agent: Guía del usuario . Valor predeterminado SOURCEID Ejemplo Fuente KUMP_SNMP_TRAPCNFG_STATUS Especifica una palabra clave en STATUS el archivo de configuración que contiene las definiciones del estatus de las condiciones de excepción de SNMP. Ninguno HostA. Determina si la cadena de N caracteres de predicado de la situación no está incluida en la condición de excepción emitida. secret KUMP_TRAP_USE_POLICY_ SEVERITY N KUMP_TRAP_ADD_PREDICATES Y KUMA_DCH_TRAPEMIT Y Proveedor de datos de HTTP KUMP_URL_OUTPUT_STAT Se utiliza para grabar de salida N las estadísticas de URL en un archivo CSV para el análisis en la hoja de cálculo EXCEL. HostB KUMP_TRAP_EMIT_COMMUNITY Define el nombre de comunidad public que el producto del gestor de SNMP esta configurado para utilizar.csv y se encuentra en el directorio WORK de la instalación del producto Tivoli Universal Agent. Si se especifican varios nombres de host.Tabla 38. deberá separarlos mediante comas. CurrStat Emisor de SNMP KUMP_TRAP_DESTINATION Define los nombres de host del gestor de SNMP que recibe las condiciones de excepción enviadas por el emisor de SNMP de Tivoli Universal Agent. Especifica si cada condición de N excepción de SNMP emitida se registra en el espacio de trabajo UAGENT ACTION. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_SNMP_TRAPCNFG_ SOURCEID Descripción Especifica la palabra clave en el archivo de configuración de condiciones de excepción que contiene las definiciones de los tipos de fuentes de SNMP. Determina si el valor de Y gravedad especificado en la definición de política del emisor de SNMP se envía como el valor de gravedad principal en la condición de excepción emitida. El nombre de archivo CSV es URLSTATS.

Se utiliza para descargar el archivo HTML asociado con el URL que se está supervisando en un subdirectorio dentro del directorio WORK de Tivoli Universal Agent. El nombre del subdirectorio coincide con el nombre del URL. 50 Apéndice G.Tabla 38. Especifique las dos variables que permiten que el proveedor de datos de HTTP realice la autentificación de proxy. Referencia de variables de entorno 251 . N Admin como ID de usuario. Se utiliza para especificar un nombre de host de proxy y número de puerto que el proveedor de datos de HTTP utilice cuando acceda a los URL. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_URL_MAX_REPLY_WAIT Descripción Valor predeterminado 60 Ejemplo Se utiliza para establecer el 45 tiempo de espera de una respuesta URL. tivoli como contraseña KUMP_HTTP_DEBUG Y KDH_CLIENTPROXY Ninguno http://myhost:1920 Proveedor de datos de ODBC KUMP_ODBC_MAX_ROWS Se utiliza para especificar de 100 forma global el número máximo de filas a devolver para cada tabla ODBC en un metarchivo. IBM Software Support puede solicitarle que proporcione un rastreo detallado del componente del proveedor de datos de HTTP y que envíe el registro RAS1 de Tivoli Universal Agent generado. N KUMP_URL_OUTPUT_HTML Y KUMP_HTTP_PROXY_USERID KUMP_HTTP_PROXY_PASSWORD Se utiliza para que los <ninguno> servidores proxy establezcan la validación de IDusuario/contraseña antes de poder acceder a sitios web externos. Se utiliza para diagnosticar un problema de supervisión de URL. Si el valor predeterminado de 45 segundos resulta en frecuentes mensajes de estatus “Tiempo de espera superado”. establezca un valor más elevado.

Si hay scripts propensos a errores que desee evitar que se inicien y a continuación.Tabla 38. Valor predeterminado N Y Ejemplo Proveedor de datos de script KUMP_SCRIPT_DEBUG Se utiliza para ayudar a N diagnosticar un problema de supervisión del proveedor de datos de script. Especifica si los scripts cuya salida es un código de retorno que no es cero se registran en UAGENT DPLOG. 5 Interfaz de consola KUMP_DPCONSOLE_PORT Especifica un puerto de escucha no predeterminado que el servidor de consola de Tivoli Universal Agent utilizará para servir solicitudes de mandatos de consola. El valor predeterminado 0 significa que no hay ningún límite. 7700 8700 252 IBM Tivoli Universal Agent: Guía del usuario . Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_ODBC_DEBUG Descripción Se utiliza para ayudar a diagnosticar un problema de supervisión de ODBC. Y Y KUMP_SCRIPT_LOG_ EXITCODES N KUMP_MAXSCRIPT_TIMEOUTS Especifica si hay un límite en 0 cuanto al número de veces que un script puede agotar el tiempo de espera antes de que el proveedor de datos de script deje de intentar ejecutar el script. establezca este valor en un entero mayor que 0. Debe establecer esta variable de entorno cuando envíe mandatos a una instancia alternativa de Tivoli Universal Agent. que excedan reiteradamente el tiempo de espera. IBM Software Support puede solicitarle que captura un rastreo detallado del componente del proveedor de datos de script y que envíe el archivo de registro RAS1 de Tivoli Universal Agent generado. IBM Software Support puede solicitarle que proporcione un rastreo detallado del componente del proveedor de datos de ODBC y que envíe el registro RAS1 de Tivoli Universal Agent generado.

Tabla 38. 60 Apéndice G. Especifica un nombre de proveedor de datos de 4 caracteres que se utiliza para saltarse el indicador de tipo de proveedor de datos cuando se procesa un mandato List o Show. Variables de entorno de Tivoli Universal Agent (continuación) Variable de entorno KUMP_DPCONSOLE_NOCONFIRM Descripción Determina si pasar por alto el indicador de confirmación para un mandato Delete o Refresh. Referencia de variables de entorno 253 . Valor predeterminado N Y Ejemplo KUMP_CONSOLE_TARGETDP <ninguno snmp KUMP_CONSOLE_COMMAND_WAIT Especifica cuántos segundos 30 un mandato espera una respuesta por parte del mandato de consola de Tivoli Universal Agent antes de que se exceda el tiempo de espera.

254 IBM Tivoli Universal Agent: Guía del usuario .

en Tivoli Universal Agent. han conservado los mismos nombres en Tivoli Universal Agent V6. Instale Tivoli Universal Agent. El binario principal de Universal Agent ha cambiado de kuma610 a kuma620. Realice una copia de seguridad de todos los archivos importantes de Universal Agent. kum0610. Nota: En los sistemas operativos UNIX. configure Tivoli Universal Agent. versión 4.2. los metarchivos y archivos de configuración que haya personalizado. V6. como por ejemplo. 2. Actualice el entorno de desarrollo del programa cliente de API con el programa cliente de API UA620. 5. Nota: Si está actualizando desde Universal Agent. 8. v Para la compatibilidad con versiones anteriores. KUMPURLS. Por ejemplo.ini y um.2. 6. v No existen programas de utilidad de actualización o herramientas especiales de conversión que tenga que ejecutar.1. debe ejecutar el siguiente mandato después de instalar Tivoli Universal Agent. Revise los archivos KUMENV.2. Actualización Este apéndice explica la actualización de versiones anteriores de Tivoli Universal Agent a la versión 6.config para determinar si desea actualizar la lista KUMA_STARTUP_DP o si tiene algún valor de variable de entorno especial para restaurar desde la copia de seguridad. Realice una copia de seguridad de los archivos en los que haya establecido variables de entorno especiales.0. Desinstale la versión anterior de Universal Agent. TRAPCNFG y KUMSMIBI.2 requiere que se vuelva a compilar y a enlazar cualquier programa cliente de API C/C++ que se haya escrito. Dichos archivos incluyen KUMPCNFG. um.Apéndice H. Restaure cualquier archivo de configuración personalizado que desee reutilizar.0 de Tivoli Universal Agent La actualización a Tivoli Universal Agent. 2003. Por lo tanto. 3.ini y um. Esto eliminará todos los archivos binarios de la versión anterior y entradas de registro.0 desde una versión anterior es un proceso sencillo.so.2.2: <dir_instalación>/bin/itmcmd config -A um 4. Restaure cualquier metarchivo que desee utilizar. 2007 255 . pero los nombres de las DLL y las bibliotecas compartidas siguen siendo los mismos en V6. V6. versión 6.2. Actualización a la versión 6.2. Inicie Tivoli Universal Agent. V6. es normal ver mensajes como los datos de semilla ya existen o rc = 80 cuando se añade soporte de aplicación de servidor de Tivoli Enterprise © Copyright IBM Corp. y especifique los proveedores de datos que desea iniciar. Verifique que todas las aplicaciones de supervisión de Tivoli Universal Agent están en línea.1. los archivos KUMENV o um. V6.2. 7.0 de Tivoli Universal Agent. las DLL y las bibliotecas compartidas de Tivoli Universal Agent cuyos nombres contengan un número de versión. Debe tener en cuenta lo siguiente: v Todos los metarchivos de Universal y archivos de trabajo de configuración de Universal Agent existentes son reutilizables. Proceso de actualización Siga los pasos siguientes para actualizar desde una versión anterior: 1.2. V6.0. Nota: Las situaciones proporcionadas por el producto de Tivoli Universal Agent no han cambiado desde Universal Agent.dll y libkump610. Por ejemplo. v Una actualización en Tivoli Universal Agent. Copie también la DLL de KUMPAPI de UA620 o la biblioteca compartida en el directorio o vía de acceso donde se ejecuta el programa cliente.config. Versión 4. tal cual están.

Estos mensajes simplemente indican que el servidor de Tivoli Enterprise Monitoring ya contiene definiciones para situaciones proporcionadas por el producto Tivoli Universal Agent. 256 IBM Tivoli Universal Agent: Guía del usuario .2.Monitoring para Tivoli Universal Agent. V6.

Tabla 39.exe. 2007 257 . Simplifica la configuración y reduce la incidencia de los problemas. Archivo y Script Proveedor de datos de archivo Proveedor de datos de HTTP Proveedor de datos de ODBC Proveedor de datos de envío Proveedor de datos de script Proveedor de datos de socket Proveedor de datos de SNMP KUMPAPIS KUMPASFS KUMPFILE KUMPHTTP KUMPODBC KUMPPOST KUMPSCRP KUMPSOCK KUMPSNMP Invoque Entorno de ejecución Debe tener el siguiente entorno de ejecución cuando inicie los proveedores de datos como procesos independientes: v Las tres siguientes DLL de Tivoli Universal Agent para los sistemas operativos Windows y las bibliotecas compartidas en los sistemas operativos UNIX deben estar en el mismo directorio que el programa del proveedor de datos o bien ser accesibles mediante la vía de acceso de búsqueda de bibliotecas: – KUM0610 © Copyright IBM Corp. Esta es la modalidad predeterminada de funcionamiento. Inicio de proveedores de datos Para iniciar Proveedor de datos de servidor de API API. Los nombres de los programas pueden variar ligeramente entre sistemas operativos. No obstante. los programas en los sistemas operativos Windows tienen la extensión .Apéndice I. y generalmente en hosts distintos de aquel donde se está ejecutando Tivoli Universal Agent. pero debe establecer algunas variables de entorno adicionales y crear scripts o mandatos para la ejecución de ejecutables del proveedor de datos. Socket. Estos programas de proveedores de datos autónomos se distribuyen con el producto Tivoli Universal Agent. puede que algunos usuarios encuentren que es necesario ejecutar los proveedores de datos como procesos independientes y autónomos. Por ejemplo. 2003. los proveedores de datos se ejecutan como subprocesos de Tivoli Universal Agent. Esta técnica es útil si la recopilación de datos debe producirse de alguna de las siguientes maneras: v fuera de un cortafuegos v en un sistema especial con recursos limitados v para supervisar un archivo o ejecutar un script en un sistema remoto Tivoli Universal Agent soporta la ejecución de proveedores de datos como procesos independientes. Programas de inicio Puede iniciar los proveedores de datos como procesos independientes invocando los programas que aparecen en la Tabla 39. Inicio de los proveedores de datos En la mayoría de casos de supervisión. Inicio de proveedores de datos como procesos independientes Este apéndice está dirigido a aquellos usuarios avanzados que desean iniciar los proveedores de datos de Tivoli Universal Agent como procesos independientes.

Si los metarchivos se encuentran en un directorio distinto. deben encontrarse en el mismo directorio que el programa de proveedor de datos o ser accesible mediante la vía de acceso de búsqueda de bibliotecas. deberá establecer la vía de acceso de búsqueda utilizando la variable de entorno KUMP_META_PATH. los proveedores de datos también necesitan las siguientes bibliotecas compartidas de IBM Tivoli Monitoring: – – – – – – – KBB KDC KDE KDH KNS KDSFILT KGLBASE – KHDXCL1 – KLX – KRA Estas bibliotecas.ini y um. v Cualquier metarchivo que desee que el proveedor de datos cargue debe estar situado en el subdirectorio \metafiles debajo del directorio donde se encuentra el programa de proveedor de datos.– KUMP610 – KUMS1API v En los sistemas operativos Windows y UNIX. deberá establecer la variable de entorno KUMP_DCH_HOST en el nombre de host remoto correcto. Conexión con Tivoli Universal Agent Debe establecer las variables de entorno de modo que se conecte correctamente el proveedor de datos autónomo a Tivoli Universal Agent. um. De forma predeterminada. no necesitará el subdirectorio \metafiles porque no hay ningún metarchivo con el proveedor de datos de HTTP.config no son necesarios para ejecutar un proveedor de datos autónomo porque sólo son necesarios para ejecutar Tivoli Universal Agent. KUMPSF y KUMPCNFG. En el siguiente ejemplo se conecta un proveedor de datos autónomo a un Tivoli Universal Agent que se ejecuta en un sistema denominado FIN1: KUMP_DCH_HOST=FIN1 La lista siguiente es una lista de variables de entorno adicionales que puede utilizar para establecer un proveedor de datos autónomo: v En el siguiente ejemplo se presupone que existe una conexión IP con Tivoli Universal Agent: KDC_FAMILIES=use:n ip use:y v El siguiente ejemplo se utiliza para controlar la gestión de señales de proceso: KBB_SIG1=dumpoff -asyncoff 258 IBM Tivoli Universal Agent: Guía del usuario . Para conectar el proveedor de datos autónomo a un sistema Tivoli Universal Agent que se ejecuta en otro lugar. v Los archivos KUMENV. v Los archivos de configuración de Tivoli Universal Agent. junto con las bibliotecas de Tivoli Universal Agent. un proveedor de datos presupone que el Tivoli Universal Agent al que se está conectando se ejecuta en el host local. deben estar en un subdirectorio \work debajo del directorio donde se encuentra el programa del proveedor de datos. incluya el archivo de configuración KUMPURLS en el subdirectorio \work. Nota: Si está ejecutando el proveedor de datos de HTTP en modalidad autónoma. Si está ejecutando el proveedor de datos de HTTP como un proceso autónomo.

se perderán los datos recopilados por el proveedor de datos durante la interrupción de conectividad. el proveedor de datos detecta la condición y sincroniza su operación con Tivoli Universal Agent. Como alternativa. aunque puede utilizarse la variable de entorno KUMA_DCH_PORT para alterar temporalmente el valor 1919 predeterminado de una instancia primaria. Si no está utilizando el puerto de escucha predeterminado del proveedor de datos (puerto 1919) de Tivoli Universal Agent. el proveedor de datos no podrá conectarse y los sistemas gestionados del proveedor de datos no pasarán a estar en línea. deberá establecer también KUMA_DCH_PORT en el número de puerto correspondiente de la lista de variables de entorno. kumpfile: set set set set set KDC_FAMILIES=use:n ip use:y KBB_SIG1=dumpoff -asyncoff KUMP_DCH_HOST=UAHOST1 KUMP_META_PATH=C:\standalone\metafiles KBB_RAS1=ERROR ^>filedp.log start /min kumpfile exit Puede crear un script de shell equivalente para los sistemas operativos UNIX.bat que ha iniciado el ejecutable del proveedor de datos. Si el proveedor de datos intenta conectarse a un Tivoli Universal Agent que no se haya iniciado aún. el proveedor de datos esperará y volverá a intentarlo hasta que establezca una conexión satisfactoria. Secuencia de inicio Puede iniciar proveedores de datos autónomos antes o después de iniciar el sistema Tivoli Universal Agent. si ejecuta un proveedor de datos de archivo autónomo para supervisar un archivo en un sistema remoto. Nota: La primera instancia alternativa de Tivoli Universal Agent utiliza un número de puerto de DCH de 49219. kumpcon en los sistemas operativos Windows y um_console en los sistemas operativos UNIX. Como es necesario establecer las variables de entorno antes de iniciar el archivo ejecutable del proveedor de datos. No obstante. Apéndice I. cree un script o archivo . por su propia comodidad. no es necesario que inicie también el proveedor de datos de ASFS o de archivo en el sistema Tivoli Universal Agent de destino. Si necesita conectar el proveedor de datos a un número de puerto de DCH distinto de 1919. Inicio de proveedores de datos como procesos independientes 259 .bat que establezca las variables de entorno y que llame después al programa del proveedor de datos. Por ejemplo. Si se recicla Tivoli Universal Agent.bat de Windows para iniciar el ejecutable del proveedor de datos de archivo. Puede utilizar el siguiente ejemplo de un archivo . puede terminar el script o el archivo . Nota: El sistema Tivoli Universal Agent al que se está conectando no necesita estar ejecutando el mismo tipo de proveedor de datos que aquel que está iniciando. Detención de los proveedores de datos Para detener un proveedor de datos autónomo.v El ejemplo siguiente se utiliza cuando sea necesario para registrar la actividad del proveedor de datos autónomo: KBB_RAS1=ERROR ^>logfile Deberá establecer variables de entorno adicionales si el proveedor de datos está conectándose a una instancia alternativa de Tivoli Universal Agent o a una instancia primaria que haya alterado el valor de puerto de DCH. puede invocar el mandato SHUTDOWN desde la ventana Actuación o desde el programa de mandatos de consola.

Si se está ejecutando más de un proveedor de datos. Sistema gestionado fuera de línea Después de terminar la conclusión del proveedor de datos. 260 IBM Tivoli Universal Agent: Guía del usuario . los sistemas gestionados activados por el proveedor de datos pasan a estar en gris en el Navigator de Tivoli Enterprise Portal para reflejar su estado fuera de línea. es normal observar un pequeño retraso en la terminación del proceso final después de emitir el mandato SHUTDOWN. Retrasos en la terminación El proveedor de datos sincroniza sus operaciones internas e inicia la terminación ordenada de todos los subprocesos de ejecución. el programa solicitará que se especifique qué tipo desea detener.El mandato SHUTDOWN El mandato SHUTDOWN de consola de Tivoli Universal Agent detiene un proveedor de datos de manera normal. Por lo tanto.

Tivoli Universal Agent utiliza rastreo RAS1 de nivel ERROR. por ejemplo: KBB_RAS1=ERROR (UNIT:kumamain ALL) (UNIT:kumpdpda Error Output) Tivoli Universal Agent soporta además varias variables de entorno de depuración especiales para rastrear un proveedor de datos o componente particular.x. Los valores de rastreo de Tivoli Universal Agent se especifican en la variable de entorno KBB_RAS1 del archivo \TMAITM6\KUMENV en sistemas Windows y en el archivo $ITMinstall_dir/config/ um. Las instancias alternativas también utilizan diferentes nombres de archivos de configuración. Valores de depuración especiales La variable de entorno KUMP_SCRIPT_DEBUG=Y le ahorra tener que entrar múltiples parámetros (UNIT:kxxx &opciones) a la hora de diagnosticar un problema de proveedor de datos Script.. que tendrán un sufijo de nombre de instancia. a continuación se muestran algunas preguntas útiles que le permiten tener una visión inicial de los problemas de Tivoli Universal Agent: v ¿Qué proveedores de datos están en ejecución? v ¿Qué tipos de metarchivos se han activado (Script. 2007 261 . entre ellos el análisis de © Copyright IBM Corp. que afectan a la interfaz de consola de Tivoli Universal Agent y a los puertos de escucha de socket y de API. De forma predeterminada. 2003. ODBC. debe añadir generalmente uno o más parámetros (UNIT:kxxx &opciones) al valor de la variable de entorno KBB_RAS1.)? v ¿Qué funciones de metarchivo se están utilizando? v ¿El problema se produce para una instancia de Tivoli Universal Agent alternativa? v ¿Está configurado Tivoli Universal Agent en un servidor de supervisión remoto o concentrador? v ¿Qué tipo de datos se recopilan? v ¿Tipo de datos de la aplicación: ¿Polled (Sondeado). pueden indicarnos si el problema implica posiblemente el formateo o la disponibilidad de los datos. etc. SNMP. este agente puede presentar más de un reto de depuración que otros agentes.ini en sistemas UNIX y Linux. variables MIB. Determinación de problemas Este apéndice está pensado para proporcionar consejos útiles sobre la resolución de problemas que pueden ayudarle en la determinación de problemas de Tivoli Universal Agent. Diferentes configuraciones de Tivoli Universal Agent influyen en la naturaleza del problema y en cómo debe actuar para analizarlo.Apéndice J. como salida de script. Para obtener rastreo más detallado. Sampled (Muestreado). y dado que con sus proveedores de datos y con la función de emisor de SNMP combina múltiples agentes de Tivoli Monitoring en uno. registros de archivos. Con KUMP_SCRIPT_DEBUG=Y. ¿se ha modificado recientemente el código fuente de script o del programa? El tipo de datos que se recopila. Keyed (Con clave) o Event (Suceso)? v ¿Hay alguna variable de entorno de Tivoli Universal Agent especial vigente? v ¿Se ha activado recientemente un metarchivo nuevo o cambiado? v ¿El problema afecta a una interfaz de programación personalizada para Tivoli Universal Agent? v Si es así. todos los aspectos de ejecución de scripts. Instancias de Tivoli Universal Agent alternativas utilizan números de puerto diferentes. Por ejemplo. Rastreo de Tivoli Universal Agent Tivoli Universal Agent utiliza el mismo recurso de rastreo RAS1 que otros componentes de Tivoli Monitoring 6. etc. Dada la gran capacidad de personalización de Tivoli Universal Agent.

es posible que no pueda ver mensajes DPLOG anteriores si ya se han desplazado. una aplicación MIB SNMP o una fuente de datos ODBC v cuándo la supervisión ha pasado de un archivo a otro v cuándo un script ha finalizado con un código de retorno que no es cero v cuándo se ha conectado y desconectado un programa cliente de API o de socket Algunas acciones dirigidas por mandato. y examine los mensaje en el DPLO particular. que consta de las tablas DPLOG y ACTION. por ejemplo: hostxSNMPdp:UAGENT00 Espacio de trabajo DPLOG El espacio de trabajo UAGENT DPLOG tiene información de estatus útil sobre la salud y el estado de un proveedor de datos. DPLOG es una tabla de sucesos puros. un URL. un archivo. para los proveedores de datos HTTP y ODBC. para diagnosticar un problema de recepción de condición de excepción. especifique: KUMP_SNMP_DEBUG_MIB_MANAGER=Y KUMP_SNMP_DEBUG_MIB_IO=Y KUMP_OUTPUT_DEBUG=Y rastrea toda la lógica relacionada con la salida y la recopilación de datos para todos los proveedores de datos. El nombre del sistema gestionado para esta aplicación tiene el formato &localhost&DPTYPEdp:UAGENT00. tales como: v si un metarchivo se ha validado correctamente v si un metarchivo no se ha podido validar (lo que significa que la aplicación no aparecerá en línea) v si una fuente de datos estaba disponible durante el arranque v qué puertos de consola y puertos de escucha de sockets se han utilizado o no estaban disponibles v cuándo se ha iniciado y parado una supervisión de un script. Por consiguiente. examine el navegador del portal en &localhost&SNMPdp:UAGENT00. establezca KUMP_SNMP_DEBUG_TRAP=Y Para diagnosticar un problema de recopilación de datos MIB. se vuelcan en el registro RAS1 de Tivoli Universal Agent para el análisis posterior.argumentos de scripts. El proveedor de datos SNMP también soporta varias variables de entorno para rastreo de depuración. Esta variable de entorno puede resultar útil cuando resuelve un problema que afecta a datos ausentes o incorrectos en un espacio de trabajo de portal. 262 IBM Tivoli Universal Agent: Guía del usuario . tales como KUMP_HTTP_DEBUG=Y y KUMP_ODBC_DEBUG=Y. La columna DP_Log_Text en DPLOG tiene mensajes informativos. la ejecución de scripts y la captura de los almacenamientos intermedios de salida estándar de script. Existe un espacio de trabajo DPLOG independiente para cada proveedor de datos. y a veces un problema de Tivoli Universal Agent se puede diagnosticar rápidamente examinando simplemente el espacio de trabajo DPLOG. la lectura de un envfile opcional. de aviso y de error sobre los principales sucesos en la vida de un proveedor de datos. también se registran en DPLOG. Existen variables de entorno especializadas equivalentes. como operaciones de renovación del metarchivo. Aplicación UAGENT Cada proveedor de datos activa automáticamente una aplicación interna suministrada por Tivoli Universal Agent denominada UAGENT. respectivamente. lo que significa que sólo guarda las 100 filas de datos más recientes (a menos que se alteren temporalmente mediante KUMA_MAX_EVENT_ENTRIES). Por ejemplo. por ejemplo con la recepción de la interrupción SNMP. Si activa cuatro proveedores de datos y se está produciendo un problema.

Si el proveedor de datos (DP) de archivo no puede encontrar el archivo supervisado.0001 Timestamp: +454F4EBB. Si la aplicación no se ha registrado con el servidor de supervisión. la tabla ACTION la comparten todos los DP.25 Jun 22 2006 18:51:10 wv7i386 ASFS product Universal Agent <---- También puede reunir la siguiente información: v El metarchivo de la aplicación (si el problema puede estar enlazado a una aplicación). A diferencia de DPLOG. el nivel de versión/compilación/fixpack de Tivoli Universal Agent. no registrará el sistema gestionado.0001 Component: +454F4EBB. la plataforma y el nivel de SO donde se ejecutaba Tivoli Universal Agent. una política o un mandato de Actuación. Determinación de problemas 263 .0001 Driver: +454F4EBB. Por ejemplo: Ha emitido un mandato de Actuación > Monitor Start para iniciar la recopilación de datos MIB. Uno o más sistemas gestionados no aparecen en línea. Los sistemas gestionados están en línea pero los espacios de trabajo están vacíos.Dos de los síntomas de problemas de Tivoli Universal Agent más comunes son: 1. Si el subnodo asociado con esta aplicación nunca se ha registrado con el servidor de supervisión. La indicación de la hora del componente Tivoli Universal Agent y el nivel de compilación se pueden encontrar cerca de la parte superior del registro RAS1: +454F4EBB. compruebe el espacio de trabajo DPLOG. lo que significa que el portal Navigator no puede saber nada de la aplicación. La tabla ACTION es Con clave y sus filas tienen un valor de tiempo de vida (TTL) de 30 minutos. Como ejemplo. que es específico del DP. Quizás hay un error tipográfico en la sentencia //SOURCE FILE del metarchivo. Recopilación de la documentación correcta La información de determinación básica de problemas incluye lo siguiente: descripción del problema. Consulte el apartado “Espacios de trabajo UAGENT” en la página 117 para obtener más información. si ha activado una aplicación nueva de metarchivo de proveedor de datos de archivos. pero el espacio de trabajo de la aplicación SNMP está vacío.0001 Target: -----> KUM610 5/5/06 DP type kum d6173a/3647132. se añade una fila de datos al espacio de trabajo UAGENT ACTION. Espacio de trabajo ACTION Siempre que se emite un mandato de Actuación o se activa una Acción refleja. nunca se añade al árbol. es posible que no vea la nueva aplicación visualizada en el árbol del portal de Navigator. permanente o intermitente. La columna Action_Result se actualiza con el éxito o la anomalía de una acción refleja. examine una posible explicación en el DPLOG adecuado. La columna Action_Result es un buen lugar para comprobar si desea conocer qué ha sucedido en una acción refleja determinada o un mandato de Actuación. 2. Apéndice J. Compruebe el espacio de trabajo ACTION para ver si se ha producido un error en el mandato Monitor Start. que puede indicarle que el archivo que este metarchivo está supervisando no existe. Este problema se puede producir debido a que la información en Navigator se recopila en la tabla de estatus de nodos del servidor de supervisión. el espacio de trabajo ACTION debajo de cada aplicación UAGENT tiene las mismas filas de datos. Si está ejecutando varios DP. En ambos casos.

v Para problemas de la interfaz de consola. Cuando Tivoli Universal Agent se cuelga en los sistemas Windows. KUMP_SNMP_DEBUG_TRAP=Y. – Para kumpcon desde un indicador de mandatos del sistema Windows. Watson aún no está habilitado en el sistema. De este modo. Sin embargo. Observe que el archivo KUMENV tiene muchos valores KBB_RAS1 sugeridos para diagnosticar diferentes categorías de problemas con un rastreo detallado. Por esta razón. Tenga en cuenta que esta variable de entorno no se establece en /config/um. La mayoría de los problemas de interfaz de consola están relacionados con el servidor de consola de Tivoli Universal Agent. La captura de rastreos de depuración especiales. el rastreo del programa cliente.ini o \TMAITM6\KUMENV. Como a menudo es difícil leer correctamente un archivo de imagen de memoria en un sistema UNIX diferente debido a incompatibilidades en la biblioteca del sistema.set KBB_RAS1_LOG=%CANDLEHOME%\logs\kumpcon.dmp. depende de la naturaleza del problema. recopile los rastreos kumpcon o um_console si el problema parece radicar en el código cliente de la consola. recopile un rastreo KUMP_API_VERBOSE=Y. pero son un buen comienzo para capturar la clase adecuada de rastreo de Tivoli Universal Agent detallado para diferentes categorías de problemas.export KBB_RAS1=″ERROR (UNIT:kumpcon ALL)″ . 264 IBM Tivoli Universal Agent: Guía del usuario . recopile el archivo de imagen de memoria o escriba los mandatos del depurador necesarios para obtener el rastreo de la pila y redirija la salida del depurador a un archivo que se pueda enviar a ECUREP o realice una captura de pantalla de la salida del depurador. v Para problemas de DP de API. Estos parámetros de rastreo de ejemplo no abarcan cada uno de los posibles casos de problemas de Tivoli Universal Agent. incluso con el rastreo a nivel de ERROR predeterminado. DP de API o DP de script). kumpcon.export KBB_RAS1_LOG=$CANDLEHOME/logs/kumpcon. recopile los archivos drwtsn32.log – Para um_console desde un indicador de mandatos del sistema UNIX. puede resultar útil escribir unos cuantos mandatos de depuración en el sistema donde se ha colgado Tivoli Universal Agent. debe establecerse en el entorno del programa cliente de API. Y como mínimo. puede obtener un rastreo de pila. Código fuente de la aplicación (si hay un problema de DP de socket.set KBB_RAS1=″ERROR (UNIT:kumpcon ALL)″ .Capturas de pantalla UAGENT DPLOG o ACTION. establezca el rastreo siguiente: . puede resultar útil a veces si todo el panorama completo es necesario para determinar por qué un mandato de consola se cuelga o detecta un error. se asegura de que no tiene una incompatibilidad de bibliotecas del sistema o cualquier otro problema que impida que la imagen de memoria se lea correctamente. pero en cambio. El archivo de registro RAS1 de Tivoli Universal Agent siempre es necesario. lo que a menudo es la única información valiosa que se puede obtener de un archivo de imagen de memoria porque los archivos binarios UNIX de Tivoli Universal Agent no se crean con símbolos de depuración. el último punto menciona en general.log v v v v Nota: Utilice los ejemplos de rastreo KBB_RAS1 de Tivoli Universal Agent en KUMENV con comentarios adicionales. escriba el siguiente mandato: drwtsn32. no es necesario. los ejemplos de rastreo de Tivoli Universal Agent comentados se pueden seleccionar desde un menú desplegable en el recuadro de diálogo de valores de rastreo. Si Dr. como por ejemplo.exe –i Cuando Tivoli Universal Agent se cuelga en los sistemas UNIX y Linux. establezca el rastreo siguiente: . Registro de archivo de aplicación de ejemplo (si se supervisa un archivo). En la GUI de Manage Tivoli Enterprise Monitoring Services.log y user. Los mismos parámetros de rastreo se pueden utilizar para versiones de Tivoli Universal Agent basadas en UNIX.

necesitará ver qué aspecto tienen los archivos de configuración. se muestran algunos mensajes RAS1 de Tivoli Universal Agent de un registro de Tivoli Monitoring 6.0000 Stack Limit: 8M Service Point: abcd1234_um +43539976. Por ejemplo.0000!=================> Registro de servicio RAS1 de IBM Tivoli <=============== +43539976. – Los mensajes de aviso de validación no resueltos. Tivoli Universal Agent no suministra un conjunto de archivos Apéndice J. ATR o ODI de casos faltan o no son correctos. etcétera).0000 System Name: abcd1234 Process ID: 2172 +43539976. KUMPCNFG.0000 ITM Process: abcd1234_um +43539976."UA_Main") Arranque de Universal Agent en proceso !43539976. Compruebe si existe una codificación del metarchivo incorrecta. mensajes DPLOG o ACTION.config. las caídas del sistema. Este archivo binario es una instancia principal de Tivoli Universal Agent y no una instancia alternativa porque el nombre de programa es kuma610 sin ningún sufijo de nombre de instancia.0000 AS Limit: None Core Limit: None +43539976. sabrá que el archivo binario kuma610 de Tivoli Universal Agent se ejecuta en un sistema de 64 bits con Solaris 9 denominado abcd1234.9 MAC1_ENV Macro: 0xA326 +43539976.5.0000 Program Name: kuma610 Task Name: kuma610 +43539976. si faltan datos o son incorrectos en un espacio de trabajo para una aplicación de Tivoli Universal Agent.Tivoli Universal Agent es más configurable y personalizable que cualquier otro agente. sólo se pueden depurar con una copia del metarchivo. Determinación de problemas 265 . Lectura del registro de Tivoli Universal Agent Igual que el espacio de trabajo DPLOG contiene sucesos importantes en el ciclo de vida de Tivoli Universal Agent. los datos de la aplicación de ejemplo y las instrucciones especiales que sean necesarias para reproducir el problema. um. Si no puede iniciar Tivoli Universal Agent. Determinadas partes clave de información aparecen resaltadas en negrita para mostrar qué hay que buscar y cómo obtener un conocimiento rápido de un registro de Tivoli Universal Agent: (4345879C.1 de un cliente. el registro RAS1 de Tivoli Universal Agent también. Qué hay que buscar A continuación. v Los listados de directorios en los archivos CAT.0000 System Type: SunOS.cpp. una función del producto no funciona. metarchivos que no se cargan.0000 KBB_RAS1: ERROR +43539976.0000 Executable Name: /opt/IBM/ITM/sol286/um/bin/kuma610 +43539976. por ejemplo: – El tipo de datos incorrecto para un atributo. es importante obtener el metarchivo. Muchos de los problemas de Tivoli Universal Agent. etcétera. – El valor de TTL es demasiado pequeño. v Metarchivos.0000 CPU Limit: None Data Limit: None +43539976.0000 KBB_ENVPATH: Si revisa el registro. lo que genera un tiempo de caducidad antes de que lleguen los datos.0000 Start Date: 2005/10/17 Start Time: 14:30:46 +43539976.0000 UTC Start Time: 43539976 ITM Home: /opt/IBM/ITM +43539976. la supervisión no se realiza o se trata de un problema que puede estar condicionado por un valor de archivo de configuración o una variable de entorno. por lo que otra documentación de utilidad que se puede recopilar puede variar: v Archivos de configuración (KUMENV.698. – El delimitador de atributo incorrecto. uno o más DP no se inician. en especial. Hay muchos mensajes de rastreo RAS1 de nivel ERROR que pueden ayudar a resolver un problema en Tivoli Universal Agent sin tener siempre que reproducir el problema con un rastreo detallado. El problema es que Tivoli Universal Agent se cuelga poco después de arrancar. etcétera.002C-1:kumamain. v Capturas de pantalla de salida incorrecta.ini/um. – Los campos de atributos que faltan.0000 Fsize Limit: None Nofile Limit: 64K +43539976. una salida errónea. KUMSMIBI.

52."BSS1_GetEnv") KUMA_GLOBALIZATION_ENABLED="Y" -1:RAS1. por lo que se utilizan los archivos binarios Solaris 8 de 64 bits de Tivoli Universal Agent del directorio /sol286.c.c. y se inicia el DP de ASFS."BSS1_GetEnv") KUMA_STARTUP_DP="ASFS" -1:kbbssge. -1:kbbssge. Todos los archivos binarios de Tivoli Universal Agent deben tener el mismo nivel de fixpack. si ve dos indicaciones de hora de compilación de “Component: kum” en el mismo registro.52.18 Timestamp: Sep 12 2005 00:55:30 Target: sos58x6 La indicación de la hora de compilación del componente Tivoli Universal Agent debe coincidir con otras indicaciones de hora de componente Tivoli Monitoring en el registro.465."BSS1_GetEnv") KUM_WORK_PATH="/opt/IBM/ITM/sol286/um/work“ Este ejemplo muestra un sistema en inglés.52. pero con fechas distintas. puede que el entorno instalado no sea correcto."BSS1_GetEnv") KIB_MAXCOLS="127" -1:kbbssge.cpp.52.52. Los archivos binarios de Tivoli Universal Agent se crearon el 9/12/2005. es que hay un conjunto combinado de archivos binarios de Tivoli Universal Agent.c. El rastreo RAS1 de nivel ERROR está en vigor.c. Tivoli Universal Agent se instala en /opt/IBM/ITM/sol286/um."BSS1_GetEnv") KBB_SIG1="-dumpoff" -1:kbbssge."CTBLD") Component: kum Driver: d5254b/3569281. -1:kumamain.c. posiblemente debido a un problema de actualización del fixpack. Asimismo. Si ve indicaciones de hora de compilación diferentes con fechas diferentes."main") Default codepage <US-ASCII> locale <en_US_POSIX> -1:kbbssge.binarios para Solaris 9 o Solaris 10.400. 266 IBM Tivoli Universal Agent: Guía del usuario .

Si este archivo no existe.mdl. UAGENT siempre se registra antes de que se procesen los metarchivos.1310."KUM0_InitializeProductSpec") Están en efecto los siguientes parámetros de especificación de producto: -1:kum0ipds.c."DCHserver::dp_register") Aplicación <APACHE> registrada correctamente -4:kumppcfg. Determinación de problemas 267 .695."DCHserver::dp_register") Aplicación <TOMCATAPPLICATION> registrada correctamente -4:kumppcfg.52. se ha situado correctamente en el directorio /work.c. -4:kumpstrt. -4:kumppcfg.c.c. Como una aplicación interna proporcionada por Tivoli Universal Agent.c."UA_Main") Arranque de Universal Agent en proceso -1:kumamain.cpp."BSS1_GetEnv") KUMP_INIT_CONFIG_PATH="/opt/IBM/ITM/sol286/um/work" -4:kbbssge.c. La variable de entorno CTIRA_HOSTNAME se ha establecido correctamente porque coincide con el nombre del sistema abcd1234 en la parte superior del registro."DCHserver::dp_register") Aplicación <UAGENT> registrada correctamente La primera etapa de la inicialización de Tivoli Universal Agent se ha completado. Tivoli Universal Agent contiene muchos subprocesos y a veces para diagnosticar problemas puede ser muy útil supervisar qué ocurre en diferentes subprocesos.134.1310. -4:kbbssge. Tivoli Universal Agent no se iniciará. Apéndice J."KUM0_InitializeProductSpec") NODE_TYPE=UA -1:kum0ipds.741.52.c.813.cpp."KUMP_ProcessStartUpConfig") 2 metarchivo(s) de aplicación procesado(s) de archivo de configuración de arranque /opt/IBM/ITM/sol286/um/work/KUMPCNFG Cada metarchivo que Tivoli Universal Agent activa genera su propio mensaje de rastreo de nivel ERROR."BSS1_GetEnv") KUMP_META_PATH="/opt/IBM/ITM/sol286/um/metafiles" -4:kbbssge.235.52.cpp.52. -1:kumamain."BSS1_GetEnv") KUMP_RB_PATH="/opt/IBM/ITM/sol286/um/rb" -7:kumdchsv.52.1709."KUMP_StartDataProvider") Input DP Type is ASFS -1:kumamain.52."KUMP_ProcessStartUpConfig") Cargando metarchivo <TomcatApplication.mdl> de archivo de configuración \ de arranque /opt/IBM/ITM/sol286/um/work/KUMPCNFG -7:kumdchsv. Todos los valores PSF se envían automáticamente en eco al registro RAS1.78.c. Observe los números de subprocesos cuyo prefijo es un guión en un registro de Tivoli Universal Agent."KUM0_InitializeProductSpec") PRODUCT_CODE=UM -1:kum0ipds. no queda claro todavía si los metarchivos son para los DP de API.cpp.170.c.1310."BSS1_GetEnv") KIB_MAXCOLS="127" -4:kumpsdpe.c. se están activando. En este registro.813.1209.cpp.c. El mensaje de rastreo incluye el tipo de DP y la fecha en que se ha compilado el módulo fuente de Tivoli Universal Agent asociado..c. La aplicación UAGENT que pertenece al DP de ASFS se ha registrado con la infraestructura del agente. ApacheLogFileProvider.c."KUMP_ProcessStartUpConfig") Cargando metarchivo </opt/IBM/ITM/sol2i86/um/metafiles/ApacheLogFileProvider.c."KUM0_InitializeProductSpec") Rec 01 PRODUCT_CODE=UM -1:kum0ipds.813.134. Como se utiliza el DP de ASFS."UA_Main") Arranque de Universal Agent completado.c."BSS1_GetEnv") CTIRA_LOG_PATH="/opt/IBM/ITM/logs" -7:kumdchsv."KUMP_StartDataProviderEnvironment") -----> KUM610 9/11/05 Tipo DP de ASFS producto Universal Agent <-----8:kbbssge.c. Archivo o Script.272. Ahora se está iniciando 1 Proveedor(es) de datos."ipcSock::allocateDCHport") Puerto 1919 de DCH de Universal Agent abierto satisfactoriamente -1:kbbssge. Cada DP que se activa contiene su propio mensaje de rastreo de “KUMP_StartDataProviderEnvironment” porque cada DP se ejecuta en su propio subproceso.116."UA_Main") La globalización está habilitada -1:kbbssge."KUM0_InitializeProductSpec") PRODUCT_NAME=Universal Agent El archivo de especificaciones del producto de Tivoli Universal Agent. Ahora hay varios subprocesos de Tivoli Universal Agent en ejecución.52.cpp.cpp.728."BSS1_GetEnv") CTIRA_HOSTNAME="abcd1234“ El puerto 1919 de DCH se ha asignado correctamente.. que preceden a los nombres de archivo fuente."BSS1_GetEnv") KDCB0_HOSTNAME="abcd1234" -2:kumdsock.c.-1:kum0ipds. Si este puerto no se puede asignar. KUMPSF.mdl> de archivo de configuración de arranque /opt/IBM/ITM/sol286/um/work/KUMPCNFG -4:kbbssge. se ven que los dos metarchivos.mdl y TomcatApplication."KUM0_InitializeProductSpec") -----El archivo de especificaciones del producto que se utiliza es /opt/IBM/ITM/sol286/um/work/KUMPSF-----1:kum0ipds. Socket. El DP de ASFS se inicia ahora.c. Tivoli Universal Agent se cierra.

0000-15B0:kumamain.70.c.0000 KBB_ENVPATH: C:\IBM\ITM\TMAITM6\KUMENV ========================================================================== (454A059C.49.c. el cliente ha enviado varios registros RAS1 de Tivoli Universal Agent y en cada caso.0001-15B0:krabufwk. por lo tanto sabe que de alguna manera estaba anticipando la caída del sistema y que la caída del sistema se produjo en el subproceso 5.00 existente para aplicación <TOMCATAPPLICATION> -12:kumpscrp. Los mensajes de error de Tivoli Universal Agent suelen llevar como prefijo una cadena de asteriscos.00.0000 Executable Name: C:\IBM\ITM\TMAITM6\kuma610.0000 Page Size: 4K Phys Memory: 2048M +454A059C.2-SP1 +454A059C.135."CTIRA_Set_DefaultCodepage") Página de códigos de IRA predeterminada 268 IBM Tivoli Universal Agent: Guía del usuario . una copia del metarchivo y un registro RAS1 de Tivoli Universal Agent detallado con (UNIT:kump ALL) rastreo."KUMP_ScriptServer") Archivo de script </opt/IBM/ITM/sol286/um/scripts/ ubicado correctamente check_tomcat_appl.0000 Program Name: kuma610 User Name: SYSTEM +454A059C."KUMP_SOCKpgmAPIServer") DP de APIS usando puerto de escucha 7600 -4:kbbssge. Estos mensajes pueden ser útiles si hay un problema.749.cpp.cpp. por ejemplo.0000 MAC1_ENV Macro: 0xC112 Start Date: 2006/11/02 +454A059C. los puertos utilizados por los DP de API y Socket a la escucha de conexiones cliente.pl> tabla <TomcatApplication> -14:kumaudi."userDataList::calculateChecksum") Conservando versión 06. -12:kumpscrp.200.144.99. con el programa kumpcon al establecer una conexión de socket con Tivoli Universal Agent."KUMP_SockConsoleSupport") Puerto 7700 de consola DP de APIS abierto Los mensajes de arranque de Tivoli Universal Agent incluyen puertos de escucha de consola y.0000!===========> Registro de servicio RAS1 de IBM Tivoli <====================== +454A059C. Este metarchivo se ha modificado porque se utiliza la versión -01.0000 Service Point: system.pl> tabla <TOMCATAPPLICATION> está ahora en línea en el proveedor de datos -15:kumaudi.cpp."KUMP_ScriptServer") Origen de script </opt/IBM/ITM/sol286/um/scripts/ check_tomcat_appl.0000 Virt Memory: 2048M Page Space: 3948M +454A059C.52.0000 Task Name: kuma610 System Type: Win2003.log +454A059C. La caída del sistema ha empezado a suceder después de que el cliente modificara el archivo TomcatApplication.68. Reconocimiento de un registro incorrecto Otro aspecto de una lectura eficaz de registro es ser capaz de reconocer cuándo se dispone de un registro incompleto o incorrecto.mdl."CTIRA_Set_DefaultCodepage") Entorno local de IRA predeterminado en_US (454A059E. en concreto. Ha sido preciso obtener documentación adicional para diagnosticar este problema."KUMP_SocketServer") DP de socket utilizando puerto 7500 -13:kumpcmdk.0000 KBB_RAS1: ERROR: (UNIT:kumamain ALL) (UNIT:kump ALL) +454A059C.5.0000 System Name: SWXYZ01 Process ID: 2460 +454A059C.c."userDataList::calculateChecksum") Conservando versión 06.137."KUMP_SockConsoleSupport") Puerto 7701 de consola DP de ASFS abierto -13:kumpcmdk.cpp.2685. si procede."BSS1_GetEnv") KUMP_SCRIPT_DEBUG="N" -10:kumpsock. el mismo mensaje de error “***** La cadena de caracteres de entrada es NULL” siempre era la última entrada del registro. En este problema en concreto.01. -5:kum0c2up.0000 Start Time: 09:50:04 CPU Count: 4 +454A059C.swxyz01_um UTC Start Time: 454a059c +454A059C.c.c. El otro metarchivo para la aplicación Apache está en la versión -00."KUM0_ConvertStringToUpper") ***** La cadena de entrada es NULL Éste es el último mensaje del registro de Tivoli Universal Agent antes de colgarse.00 existente para aplicación <APACHE> Ahora ya sabe que TomcatApplication.c. Este problema requería un arreglo de código porque una función de atributo derivado no estaba comprobando si había una cadena de caracteres de entrada vacía.2685.224.mdl es un metarchivo del DP de script.-F:kumpapis.c. !454A059C.cpp.c.exe +454A059C. Estos mensajes pretenden captar su atención para ayudarle a detectar un problema o un problema potencial.0000 ITM Home: C:\IBM\ITM ITM Process: swxyz01_um +454A059C.0000-15B0:krabufwk."UA_Main") Arranque de Universal Agent en proceso (454A059E.0000 KBB_RAS1_LOG: C:\IBM\ITM\logs\swxyz01_um_454a059c-.

En este ejemplo.1. los registros de aplicaciones.cpp.1.1784.1} 6 1 A 1 0 "Sucesos de estatus” (Type 3) En esta definición de condición de excepción intelliWatch.cpp."UA_Main") Arranque iniciando 1 proveedor(es) de datos. Si el problema está relacionado con la imposibilidad de recibir o visualizar correctamente una condición de excepción.en de Universal Agent completado.cpp.establecida en 5348 . Cualquier condición de excepción recibida por el DP de SNMP debe estar definida en el archivo trapcnfg situado en el directorio \work de Tivoli Universal Agent. etcétera.3.1. hay dos puntos adicionales después de “ERROR”.1.4. Determinación de problemas 269 . El emisor de SNMP sólo pertenece a condiciones de excepción de SNMP de salida. Cada producto del proveedor que emite una condición de excepción al DP de SNMP debe tener un registro de tipo 2 (Type 2) y tipo 3 (Type 3) con un OID de empresa definido en trapcnfg. el puerto de escucha de condición de excepción es 162. que podría levantar sospechas. los valores de la variable de entorno actual. Cuando se recibe una condición de excepción.6. Tras examinar el registro de nivel ERROR anterior. el DP de SNMP busca el valor OID de empresa de la condición de Apéndice J. siempre es bueno definir primero el tipo de problema de condición de excepción porque cada uno requiere un enfoque de diagnóstico diferente. Categorías habituales de problemas En este apartado se indican algunos casos de ejemplo de problemas de Tivoli Universal Agent típicos para ayudar a comprender cómo se utiliza el rastreo disponible y los recursos de diagnósticos para resolver un problema. es un registro de rastreo de Tivoli Universal Agent mínimo.4. como por ejemplo. 1983 es el OID de empresa. Ahora se está Universal Agent en proceso Universal Agent completada Se intenta realizar un rastreo detallado con los parámetros (UNIT:kumamain ALL) (UNIT:kump ALL) y aún así. Tivoli Universal Agent es capaz tanto de enviar como de recibir condiciones de excepción de SNMP."main") Conclusión de .1983. el problema afecta a la función de receptor de condiciones de excepción del proveedor de datos de SNMP y no a la función de emisor de SNMP. observe que en este archivo faltan muchas sentencias de rastreo de arranque de Tivoli Universal Agent. La aplicación SNMP-MANAGER se activa automáticamente cuando se inicia el DP de SNMP y no requiere un metarchivo separado. que invalidaban toda la variable de entorno KBB_RAS1.. pero este valor se puede alterar temporalmente con la variable de entorno KUMP_SNMP_TRAP_PORT. (454FA2C3.ibm-5348_P100-1997. Las condiciones de excepción de entrada requieren que el DP de SNMP se ejecute con la siguiente variable de entorno: KUMP_SNMP_MONITOR_TRAP=Y Tivoli Universal Agent debe poder asignar un puerto de escucha de condición de excepción durante el arranque. las asignaciones del puerto de consola.659. Un registro mínimo como éste significa que falta la variable de entorno KBB_RAS1 o bien está codificada incorrectamente. por lo tanto.3.1983. Idioma 55050241 (454A05A0. y dichas acciones se realizan utilizando componentes de Tivoli Universal Agent completamente diferentes.0000-15B0:kumamain.1.0001-6D8:kumamain. 6 es el número de condición de excepción genérico y 1 es el número de condición de excepción específico.1.618.0000-6D8:kumamain. por ejemplo: intelliWatch-Monitor {1.. De forma predeterminada. Las condiciones de excepción de entrada se visualizan en el espacio de trabajo TRAP debajo del nodo &hostname:SNMP-MANAGER en Navigator. Problemas de condiciones de excepción de SNMP Es importante comprender la diferencia entre los problemas de condición de excepción de SNMP de entrada y de salida."main") Conclusión de (454FA2C3. Una buena idea es comprobar la “Fecha de inicio” (Start Date) al principio del archivo para verificar si se está examinando el registro correcto y no uno de un arranque de Tivoli Universal Agent anterior.1} (Type 2 criticalAlarm {1.6.

Si los procesos no están separados y ha habilitado las funciones de recepción de condiciones de excepción o descubrimiento de red del DP de SNMP. el análisis. puede detectar problemas de autorización UNIX con los archivos binarios kumstrap o kumsnetd.excepción. Si necesita determinar si se reciben condiciones de excepción. En los sistemas UNIX cuando el receptor de condiciones de excepción kumstrap se ejecuta como un proceso autónomo. En dicho caso. Si no se encuentra ninguna coincidencia. el número de condición de excepción genérico y un número de condición de excepción específico en la copia de memoria caché de trapcnfg. Tivoli Universal Agent siempre debe iniciarse con autorización root. formúlese las siguientes preguntas: v ¿El DP de SNMP está ejecutándose? v ¿El agente de SNMP está configurado para enviar condiciones de excepción al host de Tivoli Universal Agent? 270 IBM Tivoli Universal Agent: Guía del usuario . las reenvía al DP de SNMP de Tivoli Universal Agent para el examen de trapcnfg. hay un proceso receptor de condiciones de excepción distinto denominado kumstrap. mientras que en los sistemas UNIX. se establece “No disponible” en los atributos de espacio de trabajo TRAP de SNMP-MANAGER. significa que hay un problema de condición de excepción entrante. No hay ningún mensaje de rastreo de nivel ERROR predeterminado cuando se recibe una condición de excepción. En este caso. pero puede haber varios procesos que estén interesados en las notificaciones de condiciones de excepción. Tivoli Universal Agent debe ser capaz de registrarse él mismo en el proceso kumstrap como parte interesada. el receptor de condiciones de excepción es un subproceso dentro del proceso kuma620 de Tivoli Universal Agent principal. si por alguna razón no se han instalado de ese modo. Si sólo utiliza el DP de SNMP para la recopilación de datos MIB. Este tipo de mecanismo es necesario porque sólo un proceso en un sistema puede adquirir el puerto 162. que es un pequeño programa autónomo que recibe condiciones de excepción. y a continuación. Observe que se utiliza el mismo mecanismo cuando Tivoli Universal Agent y el DP de SNMP se ejecutan en los sistemas Windows y el servicio de condiciones de excepción de SNMP proporcionado por Windows se ha iniciado primero y ya ha adquirido el puerto 162. En los sistemas Windows. no es necesario iniciar Tivoli Universal Agent con un ID raíz para que los dos procesos se inicien correctamente. Si las condiciones de excepción no se muestran en el espacio de trabajo TRAP o no se visualizan correctamente. entonces Tivoli Universal Agent no puede recibir condiciones de excepción: "Nota: El proceso de Universal Agent kumstrap no se ha iniciado. Con la segunda opción." El proceso kumstrap y el proceso de descubrimiento de red kumsnetd se separan de Tivoli Universal Agent en las plataformas UNIX porque estas dos funciones SNMP requieren autorización de nivel root para asignar los puertos 162 y 520 respectivamente. debe establecer KUMP_SNMP_DEBUG_TRAP=Y La recepción de condiciones de excepción de Tivoli Universal Agent funciona de forma ligeramente diferente en los sistemas UNIX y en los sistemas Windows. Si el proceso kumstrap no se ha iniciado correctamente y ve el siguiente mensaje después de emitir itmcmd agent start um. Tivoli Universal Agent se registra él mismo como parte interesada en el servicio de condiciones de excepción de SNMP Windows. especifique las siguientes sentencias para que la autorización root no sea nunca necesaria: KUMP_SNMP_MONITOR_TRAP=N KUMP_SNMP_NET_DISCOVERY=N Ocasionalmente. Este registro es un convenio de SNMP que permite que otros procesos en el mismo sistema indiquen que desean que se les reenvíen todas las condiciones de excepción recibidas. y la actualización del espacio de trabajo TRAP. Puede resolver estos problemas (1) iniciando Tivoli Universal Agent con un ID raíz o (2) utilizando el script SetPerm en el directorio /bin para establecer el bit set-user-id en los archivos binarios kumstrap y kumsnetd.

0000-2:kum0sock. número de error=125 (4345879E. No se ha podido iniciar el agente.153. significa que en el archivo trapcfng faltan definiciones para uno o más tipos de condiciones de excepción.1060. compruebe el último archivo &hostname_um_ &timestamp.48. v En las plataformas UNIX. el número de error equivalente es 10048.. se generarán mensajes de error en el registro RAS1 de Tivoli Universal Agent y en el espacio de trabajo UAGENT DPLOG.0003-2:kumamain.log en el directorio /logs./itmcmd agent start um Iniciando el agente.."KUM0_OpenLocalSocket") vinculación errónea para la dirección local TCP socket 8.log A continuación se muestra un ejemplo de registro detallado kumstrap: 44849629 44849629 44849629 44849629 44849629 44849629 4484963A 4484963A 4484963B ------------------------>>>>> >>>>> ----Tivoli Universal Agent SNMP trap listener daemon started Verbose output file is /opt/IBM/ITM/logs/kumstrap. A continuación se muestra un ejemplo de registro de una anomalía de arranque: (4345879E."ipcSock::allocateDCHport") Determinar si otra copia de Universal Agent ya está activa en este sistema.. Resolución de problemas sobre el uso de puertos Puede emitir el mandato netstat –a para obtener información sobre el uso de puertos en el sistema local.0002-2:kumdsock. puerto=1919.153.. Saliendo.cpp.log Opening default trap listening port 162 socket 5 opened and set to blocking IO socket 5 bound to 9.48. (4345879E. se generarán mensajes de error en el registro RAS1 de Tivoli Universal Agent o en el registro detallado kumstrap. ¿el DP de SNMP se ha registrado él mismo satisfactoriamente como parte interesada del proceso kumstrap? Si no es así."ipcSock::allocateDCHport") Error: No se han podido abrir los sockets TCP/UDP enlazados a Universal Agent DCH puerto 1919 (4345879E. Apéndice J. v ¿Ha fusionado las sentencias de definición de condición de excepción adecuadas (suponiendo que se proporcionaran tras una conversión de MIB a MDL) en el archivo trapcnfg maestro? v ¿Ha importado el metarchivo de SNMP que se había generado tras la conversión de MIB? Para problemas de condiciones de excepción entrantes. En las plataformas Windows.48.v ¿El puerto de escucha de la condición de excepción del DP de SNMP estaba asignado? Si no es así. se puede capturar el mejor rastreo detallado con: KUMP_SNMP_DEBUG_TRAP=Y En los sistemas UNIX. Un mandato ps indica si hay otro proceso kuma620 activo en este sistema. Compruebe el archivo de registro...0001-2:kumdsock.26[64945] Sending acknowledgment to DP at 9. v ¿Las condiciones de excepción se visualizan en el espacio de trabajo TRAP pero no lo hacen correctamente? Si ve “No disponible” en muchos de los problemas de espacio de trabajo TRAP.c. el proceso kumstrap tiene su propio mecanismo de rastreo no RAS1 autónomo que se puede activar estableciendo la variable de entorno KUMP_SNMP_TRAP_VERBOSE en Y y redirigiendo la salida de rastreo detallada a un archivo.153.26[162] Listening for traps. por ejemplo: KUMP_SNMP_TRAP_VERBOSE=Y>/opt/IBM/ITM/logs/kumstrap.cpp. Comprobación del archivo de registro $hostname_um_&timestamp.134.cpp."StopAgentProcess") El proceso de Universal Agent se está deteniendo Número de error 125 en la mayoría de plataformas UNIX significa “Dirección en uso”.1059. /opt/IBM/ITM/bin# .log Si Tivoli Universal Agent no consigue iniciarse..357. Determinación de problemas 271 . RegisterTrapInterest received from DP at 9.. Errores de inicio de Tivoli Universal Agent En este apartado se describen los errores de inicio de Tivoli Universal Agent.26[64945] Listening for traps.

Tivoli Universal Agent intenta vincular un socket de escucha con una dirección IP que no está disponible en el sistema local.0003-2:kumamain. puede realizar una de las tareas siguientes – Configurar una instancia de Tivoli Universal Agent alternativa."ipcSock::ipcSock") Error: arranque erróneo.147. no ha liberado el puerto de DCH. como puerto de escucha predeterminado. el sistema se puede quedar atrapado en un bucle sin fin.0003-1:kumdipc. Esta variable de entorno hace que Tivoli Universal Agent asigne un puerto de DCH diferente durante el arranque. Algunas posibles explicaciones de este error son: v Se ha iniciado otro Tivoli Universal Agent en el mismo sistema y el otro Tivoli Universal Agent aún no se ha cerrado o no se ha cerrado correctamente.002D-1:kumamain. Saliendo.cpp.ini. puede comprobar el archivo errno.0000-1:kbbssge.error=68 (455AE41F. núm. Núm error de TCP: 68.cpp.3: (455AE41C.0004-1:kumdsock.1702.cpp.h en el archivo /usr/include. (455AE41F. se necesita el puerto UDP 1919.. Tivoli Universal Agent debe vincular varios sockets de escucha con puertos locales."KUM0_OpenLocalSocket") vinculación errónea para socket 4 de UDP de dirección local. De lo contrario.144.210. estos errores de vinculación son probablemente el resultado de escribir un valor de host incorrecto en respuesta a la solicitud de configuración: Especifique el Nombre de red principal opcional o "ninguno" (El valor predeterminado es: ninguno): 272 IBM Tivoli Universal Agent: Guía del usuario . (455AE41D.c. Si Tivoli Universal Agent se ha configurado para utilizar una dirección de host que no coincide con la dirección de host del sistema local. puerto=0. En los sistemas UNIX.cpp. El puerto de DCH es necesario para todas las comunicaciones entre los proveedores de datos (DP). Núm.error=68 (455AE41D."BSS1_GetEnv") KDCB0_HOSTNAME="sgs1prod" (455AE41D.1035. Resolución de problemas de vinculación Un error de vinculación con EADDRNOTAVAIL significa que el nombre de host local no se ha configurado.c. O BIEN – Establecer KUMA_DCH_PORT=nnnnn en el archivo kumenv o um.c.144.388. error de UDP: 68."UA_Main") Arranque de Universal Agent en proceso (455AE41D. se muestran dos definiciones relevantes: #define EADDRINUSE 67 /* La dirección ya está en uso */ #define EADDRNOTAVAIL 68 /* No se puede asignar la dirección solicitada */ Consideraciones importantes sobre el cortafuegos Si la ejecución se realiza en un sistema con un cortafuegos instalado. _sockError=1 (455AE41F.0002-2:kumdsock. núm. incluido el puerto de DCH 1919. Durante el arranque.Tivoli Universal Agent debe asignar correctamente el puerto 1919 de DCH durante el arranque o no podrá funcionar y se cerrará."StopAgentProcess") Se está deteniendo el proceso de Universal Agent Determine si el arranque de Tivoli Universal Agent que ha terminado anormalmente también se debe a que el puerto de DCH está ocupado.error=68 (455AE41D.c. v Hay un proceso que no es de Tivoli Universal Agent en ejecución en el mismo sistema que también ha asignado el puerto 1919.. puerto=1919.52.0002-1:kumdsock. A continuación. deberá configurar el cortafuegos de modo que permita que el sistema local (bucle de retorno o E/S de IP hacia la dirección IP de máquina local y desde ésta) utilice la conectividad UDP.error=68 (455AE41F.144."DCHipC::startup") Error: IPCClient erróneo. Como mínimo."KUM0_OpenLocalSocket") vinculación errónea para socket 4 de TCP de dirección local. puerto=1919."ipcSock::allocateDCHport") Error: No se han podido abrir los sockets TCP/UDP vinculados a Universal Agent DCH puerto 1919. por lo tanto. todas las llamadas de vinculación de socket generarán errores de tipo “dirección no disponible”. A continuación se muestra un ejemplo de un error de arranque de Tivoli Universal Agent en AIX 5.0001-2:kum0sock. núm.cpp. debido posiblemente a un error cometido en la especificación de DCB0_HOSTNAME.0000-2:kum0sock.749.cpp."ipcSock::IPCClient") Error: _sockUDP[-1] núm."KUM0_OpenLocalSocket") vinculación errónea para socket 4 de UDP de dirección local. Si este fuera el caso y el otro proceso fuera necesario. Tenga en cuenta que un valor “número de error” en un registro de Tivoli Universal Agent siempre es un código de error de SO y no un código de error de Tivoli Universal Agent.0001-1:kum0sock. En cualquier sistema AIX.

que no coincidía con “sgs1prod. UA2. Este problema se debe con toda probabilidad a que el servidor de supervisión concentrador no contiene los archivos DM3CAT00 y DM3ATR00 en los directorios RKDSCATL y ATTRLIB. A menudo puede diagnosticar este tipo de problemas examinando el archivo de registro del servidor de supervisión concentrador: Apéndice J./itmcmd config –A um y escribir ninguno (none) como respuesta a la solicitud Especifique el Nombre de red principal opcional. el valor de “System Name:” era sys1sist. y en vez de ello. v Las entradas xxxxx:DM37X00 tienen signos ‘+’ y se pueden seleccionar. Esto se debe a un problema de carga de GSKit. Dicha resolución permite que Tivoli Universal Agent vincule sockets con el nombre de host sys1sist local predeterminado. Otra variante de este problema aparece si Tivoli Universal Agent se ejecuta en un sistema de múltiples NIC y la variable de entorno KDCB0_HOSTNAME o KDEB_INTERFACELIST no se ha establecido en la dirección IP que Tivoli Universal Agent precisa utilizar. determine de qué tipo de problema “no hay salida” se trata: v Si las entradas xxxxx:DM37X00 en el portal Navigator no tienen un signo ‘+’ situado junto a ellas. Como ejemplo. suponga que el sistema gestionado DM37X está en línea pero no hay salida. Ninguna salida en el espacio de trabajo de portal Hay muchos tipos de problemas de tipo “no hay salida” en Tivoli Universal Agent. A continuación se muestra un ejemplo de lo que se puede añadir a KUMATBLS para evitar el error: UAGENT00 UAG524400 0 UAGENT00 UAG6034300 0 Observe que después de que Tivoli Universal Agent se haya iniciado satisfactoriamente al menos una vez.3 de 32 bits. Tivoli Universal Agent se cuelga poco después de arrancar en un sistema AIX 5. En primer lugar. etcétera. Es decir. lo que significa que este error sólo es posible la primera vez que se inicia Tivoli Universal Agent después de la instalación. incluso sin encabezados de columna.3 de 32 bits Tras instalarse en un sistema AIX 5. significa que no hay ninguna consulta para abrir y visualizar los datos del espacio de trabajo. no vacío. Probablemente se trata de un problema de presentación del servidor del portal. lo que aparentemente sólo se produce en sistemas AIX 5.3 de 32 bits. pero los espacios de trabajo están completamente en blanco. puede comprobar si el nombre es el mismo que el que contiene KDCB0_HOSTNAME.Si examina el valor “System Name:” en la parte superior del archivo de registro de Tivoli Universal Agent. el archivo KUMATBLS nunca está vacío. Determinación de problemas 273 . Cuando se abre un espacio de trabajo de Tivoli Universal Agent o se produce una renovación. lo que a su vez permite que el proceso de carga GSKit se complete satisfactoriamente. y se visualiza un error de solicitud KFWITM220E en el cliente del portal. lo que genera un arranque satisfactorio. una solución alternativa es tener un archivo KUMATBLS no vacío en el directorio /um/work. Hasta que se pueda instalar el nivel de parche de AIX. determine si el servidor del portal conoce esta aplicación Tivoli Universal Agent.” La resolución correcta es volver a ejecutar el mandato . Tivoli Universal Agent no consigue iniciarse la primera vez. La presencia de definiciones de tabla en KUMATBLS altera el tiempo de arranque del agente. Compruebe si hay un archivo DM3ODI00 coincidente. En este registro. v El error KFWITM220E para un espacio de trabajo de Tivoli Universal Agent suele significar que falta un archivo CAT o es incorrecto en el servidor de supervisión concentrador. el servidor del portal envía una sentencia SQL Select al servidor de supervisión concentrador para los atributos UA1. se cuelga poco después del arranque. Este error se resuelve instalando un nivel de parche de AIX superior: AIX 5300-05-02. en el directorio \cnps o /cq/data y en el directorio \work de Tivoli Universal Agent.

que tal vez sea un servidor de supervisión remoto.cpp. pero no hay ningún valor de atributo en las columnas."KUMP_ConstructApplDataModel") Aviso: Varias sentencias SOURCE requieren el parámetro ManagedSystemName Y posteriormente. (3) el tiempo TTL es demasiado corto y los datos se eliminan antes con demasiada rapidez o bien (4) Tivoli Universal Agent no procesa la salida del script y la reenvía al servidor de supervisión."KUMP_DCHclientRoutine") *** dp_data erróneo.” “Completamente en blanco” es la mejor pista en esta descripción del problema."CreateServerView") Estatus incorrecto de VPM1_CreateViewPlan.669.c. 274 IBM Tivoli Universal Agent: Guía del usuario . especificando KUMP_OUTPUT_DEBUG=Y. (2) no envían datos a la salida estándar.367. lo que significa que el portal no puede obtener información sobre la aplicación INTERNET del DP de HTTP. O bien (1) los scripts no se están ejecutando.1380. Suponga que las entradas xxxxx:DM37X00 tienen espacios de trabajo válidos con encabezados de columna. está completamente en blanco.c.c. Otra prueba irrefutable es que el registro del servidor de supervisión contendrá mensajes de error relacionados con el catálogo. estatus = 202 -17:kdsvws1. Cuando examino el espacio de trabajo en el árbol físico debajo del URL gestionado. Para confirmar que éste es el problema correcto.c.311. Como este problema afecta a una aplicación DP de script. el portal no conocerá la aplicación INTERNET porque el portal obtiene la información de la aplicación únicamente del servidor de supervisión concentrador. Si hay un problema de recopilación de datos de Tivoli Universal Agent. Otro caso de tipo “no hay salida” se produce cuando algunos espacios de trabajo tienen datos y otros no. 202 Si un espacio de trabajo de Tivoli Universal Agent está completamente vacío sin ningún encabezado de columna. Con toda probabilidad este problema es un problema de recopilación de datos de Tivoli Universal Agent. el cliente debería ver un mensaje de error KFWxxxx en el cliente del portal al abrir el espacio de trabajo de Tivoli Universal Agent. Esto parece similar a una coincidencia en la nota técnica 1236104 de IBM Software Support. Este problema significa que el cliente no ve encabezados de columna. obtenga un rastreo de RAS1 de Tivoli Universal Agent detallado. He instalado y configurado un Universal Agent en mi servidor del portal y he añadido varios URL editando el archivo KUMPURLS y añadiendo los URL supervisados mediante el diálogo Actuación."CreateViewPlan") Error de información del catálogo.2906.-17:kdspmcat. también es útil establecer KUMP_SCRIPT_DEBUG=Y. Este es un ejemplo real de un problema de tipo “no hay salida”: Descripción del problema: “No puedo supervisar ningún URL utilizando mi implementación del proveedor de datos de HTTP de Universal Agent. Asimismo.c. se visualizan muchos mensajes parecidos a los siguientes: -B6C:kumdchsv. -B04:kumpdchc. Examine el registro RAS1 de Tivoli Universal Agent. Tivoli Universal Agent sólo carga archivos CAT y ATR en el servidor de supervisión en el que está configurado. -17:kdspmcv. El parámetro ManagedSystemName en la sentencia //SOURCE SCRIPT del metarchivo proporciona la identificación necesaria. compruebe si Tivoli Universal Agent está configurado en un servidor de supervisión remoto."DCHserver::dp_data") Error: attrType <?> attrName <Nombre_host> controlField <11> no forma parte de los atributos registrados."CompilerCatalog") Columna UA9 en la tabla UAG6034300 de la aplicación UAG00 no encontrada. En dicho caso.c."KUMP_DCHclientRoutine") >>>>>redirigiendo dp_data para sincronizar DCH para SEptr @11E25EE8 tabla <BetaNumericScript> Estos errores se producen si Tivoli Universal Agent no puede identificar de forma exclusiva a qué fuente pertenecen los datos entrantes. Si ve mensajes similares a los que se muestran a continuación.873.1877. el archivo de registro del servidor de supervisión a menudo corrobora que un problema de catálogo es la razón de que el espacio de trabajo esté en blanco. significa que se ejecutan varios scripts desde el mismo metarchivo: -B1C:kumpcadm. Sincronización de DCH necesaria para SEptr @11E25EE8 tabla <BetaNumericScript> -B04:kumpdchc.

Si Tivoli Universal Agent sigue activo. compruebe si el archivo de script listado en la sentencia //SOURCE SCRIPT existe. En dicho caso. Para un metarchivo DP de SCRIPT. ATR y ODI para la aplicación). Apéndice J. La comunicación de socket entre kumpcon y kuma620 utiliza un UDP regular y no ip:pipe. Este problema podría haberse evitado si en algún momento anterior. Determinación de problemas 275 . debe otorgarse acceso a kcumpcon al puerto de escucha del servidor de consola abierto por kuma620.” Esta misma comilla simple es necesaria si se especifican el intérprete de scripts o envfile con nombres de vías de acceso que contienen blancos intercalados. compruebe si hay un archivo de imagen de memoria. por ejemplo. deberán realizarse las siguientes comprobaciones: v Compruebe si el mandato Import ha emitido algún mensaje de error. Si se ha detenido. se había configurado Tivoli Universal Agent en el servidor de supervisión concentrador y si resulta que Tivoli Universal Agent activó el proveedor de datos de HTTP. compruebe si el archivo de registro listado en la sentencia //SOURCE FILE existe en el directorio especificado. En dicho caso.. v Compruebe si se han subido los archivos aaaATR00.exe ‘C:\Archivos de programa\scripts\Monitor. Por ejemplo: D:\IBM\ITM\ TMAITM6> kumpcon import freespace. Si éste fuera el caso. v Compruebe si el mandato Import o Refresh ha fallado al conectarse a Tivoli Universal Agent. No se ha encontrado el metarchivo. establezca la variable de entorno KUMP_DPCONSOLE_PORT=8700 antes de emitir los mandatos de consola. v Compruebe si el metarchivo importado se ha añadido al archivo \work\KUMPCNFG. Las siguientes explicaciones de KUMPS005E son las más habituales: – Tivoli Universal Agent no está en ejecución. En tal caso. – Un cortafuegos está bloqueando la conexión de socket entre kumpcon y kuma620.pl’ “arg1 arg2. Si se especifica un archivo de script sin información de vía de acceso. v Compruebe si el nombre de vía de acceso completo del archivo de registro o el archivo de script contiene blancos intercalados. Actualizar KUMPCNFG es uno de los últimos pasos de un mandato Import e indica hasta dónde ha avanzado el mandato Import.mdl KUMPS043E El mandato ha fallado. //Source Script Perl. – Una instancia de Tivoli Universal Agent alternativa está ejecutándose. (Nota: los 3 primeros caracteres del nombre de aplicación INTERNET se utilizan cuando se mencionan los archivos CAT. podría haber un problema al subir un archivo. v Suponiendo que un metarchivo FILE DP se esté importando. Compruebe si estos tres archivos coinciden de tamaño y fecha de las copias locales que Tivoli Universal Agent conserva en el directorio \work.El cliente ha reconfigurado Tivoli Universal Agent en el concentrador. v Si la importación o la renovación se quedan atascadas en un bucle sin fin con varios mensajes de tipo “Mandato en progreso. los archivos CAT y ATR para la aplicación INTERNET tendrían que haberse subido al servidor de supervisión concentrador. a la escucha en el puerto 8700 en lugar del valor predeterminado 7700. debe utilizarse el mandato “Set” de consola para acceder a la dirección IP correcta. ip:spipe ni ningún otro método suministrado por Tivoli Monitoring para pasar por los cortafuegos. aaaCAT00 y aaaODI00 en los directorios del servidor del portal y del servidor de supervisión. y esto ha resuelto el problema. – Tivoli Universal Agent se ejecuta en un sistema multi-NIC y el servidor de mandatos de consola está a la escucha en una dirección IP no predeterminada. podría ser necesario que reprodujera los pasos con el rastreo de Tivoli Universal Agent detallado para señalar la causa del problema.. Tivoli Universal Agent presupone que está situado en el directorio \TMAITM6\scripts en los sistemas Windows o en $ITMinstall_dir/$ARCH/ um/scripts en los sistemas UNIX y Linux. el nombre debe ir entre comillas simples. Si no coinciden. compruebe si Tivoli Universal Agent sigue activo o se ha detenido. Otra resolución es copiar los archivos INT CAT y ATR en el concentrador. Problemas en la interfaz de consola Si el mandato Import de un metarchivo no hace que el sistema gestionado asociado se inserte en el árbol de Navigator. se visualiza el mensaje de error KUMPS005E No se puede conectar con el servidor de mandatos de consola en myhost[7700].”. Si todas las comunicaciones de puerto en el sistema requieren un permiso explícito. Por ejemplo. pero en un bucle sin fin.

La exportación de KUMP_DPCONSOLE_PORT=8700 antes de invocar kumpcon mediante el script um_console ha resuelto el problema. el error es kumps005e:” En primer lugar. Compruebe si el cliente ejecuta una instancia de Tivoli Universal Agent principal o una alternativa. y así sucesivamente. el rastreo detallado de la consola requiere que se actualice el script de shell $ITMinstall_dir/bin/um_console. Si hay más de una instancia alternativa.log set KBB_RAS1=ERROR (UNIT:kump ALL) kumpcon refresh test. Por ejemplo. según convenga. Utilice PRIMARYKEY=0 como clave del identificador exclusivo en un grupo de atributos de varias filas. 10700 y 10710. escriba estos mandatos. especifique PRIMARYKEY=0 con cada atributo que contenga el ID para cada unidad de disco. Como kumpcon se ejecuta como un proceso autónomo. capture también un rastreo de servidor de consola detallado del proceso de Tivoli Universal Agent principal: KBB_RAS1=ERROR (UNIT:kumamain Error State) (UNIT:kumaprbl Error Detail Metrics) (UNIT:kumpccmd ALL) (UNIT:kumpcmdk ALL) (UNIT:kumpsrcc ALL) (UNIT:kumpca ALL) (UNIT:kumppcfg ALL) (UNIT:kumpdlta ALL) (UNIT:kumprthr ALL) (UNIT:kumprapr ALL) Éste es un ejemplo real de un problema en la interfaz de consola.mdl En las plataformas UNIX. determine qué plataforma utiliza. v El cliente había creado una instancia alternativa de Tivoli Universal Agent. y no entre 7700 y 7710. Compruebe si hay un cortafuegos que bloquea la comunicación de socket entre kumpcon y Tivoli Universal Agent. el cliente no debe ejecutar directamente kumpcon. Datos personalizados no resumidos Especifique la opción PRIMARYKEY para los campos clave con el fin de indicar al Agente de resumen y poda cómo distinguir entre varias instancias. lo que significa que la variable de entorno KUMP_DPCONSOLE_PORT predeterminada señala incorrectamente la conexión de consola al puerto 7700 en lugar del puerto 8700. por ejemplo: export KBB_RAS1_LOG=$ITMinstall_dir/logs/console. si un grupo de atributos describe unidades de disco. 276 IBM Tivoli Universal Agent: Guía del usuario . Esta palabra clave se utiliza a nivel de columna. Compruebe si Tivoli Universal Agent está o no activo.log export KBB_RAS1=’ERROR (UNIT:kump ALL)‘ Si no está seguro si el problema se produce en el programa kumpcon o en el componente del servidor de Tivoli Universal Agent. por ejemplo: \tmaitm6> \tmaitm6> \tmaitm6> set KBB_RAS1_LOG=c:\ibm\itm\tmaitm6\logs\kumpcon. Si es la primera instancia alternativa. Si es una plataforma distinta de Windows. el puerto de escucha de la consola puede estar a la escucha en los rangos entre 9700 y 9710. Otras conversaciones con el cliente han mostrado la siguiente información: v El cliente estaba llamando directamente a kumpcon en un sistema UNIX en lugar de utilizar el script um_console. Para capturar un rastreo de kumpcon detallado en los sistemas Windows. Descripción del problema: No consigo conectarme al servidor de mandatos de consola cuando ejecuto el mandato kumpcon. requiere su propio archivo de registro RAS1 separado para realizar un diagnóstico. La variable n empieza por 0 para cada atributo y aumenta de 1. La opción siguiente se utiliza para designa un atributo clave: OPTION{PRIMARYKEY=n} Esta opción es necesaria para cada uno de los grupos de atributos.La interfaz de consola de Tivoli Universal Agent depende de la comunicación de socket de programa a programa entre el programa kumpcon y el programa kuma620. estará a la escucha en un puerto en el rango entre 8700 y 8710.

en la página 169. Determinación de problemas 277 .Consulte el Apéndice B. Apéndice J. “Definiciones de atributos”.

278 IBM Tivoli Universal Agent: Guía del usuario .

2007 279 . Si desea obtener más información. que se encuentran documentados en el sistema operativo. en un entorno de Microsoft Windows. 2003. consulte la documentación que proporciona su sistema operativo. la documentación del producto se ha modificado a fin de incluir las siguientes características para aumentar la accesibilidad. v Ampliar lo que aparece en la pantalla. consulte la documentación que proporciona su sistema operativo.Apéndice K. a utilizar satisfactoriamente los productos de software. ya sea movilidad restringida o visión limitada. v Utilizar funciones específicas o equivalentes utilizando sólo el teclado. para poder oír lo que aparece en pantalla. Ampliación de lo que aparece en la pantalla Puede ampliar la información de las ventanas del producto mediante los recursos que proporcionan los sistemas operativos en los que se ejecuta el producto. Consulte la documentación del producto de tecnología de asistencia para obtener información detallada sobre cómo utilizar dichas tecnologías con este producto. v Toda la documentación está disponible tanto en formato HTML como en el formato PDF convertible. Además. para ofrecer a los usuarios el mayor número de posibilidades para poder utilizar software lector de pantalla. Las principales funciones de accesibilidad de este producto ayudan a los usuarios a realizar las siguientes acciones: v Utilizar tecnologías de asistencia como. puede reducir la resolución de la pantalla para aumentar el tamaño de los fonts del texto en pantalla. Desplazamiento por la interfaz mediante el teclado El producto utiliza teclas de atajo y aceleradores estándar. software lector de pantalla. v Todas las imágenes que contiene la documentación disponen de texto alternativo para que los usuarios que tengan problemas de visión puedan comprender el contenido de las imágenes. Por ejemplo. Accesibilidad Las características de accesibilidad ayudan a los usuarios con alguna discapacidad física. Si desea obtener más información. por ejemplo. © Copyright IBM Corp.

280 IBM Tivoli Universal Agent: Guía del usuario .

IBM puede utilizar o distribuir cualquier información que el usuario le suministre del modo que considere adecuado. INCLUIDAS. por escrito. póngase en contacto con el Departamento de propiedad intelectual de IBM en su país o envíe las consultas. No obstante. Puede enviar consultas sobre licencias. Las referencias a productos. Esta información puede incluir imprecisiones técnicas o errores tipográficos. Sin embargo. NY 10504-1785 EE. © Copyright IBM Corp. Avisos Esta información se ha desarrollado para los productos y servicios ofertados en los Estados Unidos. es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto.Apéndice L. Es posible que IBM oferte los productos. Algunos estados no permiten la declaración de limitación de responsabilidad de garantías explícitas o implícitas en determinadas transacciones. Para las consultas sobre licencias referentes a información de doble byte (DBCS). 2007 281 . estos cambios se incorporarán en nuevas ediciones de la publicación. programa o servicios de IBM. La posesión de este documento no le otorga ninguna licencia sobre dichas patentes. En su lugar se puede utilizar cualquier producto. programa o servicio que no es de IBM funcione correctamente. 2003. Cualquier referencia de esta información a sitios web que no sean de IBM se proporciona únicamente para su comodidad y no constituye un aval de dichos sitios web. Póngase en contacto con el representante IBM de su localidad para obtener información sobre los productos y servicios disponibles actualmente en su área. a: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome. Minato-ku Tokyo 106. Japón El siguiente párrafo no se aplica en el Reino Unido ni en ningún otro país en el que dichas disposiciones entren en conflicto con la legislación local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN ″TAL CUAL″ SIN GARANTÍAS DE NINGÚN TIPO. programa o servicio que no sea de IBM. El material de dichos sitios web no forma parte del material correspondiente a este producto IBM y el uso de estos sitios web se realiza a cuenta y riesgo del usuario. IBM puede realizar mejoras y/o cambios en los productos y/o en los programas descritos en esta publicación en cualquier momento y sin previo aviso. programas o servicios de IBM no implican ni sugieren que sólo se pueda utilizar dicho producto. el usuario es responsable de evaluar y verificar que este producto. programa o servicio equivalente que no vulnere los derechos de propiedad intelectual de IBM. NI EXPLÍCITAS NI IMPLÍCITAS.UU. por escrito. servicios o funciones tratados en este documento en otros países. AUNQUE SIN LIMITARSE A. por lo que es posible que este párrafo no se aplique en su caso. sin incurrir por ello en ninguna obligación con el usuario. COMERCIALIZACIÓN O ADECUACIÓN A UN PROPÓSITO DETERMINADO. LAS GARANTÍAS DE NO CONTRAVENCIÓN. Periódicamente se realizan cambios en la información aquí contenida. a: IBM Director of Licensing IBM Corporation North Castle Drive Armonk.

comercializar o distribuir programas de aplicación compatibles con las interfaces de programas de aplicación de IBM. el Acuerdo internacional de licencias de programas de IBM o cualquier acuerdo equivalente entre las partes. Reservados todos los derechos. Tivoli. developerWorks. Puede copiar. con la finalidad de desarrollar. bajo los términos del Acuerdo de cliente de IBM. Cada copia o fragmento de estos programas de ejemplo o cualquier trabajo que de ellos se derive. deberá incluir un aviso de copyright como el que figura a continuación: © (nombre de la empresa) (años). Partes de este código provienen de Programas de ejemplo de IBM Corp. MQSeries. sin tener que pagar a IBM. Puede que esta información esté disponible. Marcas registradas IBM. deben ponerse en contacto con: IBM Corporation 2Z4A/101 11400 Burnet Road Austin. sin tener que pagar a IBM. OMEGAMON. Lotus. se han incluido nombres de individuos. DB2. © Copyright IBM Corp. y puede incluir.UU. NetView. marcas y productos. utilizar. _entrar el año o años_. modificar y distribuir estos programas de ejemplo del modo que desee. sujeta a los términos y condiciones adecuados. Puede copiar. IBM suministra el programa bajo licencia que se describe en este documento y todo el material bajo licencia disponible para el mismo. Tivoli Enterprise Console y z/OS son marcas registradas de International Business Machines Corporation en los Estados Unidos y/o en otros países. comercializar o distribuir programas de aplicación compatibles con la interfaz de programas de aplicación para la plataforma operativa para la que se hayan escrito los programas de ejemplo.Los propietarios de licencias de este programa que deseen obtener información sobre el mismo con el fin de permitir: (i) el intercambio de información entre programas creados de forma independiente y otros programas (incluido este) y (ii) el uso mutuo de la información que se ha intercambiado. Esta información contiene ejemplos de datos e informes utilizados en operaciones empresariales diarias. utilizar. AIX. TX 78758 EE. utilidad o funcionamiento de estos programas. LICENCIA DE COPYRIGHT: Esta información contiene programas de aplicación de ejemplo en lenguaje fuente que ilustran técnicas de programación en diversas plataformas operativas. Todos estos nombres son ficticios y cualquier parecido con nombres y direcciones utilizados por empresas comerciales reales son mera coincidencia. Para ilustrarlos lo mejor posible. Estos ejemplos no se han probado exhaustivamente bajo todas las condiciones. modificar y distribuir estos programas de ejemplo en la forma que desee. el logotipo de IBM. Si visualiza esta información en copia software. 282 IBM Tivoli Universal Agent: Guía del usuario . Por lo tanto. con la finalidad de desarrollar. en algunos casos. compañías. OS/390. es posible que las fotografías y las ilustraciones en color no se vean. IBM no puede garantizar ni dar a entender la fiabilidad. el pago de una tarifa. Adobe y todas las marcas comerciales basadas en Adobe son marcas registradas de Adobe Systems Incorporated en los Estados Unidos y/o en otros países.

Windows. Linux es una marca registrada de Linus Torvalds en los Estados Unidos y/o en otros países. Inc. UNIX es una marca registrada de The Open Group en los Estados Unidos y/o en otros países. Avisos 283 .Java y todas las marcas comerciales y logotipos basados en Java son marcas registradas de Sun Microsystems. en los Estados Unidos y/o en otros países. Los nombres de otras empresas. Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos y/o en otros países. Apéndice L. productos o servicios pueden ser marcas registradas o de servicio de otras empresas. Microsoft.

284 IBM Tivoli Universal Agent: Guía del usuario .

cat 124 archivo de configuración compartir 24 creación 24 directrices de actualización 24 archivo de configuración de condición de excepción 78 archivo de configuración trapcnfg 229. 233 visión general 229 archivo de nombres simbólicos activación 78 edición de KUMSNAME 77 archivo de variables de entorno nombre y ubicación 11 archivo ejecutable del proveedor de archivos de archivo ejemplo. atributo kum. 234 modificación 233 tipos de registros en 229. 30 archivo ODI dockum 124 archivo um_cleanup.config 12 um. 30 archivo CAT en sistemas Windows 27 archivo CAT en sistemas z/OS 27 archivo de catálogo kum. 30 ODI dockum del emisor de SNMP 124 ubicación de la configuración 24 um_cleanup.MIB 124. 230 ubicación de 229 valores predeterminados en 232. 30 ATR en sistemas Windows 27 ATR en sistemas z/OS 27 CANBASE.bat en sistema Windows 30 um.bat en sistema Windows parámetro directorio_trabajo 30 archivo um. campo & 76 actualización 255 itmcmd 255 AgentData.bat 30 um_cleanup. 125 CAT 26.MIB 124.config 12 archivo um. 30 CAT en sistemas Windows 27 CAT en sistemas z/OS 27 configuración 24 configuración de condición de excepción 78 ejecutable del proveedor de datos de archivo kumpfile.attr 124 emisor de SNMP. 30 archivo ATR en sistemas Windows 27 archivo ATR en sistemas z/OS 27 archivo CAT 26. 279 acceso a la ayuda 116 activación de metarchivos utilización de los mandatos de Actuación 22 activación de metarchivos con mandatos de consola 21 Actuación > Monitor Start. 77 archivo KUMSNAME activación 78 utilización para especificar nombres simbólicos 77 archivo ODI 26. 29. catálogo kum. 77 KUMSNAME 77. 29.h 272 archivo KUMENV 12 edición en sistemas operativos Windows 12 archivo KUMSCOMM 76. nombre de instancia 38 aplicación MAS 62 aplicación SNMP-MANAGER 78 descripción 75 aplicación UAGENT 262 aplicaciones 36 creación 17 definición 17 importación de definiciones de 34 restablecimiento de números de versión 29 SNMP-MANAGER 78 UAGENT 262 versiones de 34 versiones de Tivoli Universal Agent 27 visión general 32 visualización de definiciones de 34 aplicaciones de Tivoli Universal Agent supervisión 113. 81 agentes SNMP recopilación de datos para todo 81 almacenamiento de metarchivos 20 alteración de los proveedores de datos 15 API dp_SetSourceName 43 invocación de Tivoli Universal Agent 41 Aplicación. entorno 14 KUMSCOMM 76. 2003.bat parámetro de componente en sistema Windows 30 archivo um_cleanup. 125 CANSYSSG. 94 ventajas de la personalización 76 archivo ATR 26.h 272 KUMEN. 14 variables de entorno 11 archivos ATR 29 © Copyright IBM Corp. 2007 285 .ini 12.ini 12. ejemplo 259 emisor de SNMP.Índice A accesibilidad xix.cat 124 errno. 29. 121 aplicaciones del proveedor de datos de SNMP nombres de sistemas gestionados 74 aplicaciones duplicadas 40 aplicaciones SNMP inicio de la recopilación de datos de 81 números de versión 34 SNMP-MANAGER 78 supervisión 81. 14 archivos ATR 26. kmpfile 259 archivo errno. 78 ODI 26.

ejemplo kmpfile del proveedor de datos de archivo 259 archivos ODI 29 asociación de fuentes de datos con metarchivos asociación explícita 107 sentencias SOURCE 103 atributo Agent_Info 36 atributo Agent_Name 36. 161 atributos de resumen _DateTime 161 _Interval 161 _Interval_Unit 161 _Interval_Unit_Name 161 _LocalTimeStamp 160 grupo de atributos RequestSummary 160 Occurrences 161 atributos de salida atributos clave 161 intervalo 161 LocalTimeStamp 161 Occurrences 161 atributos derivados 179 creación de atributos nuevos a partir de existentes 163 atributos derivados como números reales 179 atributos invisibles 178 atributos RFC 1213 MIB-2 84 attrGroup 82 autentificación de servidor proxy 55 avisos legales 281 ayuda acceso 116 creación 19 espacio de trabajo 116 situaciones 116 B bibliotecas ICU 184 bibliotecas compartidas KBB 258 KDC 258 286 IBM Tivoli Universal Agent: Guía del usuario . funciones 180 GetEnvValue 180 ipAddressToName 180 NetWareTimeToText 180 TivoliLogTime 180 TivoliTimeStamp 180 UTCtoGMT 180 UTCtoLocalTime 180 derivados como números reales 179 descripciones de 193 determinación de características de 191 duplicado 177 filtrado 181. 161 atributo de resumen _Occurrences 161. parámetro 127 atributos clave 73.ini 258 archivos ejecutables. 163 atributo de resumen _Interval_Unit_Name 161 atributo de resumen _LocalTimeStamp 160. catálogo kum.cat 124 archivos de configuración KUMENV 258 KUMPCNFG 258 KUMPSF 258 KUMPURLS 258 ubicación 24 um. espacios de trabajo 181 invisibles 178 parámetro. 184 filtrado.config 258 um.archivos CAT 29 archivos de catálogos emisor de SNMP. 163 atributo de resumen Occurrences 161 atributo de salida Interval 161 atributo de salida LocalTimeStamp 161 atributo de salida Occurrences 161 atributos 191. 94 atributo de resultado de resumen del atributo numérico 163 atributo de resumen _Date_Time 161 atributo de resumen _DateTime 161 atributo de resumen _Interval 161 atributo de resumen _Interval_Unit 161. 197 _Interval_Unit 163 _Occurrences 163 Agent_Name 94 clave 73 correlación de variables MIB 191 creación de nuevos 163 definición 169 derivados 179 derivados. definiciones 169 truncamiento por la izquierda 178 visión general 191 Atributos. definiciones 169 parámetro ATOMIC 172 parámetro CAPTION 173 parámetro comportamiento-agregado 174 atributos (continuación) parámetro de cadena de caracteres ENUM 172 parámetro de tamaño-máximo 171 parámetro de texto de ayuda 169 parámetro KEY 171 parámetro nombre-atributo 169 parámetro SCALE y PRECISION 173 parámetro tipo-atributo 169 resultado de resumen de atributo numérico result 163 resumen 160 resumen _Date_Time 161 resumen _Interval 161 resumen _Interval_Unit 161 resumen _Interval_Unit_Name 161 resumen _LocalTimeStam 161 resumen _Occurrences 161 RFC 1213 MIB-2 84 salida 161 secuenciado de definiciones 186 selección 120 sintaxis. concatenación de cadenas 180 derivados.

sentencia NAME 137 clientes de socket envío de mandatos de acción 108 CODEPAGE 45 comunicación UDP. ejemplo de variable de entorno 14 CTIRA_HOSTNAME. parámetro comportamiento-agregado 174 palabra clave BEHAV{<valor>}. utilización del proveedor de datos de archivo 44 CTIRA_HOSTNAME. parámetro comportamiento-agregado 175 parámetro de texto de ayuda 176 parámetro DEFAULT 176 parámetro delimitador-específico-atributo 175 parámetro FILTER 176 parámetro SEQ 176 parámetro SKEY 176 definiciones de datos 20 delimitadores. parámetro 126 Centro de información de software de Tivoli xviii clave de clasificación de resumen Request 161 clave de clasificación de resumen ServiceStatus 161 claves claves de clasificación de resumen 161 claves de clasificación de resumen 161 ClearValues parámetro. ausentes 156 descubrimiento de red 89. atributo ausente 156 delimitadores de atributos. parámetro comportamiento-agregado 175 palabra clave OPTION{PRIMARYKEY=<n>}. parámetro 126 detección de interrupciones TCP 110 detección y recuperación de errores UDP 111 detención de la recopilación de datos 82 detención de los proveedores de datos 259 determinación de problemas 261 dirección no disponible” mensaje de error 272 directorio /ATTRLIB 27 directorio /RKDSCATL 27 directorio de scripts 70 directorio de trabajo establecimiento 12 directorios \TMAITM6\work en sistemas Windows 27 Índice C campo & en Actuación > Monitor Start 76 campo. campo & en Actuación > Monitor Start 76 caracteres delimitadores sentencia ATTRIBUTES 164 caracteres delimitadores del parámetro cadena-delimitadora. 234 conjuntos de muestras ejemplo de proveedor de datos de archivo de varias filas 121 consideraciones sobre cortafuegos y puerto UDP 1919 272 Consola de favoritos Véase Consola de mensajes universales 287 .bibliotecas compartidas (continuación) KDE 258 KDH 258 KDSFILT 258 KGLBASE 258 KHDXCL1 258 KLX 258 KNS 258 KRA 258 KUM0620 257 KUMP620 257 KUMS1AP1 257 sistemas UNIX 257 bibliotecas de enlace dinámico Véase DLL bibliotecas de International Components for Unicode (ICU) 184 Consola de mensajes universales (UMC) 94 consultas espacio de trabajo. correlación de unidad lógica 44 Categoría. parámetro comportamiento-agregado 174 palabra clave DEPRECATED. proveedor de datos de socket 108 concatenación de cadenas de caracteres de atributos derivados 180 condiciones de excepción integración del Emisor de SNMP en un gestor de SNMP 124 configuración de condición de excepción 229. parámetro comportamiento-agregado 175 palabra clave OPTION{HISTORICALTIMESTAMP}. parámetro comportamiento-agregado 174 palabra clave AGTIM. tipo de letra xx convenios de tipo de letra xx conversión de direcciones 102 correlación de unidad lógica. sentencia ATTRIBUTES 164 característica de Actuación Manage Start 89 Manage Stop 89. variable de entorno 14 D datos de tablas ODBC 57 definición de atributos 169 definición LISTNAME 92 definiciones LISTNAME 92 definiciones de atributos 169 palabra clave AGPRF. 91 detención 90 exclusión de una red 90 inicio 89. 90 Destino del emisor. supresión 31 convenios. parámetro comportamiento-agregado 175 palabra clave WHSC{<atributo>}. 90 mandato Monitor Stop 82 Monitor Start 81 caso 5 caso de configuración Proveedor de datos de archivo.

distintivos de alteración de mandato itmcmd agent 16 ejemplos (continuación) -p. parámetro 126 instalación e integración 124 integración en soluciones de terceros 124 Invocar emisor una vez para cada parámetro de fila de datos 127 TrapDestination.bat para iniciar el archivo ejecutable del proveedor de datos de archivo 259 características de metarchivos ODBC 58 conjunto de muestras de varias filas del proveedor de datos de archivo 121 creación de instancias alternativas de Tivoli Universal Agent 38 CTIRA_HOSTNAME. TivoliLogTime 181 ejemplo de grupo de atributos de resumen de definiciones de atributos 163 ejemplo de metarchivo de script 72 ejemplo de parámetro DEFAULT= 176 ejemplos -o. parámetro 126 visión general 123 visualización de datos 125 Emisor de SNMP integración de condiciones de excepción en un gestor de SNMP 124 288 IBM Tivoli Universal Agent: Guía del usuario .directorios (continuación) /RKDSCATL y /ATTRLIB 27 /um/work en sistemas UNIX 27 archivo de configuración predeterminado en sistemas UNIX 24 archivo de configuración predeterminado en sistemas Windows 24 scripts 70 trabajo predeterminado 25 distintivo -o creación de instancias alternativas de Tivoli Universal Agent 38 distintivo de alteración de mandato itmcmd agent 16 ejemplo de mandato itmcmd agent 16 distintivo -p distintivo de alteración de mandato itmcmd agent 16 ejemplo de mandato itmcmd agent 16 distintivo de alteración mandato itmcmd agent 16 distintivos -o. parámetro 126 Destino del emisor. caso de configuración de correlación de unidad lógica 44 TivoliLogTime. intervalo de resumen 162 parámetro DEFAULT= 176 Proveedor de datos de archivo.attr 124 archivo de catálogo kum. regulares 239 distintivos coincidentes de expresiones regulares 239 distribución de situaciones 95 DLL KUM0620 257 KUMP620 257 KUMS1AP1 257 sistemas Windows 257 dp_SetSourceName API 43 duplicación de atributos 177 E Editor de situaciones 119 acceso a la ayuda para atributos y grupos de atributos 116 descripción 120 Ejemplo 1 metarchivos ODBC 57 Ejemplo 2 161 metarchivos ODBC 58 Ejemplo 3 161 Ejemplo 4 162 Ejemplo 5 163 ejemplo de archivo ejecutable kumpfile 259 ejemplo de definiciones de grupo de atributos de resumen 163 ejemplo de función de atributo derivado.cat 124 archivo ODI dockum 124 Atributos. alteración de mandato itmcmdagent 16 coincidencia de expresiones regulares 239 distintivos coincidentes de expresión. variable de entorno 14 definiciones de atributos en un grupo de atributos de resumen 163 distintivo -o 38 Ejemplo 1 de metarchivo 160 Ejemplo 2 de definición de metarchivo de grupo de atributos 161 ejemplo 2 de metarchivo 167 Ejemplo 3 161 Ejemplo 4 162 Ejemplo 5 163 funciones de atributos derivados 180 KBB_RAS1=ERROR ^>logfile 258 KBB_SIG1=dumpoff -asyncoff 258 KDC_FAMILIES=use:n ip use:y 258 KUMP_DCH_HOST=FIN1 258 kumpcon validate 21 metarchivo 167 metarchivo de script 72 metarchivos ODBC 57 número total. parámetro 126 establecimiento de parámetros 125 Gravedad. función de atributo derivado 181 utilización de parámetros de agregación en un metarchivo 175 ejemplos de funciones de atributos derivados 180 ejemplos de metarchivo utilización de parámetros de agregación 175 emisor de SNMP archivo de atributos kum. parámetro 127 Categoría. distintivos de alteración de mandato itmcmd agent 16 archivo de configuración del proveedor de datos 24 archivo Windows .

82. 78 supresión de consultas 31 TestScript 69 Tivoli Enterprise Portal 72. 82. 84. 84 columnas de MANAGED-NODES 85 DPLOG 26. 83. parámetro 28 definiciones de atributos 176 filtrado de atributos espacio de trabajo 181 filtrado de salidas de script no deseadas filtros expresión regular 184 fin de sesión de entrada de datos 109 72 Índice 289 . 85 espacio de trabajo MIBSTATUS 75. 208 vistas Física y Lógica de Navigator 115 visualización de datos bajo demanda actuales e históricos 5 visualización de datos históricos y en tiempo real 1 espacio de trabajo ACTION 118. 84. 83. 87 otras versiones 27 personalización 116 personalizado 7 Proveedor de datos de SNMP 75 ROUTER 84. 276 espacio de trabajo de SNMP-MANAGER TRAP 78 espacio de trabajo de Tivoli Enterprise Portal 72. 263 espacio de trabajo de aplicación MIB 95 espacio de trabajo de portal 273. 83. 79. 86 espacio de trabajo NETSUMMARY 84. 88 espacio de trabajo ROUTER 84. 85 espacios de trabajo MANAGED-NODES (o listas de favoritos) 75 espacios de trabajo MIB 81 espacios de trabajo NETWORK 75 espacios de trabajo UAGENT 117 Especificación de intervalos de supervisión para situaciones 95 especificación del código de caracteres en sentencias SOURCE 109 registro de asociación 110 exceso de tiempo de espera Proveedor de datos de socket 108 expresiones metacaracteres regulares 235 regulares ICU 235 expresiones regulares en filtros 184 F FILTER. 247 NETWORK 75. 87. 208 espacios de trabajo de aplicaciones 115 espacios de trabajo de aplicaciones MIB de SNMP 80 espacios de trabajo de la aplicación SNMP-MANAGER 84 espacios de trabajo de SNMP-MANAGER acceso 84 MANAGED-NODES 85 MIBSTATUS 86 NETSUMMARY 86 NETWORK 87. 83. 88 espacio de trabajo UAGENT 113 espacio de trabajo UAGENT ACTION 82. 86. 98 espacio de trabajo UAGENT DPLOG 39. 88. 84. 86 NETSUMMARY 84. 98 UAGENT DPLOG 39. 262 espacio de trabajo Estatus de sistemas gestionados 132 Espacio de trabajo Estatus de sistemas gestionados 29 espacio de trabajo FTPLOGFILE 7 espacio de trabajo HELPDESK 63 espacio de trabajo MANAGED_URL 53 espacio de trabajo MIBNODATA 84. 82. 83. 117. 117. 102. 247 SNMP-MANAGER 84 SNMP-MANAGER TRAP 34. 88 Espacio de trabajo ROUTER 247 espacio de trabajo SNMP-MANAGER TRAP 34 espacio de trabajo TestScript 69 espacio de trabajo TRAP 75. 73 TRAP 75. 84. 82. 73 espacio de trabajo DPLOG 26. 262 entrada FTPLOGFILE 7 Estatus de sistemas gestionados 29. 86 Espacio de trabajo NETSUMMARY 247 espacio de trabajo NETWORK 84. 263 aplicación MIB 95 aplicación MIB de SNMP 80 aplicación SNMP-MANAGER 75. 84.entorno de ejecución inicio de proveedores de datos 257 entrada de espacio de trabajo FTPLOGFILE 7 entrada de varios registros 45 Error de arranque Número de error 10048 en los sistemas Windows 271 Error de arranque Número de error 125 Dirección en uso en sistemas UNIX 271 errores inicio 271 errores de inicio 271 errores de puerto de DCH 272 errores de vinculación con EADDRNOTAVAIL 272 errores de vinculación de EADDRNOTAVAIL 272 espacio de trabajo acceso a la ayuda 116 ACTION 118. 117 UAGENT ACTION 82. 102. 88 ROUTER 88 TRAP 88 espacios de trabajo MANAGED-NODES 84. 85 MIBSTATUS 75. 132 filtrado de atributos 181 FTPLOGFILE 7 GENERAL 63 HELPDESK 63 MANAGED-NODES 84. 83. 88 UAGENT 113. 85 MANAGED-NODES (o listas de favoritos) 75 MANAGED_URL 53 MIB 81 MIBNODATA 84. 79.

91 instancias alternativas definición 38 utilización del distintivo -o para crear 38 interacción con otros componentes de IBM Tivoli Monitoring 26 interfaz de mandatos de consola invocación en sistemas operativos UNIX 207 invocación en sistemas operativos Windows 207 interrupciones.attr. 206 grupos de atributos. parámetro 72 intervalo 82 intervalo de muestreo 95 intervalo de resumen.formación véase formación técnica de Tivoli xix formación técnica de Tivoli xix fuentes de datos asociación con metarchivos 103 función de atributo derivado. 206 grupos de atributos aplicación SNMP-MANAGER MANAGED-NODES 78 MIBNODATA 78 MIBSTATUS 78 NETSUMMARY 78 NETWORK 78 ROUTER 78 TRAP 78 grupos SNMP-MANAGER 193 invisibles 138 MANAGED NODES 194. TCP 110 INTERVAL=nn. archivo de atributos del emisor de SNMP 124 KUM_DCH_HOST_NAME 208 KUM_UMC 94 KUM_WORK_PATH 229 KUM_WORK_PATH. 201 grupo de atributos RequestSummary 160 grupo de atributos ROUTER 202. variable de entorno 258 290 IBM Tivoli Universal Agent: Guía del usuario . función de atributo derivado 180 Gravedad. 201 otras versiones 27 RequestSummary 160 ROUTER 202. variable de entorno 43 KUMP_DCH_HOST. variable de entorno 43 KUMP_API_DPAPI_PORT. 203 TRAP 79. 12. ipAddressToName 180 función SETSOURCENAME 102 habilitación 102 utilización para personalizar el nombre de host de un sistema gestionado 102 funciones de atributos derivados 180 GetEnvValue 180 ipAddressToName 180 NetWareTimeToText 180 TivoliLogTime 180 TivoliTimeStamp 180 UTCtoGMT 180 UTCtoLocalTime 180 I IBM Tivoli Monitoring interacción de componente y aplicación con Tivoli Universal Agent 26 ICU International Components for Unicode 184 ICU User Guide 184 importación de metarchivos 36 información de predicado. variable de entorno 24 KUMA_DCH_PORT. archivo de entorno 14 KUMP_API_DPAPI_HOST 208 KUMP_API_DPAPI_HOST. 199 NETWORK 200. variable de entorno 259 KUMA_STARTUP_DP. 199 grupo de atributos NETWORK 200. 260 inicio del descubrimiento de red 89. variable de entorno 11. KUMP_TRAP_ADD_PREDICATES=Y 124 informes 89 SNMP-MANAGER 89 informes de SNMP-MANAGER 89 informes de validación 35 inicio Proveedor de datos de HTTP 51 Proveedor de datos de SNMP 74 secuencia para proveedores de datos de Tivoli Universal Agent 259 inicio de la recopilación de datos 81 visión general 81 inicio de proveedores de datos 257. 74 KUMENV. parámetro 69 Interval=nnn. parámetro utilización para diagnosticar nombres de host local 13 kum. 56. 195 grupo de atributos MIBNODATA 196 grupo de atributos MIBSTATUS 197 grupo de atributos NETSUMMARY 198. 203 grupo de atributos ServerLog 160 grupo de atributos TRAP 204. 15. número total 162 intervalo de situación 121 intervalo de tiempo de vida (TTL) 44 Invocar emisor una vez para cada parámetro de fila de datos 127 G generación de metarchivos 59 GetEnvValue. parámetro 126 grupo de atributos MANAGED-NODES 194. denominación de 191 grupos de atributos invisibles 138 Grupos de atributos MIB-2 192 grupos de atributos SNMP-MANAGER 193 K KBB_RAS1. 195 MIB-2 192 MIBNODATA 196 MIBSTATUS 197 NETSUMMARY 198. 204.

26 KUMP_POST_DP_PORT 60 KUMP_SNMP_AUTOSTART_COLLECTION_MIB2.KUMP_DCH_HOST=FIN1. ejemplo 258 KUMP_DP_EVENT. 98 mandato SHUTDOWN 259 mandato UNPACK 34 mandato VALIDATE 21./itmcmd config –A um 273 caracteres especiales xx Dr. 258 KUMP_META_SERVER. variable de entorno 90 KUMP_SNMP_MONITOR_TRAP=Y. 77 KUMP_SNMP_TRAP_CONSOLE_SEV. distintivo -o 16 itmcmd agent start um 79 itmcmd config -A um 12 kumpcon 259 Monitor Stop 82 netstat –a 271 ps 271 SET 98 SHUTDOWN 259 sintaxis xx Índice L lectura de registros 265 libros Véase también publicaciones comentarios sobre xvii en línea xvii pedir xvii lista de sistemas gestionados. parámetro 70 mandato . Watson 264 mandato GENERATE 59 mandato itmcmd agent distintivo -o 16 mandato itmcmd agent start um 79 mandato itmcmd config -A um 12 mandato kumpcon 259 mandato Monitor Stop 82 mandato netstat –a 271 mandato ps 271 mandato SET 97. variable de entorno 25. 34. variable de entorno 78 KUMP_TCP_DISCONNECT_BY_TTL. Watson 264 envío de acción. 94 activación 92 creación 91. variable de entorno 45 KUMP_DPCONSOLE_PORT. variable de entorno emisor de SNMP 124 KUMP_TRAP_EMIT_COMMUNITY. variable de entorno 94 KUMP_SNMP_TRAP_PORT=nnn. 90 Manage Tivoli Enterprise Monitoring Services 15 ManagedSystemName=xxxxxx. variable de entorno 124 KUMP_TRAP_DESTINATION. 35. variable de entorno emisor de SNMP 124 KUMPCNFG 24 KUMPCNFG. variable de entorno 44 KUMP_DP_HOSTNAME 102 KUMP_DP_PORT 102 KUMP_DP_SAMPLE_FACTOR. variable de entorno 76. 92 desactivación 92 listas de favoritos 76 modificación 92 ubicación de 92 120 291 . 36 mandatos . variable de entorno 20. 35. utilización para iniciar Universal Agent 14 itmcmd agent. 25. clientes de socket 108 itmcmd. ejemplo 21 listas de sistemas gestionados 95 *CUSTOM_AAARR 120 *UNIVERSAL_DATA_aaavv 95 LOADCOMM 216 LOADLIST 217 LOADNAME 218 LOCALE 45 LocalTimeStamp adición de un columna 73 M Manage Start 89 Manage Stop 89. variable de entorno 78 KUMP_SNMP_NET_COMMUNITY./itmcmd config –A um 273 mandato. variable de entorno 111 KUMP_TCP_OUTAGE_WINDOW. variable de entorno 110 KUMP_TRAP_ADD_PREDICATES=Y. variable de entorno 39 KUMP_META_PATH. archivo de configuración compartir 24 kumpcon. variable de entorno 84 KUMP_SNMP_AUTOSTART_MIB_ variable de entorno COLLECTION 84 KUMP_SNMP_CONFIG_FILE 229 KUMP_SNMP_MANAGE_LOCAL_NETWORK=N. *CUSTOM_AAARR lista de sistemas gestionados *UNIVERSAL_DATA_aaavv 95 listas de favoritos Véase listas de nodos gestionados listas de nodos gestionados 91. itmcmd utilización para iniciar Universal Agent 14 mandato de consola DELETE 210 mandato de consola GENERATE 211 mandato de consola IMPORT 214 mandato de consola LIST 215 mandato de consola MNL ADD NODE 219 mandato de consola MNL REMOVE NODE 220 mandato de consola REFRESH 221 mandato de consola SET 222 mandato de consola SHOW 223 mandato de consola SHUTDOWN 224 mandato de consola TRAPCNFG 234 mandato de consola UNPACK 226 mandato Dr.

campo & 76 almacenados en KUMSCOMM 77 descubrimiento de red 76 especificación 76 especificación de valor predeterminado 77 Recopilación de datos de MIB 76 resolución 76 nombres de comunidad. 209 VALIDATE 227 manuales Véase también publicaciones comentarios sobre xvii en línea xvii solicitud xvii marcas registradas 282 mensaje de error de arranque Número de error 10048 271 Número de error 125 Dirección en uso 271 mensaje de fin de transacción. 105 ubicación de 33 ubicación del proveedor de datos 258 validación 20. END-DP-INPUT 109 mensaje END-DP-INPUT 109 mensajes END-DP-INPUT 109 final de transacción 109 mensajes de error arranque 271 dirección no disponible 272 metacaracteres expresión regular 235 metacaracteres de expresiones regulares 235 metarchivo. función de atributo derivado 180 nodo de latido 14 nodos latido 14 nombres 14 registro con el servidor de supervisión 14 subnodos de aplicación 14 nombrehostDPTIPOdp:UAGENT00. parámetro 44 nombres de comunidad Actuación > Monitor Start. ejemplo de variable de entorno 14 subnodos 14 292 IBM Tivoli Universal Agent: Guía del usuario . especificación 81 nombres de directorio. notación xx nombres de host CTIRA_HOSTNAME. 21 versiones de 34 visualización 34 metarchivos de script 66 metarchivos de socket 104.mandatos (continuación) utilización de itmcmd para actualizar 255 VALIDATE 21 mandatos de consola 207. 58 script 66 sincronización del servidor y el cliente 26 sintaxis de sentencia de definición de datos 129 socket 104. 227 DELETE 210 envío 39 especificación de nombres en 208 GENERATE 211 IMPORT 214 kumpcon 259 LIST 215 LOADCOMM 216 LOADLIST 217 LOADNAME 218 MNL ADD NODE 219 MNL REMOVE NODE 220 REFRESH 221 resumen 207 SET 222 SHOW 223 SHUTDOWN 224 TRAPCNFG 225 UNPACK 226 utilización 207. 58 ejemplo 57 ejemplo de características adicionales 58 metarchivos SNMP. 25 alteración de la definición central 26 asociación con fuentes de datos 103 creación 17 creación de servidores 25 definición de aplicaciones con 32 definición de grupo de atributos. nombre de sistema gestionado 38 NombreHostLocal. 105 metarchivos ODBC 57. sólo de condición de excepción 34 metarchivos SNMP sólo de condición de excepción 34 modalidad COPY 121. Ejemplo 2 161 descripción 1 designación de servidores 25 metarchivos (continuación) Ejemplo 1 167 ejemplo 2 167 ejemplo ODBC 57 ejemplos 167 importación 34 nomenclatura 19 nomenclatura de 33 ODBC 57. 183 modalidad COPY en el proveedor de datos de socket 112 modalidad de bloque en el proveedor de datos de socket 112 modalidades de ejecución. scripts 69 modificación de aplicaciones de Tivoli Universal Agent 27 Monitor Start 81 N NetWareTimeToText. ejemplo 1 160 metarchivo de socket parámetro de prefijo de los registros de datos 105 metarchivo KUMPOST 62 metarchivos activación 21 activación mediante un archivo de configuración 24 almacenamiento 20.

102 notación nombres de vía de acceso xx tipo de letra xx variables de entorno xx notificación de desconexión TCP 111 número de modificación 28 número de versión incremento 27. sentencia ATTRIBUTES 165 palabra clave NONE parámetro cadena-delimitadora. sentencia SOURCE 140 ODBC. definiciones de atributos 174 palabra clave BEHAV{<valor>} parámetro comportamiento-agregado. parámetro tipo. sentencia SOURCE. sentencia CONFIRM 157 Índice O opción COPY. parámetro tipo. sentencia SOURCE. parámetro máximo de registros y regla de identificación. sentencia SOURCE 140 opción SNMP. parámetro modalidad-archivo 143 TAILRESTART. parámetro tipo. definiciones de atributos 175 palabra clave SEQ. sentencia SOURCE 140 TAIL. parámetro modalidad-archivo 144 opción TRAP. parámetro tipo. sentencia SOURCE. parámetro modalidad-archivo 143 opción TAILRESTART. parámetro modalidad -archivo 143 TAILBYCOUNT. parámetro 44. parámetro modalidad-archivo 144 operaciones SET 97. parámetro tipo. sentencia SOURCE 140 SOCK. parámetro máximo de registros y regla de identificación. parámetro tipo_confirmación. 29 números de puerto 1919 necesario como puerto de escucha predeterminado 272 números de puerto de escucha puerto UDP 1919 predeterminado 272 números de versión restablecimiento de aplicación 29 números reales. sentencia SOURCE. parámetro tipo. sentencia SOURCE parámetro modalidad-archivo 143 TAILRESTARTFROMTOP. definiciones de atributos 174 palabra clave AGTIM parámetro comportamiento-agregado. 98 procedimiento 98 requisitos 97 P palabra clave 0xnn parámetro cadena-delimitadora. sentencia RECORDSET 154 palabra clave NEWLINE parámetro cadena-delimitadora. sentencia SOURCE. parámetro tipo_confirmación. sentencia SOURCE 140 293 . sentencia ATTRIBUTES 165 palabra clave AGPRF parámetro comportamiento-agregado. parámetro modalidad-archivo 143 opción TAILBYCOUNT. notación xx NombreSistemaGestionado. definiciones de atributos 175 palabra clave OPTION{PRIMARYKEY=<n>} parámetro comportamiento-agregado. sentencia SOURCE. atributos derivados 179 opciones COPY. definiciones de atributos 174 palabra clave DEPRECATED parámetro comportamiento-agregado. parámetro modalidad-archivo 143 FILE. sentencia SOURCE. sentencia SOURCE. alternativas 38 Proveedor de datos 38 Prueba de latido 38 nombres de sistemas gestionados aplicaciones del proveedor de datos de socket 102 nombrehostDPTIPOdp:UAGENT00 38 nombres de sistemas gestionados de aplicaciones del proveedor de datos de SNMP 74 nombres de subnodos de aplicación 14 nombres de vía de acceso. parámetro tipo. sentencia RECORDSET 155 palabra clave message. parámetro modalidad-archivo 144 opción TAILBYRECORD. parámetro tipo. sentencia SOURCE 140 opción SOCK. sentencia SOURCE. sentencia SOURCE 140 SNMP. sentencia SOURCE 140 opción TAIL. parámetro modalidad-archivo 143 opción TAILRESTARTFROMTOP. sentencia SOURCE 140 opción ODBC. sentencia SOURCE. sentencia CONFIRM 157 palabra clave NEW. sentencia ATTRIBUTES 165 palabra clave OPTION{HISTORICALTIMESTAMP} parámetro comportamiento-agregado. parámetro tipo. parámetro tipo. parámetro tipo. parámetro tipo. parámetro modalidad-archivo. parámetro modalidad-archivo 144 TAILBYRECORD. definiciones de atributos 175 palabra clave END. sentencia SOURCE 143 opción de Actuación URL Add 52 Opción de Actuación URL Add 52 opción FILE. sentencia SOURCE 140 opción SCRIPT.nombres de host (continuación) utilización de variables de entorno a determinar para aplicaciones 13 utilización del parámetro KBB_RAS1 para diagnosticar nombres de host local 13 nombres de instancias Aplicación 38 creación. sentencia SOURCE 140 opción TRAP. sentencia SOURCE 140 SCRIPT.

palabra clave SIZE. sentencia SOURCE 142 parámetro ATOMIC. parámetro comportamiento-agregado. sentencia CONFIRM 157 NEW. definiciones de atributos 175 OPTION{PRIMARYKEY=<n>}. parámetro comportamientoagregado. cadena-delimitadora 165 parámetro 0xnn. definiciones de atributos 175 palabra clave NONE.bat en sistema Windows 30 parámetro DLM. sentencia ATTRIBUTES 165 parámetro DLMSTRBGN. sentencia ATTRIBUTES 166 parámetro Envfile=. parámetro comportamientoagregado 175 Xnn.bat en los sistemas UNIX 31 script um_cleanup. definiciones de atributos 172 parámetro cadena-delimitadora. sentencia SUMMARY 159 parámetro KEY. sentencia ATTRIBUTES 165 parámetro DLMSTR. NAME 135 parámetro AddTimeStamp 73 sentencia NAME 136 parámetro argumentos-script. parámetro tipo_confirmación. sentencia SOURCE 147 parámetro Interval. sentencia ATTRIBUTES 165 OPTION{HISTORICALTIMESTAMP}. parámetro cadena-delimitadora. sentencia CONFIRM 157 paquete de cliente de API 41 parámetro SNMP TEXT 36 parámetro @helptext 19 parámetro -FILTER 72. parámetro tipo_confirmación.bat en sistema Windows 30 parámetro de la sentencia INPUT. definiciones de atributos 175 palabra clave Xnn. sentencia SQL 158 parámetro de tamaño máximo. sentencia RECORDSET 154 NEWLINE. definiciones de atributos 174 parámetro Database=. definiciones de atributos 175 END. definiciones de atributos 171 parámetro KUMA_STARTUP_DP inicio del proveedor de datos de HTTP 51 parámetro Locale=. parámetro comportamiento-agregado. parámetro comportamiento-agregado. sentencia ATTRIBUTES 164 parámetro CAPTION. sentencia RECORDSET 155 message. definiciones de atributos 174 BEHAV{<valor>}. parámetro comportamiento-agregado. sentencia SOURCE 145 parámetro de arquitectura script um_cleanup. parámetro tipo_confirmación. parámetro máximo de registros y regla de identificación. 144 parámetro comportamiento-agregado. 73 parámetro AddSourceName. sentencia CONFIRM 157 palabras clave AGPRF. definiciones de atributos 173 parámetro Codepage=. parámetro máximo de registros y regla de identificación. parámetro tipo_confirmación. parámetro tipo_confirmación. sentencia SOURCE 148 parámetro ID 52 parámetro intérprete-script. 144 parámetro CompareBySize 48. 68 parámetro Force. sentencia. 184 294 IBM Tivoli Universal Agent: Guía del usuario . parámetro tipo_confirmación.bat en los sistemas UNIX 31 script um_cleanup. parámetro comportamientoagregado. definiciones de atributos 174 AGTIM. sentencia NAME 134 parámetro de número de puerto 105. sentencia SOURCE 148 parámetro ManagedSystemName=xxxxxx 56 parámetro master 59 parámetro MATCHREGEX 182. parámetro cadena-delimitadora. sentencia SOURCE 140 parámetro Interval=. sentencia SUMMARY 159 parámetro HostAddr=. sentencia INTERNAL 150 parámetro de nombre-grupo-atributos. sentencia NAME 135 parámetro DEFAULT 69 definiciones de atributos 176 parámetro delimitador-específico-atributo definiciones de atributos 175 parámetro directorio_instalación script um_cleanup. sentencia SOURCE 146 parámetro CompareByLastUpdate 48. sentencia ATTRIBUTES 166 parámetro DLMSTREND. sentencia ATTRIBUTES 165 WHSC{<atributo>}. parámetro cadena-delimitadora. sentencia ATTRIBUTES 165 SEQ. sentencia NAME 136 parámetro Interval=nn 57 parámetro Intervalo 162 parámetro intervalo.bat en sistema Windows 30 parámetro directorio_trabajo archivo um_cleanup. sentencia CONFIRM 157 palabra clave TAB parámetro cadena-delimitadora. sentencia ATTRIBUTES 165 palabra clave WHSC{<atributo>} parámetro comportamiento-agregado. definiciones de atributos 171 parámetro de tiempo de vida (TTL). sentencia CONFIRM 157 TAB. sentencia INTERNAL 150 parámetro de sentencia Select. definiciones de atributos 174 DEPRECATED. sentencia SOURCE 148 parámetro HostInfo=. definiciones de atributos 172 parámetro de componente script um_cleanup. sentencia SOURCE 146 parámetro envfile=xxxx 67. sentencia CONFIRM 157 SIZE. sentencia SOURCE 146 parámetro ManagedSystemName=. 104 parámetro de número de puerto metarchivo de socket 105 parámetro de sentencia OUTPUT.bat en los sistemas UNIX 31 parámetro de cadena de caracteres ENU. 106 parámetro de número de puerto de la sentencia SOURCE SOCK 103.

definiciones de atributos 176 definiciones de atributos 169 delimitador-específico-atributo. definiciones de atributos 173 parámetro SCANREGEX 182.bat directorio_trabajo 30 archivo um_cleanup. sentencia SOURCE 145 parámetro SETSOURCENAME 107 parámetro SETSOURCENAME =y 103 parámetro SetSourceName=Y/N. 184 parámetro RunOnce=Y/N. sentencia APPL 132 parámetro proveedor de datos de ODBC sentencia NAME 57 parámetro pswd= 59 parámetro Pswd=. sentencia SOURCE 143 parámetro nombre-atributo. sentencia SUMMARY 160 parámetro SkipNonNumeric. 68 FILTER 28 FILTER. sentencia SOURCE 140 parámetro tipo-atributo. sentencia CONFIRM 157 parámetro ubicación. definiciones de atributos 175 Destino del emisor. sentencia SUMMARY 159 intervalo de resumen 162 Invocar emisor una vez para cada fila de datos. sentencia ATTRIBUTES 166 DLMSTREND. 144 CompareBySize 48. 73 archivo um_cleanup. sentencia SOURCE 147 parámetro SKEY definiciones de atributos 176 parámetro SKEY=n. sentencia SOURCE 148 ID 52 inicio. sentencia NAME 137 parámetro SkipNonNumeric. emisor de SNMP 127 cadena de caracteres ENUM. sentencia SOURCE 146 envfile=xxxx 67. emisor de SNMP 126 DLM.bat en los sistemas UNIX 31 parámetro nombreaplic. definiciones de atributos 172 cadena-delimitadora. sentencia SOURCE 146 CompareByLastUpdate 48. emisor de SNMP 127 KBB_RAS1. sentencia SOURCE 145 parámetro WHEN{<valor>}. 184 parámetro REPLACEFIRST 182. definiciones de atributos 173 Categoría. sentencia SOURCE 144 parámetro número_máximo_de_registros. sentencia NAME 137 CODEPAGE 110 Codepage=. sentencia SOURCE 147 parámetro SCALE y PRECISION. 73 AddTimeStamp 58. emisor de SNMP 126 ClearValues. sentencia ATTRIBUTES 165 DLMSTR. sentencia SOURCE 145 parámetro REPLACEALL 182. definiciones de atributos 176 Force. sentencia APPL 131 parámetros @helptext 19 -FILTER 72. SNMP 36 parámetro tipo. definiciones de atributos 169 parámetro tipo-código. sentencia SNMP 130 parámetro TEXT. sentencia NAME 134 parámetro método-comparación-archivos. sentencia SOURCE 145 DEFAULT 69 DEFAULT. definiciones de atributos 174 Database=. sentencia SOURCE 148 HostInfo=. sentencia SOURCE 142 parámetro tipo_confirmación. sentencia ATTRIBUTES 165 DLMSTRBGN. sentencia SOURCE 142 ATOMIC.parámetro máximo de registros y regla de identificación. sentencia SOURCE 141 parámetro URL 52 parámetro URLaliasName 52 parámetro user= 59 parámetro USER= 53 parámetro User=. sentencia SOURCE 144 parámetro modalidad-archivo. sentencia SOURCE 145 parámetro método. sentencia RECORDSET 154 parámetro Maxrows=. emisor de SNMP 126 HostAddr=. sentencia SOURCE 140 parámetro SOCKET-COMMAND-ENABLED 107 parámetro StatusInterval 52 parámetro tailbyrecord 49 parámetro TEXT. sentencia SOURCE 147 INTERVAL=nn 69 Interval=nn 57 Interval=nnn 72 intervalo. sentencia SUMMARY 159 Gravedad. definiciones de atributos 172 Atributos. sistemas operativos Windows 15 inicio en los sistemas operativos UNIX 16 intérprete-script. sentencia SOURCE 148 parámetro Runtime 72 parámetro Runtime=. sentencia ATTRIBUTES 164 CAPTION. sentencia ATTRIBUTES 166 Envfile=. sentencia SOURCE 140 Interval=. definiciones de atributos 169 parámetro nombre de host de la sentencia SOURCE SOCK 103 parámetro nombre_TEMS script um_cleanup. utilización para diagnosticar nombres de host local 13 KEY. sentencia RECORDSET 153 parámetro ProductCode. sentencia APPL 131 parámetro número-de-registros-archivo. 144 comportamiento-agregado. 184 parámetro SEQ definiciones de atributos 176 parámetro Server=.bat en sistema Windows componente 30 argumentos-script. sentencia RECORDSET 154 parámetro ObjCache% 52 parámetro ODBC 57 parámetro patrón delimitador. definiciones de atributos 171 KUMA_STARTUP_DP 51 línea de mandatos CMS y CNPS 30 Índice 295 .

sentencia SOURCE 147 SCALE y PRECISION. definiciones de atributos 171 texto de ayuda. definiciones de atributos 169 nombre de host de la sentencia SOURCE SOCK 103 nombre de instancia 38 NombreHostLocal 44 NombreSistemaGestionado 44. comportamiento-agregado. definiciones de atributos 169 tipo-código. sentencia SQL 158 sentencia Server= SOURCE 145 sentencia SNMP TEXT 130 sentencia SOURCE 140 sentencia SOURCE. definiciones de atributos 174 palabra clave AGTIM. definiciones de atributos 174 palabra clave BEHAV{<valor>}. sentencia SOURCE 145 método-comparación-archivos. sentencia SOURCE 146 ManagedSystemName=. comportamiento-agregado. sentencia NAME 138 tipo. ubicación 141 sentencia SUMMARY SKEY=n 160 SEQ. 176 texto de ayuda. sentencia RECORDSET 154 ObjCache% 52 ODBC 57 palabra clave 0xnn. sentencia ATTRIBUTES 165 palabra clave AGPRF. definiciones de atributos 175 palabra clave LOCALE 45 palabra clave NEWLINE. sentencia ATTRIBUTES 165 palabra clave NONE. sentencia SOURCE 140 tipo-atributo.bat en los sistemas UNIX arquitectura 31 componente 31 directorio_instalación 31 nombre_TEMS 31 script um_cleanup.bat en sistema Windows directorio_instalación 30 sentencia APPL nombreaplic 131 ProductCode 132 WHEN{<valor>} 131 sentencia ATTRIBUTES 164 sentencia CONFIRM tipo_confirmación 157 sentencia INTERNAL 150 sentencia INPUT 150 sentencia OUTPUT 150 sentencia NAME AddSourceName 135 AddTimeStamp 136 intervalo 136 método 134 nombre-grupo-atributos 134 SkipNonNumeric 137 tiempo de vida (TTL) 135 sentencia NAME. definiciones de atributos 173 SCANREGEX 182. sentencia RECORDSET 153 prefijo de los registros de datos.parámetros (continuación) LOCALE 110 Locale=. sentencia SOURCE 148 ManagedSystemName=xxxxxx 56. definiciones de atributos 175 palabra clave TAB. emisor de SNMP 126 296 IBM Tivoli Universal Agent: Guía del usuario . cadena-delimitadora. comportamientoagregado. definiciones de atributos 174 palabra clave CODEPAGE 45 palabra clave DEPRECATED. sentencia SOURCE 143 nombre-atributo. sentencia ATTRIBUTES 165 palabra clave WHSC{<atributo>}. comportamientoagregado. proveedor de datos de ODBC 57 sentencia RunOnce=Y/N SOURCE 148 sentencia Select. sentencia SOURCE 147 SKEY. definiciones de atributos 176 SETSOURCENAME 107 SETSOURCENAME =y 103 SetSourceName=Y/N. sentencia RECORDSET 154 Maxrows=. sentencia SQL 158 pswd= 59 parámetros (continuación) Pswd= 71 Pswd=. metarchivo de socket 105 proc=procedimiento almacenado. comportamiento-agregado. 184 máximo de registros y regla de identificación. definiciones de atributos 175 parámetro Interval= 58 patrón delimitador. 104 número-de-registros-archivo. sentencia APPL 132 texto de ayuda. definiciones de atributos 169. 184 REPLACEFIRST 182. definiciones de atributos 176 SOCKET-COMMAND-ENABLED 107 StatusInterval 52 tailbyrecord 49 tamaño-máximo. sentencia ATTRIBUTES 165 palabra clave OPTION{HISTORICALTIMESTAMP}. sentencia SOURCE 142 TrapDestination. cadena-delimitadora. 102 número de puerto 106 número de puerto. sentencia SOURCE 144 modalidad-archivo. sentencia SOURCE 144 número_máximo_de_registros. 184 script um_cleanup. 184 Runtime 72 Runtime=. comportamiento-agregado. metarchivo de socket 105 número de puerto de la sentencia SOURCE SOCK 103. 70 master 59 MATCHREGEX 182. definiciones de atributos 175 palabra clave OPTION{PRIMARYKEY=<n>}. sentencia SOURCE 145 REPLACEALL 182. comportamiento-agregado.

nombre de instancia 38 Proveedor de datos de archivo 44 caso de configuración de correlación de unidad lógica 44 entrada de varios registros 45 frecuencia de muestreo 44 rutinas de extracción de archivos especiales 45 ubicación necesaria 44 Proveedor de datos de ASFS 11 Proveedor de datos de envío 60. 59 aplicaciones 56 generación de metarchivos automáticamente 59 inicio 56 nombres de sistemas gestionados 56 Proveedor de datos de script 66 nombres de sistemas gestionados 70 Proveedor de datos de servidor de API descripción 41 especificación del host 43 especificación del puerto de escucha 43 mandatos de consola 42 programas de llamada 42 puerto de escucha 43 Proveedor de datos de SNMP 74 características 75 ejecución de varias instancias 39 espacio de trabajo MIBSTATUS 75 espacio de trabajo TRAP 75 inicio 74 proveedor de datos de socket modalidad COPY 112 modalidad de bloque 112 Proveedor de datos de socket 100. 63 configuración predeterminada 60. 104 comunicación UDP 108 contactar 101 conversión de código de caracteres 109. metarchivo de socket 105 problemas condición de excepción de SNMP 269 espacio de trabajo de portal 273. 65 categorías de mensajes 61 configuración de las especificaciones en tiempo de ejecución 62. 36 personalización de contenidos de espacios de trabajo 116 política. automatización 7 política de automatización 7 políticas descripción 1 prefijo del parámetro de registros de datos. 110 conversión de direcciones 102 conversión de nombre y dirección 102 descripción 100 envío del registro CLEAR-PRIOR-DATA 109 exceso de tiempo de espera 108 Índice 297 . sentencia SOURCE 145 parámetros CODEPAGE 110 parámetros de inicio especificación en los sistemas operativos UNIX 16 sistemas operativos Windows 15 parámetros de la sentencia ATTRIBUTES 164 parámetros de línea de mandatos CMS y CNPS 30 parámetros de línea de mandatos CMS y CNPS 30 parámetros de nombre de instancia 38 parámetros LOCALE 110 personalización de aplicaciones 35. 276 interfaz de consola 275 problemas de condiciones de excepción de SNMP 269 problemas de interfaz de consola 275 procedimiento de script de limpieza en sistemas UNIX 31 procedimiento de script de limpieza en sistemas Windows 30 proceso de descubrimiento de red. 55 Atributos de URL 53 inicio 51 supervisión de un URL 51 Proveedor de datos de ODBC 56. 64 programa VALIDATE 227 descripción 20 programas cliente Proveedor de datos de socket 101 programas de inicio KUMPAPIS 257 KUMPASFS 257 KUMPFILE 257 KUMPHTTP 257 KUMPODBC 257 KUMPPOST 257 KUMPSCRP 257 KUMPSNMP 257 KUMPSOCK 257 proveedor de datos 257 Proveedor consolidado de datos Véase Proveedor de datos de ASFS Proveedor de datos. 61 datos de envío 64 datos proporcionados por el producto 63 indicación reconocimiento 61 personalización 62 variables de entorno 62 proveedor de datos de HTTP utilización de metarchivos 258 Proveedor de datos de HTTP 51.parámetros (continuación) URL 52 URLaliasName 52 user= 59 User= 71 USER= 53 User=. kumsnetd 270 proceso de descubrimiento de red kumsnetd 270 proceso kumstrap 270 procesos descubrimiento de red kumsnetd 270 kumstrap 270 programa de inicio KUMPAPIS para 257 Programa KUMPCON 207 programa KUMPSEND 62.

envío al proveedor de datos de socket 109 lectura 265 reconocimiento. nombre de instancia 38 Pswd=. 164 caracteres delimitadores.bat en los sistemas UNIX parámetro de arquitectura 31 parámetro de componente 31 parámetro directorio_instalación 31 parámetro nombre_TEMS 31 script um_cleanup. 59 programas de inicio 257 script 66 secuencia de inicio 259 servidor de API 41. xviii publicaciones en línea acceso xviii puerto UDP 1919 272 puertos no estándares recopilación de datos 83 registro SETSOURCENAME 102 registros CLEAR-PRIOR-DATA. recopilación automática de datos MIB 84 registro CLEAR-PRIOR-DATA envío al proveedor de datos de socket 109 298 IBM Tivoli Universal Agent: Guía del usuario . 55 inicio 257 inicio como procesos independientes 257. 260 ODBC 56.Proveedor de datos de socket (continuación) formato de almacenamientos intermedios de socket 108 limitaciones 111 modificación del puerto predeterminado 102 nombres de sistemas gestionados 102 reconocimiento de datos 111 varias máquinas host 102 proveedores de datos 37.bat 29.bat 29. 131 parámetro de texto de ayuda 132 parámetro ProductCode 132 parámetro WHEN{<valor>} 131 parámetros 131 secuencia de metarchivo 129 sintaxis 131 sentencia ATTRIBUTES 58.bat en sistema Windows 30 UNIX 29 Windows 29 scripts de limpieza ejecución 29 secuenciado de definiciones de atributos 186 sentencia APPL 7.bat en sistemas Windows 30 itmcmd agent start um 79 limpieza 29 modalidades de ejecución 69 tiempos de espera excedidos 71 um_cleanup 29 um_cleanup. incorrecto 268 SETSOURCENAME 102 registros de detalle. 30 um_cleanup. 26. grupo de atributos ServerLog 160 resolución de problemas 261 restablecimiento números de versión de aplicación 29 RKANDATV archivos CAT y almacenados como miembros de conjuntos de datos particionados 27 rutinas de extracción de archivos Proveedor de datos de archivo 45 S salida de script filtrado no deseado 72 script itmcmd agent start um 79 script um_cleanup 29 script um_cleanup. 65 HTTP 51.bat en sistemas UNIX ejecución de um_cleanup. parámetro cadena-delimitadora 164 notas sobre utilización 58 31 R rastreo 261 recopilación de datos detención 82 inicio 81 MIB automática para recursos de red descubiertos 84 recursos de red adición y eliminación 94 agrupamiento automático 92 recursos de red. parámetro 71 publicaciones acceso en línea xviii comentarios sobre xvii en línea xvii solicitud xvii. 59 alteración manual 15 Archivo 44 ASFS 11 descripción 1 detención 259 ejecución de varias instancias 38 ejemplo de archivo de configuración 24 entorno de ejecución 257 envío 60. 43 SNMP 74 socket 104 Socket 100 tipos 37 tipos en Tivoli Universal Agent 2 utilización de variables de entorno para conectar con Tivoli Universal Agent 258 Prueba de latido. 30 ejecución en sistemas UNIX 31 ejecución en sistemas Windows 30 parámetro directorio_instalación en sistema Windows 30 script um_cleanup.bat en sistema Windows 30 scripts ejecución de um_cleanup.

parámetro 44 NombreSistemaGestionado. parámetros 154 parámetro máximo de registros y regla de identificación. 138 parámetro AddSourceName 135 parámetro AddTimeStamp 136 parámetro ClearValues 137 parámetro de texto de ayuda 138 parámetro de tiempo de vida (TTL) 135 parámetro Interval 136 parámetro método 134 parámetro nombre-grupo-atributos 134 parámetro SkipNonNumeric 137 Proveedor de datos de ODBC 57 secuencia de metarchivo 129 sintaxis 134 sentencia proc=procedimiento almacenado. parámetro cadena-delimitadora 165 palabra clave TAB. palabra clave NEW 154 parámetro patrón delimitador 153 secuencia de metarchivo 129 sintaxis 153 sentencia SNMP 130 parámetros 130 sentencia SNMP (continuación) secuencia de metarchivo 129 sintaxis 130 sentencia SOURCE 57. 26. 59 opción FILE. parámetro tipo 140 opción SNMP. parámetro cadena-delimitadora 165 secuencia de metarchivo 129 sentencia CONFIRM 157 parámetro tipo_confirmación. 143 parámetro ubicación 141 parámetro User= 145 parámetros 140 secuencia de metarchivo 129 sintaxis 140 SOCK. opción COPY 143 parámetro modalidad-archivo. opción TAILBYCOUNT 144 parámetro modalidad-archivo. 134. parámetro cadenadelimitadora 165 parámetro cadena-delimitadora. sentencia SQL 158 sentencia RECORDSET 153 máximo de registros y regla de identificación parámetro 154 número_máximo_de_registros. palabra clave SEQ 157 parámetro tipo_confirmación. parámetro tipo 140 opción SOCK. opción TAILRESTART 143 parámetro número-de-registros-archivo 144 parámetro Pswd= 145 parámetro RunOnce=Y/N 148 parámetro Runtime= 147 parámetro Server= 145 parámetro SetSourceName=Y/N 147 parámetro tipo 140 parámetro tipo-código 142. parámetro tipo 140 opción TRAP. palabra clave message 157 parámetro tipo_confirmación. 59. parámetro de nombre de host 103 SOCK. 157 control de SQL 158 Índice 299 . parámetro tipo 140 parámetro argumentos-script 142 parámetro Codepage= 146 parámetro Database= 145 parámetro Envfile= 146 parámetro HostAddr= 148 parámetro HostInfo= 148 parámetro intérprete-script 140 parámetro Interval= 147 parámetro Locale= 146 parámetro ManagedSystemName= 148 parámetro Maxrows= 145 parámetro método-comparación-archivos 144 parámetro modalidad-archivo 144 parámetro modalidad-archivo. parámetro de número de puerto 104 sentencia SOURCE TRAP 79 sentencia SQL 58. opción TAIL 143 parámetro modalidad-archivo. parámetro tipo 140 opción SCRIPT. palabra clave SIZE 157 parámetro tipo_confirmación. parámetro-cadena delimitadora 165 parámetro 0xnn. 164 CONFIRM 129.sentencia ATTRIBUTES (continuación) palabra clave NEWLINE. 129. opción TAILBYRECORD 143 parámetro modalidad-archivo. 131 ATTRIBUTES 129. parámetro 44 sentencia INTERNAL 150 parámetro de la sentencia INPUT 150 parámetro de sentencia OUTPUT 150 parámetros 150 secuencia de metarchivo 129 sintaxis 150 sentencia NAME 58. 158 parámetros 158 secuencia de metarchivo 129 sintaxis 158 sentencia SUMMARY 159 Ejemplo 4 162 parámetros 159 secuencia de metarchivo 129 sintaxis 159 sentencias APPL 7. palabra clave Xnn 157 parámetros 157 secuencia de metarchivo 129 sintaxis 157 utilización para especificar el reconocimiento de datos del proveedor de datos de socket 111 sentencia de control SOURCE NombreHostLocal. parámetro tipo 140 opción ODBC. palabra clave END 155 parámetro máximo de registros y regla de identificación.

registro de nodos 14 servidor de supervisión registro de nodos 14 sesión de entrada. parámetro de número de puerto 103 servidor supervisión. xviii soporte de nombres de archivo dinámicos 46. 121 supervisión de las aplicaciones SNMP 80 T TCP 101 texto de ayuda parámetro 169 parámetro. 159 sentencias de definición de datos 129 sintaxis de metarchivo 129 sentencias SOURCE SOCK. 150 NAME 129.sentencias (continuación) control RECORDSET 153 definición de datos 129 definiciones de atributos 169 INTERNAL 129. predefinida 119 distribución 95. fin 109 sesión de entrada de datos. sentencia NAME 138 tiempos de espera excedidos. 120 especificación de intervalos de supervisión para 95 establecimiento de intervalos de supervisión 121 HOTLIST_offline 97 MB2_egpError 96 MB2_egpNeighError 97 MB2_icmpError 96 MB2_interfaceDown 95 MB2_interfaceInError 95 MB2_interfaceOutError 96 MB2_ipFragmentationError 96 MB2_ipInError 96 MB2_ipOutError 96 MB2_snmpOperationViolations 97 MB2_tcpError 96 MB2_udpError 96 NETWORK_not_responding 97 ROUTER_status_offline 97 selección de atributos 120 SNMP predefinida 95 TRAP_category_errors 97 TRAP_severity_errors 97 utilización 119 situaciones proporcionadas por el producto 95 descripciones de 95 SNMP-MANAGER aplicación 75 espacios de trabajo de aplicaciones 75 solicitud de publicaciones xvii. 153 sintaxis de metarchivo de definición de datos 129 SNMP 129. 158 SUMMARY 129. 140 SQL 129. fin 109 sintaxis de filtrado de atributos 182 Sintaxis de la sentencia ATTRIBUTES 164 Sistemas de destino 82 sistemas de varias interfaces 208 sistemas gestionados cambios de versión 115 descripción 113 distribución de situaciones a 95 nombre 51 nombres 114 números de versión 114 otras versiones 27 registro al arrancar 114 supresión 29 sistemas gestionados por Tivoli Universal Agent 113 sistemas UNIX Error de arranque Número de error 125 Dirección en uso 271 especificación de parámetros de inicio 16 sistemas Windows Número de error 10048 271 sistemas z/OS archivos CAT y ATR almacenados como miembros de conjuntos de datos particionados en RKANDATV 27 situación HOTLIST_offline 97 situación MB2_egpError 96 situación MB2_egpNeighError 97 situación MB2_icmpError 96 situación MB2_interfaceDown 95 situación MB2_interfaceInError 95 situación MB2_interfaceOutError 96 situación MB2_ipFragmentationError 96 situación MB2_ipInError 96 situación MB2_ipOutError 96 situación MB2_snmpOperationViolations 97 situación MB2_tcpError 96 situación MB2_udpError 96 situación NETWORK_not_respondingsituation 97 situación ROUTER_status_offline 97 situación TRAP_category_errors 97 situación TRAP_severity_errors 97 situaciones 94 acceso a la ayuda 116 creación 94 descripción 1. sentencia APPL 132 parámetro. 130 SOURCE 129. scripts 71 tipos ASN. definiciones de atributos 176 parámetro. 48 SOURCE asociación de sentencias mediante metarchivos 103 subnodos nombres 14 nombres de host 14 registro con el servidor de supervisión 14 supervisión URL https:// 55 supervisión de aplicaciones de Tivoli Universal Agent 113.1 191 300 IBM Tivoli Universal Agent: Guía del usuario . 119 descripción. 134 RECORDSET 129.

utilización 229 TrapDestination. ubicación 24 variable de entorno KUMPCNFG. función de atributo derivado 180 UTCtoLocalTime. entorno 74 KUMP_SNMP_NET_COMMUNITY. parámetro 126 truncamiento 39 TTL Véase tiempo de vida U ubicación del proveedor de datos de script 67 UDP 101. entorno 13 KDEB_INTERFACELIST 13 KUM_DCH_HOSTNAME. 15. determinación de nombres de host de aplicaciones 13 entorno.tipos de datos 191 tipos de datos de IBM Tivoli Monitoring 191 tipos de datos SMIv1 191 Tivoli. función de atributo derivado 180 V validación de metarchivos 20 valor predeterminado público 76 valor TTL (tiempo de vida) 121 valores de depuración 261 valores de tiempo de vida 95 valores predeterminados público en KUMP_SNMP_NET_COMMUNITY 77 especificación de nombre de comunidad en KUMP_SNMP_NET_COMMUNITY 77 KUMP_SNMP_NET_COMMUNITY. función de atributo derivado 180 TivoliTimeStamp. 241 CTIRA_HOSTNAME 14 determinación de nombres de host de aplicaciones 13 edición 12 edición en sistemas UNIX 12 emisor de SNMP 124 establecimiento 11 generada 68 KDCB0_HOSTNAME 13 KDEB_INTERFACELIST 13 KUM_DCH_HOSTNAME 13 KUM_DP_HOSTNAME 13 KUM_WORK_PATH 24 KUMA_DCH_PORT 259 KUMA_STARTUP_DP 11. formación técnica xix Tivoli Enterprise Portal acceso a la ayuda para atributos y grupos de atributos 116 aplicaciones visualizada en la vista de Navigator 114 creación de políticas 113 creación de situaciones 113 notificación fuera de línea del sistema gestionado de interrupciones TCP 110 supervisión de datos de Tivoli Universal Agent 113 utilización para supervisar aplicaciones 113 vista Lógica de Navigator 116 vistas Física y Lógica de Navigator 115 visualización de espacios de trabajo 113 visualización de espacios de trabajo de aplicaciones 115 visualización de grupos de atributos en espacios de trabajo 115 TivoliLogTime. entorno 13 KUMA_STARTUP_DP. 258 KUMP_META_SERVER 25. 26 KUMP_SNMP_AUTOSTART_MIB_ COLLECTION 84 Índice 301 . 12. variable de entorno 76 valores predeterminados (continuación) public 76 valores predeterminados de trapcnfg categorías soportadas 232 estatus soportados 232 ID de fuente soportados 233 niveles de gravedad soportados 232 variable de entorno generada 68 variable de entorno KUMP_INIT_CONFIG_PATH. secuencia de búsqueda en una búsqueda DNS 13 entorno de script 67 entorno generado 68 entorno KUMA_STARTUP_DP 12 establecimiento de la ubicación del entorno 11 establecimiento del entorno 11 KDCB0_HOSTNAME. función de atributo derivado 180 TRAP espacio de trabajo 79 grupo de atributos 79 redirección de datos 79 TRAPCNFG 225 trapd. ejemplo de función de atributo derivado 181 TivoliLogTime. 77 MIB SNMP escalar 35 notación para el entorno xx utilización para alterar temporalmente el nombre de host local 13 variables de entorno 94. entorno 76. ubicación 24 variables i CTIRA_HOSTNAME. entorno 13 KUM_DP_HOSTNAME.conf. entorno 14 edición del entorno 12 edición del entorno en sistemas UNIX 12 entorno. 56. 25. 109 UMC Véase Consola de mensajes universales UNIX edición de variables de entorno 12 UTCtoGMT. 74 KUMP_API_DPAPI_HOST 43 KUMP_API_DPAPI_PORT 43 KUMP_DCH_HOST 258 KUMP_DP_EVENT 44 KUMP_DP_SAMPLE_FACTOR 45 KUMP_DPCONSOLE_PORT 39 KUMP_INIT_CONFIG_PATH 24 KUMP_META_PATH 20.

77 KUMP_SNMP_TRAP_PORT=nnn 78 KUMP_TCP_DISCONNECT_BY_TTL 111 KUMP_TCP_OUTAGE_WINDOW 110 KUMP_TRAP_DESTINATION 124 KUMP_TRAP_EMIT_COMMUNITY 124 KUMP_WORK_PATH 25 KUMPCNFG 24 notación UNIX xx notación Windows xx script 67 secuencia de búsqueda en una búsqueda DNS 13 ubicación 11 utilización para alterar temporalmente el nombre de host local 13 utilización para conectar proveedores de datos con Tivoli Universal Agent 258 variable de entorno 35 variables de entorno de script 67 Variables de entorno del emisor de SNMP 124 variables MIB.variables de entorno (continuación) KUMP_SNMP_MANAGE_LOCAL_ NETWORK=N 90 KUMP_SNMP_MONITOR_TRAP=Y 78 KUMP_SNMP_NET_COMMUNITY 76. escalares 35 varias máquinas host 102 versiones aplicaciones de Tivoli Universal Agent 27 de sistemas gestionados 114 vista Física de Navigator 115 Agente 116 Grupo de atributos 116 Plataforma operativa 115 Sistema 116 vista Física de Navigator. Agente 116 vista Física de Navigator. Sistema 116 vista Lógica de Navigator 115. 116 nivel de grupo de atributos 115 visualización de metarchivos 34 302 IBM Tivoli Universal Agent: Guía del usuario . escalares SNMP 35 variables MIB de SNMP escalares 35 variables MIB SNMP. 116 vistas de Navigator Física 115 Agente 116 Empresa 115 Grupo de atributos 116 Plataforma operativa 115 Sistema 116 Lógica 115. Plataforma operativa 115 vista Física del Navigator. Grupo de atributos 116 vista Física del Navigator.

.

Impreso en España SC11-3144-01 .