Manual de consulta - IBMpublib.boulder.ibm.com/tividd/td/tec/GC32-0666-02/es_ES/... ·...

IBM Tivoli Enterprise Console

Manual de consultaVersión 3.8

GC10-3624-00

NotaAntes de utilizar esta información y el producto al que hace referencia, lea la información que figura en el apartado“Avisos” en la página 165.

Primera edición (septiembre de 2002)

Este manual es la traducción del original en inglés IBM Tivoli Enterprise Console Reference Manual Version 3.8(GC32-0666-02). Esta edición hace referencia a la versión 3, release 8 de IBM Tivoli Enterprise Console (número deproducto 5698-TEC) y a la totalidad de los releases y las modificaciones posteriores hasta que se indique locontrario en nuevas ediciones.

© Copyright International Business Machines Corporation 2002. Reservados todos los derechos.

Contenido

Prefacio . . . . . . . . . . . . . . . vA quién va dirigido este manual. . . . . . . . vPublicaciones . . . . . . . . . . . . . . v

Biblioteca de IBM Tivoli Enterprise Console . . . vPublicaciones de requisitos previos . . . . . . vPublicaciones relacionadas . . . . . . . . vi

Acceso a publicaciones en línea . . . . . . . . viEnvío de comentarios sobre las publicaciones . . . viAccesibilidad . . . . . . . . . . . . . . viCómo ponerse en contacto con el servicio desoporte al cliente . . . . . . . . . . . . viiConvenios utilizados en este manual . . . . . . vii

Convenios de tipo de letra . . . . . . . . viiVariables y rutas dependientes del sistemaoperativo . . . . . . . . . . . . . . . vii

Capítulo 1. Comandos . . . . . . . . . 1Establecimiento del entorno Tivoli . . . . . . . 1Utilización de los comandos de Tivoli . . . . . . 2Sintaxis de la línea de comandos . . . . . . . 2

Límites de cadenas . . . . . . . . . . . 3Referencias a objetos. . . . . . . . . . . . 3

Nombres registrados. . . . . . . . . . . 3Rutas de objeto . . . . . . . . . . . . 4

Comandos de Tivoli Enterprise Console . . . . . 4Comandos de consola . . . . . . . . . . 4Comandos fuente . . . . . . . . . . . . 5Comandos de mensajes de eventos . . . . . . 5Comandos de servidor de eventos . . . . . . 5Comandos de base de reglas . . . . . . . . 5Comandos de base de datos . . . . . . . . 6Comandos de ACF (Adapter ConfigurationFacility) . . . . . . . . . . . . . . . 6

chkclass . . . . . . . . . . . . . . . . 7postemsg . . . . . . . . . . . . . . . 8tec_console . . . . . . . . . . . . . . 10upgrade_gui.sh . . . . . . . . . . . . . 12waddac. . . . . . . . . . . . . . . . 13wchkclass . . . . . . . . . . . . . . . 17wconsole . . . . . . . . . . . . . . . 18wcrtsrc . . . . . . . . . . . . . . . . 33wcrtnvgroups . . . . . . . . . . . . . 34wdbconfig.sh . . . . . . . . . . . . . . 35wdbinstall.sh . . . . . . . . . . . . . . 36wdbmaint.sh . . . . . . . . . . . . . . 38wdelac . . . . . . . . . . . . . . . . 40wdelsrc . . . . . . . . . . . . . . . . 41wlsac . . . . . . . . . . . . . . . . 42wlsaddflt . . . . . . . . . . . . . . . 45wlsadenv . . . . . . . . . . . . . . . 47wlsadgui . . . . . . . . . . . . . . . 48wlsadval . . . . . . . . . . . . . . . 49wlsaeenv . . . . . . . . . . . . . . . 51wlsemsg . . . . . . . . . . . . . . . 52wlsesvrcfg . . . . . . . . . . . . . . . 54

wlssrc . . . . . . . . . . . . . . . . 56wmigcon . . . . . . . . . . . . . . . 57wpostemsg . . . . . . . . . . . . . . 59wrb . . . . . . . . . . . . . . . . . 62wrbupgrade . . . . . . . . . . . . . . 75wsendresp. . . . . . . . . . . . . . . 76wsetac . . . . . . . . . . . . . . . . 77wsetaddflt . . . . . . . . . . . . . . . 82wsetadenv. . . . . . . . . . . . . . . 87wsetadgui . . . . . . . . . . . . . . . 88wsetadval . . . . . . . . . . . . . . . 90wsetaeenv . . . . . . . . . . . . . . . 92wsetemsg . . . . . . . . . . . . . . . 95wsetesvrcfg . . . . . . . . . . . . . . 97wsetsrc . . . . . . . . . . . . . . . . 99wstartesvr . . . . . . . . . . . . . . 100wstatesvr . . . . . . . . . . . . . . . 101wstopesvr . . . . . . . . . . . . . . 102wstoptecgw . . . . . . . . . . . . . . 103wtdbclear . . . . . . . . . . . . . . 104wtdbclear.pl . . . . . . . . . . . . . . 106wtdbspace . . . . . . . . . . . . . . 108wtdbstat . . . . . . . . . . . . . . . 110wtdumper . . . . . . . . . . . . . . 111wtdumprl . . . . . . . . . . . . . . 113wtdumptr . . . . . . . . . . . . . . 115wtecexport . . . . . . . . . . . . . . 116wtecimport . . . . . . . . . . . . . . 118wtouchac . . . . . . . . . . . . . . . 120

Capítulo 2. Tareas . . . . . . . . . 121Nombres y scripts de tareas . . . . . . . . 122Salida de la tarea . . . . . . . . . . . . 123Sintaxis de la línea de comandos . . . . . . . 124Change_Severity . . . . . . . . . . . . 126Clean_Database . . . . . . . . . . . . 127Clear_Closed_Events . . . . . . . . . . . 128Clear_Reception_Log . . . . . . . . . . . 129Close_Event . . . . . . . . . . . . . . 130Dump_Event_Repository . . . . . . . . . 131Event_Query . . . . . . . . . . . . . 133Find_Similar_Events . . . . . . . . . . . 137Forward_Event . . . . . . . . . . . . . 139Log_Event_To_File . . . . . . . . . . . 140Popup_Message . . . . . . . . . . . . 141Send_Email . . . . . . . . . . . . . . 142Send_Event . . . . . . . . . . . . . . 143Wake_Up_Netscape . . . . . . . . . . . 146

Capítulo 3. Variables de entornodisponibles para las tareas . . . . . 147Descripciones de las variables . . . . . . . . 147Ejemplos . . . . . . . . . . . . . . . 153

Vuelco de las variables de entorno al ejecutaruna tarea desde la consola de eventos . . . . 153

© Copyright IBM Corp. 2002 iii

Vuelco de las variables de entorno al ejecutar unprograma desde la consola de eventos . . . . 154

Capítulo 4. Flujo de eventos . . . . . 157Proceso maestro . . . . . . . . . . . . 158Proceso del motor de recepción . . . . . . . 158Proceso del motor de reglas . . . . . . . . 160Proceso del motor de asignación . . . . . . . 160

Servidor de interfaz de usuario . . . . . . 161Proceso del motor de tareas . . . . . . . . 161

Apéndice. Parámetros deconfiguración . . . . . . . . . . . 163

Avisos . . . . . . . . . . . . . . 165Marcas registradas. . . . . . . . . . . . 167

Glosario . . . . . . . . . . . . . 169

Índice . . . . . . . . . . . . . . . 173

iv IBM Tivoli Enterprise Console: Manual de consulta

Prefacio

El Manual de consulta de Tivoli Enterprise Console proporciona información detalladasobre los comandos de Tivoli

®

Enterprise Console, las tareas proporcionadas en labiblioteca de tareas que se suministra con el producto Tivoli Enterprise Console ylas variables de entorno disponibles para las tareas de la biblioteca de tareas.

A quién va dirigido este manualEste manual va dirigido a los administradores que deseen utilizar la interfaz delínea de comandos y configurar las tareas de Tivoli Enterprise Console. Esnecesario tener conocimientos previos de lo siguiente:v Sistema operativo UNIX

®

v Tivoli Management Framework

PublicacionesEn este apartado se indican las publicaciones de la biblioteca de IBM TivoliEnterprise Console y otros documentos relacionados. También se describe cómoacceder a las publicaciones de Tivoli en línea, hacer pedidos de publicaciones deTivoli y enviar comentarios sobre las publicaciones de Tivoli.

Biblioteca de IBM Tivoli Enterprise ConsoleLos siguientes documentos están disponibles en la biblioteca de Tivoli EnterpriseConsole:v IBM Tivoli Enterprise Console Adapters Guide, GC32-0668

Proporciona información sobre los adaptadores disponibles en la actualidad.v IBM Tivoli Event Integration Facility User’s Guide, GC32-0691

Describe cómo desarrollar sus propios adaptadores de eventos, adaptados a suentorno de red y sus necesidades específicas. Además, la publicación describecómo filtrar eventos en la fuente.

v IBM Tivoli Enterprise Console Guía de instalación, SC10-3836-00Describe cómo instalar, actualizar y eliminar componentes de IBM TivoliEnterprise Console.

v IBM Tivoli Enterprise Console Rule Builder’s Guide, GC32-0669Describe cómo desarrollar reglas e integrarlas para la correlación de eventos y lagestión automatizada de eventos.

v IBM Tivoli Enterprise Console Guía del usuario, SC10-3620-02Describe cómo planificar y configurar el entorno de la base de datos de eventos,además de facilitar una descripción de los componentes, los roles y otrainformación general específica para el uso del producto IBM Tivoli EnterpriseConsole.

Publicaciones de requisitos previosDebe conocer los siguientes manuales antes de intentar utilizar el producto TivoliEnterprise Console.

© Copyright IBM Corp. 2002 v

Los documentos siguientes proporcionan información detallada sobre el escritorio,los nodos gestionados, los administradores, las regiones de política, los perfiles, losavisos, las tareas, la planificación y los comandos de CLI:v IBM Tivoli Management Framework Planning for Deployment Guide

v IBM Tivoli Management Framework Guía del usuario

v Tivoli Management Framework Maintenance and Troubleshooting Guide

v IBM Tivoli Management Framework Reference Manual

Publicaciones relacionadasLa publicación Tivoli Glossary contiene definiciones para muchos de los términostécnicos relacionados con el software de Tivoli. La publicación Tivoli Glossary estádisponible, únicamente en inglés, en el siguiente sitio web:http://www.tivoli.com/support/documents/glossary/termsm03.htm

Acceso a publicaciones en líneaEl CD del producto contiene publicaciones de las bibliotecas del producto enformato PDF o HTML, o en ambos. Para acceder a las publicaciones mediante unnavegador web, abra el archivo infocenter.html, que se encuentra en el directoriode publicaciones correspondiente del CD del producto.

Cuando IBM publica una versión actualizada de una o varias publicaciones enlínea o impresas, éstas se publican en el Tivoli Information Center. Puede acceder alas publicaciones actualizadas del Tivoli Information Center desde el siguiente sitioweb del servicio de soporte al cliente: http://www.tivoli.com/documents/

El Tivoli Information Center contiene la versión más reciente de los manuales de labiblioteca del producto en formato PDF o HTML, o en ambos. También estándisponibles las traducciones de los documentos de algunos productos.

Nota: si imprime documentos PDF en un tamaño de papel que no es el de carta,marque el cuadro de selección Ajustar a la página en el diálogo deimpresión de Adobe Acrobat (que aparece al hacer clic en Archivo -->Imprimir) para asegurarse de que se imprime el tamaño completo de unapágina de tamaño carta en el papel que se utiliza.

Envío de comentarios sobre las publicacionesLe agradeceremos que nos informe de su experiencia con los productos y ladocumentación de Tivoli y esperamos recibir sus sugerencias para mejorar nuestroservicio. Si tiene comentarios o sugerencias sobre nuestros productos y sudocumentación, póngase en contacto con nosotros de una de las siguientesmaneras:v Envíenos un mensaje de correo electrónico a [email protected] Rellene nuestro formulario de comentarios del cliente en el siguiente sitio web:

http://www.tivoli.com/support/survey/

AccesibilidadLas funciones de accesibilidad ayudan a los usuarios que tienen discapacidadesfísicas, tales como movilidad restringida o visión limitada, a utilizar productos desoftware de manera correcta. Para obtener más información, consulte el apéndicesobre accesibilidad de la publicación IBM Tivoli Enterprise Console Guía del usuario.

vi IBM Tivoli Enterprise Console: Manual de consulta

Cómo ponerse en contacto con el servicio de soporte al clienteSi tiene algún problema con algún producto de Tivoli, póngase en contacto con elcentro de soporte al cliente de Tivoli. Consulte el manual Tivoli Customer SupportHandbook en el siguiente sitio web:

http://www.tivoli.com/support/handbook/

El manual proporciona información sobre cómo ponerse en contacto con el Centrode soporte al cliente de Tivoli en función de la gravedad del problema, y lasiguiente información:v Registro y condiciones exigidas.v Números de teléfono y direcciones de correo electrónico, dependiendo del país

en que se encuentre.v Información que debe recopilar antes de contactar con el centro de soporte.

Convenios utilizados en este manual

Convenios de tipo de letraEn este manual se utilizan los siguientes convenios de tipo de letra:

NegritaLos comandos, las palabras clave, los nombres de archivo, los roles deautorización, los URL u otra información que el usuario debe utilizarliteralmente aparecen en negrita. Los nombres de ventanas, diálogos yotros controles también aparecen en negrita.

CursivaLas variables y valores que el usuario debe proporcionar aparecen encursiva. Las palabras y las expresiones que están enfatizadas tambiénaparecen en cursiva, así como los nuevos términos definidos en el texto.

MonoespaciadoLos ejemplos de códigos, la salida y los mensajes del sistema aparecen conla fuente monoespaciado.

Variables y rutas dependientes del sistema operativoEste manual utiliza el convenio de UNIX para especificar variables de entorno ypara la notación de directorios.

Si utiliza la línea de comandos de Windows, sustituya $variable por %variable%para las variables de entorno y sustituya la barra inclinada (/) por la barrainclinada invertida (\) en las rutas de acceso de los directorios.

Este manual utiliza también el convenio de barra inclinada invertida (\) al final deuna línea de texto de ejemplo para indicar que el texto que aparece en la líneasiguiente se ha dividido en más de una línea debido a las limitaciones de espaciode la página. El ejemplo se debe interpretar como si estuviera en una sola línea.

Nota: si utiliza el shell bash en un sistema Windows, puede emplear los conveniosde UNIX.

Prefacio vii

viii IBM Tivoli Enterprise Console: Manual de consulta

Capítulo 1. Comandos

Establecimiento del entorno TivoliCuando se instala Tivoli Management Framework, se crean dos archivos deconfiguración que permiten establecer fácilmente las rutas de búsqueda y lasvariables de entorno correctas. Estos archivos están disponibles en cualquier clienteo en el servidor de la región de gestión de Tivoli (TMR).

Siga estos pasos para configurar el entorno del sistema UNIX a fin de ejecutar loscomandos de Tivoli Enterprise:1. Inicie la sesión en un cliente Tivoli Enterprise o en el servidor Tivoli Enterprise

en el que el administrador de Tivoli Enterprise tenga un alias con el rol superpara la TMR. Consulte la publicación Tivoli Management Framework Guía delusuario para obtener más detalles sobre cómo crear administradores de TivoliEnterprise con roles de autorización para la TMR.

2. Hay disponibles dos scripts de inicialización y configuración del entorno: unopara el shell Bourne y otro para el shell C. Si utiliza el shell Bourne, ejecute elcomando siguiente:. /etc/Tivoli/setup_env.sh

—O bien—

Si utiliza el shell C, ejecute el comando siguiente:source /etc/Tivoli/setup_env.csh

Emita los comandos siguientes desde un indicador de comandos de Windows a finde configurar el entorno del sistema Windows para los comandos de Tivoli:1. %SystemRoot%\system32\drivers\etc\Tivoli\setup_env

2. sh

Nota: el segundo comando es opcional. Algunos comandos de Windows sonscripts y deben ejecutarse con sh; muchos comandos pueden ejecutarsedesde la línea de comandos.

Ahora ya tiene un entorno preparado para llevar a cabo operaciones de Tivoli.

Los comandos de Tivoli permiten llevar a cabo operaciones del sistema desde unalínea de comandos en lugar de utilizar el escritorio de Tivoli. Esto a menudoresulta de utilidad cuando no se tiene acceso a una pantalla gráfica, como porejemplo al iniciar la sesión a través de una línea de módem, o al ejecutar scripts demantenimiento.

La mayor parte de los comandos de usuario final de Tivoli empiezan por una letraw que los identifica como comandos de Tivoli. Los comandos de usuario final deTivoli que no utilizan los servicios de Tivoli no empiezan por w. La mayoría de loscomandos también se han desarrollado con la sintaxis w+verbo+objeto, quecoincide con la descripción que se daría de la acción.

Por ejemplo, si desea crear un usuario, utilice el comando wcrtusr. Para suprimirun usuario, utilice el comando wdelusr.

© Copyright IBM Corp. 2002 1

Utilización de los comandos de TivoliA menudo resulta útil o más apropiado invocar una operación de la aplicación degestión Tivoli desde la línea de comandos que desde la GUI. Por ejemplo:v Si no tiene acceso a una GUI, tal vez porque se ha conectado a través de una

línea telefónica.v Si se van a agrupar diversas operaciones en un script de shell.v Si utiliza el editor Emacs y no desea dejar el teclado para emplear un ratón sino

invocar un comando desde un shell.v Si una operación no está disponible mediante el escritorio de Tivoli.

Sintaxis de la línea de comandosEste documento utiliza los caracteres especiales siguientes para definir la sintaxisde los comandos:

[ ] Identifica un argumento opcional. Los argumentos que no estándelimitados por corchetes son obligatorios.

... Indica que puede especificar varios valores para el argumento anterior.

| Indica información que se excluye mutuamente. Puede emplear o bien elargumento situado a la izquierda del separador o bien el argumentosituado a la derecha del separador. No es posible emplear ambosargumentos en un solo uso del comando.

{ } Delimita un conjunto de argumentos que se excluyen mutuamente cuandouno de los argumentos es obligatorio. Si los argumentos son opcionales, sedelimitan mediante corchetes ([ ]).

Por ejemplo:

wsetsrc [–S servidor] [–b mapa_bits] [–l etiqueta] [–n nombre] fuente

El argumento fuente es el único argumento obligatorio del comando wsetsrc. Loscorchetes que delimitan los demás argumentos indican que éstos son opcionales.

El comando wlsac proporciona otro ejemplo:

wlsac [ –l | –f formato] [clave... ] perfil

En este ejemplo, los argumentos –l y –f formato se excluyen mutuamente y sonopcionales. El argumento perfil es obligatorio. El argumento clave es opcional.Asimismo, los puntos suspensivos (...) que figuran tras el argumento clave indicanque puede especificar varios nombres de clave.

El comando wrb –import proporciona otro ejemplo:

wrb –import {paquete_reglas | conjunto_reglas} ...

En este ejemplo, los argumentos paquete_reglas y conjunto_reglas se excluyenmutuamente, aunque debe especificarse uno de los argumentos. Asimismo, lospuntos suspensivos (...) indican que puede especificar varios paquetes o conjuntosde reglas.

2 IBM Tivoli Enterprise Console: Manual de consulta

Límites de cadenasEl número de caracteres máximo de un argumento es 256.

Referencias a objetosCuando se hace una referencia a un objeto desde un comando, la referencia no esuna “referencia a objeto” absoluta como las que se utilizan en programación. En sulugar, se utiliza un nombre que sea fácil de emplear. Este nombre de uso sencillo seobtiene a partir de un nombre dado al objeto por el usuario de la aplicación (porejemplo, cuando se crea una región de política).

Se pueden emplear dos formatos de nombres distintos con los comandos de lainterfaz de línea de comandos (CLI), tal como se indica a continuación:v Nombres registradosv Rutas de objeto

Los programas de CLI de Tivoli dan soporte a ambos métodos de denominación.En ocasiones le resultará más cómodo utilizar un formato que el otro.

Nombres registradosCada TMR contiene un registro de nombres. El registro de nombres es una tablabidimensional que contiene los nombres y los tipos de objetos.

Los nombres registrados son nombres de objetos que se pueden consultar en elregistro de nombres por el nombre de instancia y el tipo de recurso. Cada objeto orecurso tiene un nombre y un tipo. Por ejemplo, una impresora puede tener elnombre apple y el tipo impresora.

Todos los objetos de la TMR que necesiten consultarse deben registrarse en elregistro de nombres al crearse, deben eliminarse del registro al suprimirse y debenmoverse al cambiar su etiqueta. Para la mayor parte de los recursos del productoTivoli Enterprise Console, estas acciones se efectúan automáticamente. Consulte lapublicación IBM Tivoli Management Framework Planning for Deployment Guide paraver una lista completa de los tipos de recursos y la información de intercambio.

El uso del registro de nombres facilita el intercambio de recursos entre varias TMR.Consulte en la publicación IBM Tivoli Management Framework Planning forDeployment Guide una descripción completa de las TMR y las conexiones entreregiones.

Utilice el comando wlookup para consultar un recurso. Por ejemplo, para vertodos los tipos de recursos registrados, emplee el comando siguiente:% wlookup –R

Consulte en la publicación IBM Tivoli Management Framework Reference Manualuna descripción detallada y la sintaxis del comando wlookup.

Otros comandos que utilizan nombres registrados son wls y wmv. Por ejemplo,para obtener una lista de los objetos del escritorio del administrador Jerry,especifique:wls @Administrator:jerry

donde Administrator es el recurso y jerry es la instancia.

Capítulo 1. Comandos 3

Rutas de objetoLas rutas de objeto son parecidas a los nombres de ruta de los sistemas de archivosy pueden ser relativas o absolutas. Una ruta absoluta es una ruta que empieza porun carácter de barra inclinada (/). Una ruta relativa puede empezar por cualquierotro carácter que no sea una barra inclinada (/), como por ejemplo loscomponentes de rutas especiales correspondientes al directorio actual (.) y aldirectorio padre (..). A continuación se indican algunos ejemplos de nombres deruta de objeto empleados como argumentos para los comandos wls y wmv:wls /Regions/Servers

wmv ../Servers/ayers-rock /Regions/Servers

La sintaxis para especificar un recurso con el estilo de nombre de ruta de objeto esla siguiente:

/distintivo/padre/[tipo:]nombre

donde:

distintivoes un tipo de recurso.

padre es el principio del nombre de ruta de objeto.

tipo es una etiqueta explícita opcional.

nombre es la instancia concreta en la que desea efectuar alguna operación.

Utilice el especificador tipo opcional si debe especificar un recurso concreto quetiene el mismo nombre que otro recurso de otro tipo. Por ejemplo, imagine que laregión de política Engineering tiene un gestor de perfiles denominado Servers yuna subregión de política llamada Servers. Para especificar el gestor de perfiles conun nombre de ruta de objeto, podría emplear lo siguiente:wls /Regions/Engineering/ProfileManager:Servers

Comandos de Tivoli Enterprise ConsoleEn los apartados siguientes se describen brevemente los comandos de TivoliEnterprise Console por componente.

Comandos de consola

Comando Finalidad

tec_console Inicia una consola de eventos.

wconsole Gestiona las consolas de eventos.

wcrtnvgroups Crea los grupos de eventos necesarios para emplear el conjunto de reglasnetview.rls.

wmigcon Efectúa la migración de las consolas, los grupos de eventos y los operadores dela versión 3.6 de Tivoli Enterprise Console a la versión 3.7 y la versión 3.8.

wsendresp Visualiza una respuesta dirigida a un administrador.

wtecexport Exporta las definiciones de la consola de eventos a un archivo.

wtecimport Importa definiciones de consola de eventos de un archivo a otra TMR.


Comandos fuente

Comando Finalidad

wdelsrc Suprime una fuente de la lista de servidores de eventos.

wlssrc Proporciona una lista de las fuentes existentes en el servidor de eventos.

wsetsrc Restablece los atributos de las fuentes de eventos.

Comandos de mensajes de eventos

Comando Finalidad

postemsg Envía un evento al servidor de eventos. Este comando no requiere los serviciosde Tivoli Management Framework.

wlsemsg Muestra una lista de los eventos recibidos para una consola. Este comandorequiere los servicios de Tivoli Management Framework.

wpostemsg Envía un evento al servidor de eventos. Este comando requiere los servicios deTivoli Management Framework.

wsetemsg Modifica un evento. Este comando requiere los servicios de Tivoli ManagementFramework.

Comandos de servidor de eventos

Comando Finalidad

wlsesvrcfg Muestra una lista de los parámetros de configuración de un servidor de eventosen ejecución.

wsetesvrcfg Establece los parámetros de configuración para el servidor de eventos.

wstartesvr Inicia el servidor de eventos.

wstatesvr Visualiza el estado del servidor de eventos.

wstopesvr Detiene el servidor de eventos.

Comandos de base de reglas

Comando Finalidad

chkclass Comprueba si un archivo de definiciones de clases de eventos es válidocotejándolo con un directorio de base de reglas. Este comando permitedesarrollar clases en un entorno distinto de TME.

upgrade_gui.sh Actualiza las reglas generadas por la versión 3.6.2 y anteriores del generador dereglas a la sintaxis soportada por el compilador de reglas proporcionado en estaversión del producto Tivoli Enterprise Console.

wchkclass Comprueba si un archivo de definiciones de clases de eventos es válidocotejándolo con un directorio de base de reglas. Este comando permitedesarrollar clases en un entorno Tivoli Enterprise Console.

wrb Gestiona las bases de reglas.

wrbupgrade Actualiza las bases de reglas y los archivos BAROC de eventos creados con lasversiones de Tivoli Enterprise Console anteriores a la 3.7 al formatocorrespondiente a la versión 3.7 y posteriores.


Comandos de base de datos

Comando Finalidad

wdbinstall.sh Ejecuta el asistente para la instalación de la base de datos de eventos.

wdbconfig.sh Ejecuta los scripts de configuración de la base de datos.

wdbmaint.sh Actualiza las estadísticas de distribución de datos de la base de datos yreorganiza la base de datos.

wtdbclear Borra eventos de la base de datos de eventos.

wtdbspace Proporciona estadísticas para la base de datos.

wtdbstat Visualiza el estado del servidor de base de datos.

wtdumper Genera un informe de eventos.

wtdumprl Genera un informe de los eventos recibidos.

wtdumptr Genera un informe de las tareas completadas.

Comandos de ACF (Adapter Configuration Facility)

Comando Finalidad

waddac Añade un registro de configuración de adaptador para un perfil de configuraciónde adaptador.

wdelac Elimina un registro de configuración de adaptador de un perfil de configuraciónde adaptador.

wlsac Muestra los registros de configuración de adaptador de un perfil deconfiguración de adaptador.

wlsaddflt Muestra los registros de configuración de adaptador de un perfil deconfiguración de adaptador.

wlsadenv Muestra una lista instalada de las variables de entorno de EIF específicas deladaptador.

wlsadgui Muestra un enlace instalado con las herramientas de configuración ampliadasespecíficas del adaptador.

wlsadval Muestra la información de validación instalada para un tipo de adaptador.

wlsaeenv Muestra las variables de entorno disponibles en un punto final de perfil deconfiguración de adaptador.

wsetac Modifica un registro de configuración de adaptador existente en un perfil deconfiguración de adaptador.

wsetaddflt Añade o establece un registro de configuración de adaptador para un valorpredeterminado de tipo de adaptador.

wsetadenv Instala una lista de variables de entorno de EIF reconocidas para un tipo deadaptador.

wsetadgui Instala un enlace de la GUI de ACF (Adapter Configuration Facility) con unaherramienta de configuración específica del tipo.

wsetadval Instala información de validación para un tipo de adaptador.

wsetaeenv Modifica las variables de entorno almacenadas en los puntos finales del perfil deconfiguración de adaptador.

wstoptecgw Detiene el gateway de Tivoli Enterprise Console.

wtouchac Actualiza la hora de modificación de un registro de perfil de configuración deadaptador para forzar la redistribución.


chkclass

Comprueba si un archivo de definiciones de clases de eventos es válidocotejándolo con un directorio de base de reglas.

Sintaxischkclass [–k dir_base_reglas] archivo_clases

DescripciónEl comando chkclass comprueba que un archivo de definiciones de clases deeventos sea válido para el directorio de base de reglas especificado por elargumento dir_base_reglas. El argumento dir_base_reglas que se utiliza con laopción –k sólo es opcional si no se ha establecido la variable de entorno$TEC_KB_DIR (no se establece automáticamente). Este comando se proporcionapara desarrollar clases en un sistema que no tiene instalado Tivoli ManagementEnvironment.

Nota: si el sistema tiene instalado Tivoli Management Environment, utilice elcomando wchkclass.

AutorizaciónNinguna

Opcionesarchivo_clases

Especifica la ruta del archivo de definiciones de clases de eventos que seva a comprobar. El argumento ruta debe especificarse como un nombre deruta absoluto.

–k dir_base_reglasEspecifica el directorio de base de reglas. El valor predeterminado es eldirectorio definido por la variable de entorno $TEC_KB_DIR.

EjemplosEl ejemplo siguiente comprueba el archivo de definiciones de clases de eventos/install/bin/hpux/TME/TEC /classfile1 cotejándolo con el directorio de base dereglas especificado por la variable de entorno $TEC_KB_DIR:chkclass /install/bin/hpux/TME/TEC/classfile1

Véase tambiénwchkclass


postemsg

Envía un evento al servidor de eventos. .

Sintaxispostemsg –S servidor | –f archivo de configuración [–m mensaje] [–r gravedad][atributo=valor...] fuente_clase

DescripciónEl comando postemsg envía un evento a un servidor de eventos. Este comando norequiere el uso de los servicios de Tivoli Management Framework. Enviar eventoses un buen método para probar el servidor después de haber creado nuevosgrupos de eventos o asignaciones de grupos de eventos, haber editado reglas ohaber modificado de algún otro modo el método de proceso de eventos de unservidor.

Si el mensaje contiene un carácter de comilla simple (’) intercalado, debe anteponerotra comilla simple a la comilla simple intercalada.

En el caso de los valores de atributo que contengan caracteres que no figuren en lalista siguiente de caracteres ASCII, se añadirán automáticamente comillas simplesal principio y final de la cadena:v a-zv A-Zv Los caracteres $ - . / % & * + @ \ ^ _ ` | ~

Si el sistema tiene instalado Tivoli Management Environment, puede emplear elcomando wpostemsg.


Opcionesatributo=valor

Asigna un valor a cualquier atributo válido. El atributo debe estar definidopara la clase de evento.

clase Especifica la clase del evento. Debe coincidir con una clase configurada enel servidor. El adaptador de eventos define las clases y éstas se indican enel archivo .baroc del adaptador. Si hay algún espacio en blanco en elnombre de la clase, especifique el nombre de la clase entre comillas dobles.

fuente Especifica la fuente del evento. Si hay algún espacio en blanco en elnombre de la fuente, especifíquelo entre comillas dobles.

–f archivo de configuraciónEspecifica el nombre del archivo de configuración del adaptador. Debeespecificar el argumento –S o el argumento –f. El archivo de configuracióndel adaptador debe especificar una opción ServerLocation y, en casonecesario, una opción ServerPort. Si el servidor de eventos está instaladoen una máquina Windows, debe especificarse la opción ServerPort.


–m mensajeEspecifica el texto del evento. Si hay algún espacio en blanco en el textodel mensaje, especifique el texto entre comillas dobles.

–r gravedadEspecifica una gravedad, cuyos valores posibles son Muy grave (FATAL),Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo(HARMLESS) , y Desconocido (UNKNOWN).

–S servidorEspecifica el nombre de host o la dirección IP (protocolo de Internet) delservidor. Debe especificar el argumento –S o el argumento –f.

Nota: esta opción sólo es válida para las máquinas UNIX. Si el servidor deeventos está instalado en una máquina Windows, utilice la opción–f.

EjemplosEl siguiente ejemplo para los entornos UNIX envía un mensaje de prueba quemuestra un evento Su_Failure en las consolas de eventos:postemsg -S tecbox –r AVISO –m "Error de inicio de sesión su." Su_Failure LOGFILE

Véase tambiénwsetemsg, wpostemsg

En la publicación IBM Tivoli Event Integration Facility User’s Guide, consultewpostzmsg y postzmsg.


tec_console

Inicia la consola de eventos de Tivoli Enterprise Console.

Sintaxistec_console [–u ID_usuario] [–p contraseña] [–h nombre_host[:puerto]][–e grupo_eventos] [–nowindow] [&]

DescripciónEl comando tec_console inicia la consola de eventos de Tivoli Enterprise Console.Este comando se encuentra en $BINDIR/bin en un nodo gestionado con la consolade eventos instalada. En un host que no sea TME o en un punto final, el comandose encuentra en el directorio en el que se ha instalado la consola de eventos.

Puede ejecutar este comando en segundo plano para poder utilizar el indicador decomandos de la sesión. Al ejecutar este comando en un nodo gestionado, elentorno Tivoli debe estar inicializado.

Si emite el comando tec_console desde un shell bash en Windows, incluya laextensión del nombre de archivo .cmd; por ejemplo:tec_console.cmd &

El proceso del servidor de la interfaz de usuario (UI) actúa de interfaz con laconsola de eventos para obtener eventos del repositorio de eventos y empaquetarlas solicitudes de actualización de base de datos y pasarlas al proceso deasignación de Tivoli Enterprise Console.

En el directorio inicial del usuario se crea un directorio .tmeconsole que guarda losvalores globales de la consola del usuario.

Debe tener la opción de inicio de sesión de cliente remoto permitido de TivoliManagement Framework establecida en TRUE para que este comando funcione.Puede ver el valor actual establecido con el comando odadmin odinfo. Paraestablecer esta opción, ejecute el siguiente comando:odadmin set_allow_rconnect TRUE

El cambio entra en vigor de inmediato.

Autorizaciónuser, RIM_view, RIM_update para los operadores.

senior para los administradores.

Nota: los administradores requieren todos los roles de autorización de losoperadores y el rol senior.

Opciones& Ejecute el comando en segundo plano para que el indicador de comandos

esté disponible y pueda utilizarse.

–e grupo_eventosMuestra el grupo de eventos especificado en el visor de eventos cuando seinicia la consola.


–h nombre_host[:puerto]Nombre de host de la ubicación donde se ejecuta el servidor de la interfazde usuario. Especifique esta opción con el formato nombre_host:puerto si seutiliza un puerto distinto del puerto 94.

–nowindowSuprime la ventana de DOS (sólo Windows).

–p contraseñaContraseña del ID de inicio de sesión del administrador de Tivoli.

–u ID_usuarioID de inicio de sesión del administrador de Tivoli.

Ejemplos1. El ejemplo siguiente inicia una consola de eventos en un host UNIX en

segundo plano. Se solicita al usuario el nombre de host, el ID de inicio desesión y la contraseña.tec_console &

2. El ejemplo siguiente inicia una consola de eventos en un host Windows ensegundo plano y muestra el grupo de eventos NT en el visor de eventos. Sesolicita al usuario el nombre de host, el ID de inicio de sesión y la contraseña.tec_console.cmd -e NT &


upgrade_gui.sh

Actualiza las reglas generadas por la versión 3.6.2 y anteriores del generador dereglas a la sintaxis soportada por el compilador de reglas proporcionado en estaversión del producto Tivoli Enterprise Console.

Sintaxisupgrade_gui.sh dir_base_reglas

DescripciónSi tiene reglas generadas por la versión 3.6.2 y anteriores del generador de reglasde Tivoli Enterprise Console, éstas se encuentran almacenadas en el archivo$BINDIR/TME/TEC/base_reglas/TEC_RULES/.rule_builder.pro. Puede emplear elscript $BINDIR/TME/RULE_BUILDER/upgrade_gui.sh para convertir estas reglasa la sintaxis soportada por el compilador de reglas proporcionado en esta versióndel producto Tivoli Enterprise Console. Las reglas convertidas utilizan lasfunciones implementadas por la nueva versión del compilador y son más fáciles deleer. Si convierte reglas con este script, ya no podrá editar las reglas convertidascon el generador de reglas; deberá utilizar un editor de texto.

Nota: efectúe una copia de seguridad del archivo .rule_builder.pro antes deejecutar este script.

El script actualiza las reglas de cada conjunto de reglas del archivo.rule_builder.pro y las graba en los archivos nombre_conjunto_reglas.rls delsubdirectorio TEC_RULES de la base de reglas. El archivo .rule_builder.pro quedavacío.


Opcionesdir_base_reglas

Directorio que contiene la base de reglas que contiene las reglas delgenerador de reglas que se desea actualizar.

EjemplosEl ejemplo siguiente actualiza las reglas del generador de reglas para la base dereglas situada en el directorio /rulebases/test/test001:upgrade_gui.sh /rulebases/test/test001

Véase tambiénNada


waddac

Añade un registro de configuración de adaptador para un perfil de configuraciónde adaptador (ACP).

Sintaxiswaddac detalles_adaptador tipo perfil

DescripciónEl comando waddac añade un registro para configurar un adaptador de eventos deTivoli Enterprise Console a un ACP existente. Cuando se distribuye a los nodosgestionados de abono, el nuevo registro hará que entre en vigor la configuracióndel adaptador que reflejan los argumentos detalles_adaptador proporcionados, encombinación con los valores predeterminados específicos del tipo que hayainstalados.

Cada tipo de adaptador de cada ACP puede recibir el soporte de políticaspredeterminadas para proporcionar valores iniciales para componentes de laconfiguración no suministrados por una invocación de waddac. Del mismo modo,puede haber políticas de validación para garantizar que una configuracióndeterminada sea válida según las necesidades de la implementación del adaptadorde eventos, las particularidades de la instalación y las consideraciones deseguridad.

El comando waddac escribe el valor de clave del nuevo registro de configuraciónde adaptador en la salida estándar. El valor de clave se puede emplear másadelante para modificar o eliminar el registro. Puede ver el valor de clave en laparte superior derecha del panel de entrada de ACP o mediante el comando wlsac.

Autorizaciónadmin

Opcionesdetalles_adaptador

Proporciona la información de configuración específica del adaptadorcomo, por ejemplo, las rutas de distribución, los ID de usuario y los filtrosdel adaptador empleados para los parámetros de distribución deladaptador.

–b indicador=valorEstablece el indicador de comportamiento del punto finaldeterminado en el valor especificado. Los indicadores decomportamiento del punto final se interpretan en situacionesespeciales cuando se distribuyen perfiles, por ejemplo al procesarun registro marcado como suprimido. Los indicadores específicos alos que se da soporte variarán según el punto final, pero entre losque se admiten actualmente se encuentran los siguientes:

action_failControla el manejo de las anomalías de las solicitudes dedistribución !command y !!command. Los valoresreconocidos son:

abort = cancelar anormalmente la distribución


ignore = omitir todas las anomalías

report = informar de las anomalías pero seguir con laactividad de distribución (comportamientopredeterminado)

expandControla si, al distribuir el perfil, el código del punto finaldebe expandir las referencias a las variables de contextodel punto final con el formato ${variable} dentro de losatributos del registro. El valor de la variable puede ser nopara inhabilitar la expansión, yes a fin de habilitarla paratodos los atributos (comportamiento predeterminado), ouna lista de nombres de atributo separados por comas paraefectuar una expansión selectiva únicamente en los valoresde esos atributos.

rm_on_delIndica al código del punto final si debe eliminar losarchivos de configuración y archivos distribuidos cuandose distribuye el registro tras eliminarse. El valor puede seryes (para forzar la eliminación, que es el comportamientopredeterminado), no (para inhabilitar la eliminación y, porconsiguiente, conservar los archivos en su ubicación tras lasupresión del registro) o conf (para eliminar únicamente elarchivo .conf).

run_actionsControla si se realizan las solicitudes de distribución!command y !!command. El valor puede ser yes o no, conyes como valor predeterminado.

El código del punto final admite (salvo que la política devalidación los rechace) y omite los indicadores o los valores de losindicadores de comportamiento no reconocidos.

–c comentarioTexto de comentario que se asociará al nuevo registro de ACP. Eltexto de comentario se escribirá en el archivo de configuracióncuando se cree la próxima vez que se distribuya el perfil.

–D destino=fuenteSolicita que el archivo fuente se distribuya al archivo de destino encada host de abono cuando se distribuya el perfil. Si el nombre dedestino no empieza por un carácter de barra inclinada, el nombrede archivo real se formará añadiendo destino al directorio dedestino según la especificación de una opción –d (o de los valorespredeterminados de la política).

En lugar del formato destino=fuente para una solicitud dedistribución, la cadena puede tener el formato !command o!!command. La instrucción comando proporcionada, que puede sercualquier sentencia válida para el intérprete de línea de comandosdependiente de la plataforma presente en los nodos de abono(normalmente, /bin/sh, aunque en las plataformas distintas deUNIX puede ser diferente), se ejecuta antes (!) o después (!!) de lainformación de configuración y todos los archivos distribuidos seescriben.

Se pueden proporcionar muchas opciones –D.


–d dir Directorio de los nodos de abono al que deben distribuirse losarchivos de configuración del adaptador.

–e nombre=valorDefine una variable de entorno que se colocará en el archivo deconfiguración del adaptador. Pueden proporcionarse tantosargumentos –e como se desee para crear un número de variablesde entorno arbitrario. Algunas variables de entorno, que lasbibliotecas del adaptador de eventos reconocen directamente,controlan el funcionamiento básico del adaptador. Otras variablespueden ser utilizadas en un nivel superior por adaptadoresespecíficos.

–f filtroDefine un filtro de eventos que se colocará en el archivo deconfiguración del adaptador. La cadena filtro debe tener el formatosiguiente:Atributo=Valor;Atributo=Valor;Atributo=Valor;...

Toda la cadena debe escribirse entre comillas para evitar que elintérprete de línea de comandos tenga en cuenta los caracteres depunto y coma. Para crear un filtro cuyo estado inicial seainhabilitado, se puede añadir el prefijo #ilter: a la cadena. Así,waddac -f ’#ilter:Class=LogFile_Base;’ acp1

añade un único registro de filtro inhabilitado al nuevo perfil acp1.(Si se desea, puede anteponerse Filter: a los filtros habilitados.)

Se pueden proporcionar muchas opciones –f.

–F caché de filtroDefine una caché de filtro de eventos que se colocará en el archivode configuración del adaptador. La cadena caché de filtro debe tenerel formato siguiente:Atributo=Valor;Atributo=Valor;Atributo=Valor;...

Toda la cadena debe escribirse entre comillas para evitar que elintérprete de línea de comandos tenga en cuenta los caracteres depunto y coma. Para crear una caché de filtro cuyo estado inicial seainhabilitado, se puede añadir el prefijo #ilterCache: a la cadena.Así,waddac -F ’#ilterCache:Class=LogFile_Base;’ acp1

añade un único registro de caché de filtro inhabilitado al nuevoperfil acp1. (Si se desea, puede anteponerse FilterCache: a lascachés de filtro habilitadas.)

Se pueden proporcionar muchas opciones –F.

–g gid Valor de ID de grupo que se utilizará para los archivos distribuidosy los comandos en los puntos finales de abono. El valor de gid sepuede proporcionar como un nombre o un valor numérico.

–m modo_prefiltroDefine el Modo prefiltro que se colocará en el archivo deconfiguración del adaptador para los adaptadores de Windows yNetWare. Los valores válidos son IN, in, OUT y out. El valorpredeterminado es OUT. Si utiliza IN o in, también deberá


proporcionar el parámetro –p para especificar un Prefiltro. En elejemplo siguiente se muestra un comando que utiliza esteargumento:waddac -a -m ’OUT’ -p ’Log=System’ 1 ACPprofile

–p prefiltroDefine los Prefiltros que se colocarán en el archivo deconfiguración del adaptador para los adaptadores de Windows yNetWare. Debe especificar como mínimo la especificación deregistro y, si lo desea, las especificaciones EventId, EventType ySource. En el ejemplo siguiente se muestra un comando que utilizaeste argumento:waddac -a -p ’Log=Security’ 1 ACPprofile

–t destinoNombre del archivo de configuración del adaptador principal,denominado habitualmente archivo .conf. El nombre de archivocompleto de este archivo se forma añadiendo destino al valorproporcionado para dir con la opción –d. Tenga en cuenta que lapolítica predeterminada normalmente estará establecida de modoque defina destino y dir_destino en los valores adecuados.

–u uid Valor de ID de usuario que se utilizará para los archivosdistribuidos y los comandos en los puntos finales de abono. Elvalor de uid se puede proporcionar como un nombre o un valor deID numérico.

perfil ACP al que se añadirá el nuevo registro de configuración deladaptador.

tipo Proporciona el tipo de adaptador del nuevo adaptador. El tipo deadaptador normalmente se utiliza para regir el funcionamiento delas políticas predeterminadas y de validación. Si se proporcionantipos de adaptador desconocidos para waddac, las políticas devalidación del ACP de destino pueden rechazar el nuevo registro.Para ver los tipos disponibles, utilice el comando wlsaddflt.

EjemplosEl ejemplo siguiente añade una entrada de ACP con el comentario “My Logfile” enel archivo .conf, el ID de usuario 0 y el ID de grupo 0 para un adaptador de tipotecad_logfile_solaris2 en el perfil denominado ACP Profile:waddac -c "My_Logfile" -u 0 -g 0 tecad_logfile_solaris2 "ACP Profile"

Véase tambiénwdelac, wlsac


wchkclass

Comprueba si un archivo de definiciones de clases de eventos es válidocotejándolo con un directorio de base de reglas.

Sintaxiswchkclass [–S servidor] [–a archivo_clases | –b archivo_clases] [[host:]ruta] ...directorio_base_reglas

DescripciónEl comando wchkclass comprueba que un archivo de definiciones de clases deeventos sea válido para el directorio de base de reglas especificado por elargumento base_reglas. Este comando se proporciona para desarrollar clases en unsistema que tiene instalado Tivoli Management Framework. Si Tivoli ManagementFramework no está instalado, debe emplear el comando chkclass.

Autorizaciónuser

Opcioneshost:ruta

Especifica el host que contiene el archivo de clases que debe comprobarsey la ruta del archivo de clases que debe comprobarse. Si no especifica esteargumento, se comprobará la base de reglas actual para determinar lavalidez. Separe las diversas rutas de archivo con un espacio.

base_reglasEspecifica el nombre de la base de reglas con la que se comprobará elarchivo de definiciones de clases.

–a archivo_clasesIniciar la comprobación como si el archivo de clases especificado estuvierainsertado tras el archivo de clases especificado en la base de reglas.

–b archivo_clasesIniciar la comprobación como si el archivo de clases especificado estuvierainsertado antes del archivo de clases especificado en la base de reglas.

–S servidorEspecifica el nombre del servidor de eventos con el formato del registro denombres. El valor predeterminado es el servidor de eventos local. Paraespecificar un servidor remoto, escriba @EventServer#tmr, donde tmr es elnombre de una región de gestión de Tivoli (TMR).

EjemplosEl ejemplo siguiente comprueba el archivo de definiciones de clases de eventos/install/bin/hpux/TME/TEC /classfile1 cotejándolo con la base de reglas rb1:wchkclass /install/bin/hpux/TME/TEC/classfile1 rb1

Véase tambiénchkclass


wconsole

Gestiona las consolas de eventos.

Sintaxiswconsole [opción [subopción]]

DescripciónEl comando wconsole permite efectuar tareas como crear, copiar, suprimir y listarconsolas de eventos, así como configurar, asignar y gestionar de otro modo gruposde eventos y filtros de grupos de eventos.

La primera opción del comando wconsole especifica su función principal. Lassubopciones posteriores sólo son válidas en el contexto de la primera opción.

Autorizaciónuser (rol TMR sólo para el comando, sin opciones)

Los administradores y operadores de Tivoli Enterprise Console requieren rolesTMR para las opciones de wconsole tal como se muestra en la tabla siguiente. Enla tabla también se muestran las vistas de Tivoli Enterprise Console disponiblespara los dos tipos de usuarios. Consulte la publicación IBM Tivoli EnterpriseConsole Guía del usuario para obtener información adicional sobre los rolesnecesarios para los usuarios de Tivoli Enterprise Console.

Usuario de laconsola Roles TMR Vistas de la consola

Administrador RIM_view, RIM_update,senior

Vistas de configuración, resumen yprioridad y visor de eventos

Operador RIM_view, RIM_update,user

Vistas de resumen y prioridad y visorde eventos


En la tabla siguiente se muestran los roles TMR para opciones específicas delcomando wconsole, junto con breves descripciones de las opciones.

Opción Descripción Roles TMR

–addegflt Añade un nuevo filtro a ungrupo de eventos.

RIM_view, RIM_update,senior

–assigneg Asigna un grupo de eventosa una definición de consolade eventos.


–assignop Asigna operadores a unadefinición de consola deeventos.


–copyconsole Copia los grupos de eventos,los filtros de grupos deeventos y las asignaciones deroles de autorización de unaconsola de eventos en otradefinición de consola.


–crtconsole Crea una nueva definición deconsola de eventos.


–crteg Crea un nuevo grupo deeventos.


-crtoperator Crea un nuevo operador deconsola.


–delconsole Suprime una definición deconsola de eventos.


–deleg Suprime uno o varios gruposde eventos.


–delegflt Suprime uno o varios filtrosde un grupo de eventos.


-deloperator Suprime un operador deconsola existente.


–lsassigneg Lista los grupos de eventosasignados a una definiciónde consola de eventos.

RIM_view, RIM_update,user

–lsconsole Lista las definiciones deconsola de eventos.


-lsconsoleup Lista las consolas que estánen ejecución en estemomento.


–lseg Lista los grupos de eventos. RIM_view, RIM_update,user

-lsoperator Lista las definiciones deconsola de eventos.

RIM_view, RIM_update, user

–setconsole Cambia el nombre y ladescripción de una definiciónde consola de eventos.


–seteg Cambia el nombre y ladescripción de un grupo deeventos.



Opción Descripción Roles TMR

–setegflt Cambia el nombre y ladescripción de un filtro degrupo de eventos.


–unassigneg Desasigna uno o variosgrupos de eventos de unadefinición de consola deeventos.


–unassignop Desasigna operadores de unadefinición de consola deeventos.


Notasv Si emite el comando wconsole desde un shell bash en Windows, incluya la

extensión del nombre de archivo .cmd; por ejemplo:wconsole.cmd -delconsole -h mfoster -u Administrator \-p chief10 -n “Personnel Systems”

v Antes de ejecutar el comando wconsole en un nodo gestionado, compruebe queel entorno Tivoli esté inicializado.

v Apague las consolas de eventos en ejecución cuyas propiedades debanmodificarse. Una vez realizados los cambios, reinicie las consolas para que loscambios entren en vigor.

OpcionesCada opción del comando wconsole contiene subopciones –h, –u y –p opcionalespara especificar el nombre de host, el ID de usuario y la contraseña,respectivamente, a fin de iniciar la sesión en el host donde se ejecuta el servidor dela interfaz de usuario (UI). Si no especifica estas subopciones, se visualizará uncuadro de diálogo para especificar la información cuando se ejecute el comandowconsole. El entorno debe estar configurado debidamente para permitir estavisualización. Si no es posible configurarlo para que aparezca un cuadro dediálogo, utilice las subopciones. Las subopciones –h, –u y –p aparecen en lassentencias de sintaxis de este apartado, aunque las definiciones de las mismas sólose muestran en la tabla siguiente.

Subopción común Definición

–h host[:puerto] Nombre del host donde se ejecuta el servidor de la interfazde usuario. Especifique el número de puerto si el puertoempleado por el host no es el 94.

–u usuario ID de inicio de sesión del administrador de Tivoli.

–p contraseña Contraseña asociada al ID de inicio de sesión deladministrador de Tivoli.

Notas:

1. Los argumentos que contengan espacios deberán escribirse entre comillasdobles. Por ejemplo, los nombres y las descripciones pueden contener espacios.

2. Las cadenas deben delimitarse mediante comillas simples.3. Los valores numéricos no pueden delimitarse con ningún tipo de comilla.4. Los valores enumerados deben especificarse por sus nombres de enumeración,

no sus valores numéricos. Los valores enumerados deben delimitarse mediantecomillas simples.


–addegflt [–h host[:puerto]] [–u usuario] [–p contraseña] –E grupo_eventos –n nombre[–D descripción] [–s restricciones] [–S SQL_formato_libre]

Añade un nuevo filtro a un grupo de eventos.

Un filtro de grupo de eventos es en realidad una cláusula SQL WHERE,que se utiliza para consultar la base de datos de eventos a fin de extraerlos eventos que cumplen los criterios del filtro. Estos eventos normalmentese muestran en el visor de eventos de la consola de un operador (unoperador o una regla pueden impedir que aparezca en un visor deeventos).

Los filtros de grupos de eventos permiten configurar los criterios deselección para que se incluyan eventos en un grupo de eventos. Un grupode eventos puede no tener ningún filtro o tener alguno. Un evento seincluye en un grupo de eventos si satisface como mínimo los criterios deun filtro. Si no hay ningún filtro configurado para un grupo de eventos,todos los eventos se incluirán en el grupo de eventos.

Cada filtro de un grupo de eventos puede constar de cero o másrestricciones para los atributos de los eventos recibidos y una sentenciaSQL de formato libre. Una restricción se construye empleando atributos deeventos, operadores SQL y valores de atributos de eventos. Lasrestricciones de un filtro pueden unirse con el operador AND. Unasentencia SQL de formato libre puede ser cualquier sentencia válida parauna cláusula WHERE.

Notas:

1. El comando wconsole no efectuará ninguna comprobación de sintaxisen las sentencias SQL de formato libre que especifique, por lo queusted es el responsable de que las sentencias SQL de formato libre seancorrectas para un filtro de eventos.

2. El operador LIKE admite los siguientes caracteres comodín en casitodas las bases de datos:

Carácter comodín Significado

% Cualquier cadena de cero o más caracteres.

_ Cualquier carácter único.

[ ] Cualquier carácter único dentro del rangoespecificado. Por ejemplo, [a-f] o [abcedf]

[^] Cualquier carácter único que no se encuentredentro del rango especificado. Por ejemplo,[^a - f] o [^abcdef]

3. La sintaxis de la cláusula WHERE debe cumplir los requisitos delRDBMS empleado para la base de datos de eventos.

–D descripciónDescripción de texto del nuevo filtro.

–E grupo_eventosNombre del grupo de eventos que contendrá el nuevo filtro.

–n nombreNombre del nuevo filtro.

–s restricciónUna o varias restricciones para el nuevo filtro. No especifique lapalabra clave WHERE inicial, ya que se maneja automáticamente.


Vincule varias restricciones con el operador AND. Cada una de lasrestricciones debe delimitarse mediante paréntesis. El argumento derestricciones completo debe escribirse entre comillas dobles; porejemplo:-s "(severity IN (‘CRITICAL’,’FATAL’))AND \(source=’NT’)"

Los operadores válidos para una restricción son =, <>, <, <=, >, >=,LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL,BETWEEN y NOT BETWEEN.

La tabla siguiente muestra diversos atributos de eventosestablecidos en indicaciones de la hora y el formato que debeemplearse al especificar valores para estos atributos con lasubopción –s. Los valores de indicación de la hora debendelimitarse mediante comillas simples. Los valores de indicaciónde la hora con formato especificados en una restricción seconvierten de forma interna en los tipos de datos correspondientesque requiere la base de datos de eventos.

Atributos que contienenvalores de indicación de lahora Formato Ejemplos

cause_date_receptiondate_receptionlast_modified_time

’m/d/aa h:mm:ss a z’

a corresponde a AM oPM.

z es la abreviatura delhuso horario.

’4/1/01 9:36:24 AM CST’

’3/13/01 9:36:24 AM CST’

’10/13/01 10:59:55 PM EST’

Nota: la especificación de una restricción de filtro funciona comoel diálogo Editor de restricciones de la consola de eventos.Puede especificar los mismos atributos de eventos,operadores y valores de atributos en el Editor derestricciones que con la subopción –s de la opción –addegflt.

–S SQL_formato_libreSentencias SQL válidas para una cláusula WHERE y permitidaspor el RDBMS empleado para la base de datos de eventos. Noespecifique la palabra clave WHERE inicial, ya que se manejaautomáticamente. Escriba el argumento SQL_formato_libre completoentre comillas. Puede emplear caracteres comodín de SQL siempreque el RDBMS empleado para la base de datos de eventos losadmita.

Nota: el comando wconsole no efectuará ninguna comprobaciónde sintaxis en las sentencias SQL de formato libre queespecifique, por lo que usted es el responsable de que lassentencias SQL de formato libre sean correctas para un filtrode eventos.

–assigneg [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola –E grupo_eventos[–r rol:...]

Asigna un grupo de eventos a una definición de consola de eventos. Si lo


desea, también puede asignar los roles del grupo de eventos. Los rolesdeterminan si un operador puede confirmar y cerrar los eventospertenecientes al grupo de eventos.

–C consolaNombre de la consola a la que se asignará el grupo de eventos.

–E grupo_eventosNombre del grupo de eventos que se asignará.

–r rol:...Roles que se asignarán al grupo de eventos. Separe cada rol con uncarácter de dos puntos (:). El valor predeterminado es admin. Losvalores válidos son super, senior, admin y user. Si desea obtenermás información sobre los roles de Tivoli Enterprise Console,consulte la publicación IBM Tivoli Enterprise Console Guía delusuario.

–assignop [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola –O operador:...Asigna operadores a una definición de consola de eventos.

–C consolaNombre de la consola a la que se asignarán los operadores.

–O operador:...Lista de operadores que se asignarán a la consola. Separe cadaoperador con un carácter de dos puntos (:). Los operadoresespecificados ya deben haberse creado como administradores deTivoli y no pueden estar asignados en este momento a otraconsola. Asimismo, ya debe haber creado el operador especificadocon la opción de creación de un operador en la consola de eventoso mediante el comando wconsole -crtoperator. Si un operadortodavía no se ha definido como administrador de Tivoli o en estemomento está asignado a otra consola, se emitirá un mensaje deerror y el proceso del comando continuará. Consulte la opción–lsconsole para obtener información sobre cómo obtener una listade todas las consolas definidas en este momento y los operadoresasignados a las mismas.

–copyconsole [–h host[:puerto]] [–u usuario] [–p contraseña] –n nombre –C consolaCopia los grupos de eventos, los filtros de grupos de eventos y lasasignaciones de roles de autorización de una consola de eventos en otradefinición de consola. Las preferencias del visor de eventos no se copian.Las preferencias del visor de eventos se almacenan de forma local en loshosts donde están instalados los clientes de la consola. La consola dedestino debe existir.

–C consolaNombre de la consola de destino.

–n nombreNombre de la consola fuente.

–crtconsole [–h host[:puerto]] [–u usuario] [–p contraseña] [–C consola] [–n nombre][–D descripción] [–O operador:...]

Crea una nueva definición de consola de eventos.

–C consolaNombre de la consola fuente de la que se copiarán los grupos deeventos y sus roles de autorización, así como los filtros de gruposde eventos, en la nueva definición de consola.


–D descripciónDescripción de texto de la nueva consola. El valor predeterminadoes Nueva descripción.

–n nombreNombre de la nueva consola. El valor predeterminado es Nuevo.

–O operador:...Lista de operadores que se asignarán a la nueva consola. Separecada operador con un carácter de dos puntos (:). Los operadoresespecificados ya deben haberse creado como administradores deTivoli y no pueden estar asignados en este momento a otraconsola. Asimismo, ya debe haber creado los operadoresespecificados con la opción de creación de un operador de laconsola de eventos o mediante el comando wconsole -crtoperator.Si un operador todavía no se ha definido como administrador deTivoli o en este momento está asignado a otra consola, se emitiráun mensaje de error y el proceso del comando continuará. Consultela opción –lsconsole para obtener información sobre cómo obteneruna lista de todas las consolas definidas en este momento y losoperadores asignados a las mismas.

-crtoperator [-h host[:puerto]] [-u usuario] [-contraseña] -O operador:... [-C consola]Crea un nuevo operador de consola.

-O operador:...Lista de operadores que se crearán. Separe cada operador con uncarácter de dos puntos (:). Los operadores especificados ya debenhaberse creado como administradores de Tivoli y no pueden estarasignados en este momento a otra consola. Si un operador todavíano se ha definido como administrador de Tivoli o en este momentoestá asignado a otra consola, se emitirá un mensaje de error y elproceso del comando continuará. Consulte la opción -lsconsolepara obtener información sobre cómo obtener una lista de todas lasconsolas definidas en este momento y los operadores asignados alas mismas.

-C consolaNombre de una consola existente a la que se asignarán los nuevosoperadores creados.

–crteg [–h host[:puerto]] [–u usuario] [–p contraseña] –n nombre [–D descripción][–E grupo_eventos]

Crea un nuevo grupo de eventos.

–D descripciónDescripción de texto del nuevo grupo de eventos.

–E grupo_eventosNombre de un grupo de eventos fuente que se copiará como elnuevo grupo de eventos. Los filtros del grupo de eventos fuentetambién se copian.

–n nombreNombre del nuevo grupo de eventos.

–delconsole [–h host[:puerto]] [–u usuario] [–p contraseña] –n nombreSuprime una definición de consola de eventos. Si hay instancias de laconsola que están en ejecución cuando se emite esta opción, la definiciónno se eliminará hasta que no haya ninguna instancia en ejecución.


–n nombreNombre de la definición de consola que se va a suprimir.

–deleg [–h host[:puerto]] [–u usuario] [–p contraseña] –e grupo_eventos:...Suprime uno o varios grupos de eventos, incluidos los filtros. Si alguno delos grupos de eventos especificados con esta opción está asignado a unaconsola, se desasignará de la consola antes de suprimirse.

–e grupo_eventos:...Nombres de los grupos de eventos que se desea suprimir. Separecada nombre de grupo de eventos con un carácter de dos puntos(:).

–delegflt [–h host[:puerto]] [–u usuario] [–p contraseña] –E grupo_eventos{–a | –n nombre}

Suprime uno o varios filtros de un grupo de eventos.

–a Suprime todos los filtros del grupo de eventos.

–E grupo_eventosNombre del grupo de eventos que contiene los filtros que se deseasuprimir.

–n nombreNombre del filtro que se desea suprimir.

-deloperator [-h host[:puerto]] [-u usuario] [-p contraseña] -O operador:...Suprime un operador de consola existente.

-O operador:...Lista de operadores que se suprimirán. Separe cada operador conun carácter de dos puntos (:). Las consolas asignadas primero sedesasignan. Consulte la opción -lsconsole para obtener informaciónsobre cómo obtener una lista de todas las consolas definidas eneste momento y los operadores asignados a las mismas.

–lsassigneg [–h host[:puerto]] [–u usuario] [–p contraseña] –C consolaLista los grupos de eventos asignados a una definición de consola deeventos.

–C consolaNombre de la consola que se desea listar.

–lsconsole [–h host[:puerto]] [–u usuario] [–p contraseña] [–a] [–c consola:...]Lista las definiciones de consola de eventos. Esta opción no muestra losclientes de la consola que están instalados.

–a Lista la descripción de la consola, los grupos de eventos asignadosy sus roles de autorización, así como los operadores asignados paracada definición de consola. Si no se especifica esta opción, sólo semuestran los nombres de consola.

–c consola:...Nombres de las definiciones de consola específicas que se desealistar. Separe cada nombre de consola con un carácter de dospuntos (:). Si no se especifica esta subopción, se listarán todas lasdefiniciones de consola.

-lsconsoleup [–h host[:puerto]] [–u usuario] [–p contraseña]Muestra una lista de las consolas que están en ejecución en este momentopara el servidor de la interfaz de usuario en la TMR en la que el usuarioque ejecuta el comando wconsole -lsconsoleup tiene iniciada una sesión.Este comando requiere el producto servidor UI de Tivoli Enterprise


Console, Versión 3.7.1 o superior. Para emplear esta opción, todos losproductos IBM Tivoli Enterprise Console deben tener el nivel 3.7.1 osuperior.

–lseg [–h host[:puerto]] [–u usuario] [–p contraseña] [–a] [–e grupo_eventos:...]Lista los grupos de eventos.

–a Lista la descripción y los filtros de cada grupo de eventos. Si no seespecifica esta subopción, sólo se muestran los nombres de losgrupos de eventos.

–e grupo_eventos:...Nombres de los grupos de eventos específicos que se desea listar.Separe cada nombre de grupo de eventos con un carácter de dospuntos (:). Si no se especifica esta subopción, se listarán todos losgrupos de eventos.

-lsoperator [-h host[:puerto]] [-u usuario] [-p contraseña] [-a] -[O operador:...]Lista las definiciones de operadores de consola.

-a Lista la definición de consola asignada. Si no se especifica estaopción, sólo se muestran los nombres de operador.

-O operador:...Nombres de los operadores de consola específicos que se desealistar. Separe cada operador con un carácter de dos puntos (:). Si nose especifica esta subopción, se listarán todos los operadores deconsola.

–setconsole [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola [–n nombre][–D descripción]

Cambia el nombre y la descripción de una definición de consola deeventos.

–C consolaNombre de la consola que se desea cambiar.

–D descripciónNueva descripción de texto de la consola.

–n nombreNuevo nombre de la consola. El nombre no cambiará si seespecifica uno que ya se utiliza en otra consola.

–seteg [–h host[:puerto]] [–u usuario] [–p contraseña] [–n nombre] [–D descripción]–E grupo_eventos

Cambia el nombre y la descripción de un grupo de eventos. Los cambiosse replican en los grupos de eventos asignados.

–D descripciónNueva descripción de texto del grupo de eventos.

–E grupo_eventosNombre del grupo de eventos que se cambiará.

–n nombreNuevo nombre del grupo de eventos. El nombre no cambiará si seespecifica uno que ya se utiliza en otro grupo de eventos.

–setegflt [–h host[:puerto]] [–u usuario] [–p contraseña] [–n nombre] [–D descripción]–E grupo_eventos –F filtro

Cambia el nombre y la descripción de un filtro de grupo de eventos.


–D descripciónNueva descripción de texto del filtro.

–E grupo_eventosNombre del grupo de eventos que contiene el filtro que secambiará.

–F filtroNombre del filtro que se cambiará.

–n nombreNuevo nombre del filtro. El nombre no cambiará si se especificauno que ya se utiliza en otro filtro del grupo de eventos.

–unassigneg [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola–e grupo_eventos:...

Desasigna uno o varios grupos de eventos de una definición de consola deeventos.

–C consolaNombre de la consola que contiene los grupos de eventos que sedesea desasignar.

–e grupo_eventos:...Nombres de los grupos de eventos que se desea desasignar de laconsola. Separe cada grupo de eventos con un carácter de dospuntos (:).

–unassignop [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola–O operador:...

Desasigna operadores de una definición de consola de eventos.

–C consolaNombre de la consola de la que se desasignarán los operadores.

–O operador:...Lista de operadores que se desasignarán de la consola. Separe cadaoperador con un carácter de dos puntos (:). Consulte la opción–lsconsole para obtener información sobre cómo obtener una listade todas las consolas definidas en este momento y los operadoresasignados a las mismas.

Valores de retornoEl comando wconsole devuelve uno de los valores siguientes. Los valores deretorno se pueden obtener con la variable de shell $?. El texto de mensaje de errorse escribe en la salida estándar de error (stderr).v 0 indica que el comando wconsole se ha completado correctamente.v 1 indica que el comando wconsole no se ha ejecutado correctamente debido a un

motivo desconocido.v 2 indica que el comando wconsole no se ha ejecutado correctamente debido a un

problema de autorización

EjemplosEn la lista siguiente se proporcionan ejemplos de uso de las opciones del comandowconsole. En los ejemplos, el carácter de barra inclinada invertida (\) situado alfinal de una línea indica que el texto que aparece en la línea siguiente se haseparado debido a las limitaciones de espacio de la página. El ejemplo se debeinterpretar como si estuviera en una sola línea.


–addegflt - Ejemplos

1. El ejemplo siguiente crea el filtro de grupo de eventos ImmediateAttention en el grupo de eventos Operators. El grupo de eventosOperators ya debe existir. El filtro Immediate Attention contiene unarestricción: el atributo de evento de gravedad está establecido en unvalor crítico (CRITICAL) o muy grave (FATAL).wconsole -addegflt -E Operators\-n “Immediate Attention” \-s "(Immediate Attention IN\(’CRITICAL’,’FATAL’))"

2. El ejemplo siguiente crea el filtro de grupo de eventos LowRepeats enel grupo de eventos Logfile. El grupo de eventos Logfile ya debeexistir. El filtro LowRepeats contiene las dos restricciones siguientes,que deben cumplirse para que los eventos pasen este filtro y seincluyan en el grupo de eventos:a. El atributo de evento source está establecido en el valor LOGFILE.b. El atributo de evento repeat_count está establecido en un valor

comprendido entre 1 y 10.wconsole -addegflt -E Logfile -n LowRepeats \-s "(source=’LOGFILE’) AND \(repeat_count BETWEEN 1 AND 10)"

3. El ejemplo siguiente añade un nuevo filtro denominado Router Ports algrupo de eventos Subnet. El grupo de eventos Subnet ya debe existir.El filtro Router Ports contiene las dos restricciones siguientes y unasentencia SQL de formato libre. Deben cumplirse las tres restriccionespara que los eventos pasen este filtro y se incluyan en el grupo deeventos:a. La clase de evento es Link_Down.b. El atributo de evento adapter_host no contiene un valor nulo; esto

significa que hay un valor establecido para el atributo.c. El atributo de evento repeat_count no está establecido en un valor

inferior a 10. El operador relacional empleado en esta restricción esespecífico de un RDBMS Microsoft SQL Server. El carácter de barrainclinada invertida antepuesto al operador es un carácter de escapepara que el shell UNIX interprete correctamente el signo deexclamación.

wconsole -addegflt -E Subnet \-n "Router Ports" -s "(class=’Link_Down’) \AND (adapter_host IS NOT NULL)" \-S "(repeat_count \!< 10)"

–assigneg - Ejemplos

El ejemplo siguiente asigna el grupo de eventos Subnet con los rolessuper y senior a la consola NetAdmin:wconsole.cmd -assigneg -C NetAdmin \-E Subnet -r super:senior

–assignop - Ejemplos

El ejemplo siguiente asigna el operador denominadoRoot_hmckinne-nt-region a la consola NetAdmin:wconsole.cmd -assignop -C NetAdmin \-O Root_hmckinne-nt-region

–copyconsole - Ejemplos

El ejemplo siguiente copia los grupos de eventos y sus roles, así comolos filtros de grupos de eventos de la consola Personnel Systems en la


consola Personnel Systems Audit. Observe que los operadores no secopian y la consola de destino debe existir.wconsole.cmd -copyconsole -h mfoster:6688 \-u Administrator -p chief10 \-n "Personnel Systems" \-C "Personnel Systems Audit"

–crtconsole - Ejemplos

1. El ejemplo siguiente crea una definición de consola denominadaPersonnel Systems y especifica su descripción. No se asigna ningúngrupo de eventos ni operador a la consola.wconsole.cmd -crtconsole -h mfoster:6688 \-u Administrator -p chief10 \-n "Personnel Systems" -D "Console \Definition for Managing Personnel \Systems Events"

2. El ejemplo siguiente crea una definición de consola denominadaPersonnel Systems, especifica su descripción y asigna el operadordenominado mf_viewer a la consola. No se asigna ningún grupo deeventos a la consola.wconsole.cmd -crtconsole -h mfoster:6688 \-u Administrator -p chief10 \-n "Personnel Systems" -D "Console \Definition for Managing Personnel \Systems Events" -O mf_viewer

3. El ejemplo siguiente crea una definición de consola denominadaPersonnel Systems, especifica su descripción, asigna el operadordenominado mf_viewer y copia los grupos de eventos y sus roles de laconsola AdministratorConsole en la consola Personnel Systems. Tengapresente que la opción –C corresponde a una operación de copia, no detraslado.wconsole.cmd -crtconsole -h mfoster:6688 \-u Administrator -p chief10 \-n "Personnel Systems" -D "Console \Definition for Managing Personnel Systems Events" \-O mf_viewer \-C AdministratorConsole

–crteg - Ejemplos

El ejemplo siguiente crea un grupo de eventos denominado Subnet. Losfiltros del grupo de eventos Network se copian en el nuevo grupo deeventos.wconsole.cmd -crteg -n Subnet -D "Subset \of the Network event group" -E Network

–delconsole - Ejemplos

El ejemplo siguiente suprime la definición de consola PersonnelSystems:wconsole.cmd -delconsole -h mfoster:6688 \-u Administrator -p chief10 \-n "Personnel Systems"

–deleg - Ejemplos

El ejemplo siguiente suprime el grupo de eventos System:wconsole.cmd -deleg -e System

–delegflt - Ejemplos

1. El ejemplo siguiente suprime los filtros SNMP y OpenView del grupode eventos Network:


wconsole.cmd -delegflt -E Network \-n SNMP:OpenView

2. El ejemplo siguiente suprime todos los filtros del grupo de eventosPerformance:wconsole.cmd -delegflt -E Performance -a

–lsassigneg - Ejemplos

El ejemplo siguiente lista los grupos de eventos asignados a la consolaNetAdmin:wconsole.cmd -lsassigneg -C NetAdmin

La salida que visualiza este comando es:SubnetNetworkSystem

–lsconsole - Ejemplos

1. El ejemplo siguiente lista las definiciones de consola sin detalles:wconsole.cmd -lsconsole -h mfoster:6688 \-u Administrator -p chief10

La salida que visualiza este comando es:AdministratorNewTest1Test2

2. El ejemplo siguiente lista las definiciones de consola Administrator yNew con detalles (subopción –a):wconsole.cmd -lsconsole -h mfoster:6688 \-u Administrator -p chief10 \-a -c Administrator:New

La salida que visualiza este comando es:Administrator

Description: Console for \Administrator User

Event Group: DM (User, Admin, \Senior, Super)

Event Group: UNIX_Logfile (User, \Admin, Senior, Super)

Event Group: NT (User, Admin, \Senior, Super)New

Description: New descriptionEvent Group: newEG2 (User, Admin)Event Group: newEG1 (User, Admin)

-lsconsoleup - EjemploA continuación se muestra un ejemplo de la salida de la opción–lsconsoleup con los valores predeterminados:There are currently 3 active TEC consoles.

Console Administrator/Operator_________________________________________Root_jbr01-region Admin1test1 TestAdminDB2 DB2Admin

–lseg - Ejemplos


El ejemplo siguiente lista la descripción de grupo de eventos y losfiltros (incluidas las restricciones) de los grupos de eventos Subnet yNetwork:wconsole.cmd -lseg -a -e Subnet:Network

La salida que visualiza este comando es:Subnet

Description: Subset of the Network \event group

SunNet Manager: (source = ’SNM’)AND \(class = ’EVENT’)

HP OpenView: (source = ’HPOV’)\AND(class = ’EVENT’)

NetView 6000: (source = ’NV6K’)\AND(class = ’EVENT’)

Router Ports: (class = ’Link_Down’)\AND(adapter_host IS NOT NULL)

AND(repeat_count !< 10)\Network

Description: General network eventsSNMP: (source = ’SNMP’)\

AND(class = ’EVENT’)SunNet Manager: (source = ’SNM’)\

AND(class = ’EVENT’)HP OpenView: (source = ’HPOV’)\

AND(class = ’EVENT’)NetView 6000: (source = ’NV6K’)\

AND(class = ’EVENT’)

–setconsole - Ejemplos

El ejemplo siguiente cambia el nombre de la consola Personnel Systemspor Human Resources Systems.wconsole.cmd -setconsole -h mfoster:6688 \-u Administrator -p chief10 \-C "Personnel Systems" \-n "Human Resources Systems"

–seteg - Ejemplos

El ejemplo siguiente cambia el nombre del grupo de eventos Subnetpor Subnetwork y cambia la descripción:wconsole.cmd -seteg -n Subnetwork \-D "Subnetwork Event Data" -E Subnet

–setegflt - Ejemplos

El ejemplo siguiente cambia el nombre del filtro SunNet Manager delgrupo de eventos Subnetwork por SNM y cambia la descripción:wconsole -setegflt -n SNM -D "SNM Events" \-E Subnetwork -F "SunNet Manager"

–unassigneg - Ejemplos

El ejemplo siguiente desasigna los grupos de eventos Network ySystem de la consola NetAdmin:wconsole.cmd -unassigneg -C NetAdmin \-e Network:System

–unassignop - Ejemplos

El ejemplo siguiente desasigna el operador denominadoRoot_hmckinne-nt-region de la consola NetAdmin:wconsole.cmd -unassignop -C NetAdmin \-O Root_hmckinne-nt-region


Véase tambiénNada.


wcrtsrc

Crea una fuente en el servidor de eventos.

Sintaxiswcrtsrc [–S servidor] [–b mapa_bits] [–l etiqueta] fuente

DescripciónEl comando wcrtsrc añade una fuente a la lista de fuentes actuales del servidor deeventos. El comando wcrtsrc llena la base de datos de objetos de Tivoli que lasconsolas de eventos utilizan para crear filtros de eventos. El nombre de fuente secomprueba para asegurarse de que no es un duplicado antes de añadirse a la lista.Las fuentes envían información de eventos a Enterprise Console por medio de losadaptadores de eventos. El adaptador de eventos define el nombre de una fuente.

Autorizaciónsenior

Opcionesfuente Especifica el nombre de la fuente que se va a crear. El nombre debe

corresponderse con el nombre especificado por el adaptador de eventos.

–b mapa_bitsVisualiza el mapa de bits especificado en la consola de eventos. El mapa debits debe ser el nombre de un mapa de bits almacenado en el servidor.

–l etiquetaUtiliza la etiqueta especificada como nombre de la fuente en las consolasde eventos. Si no se especifica este argumento, se utilizará como etiqueta elvalor especificado en el argumento fuente.


EjemplosEl ejemplo siguiente añade la fuente LOGFILE a la TMR local y da a la fuente laetiqueta Logfile:wcrtsrc –l "Logfile" LOGFILE

Véase tambiénwdelsrc, wlssrc, wsetsrc


wcrtnvgroups

Crea los grupos de eventos necesarios para emplear el conjunto de reglasnetview.rls.

Sintaxiswcrtnvgroups [-h host] [-u usuario] [-p contraseña]

DescripciónEl script wcrtnvgroups utiliza el comando wconsole para crear los grupos deeventos de Tivoli Netview que requiere el conjunto de reglas netview.rls. Estos dosgrupos son el grupo de eventos OpenNetview y el grupo de eventosClosedNetview. El grupo de eventos OpenNetview contiene los eventos delproducto Tivoli Netview que están abiertos en el producto IBM Tivoli EnterpriseConsole. El grupo de eventos ClosedNetview contiene los eventos del productoTivoli Netview que tienen un estado distinto del estado abierto en el producto IBMTivoli Enterprise Console.

Si no especifica las opciones -h, -u y -p, se visualizará un cuadro de diálogo paraespecificar la información cuando se ejecute el comando wcrtnvgroups. El entornodebe estar configurado debidamente para permitir esta visualización. Si no esposible configurar el entorno para que visualice un cuadro de diálogo, deberáutilizar las opciones -h, -u y -p en su lugar.

Autorizaciónuser

Opciones-h host Especifica el nombre de host donde se ejecuta la consola de eventos.

-u usuarioEspecifica el nombre de usuario del administrador.

-p contraseñaEspecifica la contraseña del administrador.

EjemplosEl ejemplo siguiente crea los grupos de eventos en una máquina denominadaphizer:wcrtnvgroups phizer.dev.tivoli.com jford my_password

Véase tambiénwconsole


wdbconfig.shEjecuta los scripts de configuración de la base de datos desde fuera del asistenteinstallshield.

Sintaxiswdbconfig.sh [rm | rm_tbl | cr | cr_tbl | upg | upg_362]

DescripciónEl script wdbconfig.sh ejecuta los scripts de configuración de la base de datos queha generado el asistente para la configuración de la base de datos de eventos. Seutiliza cuando los scripts generados deben copiarse en una máquina de host RIMque se encuentra en una máquina distinta de la del servidor de eventos.

El usuario debe haber iniciado la sesión como el mismo usuario que el ID deusuario RIM especificado para el objeto RIM de base de datos de eventos. Esteusuario debe tener acceso DBA a las tablas de la base de datos de eventos.Asimismo, el usuario debe tener un inicio de sesión correspondiente para eladministrador del entorno de gestión de Tivoli.

Para la base de datos Informix, el script wdbconfig.sh sólo se puede ejecutar en lamáquina donde está instalado el servidor de la base de datos.

Autorizaciónuser

Opcionesrm Ejecuta el script dbConfigure_rm.sh para eliminar por completo la base de

datos.

rm_tblEjecuta el script dbConfigure_rm_tbl.sh para eliminar las tablas, los índicesy las vistas de la base de datos.

cr Ejecuta el script dbConfigure_cr.sh para efectuar una nueva instalación dela base de datos. Si tiene una base de datos existente, ésta debe eliminarseantes de realizar una nueva instalación.

cr_tbl Ejecuta el script dbConfigure_cr_tbl.sh para añadir las tablas, los índices ylas vistas de la base de datos.

upg Ejecuta el script dbConfigure_upg.sh para actualizar la base de datos de unesquema de versión 3.7.1 a un esquema de versión 3.8.

upg_362Ejecuta el script dbConfigure_upg_362.sh para actualizar la base de datosde un esquema de versión 3.6.2 a un esquema de versión 3.8.

EjemplosEl ejemplo siguiente crea una nueva base de datos:wdbconfig.sh cr

Véase tambiénwdbinstall.sh


wdbinstall.sh

Ejecuta el asistente para la instalación de la base de datos de eventos. Este asistentepara la instalación de la base de datos crea, actualiza o elimina el esquema de basede datos.

Sintaxis./wdbinstall.sh &

DescripciónEl asistente para la instalación permite al usuario especificar los parámetros deconfiguración de la base de datos deseados a fin de generar y ejecutar los scriptsSQL y scripts de shell de base de datos necesarios para crear el esquema de basede datos. El asistente para la instalación de la base de datos genera los scripts apartir de los parámetros de configuración.

Hay seis acciones posibles, cada una de las cuales crea un script distinto. Son lassiguientes:v Instalar una nueva base de datos y los componentes de la base de datosv Actualizar el esquema de base de datos de la configuración 3.7.1 a la

configuración 3.8v Actualizar el esquema de base de datos del esquema de configuración 3.6.2 al

esquema de configuración 3.8v Eliminar la base de datos y los componentes de la base de datosv Instalar los componentes de la base de datosv Eliminar los componentes de la base de datos

Los componentes de la base de datos son las tablas, los índices, las vistas y, en elcaso de las bases de datos Sybase y MS SQL Server 7, los desencadenantes.

Nota: si el host RIM no es la misma máquina que el servidor de eventos, elija sólo“Generar” los scripts de configuración del esquema de base de datos cuandose ejecute el script wdbinstall.sh.

Cuando ejecute el asistente para la instalación de la base de datos, se le solicitaráun directorio para instalarla. Salvo que utilice una base de datos Informix,asegúrese de que la estructura de directorio sea la misma en la que se escriben losscripts generados en la máquina del host RIM. Si utiliza una base de datosInformix, este directorio debe encontrarse en la máquina del servidor de base dedatos Informix. Si los scripts no están en el mismo directorio en el host RIM, editecada uno de los scripts generados y cambie la variable SCRIPTDIR por la nuevaruta de directorio.

El script wdbinstall.sh debe ejecutarse desde el directorio $BINDIR/TME/TEC/sql.Para las bases de datos Sybase, MS SQL Server y Oracle, el entorno de la base dedatos debe especificarse. Los entornos de las bases de datos DB2 e Informix debenespecificarse al iniciar la sesión como usuario RIM de IBM Tivoli EnterpriseConsole.

Para todas las bases de datos excepto Oracle, para instalar, actualizar o eliminartoda la base de datos es necesario detener y reiniciar la instancia de base de datos


o el servidor de la base de datos. Además, efectúe una copia de seguridad de lainstancia de base de datos o el servidor de la base de datos antes de ejecutar losscripts de configuración.

Autorizaciónuser

OpcionesNinguna.

Ejemplos./wdbinstall.sh &

Véase tambiénwdbconfig.sh


wdbmaint.shActualiza las estadísticas de distribución de datos de la base de datos o reorganizala base de datos.

Sintaxiswdbmaint.sh [stats | reorg] [nombre_objeto_rim] [ db2 server | db2client]

DescripciónEl comando wdbmaint.sh mejora el rendimiento en tiempo de ejecución de la basede datos actualizando las estadísticas de la base de datos o reorganizando la basede datos.

Al actualizar las estadísticas de la base de datos para reflejar los valores actualesde cantidad de datos y distribución de datos se facilita la tarea del gestor internode la base de datos de elegir el mejor plan de acceso para recuperar datos de labase de datos.

Al reorganizar la base de datos se pueden volver a colocar los índices o las tablasen el orden de índice secuencial, con lo que se reduce la fragmentación. Trasejecutarse el programa de utilidad de reorganización, las estadísticas se actualizanautomáticamente.

Nota: la reorganización de las bases de datos o la actualización de las estadísticasdebe llevarse a cabo mientras el servidor de eventos está desconectado.

Se recomienda ejecutar estos programas de utilidad con frecuencia. En concreto, losprogramas de utilidad deben ejecutarse después de que se produzcan grandescantidades de supresiones o inserciones. Por este motivo, se recomienda ejecutar elprograma de utilidad reorg tras wtdbclear.

Los programas bash y wrimsql deben estar disponibles en la máquina en la que seejecuta este comando. Para la base de datos MS SQL Server que ejecuta la opciónreorg, este comando debe ejecutarse desde el host RIM. Para todas las demás basesde datos, este comando se ejecuta desde el servidor de eventos. Para la base dedatos IBM DB2, debe iniciar la sesión como usuario RIM de TEC DB2 y elcomando debe ejecutarse desde el procesador de línea de comandos de DB2 en elhost RIM.

Si este comando no se ejecuta en el servidor de eventos, los archivos siguientesdeberán copiarse en la máquina donde se ejecuta el script:v wdbmaint.shv genreorg.shv genrunstats.sh

Además, estos archivos deberán copiarse para las siguientes bases de datos:

Base de datos Archivo que debe copiarse

Servidor DB2 reorg.db2

Cliente DB2 reorg_client.db2

Sybase reorg.syb

MS SQL Server reorg.mssql


Autorizaciónuser

Opcionesreorg Permite reorganizar los índices y las tablas de la base de datos.

stats Permite actualizar las estadísticas internas de distribución de datos.

db2clientEspecifica que el cliente IBM DB2 está instalado en el host RIM y es laconexión empleada por RIM. Este parámetro sólo se utiliza con lasconexiones IBM DB2 con RIM.

db2serverEspecifica que el servidor IBM DB2 está instalado en el host RIM y es laconexión empleada por RIM. Este parámetro sólo se utiliza con lasconexiones IBM DB2 con RIM.

Ejemplos$BINDIR/TME/TEC/sql/wdbmaint.sh reorg

$BINDIR/TME/TEC/sql/wdbmaint.sh stats

Véase tambiénwtdbclear


wdelac

Elimina un registro de configuración de adaptador de un perfil de configuraciónde adaptador.

Sintaxiswdelac clave... perfil

DescripciónEl comando wdelac suprime los registros seleccionados por las clavesproporcionadas del perfil de configuración de adaptador (ACP) especificado. Lapróxima vez que se distribuya el perfil, se eliminarán los archivos de configuraciónantiguos o no se basarán en el valor del indicador de comportamiento rm_on_del.

Autorizaciónadmin

Opcionesclave... Clave de los registros que se desea eliminar. Debe especificarse al menos

una clave. Separe las diversas claves con un espacio. Puede ver el valor declave en la parte superior derecha del panel de entrada de ACP o medianteel comando wlsac.

perfil Nombre del ACP del que deben eliminarse los registros. Si el nombrecontiene espacios, escriba todo el nombre entre comillas.

EjemplosEl ejemplo siguiente suprime los registros con los valores de clave 0, 1 y 4 delperfil denominado ACP Logfile Profile:wdelac 0 1 4 "ACP Logfile Profile"

Véase tambiénwaddac, wlsac


wdelsrc

Suprime un fuente de la lista de servidores de eventos.

Sintaxiswdelsrc [–S servidor] fuente...

DescripciónEl comando wdelsrc suprime una fuente de la lista de fuentes actuales del servidorde eventos. La fuente suprimida no se elimina de las consolas de eventos, nitampoco se suprimen los eventos existentes de la fuente eliminada de la caché deeventos. Por lo tanto, la fuente se puede añadir de nuevo sin volver a configurarlos grupos de eventos.

Para visualizar una lista de las fuentes disponibles, utilice el comando wlssrc.

Autorizaciónsenior

Opcionesfuente...

Especifica el nombre de la fuente que se desea suprimir. Debe especificarseal menos una fuente. Separe las distintas fuentes con un espacio.


EjemplosEl ejemplo siguiente suprime la fuente SNMP de la TMR local:wdelsrc SNMP

Véase tambiénwcrtnvgroups, wlssrc, wsetsrc


wlsac

Muestra los registros de configuración de adaptador de un perfil de configuraciónde adaptador.

Sintaxiswlsac [ –l | –f formato] [clave... ] perfil

DescripciónEl comando wlsac escribe en la salida estándar uno o varios registros de un perfilde configuración de adaptador (ACP). Es posible proporcionar una o varias clavesde registro para elegir registros individuales. Si no se especifica ninguna clave, seimprimirán todos los registros.

Los registros se imprimen con uno de los dos formatos posibles. El formatopredeterminado incluye la clave, el tipo de adaptador y el nombre de archivo dedestino completo (es decir, el nombre del archivo en los hosts abonados donde seescribirá la configuración del adaptador al efectuar la distribución). Se puedeespecificar otro formato con la opción –f. Con la opción –l, cada registro seimprime como una auténtica configuración de adaptador con el mismo formatoempleado cuando se crean los archivos de configuración al efectuar la distribución.

Autorizaciónadmin

Opcionesclave... Clave de los registros que se desea imprimir. Si se omite la clave, se

imprimirán todos los registros. Separe las diversas claves con un espacio.Puede ver el valor de clave en la parte superior derecha del panel deentrada de ACP o mediante este comando.

perfil Nombre del ACP cuyos registros deben imprimirse. Si el nombre contieneespacios, escriba todo el nombre entre comillas.

–f formatoProporciona un formato alternativo para imprimir registros. La cadena deformato puede contener texto arbitrario así como referencias a los datos delregistro. Estas referencias tienen el mismo formato que el empleado alconstruir catálogos de mensajes, es decir, un valor de índice y una solicitudde formato. Los valores siguientes están disponibles para el formato:

%1 Clave

%2 Tipo de adaptador

%3 Directorio de destino

%4 Nombre de archivo de destino

%5 Campo de comentarios del registro

%6 Secuencia de definiciones de variables de entorno

%7 Secuencia de definiciones de filtros de eventos

%8 Secuencia de solicitudes de distribución de archivo

%9 Secuencia de indicadores de comportamiento de punto final


%10 ID de usuario para las acciones de distribución

%11 ID de grupo para las acciones de distribución

Los valores de clave, tipo, directorio de destino y nombre de archivo soncadenas y es necesario darles el formato $s. Los valores de secuencia sonlistas de cadenas; el formato más sencillo para esos valores es del tipo’$I{%1$s}{\n}’, que imprime cada cadena de la secuencia en una líneaaparte. Toda la cadena debe escribirse entre comillas simples. Así, elformato predeterminado es:’%1$s %2$s %3$s/%4$s’

Para imprimir únicamente el tipo de adaptador y los filtros:’%2$s\n%6$I{\t%1$s}{\n}’

Si desarrolla aplicaciones que utilizan Enterprise Console y Tivoli ADE,consulte la publicación Tivoli ADE Application Services Manual, Vol. 1 paraobtener completa información sobre los formatos de los mensajes y loscatálogos de mensajes.

–l Muestra todos los registros seleccionados como configuraciones deadaptador completas.

EjemplosEl ejemplo siguiente muestra cómo utilizar los formatos:wlsac -f \’%1$s %2$s %3$s/%4$s\nRecord comment [%5$s]\n\n \Env Var Defs BEGIN\n%6$I{%1$s}{\n}\nEnv Var Defs END\n\n \Event Filters BEGIN\n%7$I{%1$s}{\n}\nEvent Filters END\n\n \File Dists BEGIN\n%8$I{%1$s}{\n}\nFile Dists END\n\n \Endpt Behavior Flags [%9$s]\nUID [%10$s]\nGID [%11$s]’ \@"ACP:$1" # NT_Std_PD

El ejemplo siguiente muestra la salida del ejemplo anterior:0 tecad_nt C:\TEMP/tecad_nt.confRecord comment tecad_nt Configuration!Env Var Defs BEGINServerLocation=@EventServerEventMaxSize=4096PollInterval=30BufEvtPath=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\adapters\etc\ \tecad_nt.cacheAdapterCdsFile=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\adapters\ \etc\tecad_nt.cdsAdapterErrorFile=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\adapters\ \etc\tecad_nt.errAdapterSpecificFile=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\ \adapters\etc\tecad_nt.confEnv Var Defs ENDEvent Filters BEGINFilter:Class=NT_BaseFilter:Class=NT_Base_Event;Filter:Class=NT_TimeServ_Worked;Filter:Class=NT_User_Logoff;Filter:Class=NT_Logon_Successful;Filter:Class=SNA_Connect;Filter:Class=NT_Document_Print_Success;Filter:Class=NT_Document_Print_Deleted;Filter:Class=NT_Privileged_Service_Called;Filter:Class=NT_Security_Database;Filter:Class=NT_Base_Event;


Filter:Class=NT_Master_Browser;Filter:Class=NT_Account_Management_Success;Filter:Class=NT_Audit_Policy_Change;Event Filters ENDFile Dists BEGINtecad_nt.err=/usr/local/Tivoli/bin/generic_unix/TME/ACF_REP/ \tecad_nt.errtecad_nt.fmt=/usr/local/Tivoli/bin/generic_unix/TME/ACF_REP/ \tecad_nt.fmttecad_nt.cds=/usr/local/Tivoli/bin/generic_unix/TME/ACF_REP/ \tecad_nt.cds!net stop TECNTAdapterc:cd \usr\local\Tivoli\bin\w32-ix86cd TME\TEC\adapters\etcdel tecad_nt.*cd \tempdel tecad_nt.*copy c:\temp\tecad_nt.* c:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\ \adapters\etc\del c:\temp\tecad_nt.*!!net start TECNTAdapterFile Dists ENDEndpt Behavior Flags rm_on_del=yes!UID Operator!GID 0!

Véase tambiénwaddac, wdelac


wlsaddflt

Muestra información predeterminada global sobre los tipos de adaptadordefinidos.

Sintaxiswlsaddflt [ –l | –f formato] [tipo... ]

DescripciónEl comando wlsaddflt recupera información predeterminada global para uno ovarios tipos de adaptador. Si no se especifica ningún tipo, wlsaddflt imprimeinformación predeterminada para todos los tipos de adaptador conocidos.

Los registros se imprimen con uno de los dos formatos posibles. El formatopredeterminado incluye el tipo de adaptador y el nombre de archivo de destinocompleto (es decir, el nombre del archivo en los hosts abonados donde se escribirála configuración del adaptador al efectuar la distribución). Se puede especificarotro formato con la opción –f. Con la opción –l, cada registro se imprime comouna auténtica configuración de adaptador con el mismo formato empleado cuandose crean los archivos de configuración al efectuar la distribución.

Autorizaciónadmin

Opcionestipo... Tipos de adaptador cuyos valores predeterminados globales deben

imprimirse. Separe los diversos tipos con un espacio. Para ver los tiposdisponibles, utilice el comando wlsaddflt.

–f formatoProporciona un formato alternativo para imprimir registros. La cadena deformato puede contener texto arbitrario así como referencias a los datos delregistro. Estas referencias tienen el mismo formato que el empleado alconstruir catálogos de mensajes, es decir, un valor de índice y una solicitudde formato. Los valores siguientes están disponibles para el formato:

%1 Tipo de adaptador (igual que %2).

%2 Tipo de adaptador

%3 Directorio de destino

%4 Nombre de archivo de destino

%5 Campo de comentarios del registro

%6 Secuencia de definiciones de variables de entorno

%7 Secuencia de definiciones de filtros de eventos

%8 Secuencia de solicitudes de distribución de archivo

%9 Secuencia de indicadores de comportamiento de punto final

%10 ID de usuario para las acciones de distribución

%11 ID de grupo para las acciones de distribución


Los valores de tipo, directorio de destino y nombre de archivo son cadenasy es necesario darles el formato $s. Los valores de secuencia son listas decadenas; el formato más sencillo para esos valores es del tipo’$I{%1$s}{\n}’, que imprime cada cadena de la secuencia en una líneaaparte. Toda la cadena debe escribirse entre comillas simples. Así, elformato predeterminado es:’%1$s %2$s %3$s/%4$s’

Para imprimir únicamente el tipo de adaptador y los filtros:’%2$s\n%6$I{\t%1$s}{\n}’

Si desarrolla aplicaciones que utilizan Enterprise Console y Tivoli ADE,consulte la publicación Tivoli ADE Application Services Manual, Vol. 1 paraobtener completa información sobre los formatos de los mensajes y loscatálogos de mensajes.

–l Muestra todos los registros seleccionados como configuraciones deadaptador completas.

EjemplosEl ejemplo siguiente muestra el registro de configuración para el tipo tecad_hpov:# wlsaddflt -l tecad_hpov:::: record tecad_hpov ::::# Sun 06 Aug 2000 07:05:49 PM CDT## tecad_hpov Configuration#ServerLocation=@EventServerEventMaxSize=4096WellBehavedDaemon=TRUEBufEvtPath=$TIVOLIHOME/tec/${AC_TYPE}.cache

Véase tambiénwaddac, wdelac


wlsadenv

Muestra una lista instalada de variables de entorno de EIF (Event IntegrationFacility) específicas del adaptador.

Sintaxiswlsadenv tipo

DescripciónEl comando wlsadenv escribe en la salida estándar la lista de variables de entornode EIF que reconoce el tipo de adaptador especificado, separadas por líneasnuevas. ACF (Adapter Configuration Facility) utiliza el tipo “__generic__” para lalista de variables que reconoce la propia biblioteca de EIF.

Autorizaciónadmin

Opcionestipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comando

wlsaddflt.

EjemplosEl ejemplo siguiente lista las variables de entorno de EIF para el tipo de adaptadortecad_logfile:wlsadenv tecad_logfile

Este ejemplo devuelve la siguiente información:UnmatchLogLogSources

Véase tambiénwaddac, wsetadenv, wlsadgui, wlsadval


wlsadgui

Muestra un enlace instalado con las herramientas de configuración ampliadasespecíficas del adaptador.

Sintaxiswlsadgui tipo

DescripciónEl comando wlsadgui escribe en la salida estándar el nombre de clase, el nombrede instancia y la etiqueta de botón instalada con wsetadgui para el tipo deadaptador especificado. Si un adaptador tiene herramientas de configuraciónampliadas especiales destinadas al uso con las herramientas de configuracióngráficas del archivo de configuración del adaptador (ACF), debe establecerse unenlace al instalar el adaptador.

Autorizaciónadmin

Opcionestipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comando

wlsaddflt.

EjemplosEl ejemplo siguiente muestra las herramientas de configuración ampliadas para eltipo tecad_logfile:# wlsadgui tecad_logfile@LogfileConfiguration:LogfileConfiguration Logfile Format Editor...

Véase tambiénwlsac, wlsadenv, wsetadgui, wlsadval


wlsadval

Muestra la información de validación instalada para un tipo de adaptador.

Sintaxiswlsadval atributo tipo

DescripciónEl comando wlsadval escribe en la salida estándar la información de validaciónalmacenada anteriormente con wsetadval para el atributo especificado del tipo deadaptador proporcionado.

Autorizaciónadmin

Opcionesatributo

Nombre del atributo de perfil cuya información de validación debeimprimirse. La lista siguiente muestra los atributos de un ACP normal:

ACPbhvSecuencia de variables de comportamiento del perfil, separadas porlíneas nuevas.

ACPcommentCampo de comentarios.

ACPdistSecuencia de solicitudes de distribución, separadas por líneasnuevas.

ACPevSecuencia de variables de entorno, separadas por líneas nuevas.

ACPfltSecuencia de definiciones de filtro, separadas por líneas nuevas.

ACPgidID de grupo para las acciones de punto final.

ACPtargdirDirectorio de instalación de configuración.

ACPtargetNombre de archivo de configuración principal de destino.

ACPtypeTipo de registro. Normalmente este atributo no necesita validación.

ACPuidID de usuario para las acciones de punto final.

Puede haber otros atributos si se añaden al perfil con las herramientas deTivoli Application Extension Facility (AEF).

tipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comandowlsaddflt.


EjemplosEl ejemplo siguiente muestra la información de validación para el atributoACPtarget y el tipo tecad_logfile_solaris2:wlsadval ACPtarget tecad_logfile_solaris2case "$1" in"tecad_logfile.conf")echo TRUE;;

*)echo FALSE;;

esac

exit 0

Véase tambiénwlsac, wlsadenv, wsetadgui


wlsaeenv

Muestra las variables de entorno disponibles en un punto final de perfil deconfiguración de adaptador.

Sintaxiswlsaeenv [–a] punto_final

DescripciónEl comando wlsaeenv imprime en la salida estándar la lista de variables deentorno y sus valores para un punto final determinado. Cada una de las variablesse imprime en una línea con el formato nombre=valor. Este formato se puedeemplear con wsetaeenv cuando se invoca ese comando con su opción –i. Porconsiguiente, es posible emplear wlsaeenv y wsetaeenv en combinación paracopiar el entorno de un punto final en otro.

Autorizaciónadmin

Opcionespunto_final

Nombre del objeto de punto final que se modificará. Se puede hacerreferencia al objeto de punto final con la notación @Classname:etiquetaestándar; de lo contrario, se supone que es una referencia a un objeto denodo gestionado.

–a Solicita que se impriman las cuatro variables automáticas específicas delpunto final (ACPEP_NAME, ACPEP_CLASS, ACPEP_NODE yACPEP_OID) junto con todas las establecidas con wsetaeenv. La variableACPEP_NODE sólo se imprime para los nodos gestionados, no para lospuntos finales. Si se hace referencia al nombre del punto final como@Endpoint:etiqueta, la variable ACPEP_NODE no se imprimirá ya que notiene ningún sentido para este nombre de clase.

EjemplosEl ejemplo siguiente muestra las variables de entorno y sus valores para el puntofinal ep1:wlsaeenv -a @Endpoint:ep1

Este comando devuelve la siguiente información:ACPEP_NAME=@Endpoint:xeriusACPEP_OID=1170507881.2.508+#TMF_Endpoint::Endpoint#ACPEP_CLASS=Endpoint

Véase tambiénwaddac, wdelac, wdistrib (en la publicación IBM Tivoli Management FrameworkReference Manual), wsetaeenv


wlsemsg

Lista los eventos recibidos.

Sintaxiswlsemsg [–k clave] [–r gravedad] [–t estado] consola [grupo_eventos...]

DescripciónEl comando wlsemsg lista los eventos recibidos en la base de datos de eventos.Debe emplear las opciones para especificar un conjunto de eventos determinado ose devolverán todos los eventos. Si desea especificar varios valores para unindicador, utilice el indicador varias veces, salvo que se indique lo contrario para laopción.

Cuando utilice las opciones, sólo se devolverán los eventos que cumplan laespecificación de todas las opciones. Utilice la opción –k para especificar claves declasificación para los eventos devueltos.

Autorizaciónuser

Opcionesconsola Lista los eventos que coinciden con la consola de eventos de un

administrador. Especifique el nombre de la consola.

grupo_eventos...Lista los eventos que coinciden con las definiciones de grupo de eventos(es decir, que pasan los filtros del grupo de eventos). Separe los diversosgrupos de eventos con un espacio. Sólo se indicarán los eventos que pasenlos filtros del grupo de eventos.

–k clave

Especifica los campos por los que se efectuará la clasificación. Los eventosse clasifican en orden ascendente por event_handle, server_handle ydate_reception. Otros valores son administrator, class, hostname,id,message, origin, repeat_count, severity, source, status, sub_source ysub_origin. El campo id se define como la concatenación de event_handle,server_handle y date_reception.

Separe los diversos valores con una coma y, a continuación, un espacio (, )y escriba todo el conjunto de valores entre comillas dobles, como en elejemplo siguiente:wlsemsg -k "Class, Date, Status" ConsoleName

–r gravedadEspecifica un nivel de gravedad Muy grave (FATAL), Crítico (CRITICAL),Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) o Desconocido(UNKNOWN). La ubicación también puede configurar gravedadesadicionales.

–t estadoEspecifica un estado Abierto (OPEN), Cerrado (CLOSED), Respondido(RESPONSE) o Confirmado (ACK).


EjemplosEl ejemplo siguiente visualiza todos los eventos abiertos con la gravedad de aviso(WARNING) que se han reportado a la consola de eventos “Network Events”:wlsemsg –r WARNING –t OPEN "Network Events"

Véase tambiénwpostemsg, wsetemsg


wlsesvrcfg

Lista los parámetros de configuración de un servidor de eventos en ejecución.

Sintaxiswlsesvrcfg [–S servidor] [–b] [–c] [–e] [–k] [–m] [–n] [–r] [–t]

DescripciónEl comando wlsesvrcfg lista los parámetros de configuración de un servidor deeventos en ejecución. El servidor de la región de gestión de Tivoli (TMR) local es elvalor predeterminado salvo que se especifique otro servidor.

Si no se especifica ninguna opción, se visualizarán todos los parámetros.

Autorizaciónuser

Opciones–b Visualiza el número máximo de mensajes de eventos colocados en el búfer

de recepción.

–c Visualiza el número de eventos que pueden almacenarse en la caché deeventos.

–e Visualiza el número de segundos que se conservan los eventos recibidos enel registro de recepción.

–k Visualiza el número de segundos que deben conservarse los eventoscerrados en la caché de eventos.

–m Visualiza el número de segundos que deben concederse al servidor deeventos para inicializarse.

–n Visualiza el número de segundos que deben conservarse los eventos queno se han cerrado.

–S servidorEspecifica el nombre del servidor de eventos con el formato del registro denombres. El valor predeterminado es el servidor de eventos local. Paraespecificar un servidor remoto, escriba @EventServer#tmr, donde tmr es elnombre de una TMR.

–t Visualiza si el rastreo de reglas está habilitado y el nombre de ruta delarchivo de rastreo.

EjemplosEl ejemplo siguiente lista información correspondiente al servidor de eventosinstalado en la TMR gray-region:# wlsesvrcfg -S @EventServer#gray-region -t

A continuación se muestra la salida de este comando:Trace rule execution: NoRule trace output file: /tmp/rules.trace


Véase tambiénwsetesvrcfg


wlssrc

Lista las fuentes existentes en el servidor de eventos.

Sintaxiswlssrc [–S servidor] [–b] [–l] [fuente...]

DescripciónEl comando wlssrc lista las fuentes que están configuradas en este momento en elservidor de eventos. Si no se especifica ninguna fuente, se listarán todas.

Puede emplear opciones para ver el mapa de bits y la etiqueta para cada fuente. Elmapa de bits y la etiqueta representan la fuente en las consolas de eventos de losadministradores.

Autorizaciónuser

Opcionesfuente...

Especifica una fuente para obtener una lista de la misma o una expresiónregular Perl. Si no se especifica ninguno, se listarán todas las fuentes.Separe las distintas fuentes con un espacio.

–b Visualiza el mapa de bits empleado para cada fuente.

–l Visualiza la etiqueta que identifica cada fuente.


EjemplosEl ejemplo siguiente lista toda la información acerca de todas las fuentes delservidor de eventos local:wlssrc –bl

Véase tambiénwcrtnvgroups, wdelsrc


wmigcon

Efectúa la migración de las consolas, los grupos de eventos y los operadores de laversión 3.6 de IBM Tivoli Enterprise Console a la versión 3.7 y la versión 3.8.

Sintaxiswmigcon [–h host:puerto] [–u usuario] [–p contraseña] [–x e | r | c]

DescripciónEl comando wmigcon lleva a cabo una migración automática de las consolas, losgrupos de eventos y los operadores de una instalación de la versión 3.6 de IBMTivoli Enterprise Console existente al formato adecuado para la consola de eventosde la versión 3.7 y la versión 3.8. Este comando normalmente se utiliza sólo unavez, durante la configuración inicial de IBM Tivoli Enterprise Console, versión 3.7o 3.8.

La tabla siguiente indica cómo se cambiarán los filtros de grupos de eventos.

Filtro antiguo Filtro nuevo

LOG LIKE %LOG%

^LOG LIKE LOG%

LOG$ LIKE %LOG

^LOGFILE$ LIKE LOGFILE

LOG* LIKE %LOG%

LOG+ LIKE %LOG%

LOG? LIKE %LOG%

LO[G,T] LIKE %LO[G,T]%

123.84.12.[0-5][0-9] LIKE %123.84.12.[0-5][0-9]%

123.84.12.0\b LIKE %123.84.12.0 %

^LO[G,T] LIKE LO[G,T]

LO[G,T]$ LIKE %LO[G,T]

^123.84.12.[0-5][0-9]$ LIKE 123.84.12.[0-5][0-9]

Notas:

1. Este comando intenta convertir cada filtro con la mayor precisión posible, perono es posible obtener una coincidencia exacta para cada filtro. Los filtrosantiguos se especifican como expresiones regulares Perl, mientras que los filtrosnuevos se especifican con el operador LIKE SQL. Las expresiones regulares y elcódigo SQL no se correlacionan entre sí de modo preciso. Por consiguiente, serecomienda examinar cada uno de los filtros una vez que wmigcon los hayaconvertido para asegurarse de que el filtro SQL obtenido sea correcto.

2. El comando wmigcon migra la totalidad de las consolas, los grupos de eventosy los operadores. No es posible migrar estos objetos de forma selectiva.

3. El filtro de eventos de la versión 3.6 de Tivoli Enterprise Console realiza elfiltrado basándose en cinco atributos de un evento: class, source, sub_source,origin y sub_origin. El comando wmigcon trata el atributo source de formadistinta a los demás atributos. El comando wmigcon creará un nuevo filtro quecoincida exactamente con una sola fuente. Esto significa que no habrá ningúncarácter comodín (%) en el filtro de la versión 3.8 de IBM Tivoli Enterprise


Console. Por lo tanto, si la fuente (source) y una subfuente (sub_source) de unaversión 3.6 de Tivoli Enterprise Console son las siguientes:source: “LOG”sub_source: “LOGFILE”

el filtro de la versión 3.8 de IBM Tivoli Enterprise Console obtenido será:source “Equal to (=)” “LOG”sub_source “LIKE (LIKE)” “%LOGFILE%”

donde el nuevo sub_source contiene caracteres comodín, lo que le permitecoincidir con cualquier cadena que contenga la subcadena LOGFILE, pero elatributo source sólo coincide con las cadenas que son exactamente LOG.

Autorizaciónsuper, senior

Opciones–h host[:puerto]

Nombre del nodo gestionado que contiene la consola de eventos de IBMTivoli Enterprise Console versión 3.6. Especifique esta opción con elformato host:puerto si se utiliza un puerto distinto del puerto 94.

–p contraseñaContraseña del inicio de sesión especificado en el argumento –u usuario.

–u usuarioInicio de sesión empleado como administrador de Tivoli.

–x e | r | cModo de resolución de los nombres de objeto conflictivos. Utilice –x e paraemplear el objeto existente (consola, grupo de eventos u operador), –x rpara sustituir el objeto existente por el nuevo o –x c para cambiar elnombre del objeto añadiendo un número al nuevo objeto. Los indicadoresson sensibles a las mayúsculas y minúsculas. El espacio entre la opción y elindicador es opcional.

EjemplosEl ejemplo siguiente lleva a cabo la migración como el usuario root en el nodogestionado mica. Los conflictos de nombres se resolverán cambiando el nombre delnuevo objeto.wmigcon -h mica -u root -p tivoli -x c


wpostemsg

Envía un evento al servidor de eventos.

Sintaxiswpostemsg –S servidor | –f archivo_configuración [–m mensaje] [–r gravedad][atributo=valor...] fuente_clase

DescripciónEl comando wpostemsg envía un evento a un servidor de eventos. Este comandorequiere el uso de los servicios de Tivoli Management Framework. Enviar eventoses un buen método para probar el servidor después de haber creado nuevosgrupos de eventos o asignaciones de grupos de eventos, haber editado reglas ohaber modificado de algún otro modo el funcionamiento del proceso de eventos enel servidor.

Si el mensaje de evento contiene un carácter de comilla simple (’) intercalado, debeanteponer otra comilla simple a la comilla simple intercalada.

En el caso de los valores de atributo que contengan caracteres que no figuren en lalista siguiente de caracteres ASCII, se añadirán automáticamente comillas simplesal principio y final de la cadena:v a-zv A-Zv Los caracteres $ - . / % & * + @ \ ^ _ ` | ~

Las versiones de nodo gestionado y punto final del programa de utilidad puedenencontrarse en los directorios siguientes:v Versión de nodo gestionado: $BINDIR/bin

v Versión de punto final: $LCF_BINDIR/../bin

El uso de la versión de punto final de wpostemsg depende de las variables deentorno del punto final que se puedan establecer en los archivos lcf_env.sh olcf_env.csh incluidos en la instalación del punto final. Para configurar las variablesde entorno, especifique estos archivos, donde DIR_RAÍZ_PF es la ruta deinstalación del punto final:

Shell C:source DIR_RAÍZ_PF/dat/lcfnúmero/lcf_env.csh

Shell Bourne:DIR_RAÍZ_PF/dat/lcfnúmero/lcf_env.sh

Para asegurarse de que siempre se utiliza wpostemsg para que coincida con sunodo en una máquina configurada como punto final y nodo gestionado, serecomienda crear un alias de shell para la versión de punto final de wpostemsg.

Ejemplos de shell de Unix:

Shell C:alias wpostemsgep "$LCF_BINDIR/../bin/wpostemsg"


Shell Korn:alias wpostemsgep="$LCF_BINDIR/../bin/wpostemsg"

Ejemplo de shell bash en Windows:alias wpostemsgep="/Archivos\ de programa/Tivoli/lcf/bin/w32-ix86/bin/wpostemsg.exe"

La barra inclinada invertida que figura tras /Archivos se utiliza como un carácterde escape para pasar por alto el espacio del nombre de directorio /Archivos deprograma.

Para un nodo de punto final únicamente, añada la ruta de wpostemsg a la variablede entorno PATH. Verifique el contenido de PATH para eliminar la confusión quesupone el hecho de que ambas rutas de nodo gestionado y punto final se definan ala vez.

Ejemplo:wpostemsg –m "test message from EP" TEC_Notice LOGFILE

Nota: para el uso de AS/400, consulte el capítulo sobre el adaptador de alertaAS/400 en la publicación Guía del adaptador de IBM Tivoli Enterprise Console.

Autorizaciónuser

Opcionesatributo=valor...

Asigna un valor a cualquier atributo válido. El atributo debe ser eldefinido para la clase de evento. Separe las diversas expresionesatributo=valor con un espacio.

clase Especifica la clase del evento. Debe coincidir con una clase configurada enel servidor. El adaptador de eventos define las clases.

fuente Especifica la fuente del evento.

–f archivo_configuraciónEspecifica el nombre del archivo de configuración del adaptador. Laubicación predeterminada del archivo de configuración tecad_eif.conf es eldirectorio /etc/Tivoli/; sin embargo, este archivo no existe de formapredeterminada.

–m mensajeTexto del evento, entre comillas dobles.

–r gravedadEspecifica un nivel de gravedad, que puede ser Muy grave (FATAL),Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo(HARMLESS) o Desconocido (UNKNOWN).


Nota: si el servidor de eventos está instalado en una máquina Windows,no se puede emplear la opción –S. En su lugar, utilice la opción –f.


EjemplosEl siguiente ejemplo envía un mensaje de prueba que muestra un eventoSu_Failure con el nivel de gravedad de aviso en las consolas de eventos:wpostemsg –r AVISO –m "error de su" Su_Failure LOGFILE

Véase tambiénpostemsg, wsetemsg, wpostzmsg y postzmsg (en la publicación IBM Tivoli EventIntegration Facility User’s Guide)


wrb

Permite gestionar las bases de reglas en el servidor de eventos.

Sintaxiswrb [opción [subopción]]

DescripciónEl comando wrb permite gestionar las bases de reglas. Puede llevar a cabo tareastales como crear, ver información, manipular, suprimir, compilar, cargar y activarbases de reglas con este comando. La primera opción del comando especifica sufunción principal. Las subopciones posteriores sólo son válidas en el contexto delprimer argumento.

Al trabajar con una base de reglas creada por otro usuario, deberá tener acceso delectura y escritura al directorio de base de reglas de nivel superior y a lossiguientes archivos y subdirectorios de bases de reglas:v TEC_RULES/

– rule_sets

– rule_sets_EventServer

– rule_sets_target

– rule_packs

v TEC_CLASSES/

– .load_rules

Asimismo, deberá tener acceso de lectura a todos los demás archivos del directoriode base de reglas.

Determinadas tareas llevadas a cabo con el comando wrb requieren que la base dereglas esté en un estado coherente antes de finalizar el comando. Si la base de reglasno es coherente, el comando visualizará un mensaje de error en el que se describirála causa de la incoherencia. Para que una base de reglas sea coherente, se verificarála sintaxis de los conjuntos de clases y reglas, así como las referencias a esosarchivos en diversos archivos de definición de base de reglas. Para que una basede reglas esté en un estado coherente, deben darse las condiciones siguientes:v Los tipos enumerados a los que hace referencia una definición de atributo de

clase de evento se han definido en el archivo BAROC.v Las clases padre a las que hace referencia una clase hija (relación ISA) se han

definido en el archivo BAROC.v Los valores de atributo y faceta son del tipo correcto y están dentro del rango.v No se ha definido ninguna enumeración ni clase de evento más de una vez.v No se ha definido más de una vez ningún atributo de una clase de evento.v Los filtros de eventos y los filtros de atributos hacen referencia a las clases de

eventos y a los atributos de clases de eventos que se han definido en un archivoBAROC.

v Los conjuntos de reglas a los que hace referencia un paquete de reglas se handefinido en la base de reglas.

v Los conjuntos de reglas o paquetes de reglas a los que hace referencia un destinode base de reglas se han definido en la base de reglas.


Cualquier comando que compruebe la coherencia de la base de reglas aceptará elargumento –force para efectuar la tarea sin comprobar primero la coherencia de labase de reglas.

Al importar archivos de definiciones de clases (.baroc) o archivos de conjunto dereglas (.rls) a una base de reglas, es preciso especificar el nombre del archivo (conla extensión). Una vez que estos objetos se hayan importado a una base de reglas,deberá utilizar el nombre lógico (es decir, sin la extensión) en las opciones decomando.

Al importar un objeto a una base de reglas (por ejemplo, conjuntos de reglas,clases de eventos, paquetes de reglas a destinos de bases de reglas, etc.), deberásuprimirse un objeto que ya exista en la base de reglas antes de poder sustituirlopor una versión más reciente del objeto. Cada opción de comando siguienteespecifica si es necesario especificar el nombre del archivo o el nombre del objeto.

Nota: para obtener información sobre los convenios de denominación de todos losobjetos de reglas (bases de reglas, conjuntos de reglas, paquetes de reglas,etc.), consulte la publicación IBM Tivoli Enterprise Console Guía del generadorde reglas.

Autorizaciónuser (rol TMR para el comando wrb)

La tabla siguiente lista los roles TMR para las opciones del comando wrb:

Opción de comando Autorización

–comprules user

–cprb –classes senior

–cprb –rulepacks user

–cprb –rulesets senior

–cprb –targets user

–crtrb senior

–crtrp user

–crttarget user

–delrb senior

–delrbclass senior

–delrbpack user

–delrbrule senior

–delrbtarget user

–delrprule user

–deltgtdata user

–deltgtrule user

–imprbclass senior

–imprbrule senior

–imprprule user

–imptgtdata user

–imptgtrule user



–loadrb senior

–lscurrb senior

–lsrb user

–lsrbclass user

–lsrbpack user

–lsrbrule user

–lsrbtarget user

–setrb senior

Opciones–comprules [–deprecation] [–profile] [–trace] base_reglas

Compile las reglas de la base de reglas especificada por el argumentobase_reglas en archivos de objetos Prolog que el motor de reglas puedaprocesar. Asimismo, se crea un directorio para cada destino de base dereglas. Cada directorio contiene una base de reglas completa que un motorde reglas puede cargar. Los conjuntos de reglas inactivas no se compilan.

Nota: si no compila la base de reglas antes de intentar cargarla, obtendráun mensaje de error.

base_reglasNombre de la base de reglas que se desea compilar.

–deprecationEmite un aviso de desuso para cada uso de una función delenguaje de regla o Baroc que ha quedado obsoleta.

–profileHabilita los perfiles para la base de reglas en la compilación. Parahabilitar o suprimir los perfiles en el nivel del conjunto de reglas ola regla de una base de reglas, consulte la información sobredirectivas de perfiles de la publicación IBM Tivoli Enterprise ConsoleGuía del generador de reglas.

–trace Habilita el rastreo para la base de reglas en la compilación. Parahabilitar o suprimir el rastreo en el nivel del conjunto de reglas ola regla de una base de reglas, consulte la información sobredirectivas del compilador de reglas trace de la publicación IBMTivoli Enterprise Console Guía del generador de reglas.

–cprb [–classes] [–rulesets] [–rulepacks] [–targets] [–delete | overwrite] [–force]fuentedestino

Copia una base de reglas existente en otra base de reglas existente. Si noespecifica los argumentos –classes, –rulesets, –rulepacks o –targets, secopian los conjuntos de clases, los conjuntos de reglas, los paquetes dereglas y los destinos de bases de reglas. La base de reglas fuente debeencontrarse en un estado coherente para que se pueda copiar. Puede eludirla comprobación de coherencia con el argumento –force.

Notas:

1. Al copiar un conjunto de reglas o paquete de reglas de otra base dereglas, deberá importarlo a un destino de base de reglas antes de que lopueda emplear el motor de reglas.


2. Si se copian conjuntos de reglas, los conjuntos de reglas inactivas de labase de reglas fuente también se copian en la base de reglas de destino.

destino Nombre de la base de reglas en la que se copiará la información.

source Nombre de la base de reglas de la que se copiará la información.

–classesCopia clases de eventos.

–deleteSuprime todos los archivos existentes de la base de reglas dedestino antes de escribir información procedente de la base dereglas fuente.

–force Fuerza la copia de la base de reglas fuente aunque comoconsecuencia de ello pueda producirse una incoherencia de base dereglas.

–overwriteLos archivos duplicados se sobrescriben en la base de reglas dedestino. De forma predeterminada, los archivos duplicados no secopian.

–rulepacksCopia paquetes de reglas.

–rulesetsCopia conjuntos de reglas.

–targetsCopia destinos de bases de reglas.

–crtrb [–pathruta] [–force] base_reglasCrea una base de reglas en el servidor de eventos de la región de gestiónde Tivoli (TMR) actual. Si en la ruta hay una base de reglas existente, secomprueba la base de reglas para ver si es coherente y se utiliza esa basede reglas. Puede eludir la comprobación de coherencia con el argumento–force. Automáticamente se crea un destino de base de reglas denominadoEventServer en la nueva base de reglas para el servidor de eventos local.Puede definir varias bases de reglas en el servidor, pero sólo es posiblecargar y activar una a la vez.

Nota: si no compila la base de reglas antes de intentar cargarla, obtendráun mensaje de error.

base_reglasNombre de la base de reglas que se desea crear.

–force Fuerza la creación de la base de reglas en la ruta aunque éstacontenga una base de reglas existente con un estado incoherente.

–path rutaRuta donde desea ubicar la nueva base de reglas. Si no seespecifica este argumento, la base de reglas se creará en eldirectorio de trabajo actual del usuario.

–crtrp paquete_reglas [–import conjunto_reglas ...] base_reglasCrea un paquete de reglas en la base de reglas. Un paquete de reglas esuna colección de conjuntos de reglas. Un paquete de reglas se puedeimportar a un destino de base de reglas igual que un conjunto de reglas.


base_reglasNombre de la base de reglas en la que se desea crear el paquete dereglas.

paquete_reglasNombre del paquete de reglas que se desea crear.

–import conjunto_reglas ...Nombre de uno o varios conjuntos de reglas opcionales que seimportarán al nuevo paquete de reglas. Separe los diversosnombres de conjunto de reglas con un espacio. No es posibleimportar los conjuntos de reglas inactivas a un paquete de reglas.Los conjuntos de reglas se añaden al paquete de reglas en el ordenespecificado en la línea de comandos. Los conjuntos de reglas quese importan al paquete de reglas primero deben haberse importadoa la base de reglas.

–crttarget destino[–import {paquete_reglas | conjunto_reglas} ...] base_reglasCrea un destino de base de reglas en la base de reglas. El destino de basede reglas representa el motor de reglas al que se distribuirán estas reglas.El servidor de eventos local se representa mediante el destino de base dereglas EventServer. Este destino de base de reglas se crea automáticamenteal crearse una base de reglas. Cuando se compile la base de reglas, segenerará una base de reglas completa para cada destino de base de reglasen la base de reglas. El servidor AIM distribuirá y cargará cada una de lasbases de reglas en el destino de base de reglas correspondiente.

base_reglasNombre de la base de reglas en la que se creará este destino.

destino Nombre del destino de base de reglas que se desea crear.

–import {paquete_reglas | conjunto_reglas} ...Nombre de uno o varios paquetes de reglas o conjuntos de reglasopcionales que se importarán. Puede especificar conjuntos dereglas y paquetes de reglas a la vez. Sin embargo, los conjuntos dereglas y los paquetes de reglas no pueden tener el mismo nombreen una base de reglas. Separe los diversos conjuntos de reglas ypaquetes de reglas con un espacio. No es posible importar losconjuntos de reglas inactivas a un destino de base de reglas. Losconjuntos de reglas y paquetes de reglas se añaden al destino debase de reglas en el orden especificado en la línea de comandos. Elconjunto de reglas o paquete de reglas que se importa al destinode base de reglas primero debe existir en la base de reglas.

–deltgtrule [conjunto_reglas | paquete_reglas] destino base_reglasSuprime un conjunto de reglas o paquete de reglas de un destino de basede reglas.

conjunto_reglasNombre del conjunto de reglas que se desea suprimir.

paquete_reglasNombre del paquete de reglas que se desea suprimir.

destino Nombre del destino de base de reglas del que se va a suprimir elconjunto de reglas o paquete de reglas.

base_reglasNombre de la base de reglas cuyo destino se modificará.


–delrb base_reglas ...Suprime una o varias bases de reglas del servidor de eventos. No sesuprime el directorio de base de reglas ni su contenido.

base_reglas ...Nombre de la base de reglas que se desea suprimir. Debeespecificar al menos una base de reglas. Separe las diversas basesde reglas con un espacio.

–delrbclass archivo_clases [–force] base_reglasSuprime un archivo de clases de una base de reglas. Se emite un mensajede error si alguna otra clase o alguna regla hace referencia a alguna clasede evento del archivo de clases. Especifique el argumento –force parasuprimir el archivo de clases de todos modos.

Nota: con esta opción, se suprime el archivo .baroc especificado de la basede reglas. Copie el archivo .baroc en una ubicación distinta por si esnecesario en el futuro.

archivo_clasesNombre del archivo de clases que se va a suprimir de la base dereglas especificada con base_reglas.

base_reglasNombre de la base de reglas de la que se va a suprimir el archivode clases.

–force Suprime el archivo de clases aunque con ello pueda producirse unaincoherencia de base de reglas.

–delrbpack paquete_reglas [–force] base_reglasSuprime un paquete de reglas de una base de reglas. Se visualizará unmensaje de error si el paquete de reglas que se va a suprimir está definidoen un destino de base de reglas. Especifique el argumento –force parasuprimir el paquete de reglas de todos modos.

base_reglasNombre de la base de reglas de la que se va a suprimir el paquetede reglas.

paquete_reglasNombre del paquete de reglas que se desea suprimir.

–force Permite suprimir el paquete de reglas aunque con ello puedaproducirse una incoherencia de base de reglas.

–delrbrule conjunto_reglas [–force] base_reglasSuprime un conjunto de reglas de una base de reglas. Se visualizará unmensaje de error si el conjunto de reglas que se va a suprimir está definidoen un destino de base de reglas o paquete de reglas, o está inactivo.Especifique el argumento -force para suprimir el conjunto de reglas detodos modos.

Nota: con esta opción se elimina el archivo .rls de una base de reglas parael conjunto de reglas especificado. Copie el archivo .rls en unaubicación distinta por si es necesario en el futuro.

base_reglasNombre de la base de reglas de la que se va a suprimir el conjuntode reglas.


conjunto_reglasNombre del conjunto de reglas que se desea suprimir.

–force Permite suprimir el conjunto de reglas aunque con ello puedaproducirse una incoherencia de base de reglas.

–delrbtarget destino base_reglasSuprime un destino de base de reglas de una base de reglas.

base_reglasNombre de la base de reglas de la que se va a suprimir el destino.

destino Nombre del destino de base de reglas que se desea suprimir.

–delrprule conjunto_reglas paquete_reglas base_reglasSuprime un conjunto de reglas de un paquete de reglas.

base_reglasNombre de la base de reglas en la que existe el paquete de reglas.

paquete_reglasNombre del paquete de reglas del que se va a suprimir el conjuntode reglas.

conjunto_reglasNombre del conjunto de reglas que se va a suprimir.

–deltgtdata archivo_datos destino base_reglasSuprime un archivo de datos de soporte de un destino de base de reglas.

archivo_datosEspecifica el nombre del archivo que se va a suprimir del destinode base de reglas indicado. Debe ser el nombre completo delarchivo en el directorio de base de reglas.

destino Especifica el nombre del destino de base de reglas del que se va asuprimir el archivo de datos.

base_reglasEspecifica el nombre de la base de reglas que contiene el destino.

–imprbclass archivo_clases [–encoding [encoding] ] [–before archivo_clases | –afterarchivo_clases] [–force] base_reglas

Importa un archivo de especificaciones de clase de evento (archivo .baroc)a una base de reglas, añadiéndolo al final de las especificaciones de clasesalvo que se especifique lo contrario con argumentos. Se visualizará unmensaje de error si el archivo de conjunto de clases contiene errores desintaxis o referencias a enumeraciones o clases de eventos inexistentes, o sihay definidas clases de eventos o enumeraciones duplicadas. Si las clasesde un archivo de clases se obtienen de las clases de otro archivo, importelos archivos de clase a la base de reglas en un orden que mantenga laestructura heredada. Por ejemplo, si el archivo de clases B.baroc contieneclases derivadas del archivo de clases A.baroc, primero debe importar elarchivo de clases A.baroc.

archivo_clasesEspecifica el nombre del archivo de clases que se va a importar.Debe ser una ruta de un archivo .baroc.

base_reglasNombre de la base de reglas que va a recibir el conjunto de clasesimportado.


–after archivo_clasesEspecifica el nombre del archivo de clases tras el cual se colocará elarchivo de clases importado.

–before archivo_clasesEspecifica el nombre del archivo de clases antes del cual secolocará el archivo de clases importado.

–encoding[codificación]De forma predeterminada (cuando no se especifica esta opción), alimportar un archivo de clases a una base de reglas, el archivo seabre con la codificación de caracteres UTF-8. Si se especifica estaopción sin codificación, el archivo se abre con la codificación decaracteres predeterminada de la máquina local. Es posibleespecificar otra codificación de caracteres con la opción decodificación. Para obtener más información sobre las codificacionesinternacionales, consulte el apartado de internacionalización de lapublicación Tivoli Enterprise Guía de instalación.

–force Importa el archivo de clases aunque con ello pueda producirse unaincoherencia de base de reglas.

–imprbrule archivo_reglas [–encoding [encoding] ] [–force] base_reglasImporta un archivo de conjunto de reglas a la base de reglas. Como losconjuntos de reglas que se han importado a la base de reglas debenimportarse a un destino de base de reglas antes de ejecutarse, el orden enque se importen los conjuntos de reglas a la base de reglas no es relevante.El orden en que se importan los conjuntos de reglas a un destino de basede reglas especifica el orden en que ese motor de reglas concreto ejecutarálas reglas. Se visualizará un mensaje de error si la regla que se importahace referencia a una clase de evento inexistente. Puede eludir estacomprobación de coherencia con el argumento –force.

base_reglasNombre de la base de reglas que va a recibir el archivo deconjunto de reglas importado.

archivo_reglasNombre de archivo del conjunto de reglas que se importará a labase de reglas. Debe ser una ruta de un archivo .rls.

–encoding[codificación]De forma predeterminada (cuando no se especifica esta opción), alimportar un archivo de clases a una base de reglas, el archivo seabre con la codificación de caracteres UTF-8. Si se especifica estaopción sin codificación, el archivo se abre con la codificación decaracteres predeterminada de la máquina local. Es posibleespecificar otra codificación de caracteres con la opción decodificación. Para obtener más información sobre las codificacionesinternacionales, consulte el apartado de internacionalización de lapublicación Tivoli Enterprise Guía de instalación.

–force Añade el conjunto de reglas a la base de reglas aunque una reglahaga referencia a una clase de evento inexistente.

–imprprule conjunto_reglas [–before conjunto_reglas | –after conjunto_reglas]paquete_reglas base_reglas

Importa un conjunto de reglas a un paquete de reglas para la base dereglas especificada. Los conjuntos de reglas inactivas no se importan a lospaquetes de reglas.


base_reglasNombre de la base de reglas en la que se encuentra el paquete dereglas.

paquete_reglasNombre del paquete de reglas que va a recibir el conjunto dereglas importado. El paquete de reglas primero debe habersecreado con la opción de comando –crtrp.

conjunto_reglasNombre del conjunto de reglas que se importará al paquete dereglas. El conjunto de reglas primero debe haberse importado a labase de reglas.

–after conjunto_reglasEspecifica el nombre del conjunto de reglas tras el cual se colocaráel conjunto de reglas importado.

–before conjunto_reglasEspecifica el nombre del conjunto de reglas antes del cual secolocará el conjunto de reglas importado.

–imptgtdata archivo_datos destino base_reglasImporta un archivo de datos de soporte a una base de reglas paradistribuirse a un destino de base de reglas. Este archivo se distribuirá conla base de reglas del subdirectorio TEC_RULES. Por ejemplo, un archivo deconfiguración EIF o un archivo de datos o hechos Prolog puede importarsecomo un archivo de datos de soporte.

archivo_datosEspecifica el nombre del archivo que se va a importar al destino debase de reglas indicado. Debe ser una ruta del archivo.

destino Especifica el nombre del destino de base de reglas que recibirá elarchivo de datos importado.

base_reglasEspecifica el nombre de la base de reglas que contiene el destino.

–imptgtrule {conjunto_reglas | paquete_reglas} [{–before | –after} {conjunto_reglas |paquete_reglas}] destino base_reglas

Importa un conjunto de reglas o paquete de reglas a un destino de base dereglas. Los conjuntos de reglas y los paquetes de reglas de una base dereglas no pueden tener el mismo nombre. Los conjuntos de reglas inactivasno se importan a los destinos de base de reglas.

base_reglasNombre de la base de reglas que contiene el destino de base dereglas.

paquete_reglasNombre del paquete de reglas que se desea importar. El paquetede reglas primero debe haberse importado a la base de reglas.

conjunto_reglasNombre del conjunto de reglas que se desea importar. El conjuntode reglas primero debe haberse importado a la base de reglas.

destino Nombre del destino de base de reglas que va a recibir el conjuntoo paquete de reglas importado. Primero debe haberse creado eldestino con la opción de comando –crttarget.


–after conjunto_reglas | paquete_reglasEspecifica el nombre del conjunto o paquete de reglas tras el cualdebe colocarse el conjunto o paquete de reglas importado.

–before conjunto_reglas | paquete_reglasEspecifica el nombre del conjunto o paquete de reglas antes delcual debe colocarse el conjunto o paquete de reglas importado.

–loadrb [–use] base_reglasCarga una base de reglas en el servidor de eventos. De este modo,base_reglas pasa a ser la base de reglas activa en este momento en elservidor de eventos. La base de reglas ya debe estar definida en el servidory los archivos de especificaciones de clase de evento y archivos de reglasdel directorio deben ser válidos. La base de reglas cargada sustituye atodas las especificaciones de clase de evento y reglas definidas actualmenteen el servidor. Sólo puede haber una base de reglas activa a la vez. Alcargar otra base de reglas se sobrescribe la base de reglas activa en estemomento. Si no compila la base de reglas antes de intentar cargarla,recibirá un mensaje de error.

base_reglasNombre de la base de reglas que se desea cargar.

–use Activa la base de reglas inmediatamente después de cargarla. Si sehan efectuado cambios de clase de evento en la base de reglas,reinicie el servidor de eventos tras la carga a fin de que loscambios de clase de evento entren en vigor.

–lscurrbLista el nombre de la base de reglas que está cargada en este momento.

–lsrb [–path] [base_reglas ...]Lista las bases de reglas que están definidas en este momento en elservidor de eventos. Puede haber muchas bases de reglas definidas en elservidor de eventos, aunque sólo puede haber una cargada y activa. Utiliceel comando wrb –lscurrb para visualizar la base de reglas que está cargadaen este momento. Una base de reglas tiene un nombre exclusivo y unnombre de ruta que apunta a un directorio que contiene archivos dedefiniciones de clases de eventos (.baroc), archivos de reglas (.rls), archivosde paquetes de reglas (.rpk) y archivos de destinos de bases de reglas(rule_sets_target).

base_reglasEspecifica los nombres de bases de reglas individuales o unaexpresión regular Perl. De forma predeterminada, se visualizantodas las bases de reglas. Separe los diversos nombres de base dereglas con un espacio.

–path Lista la ruta del directorio de la base de reglas así como el nombrede la base de reglas. De forma predeterminada, sólo se visualiza elnombre de la base de reglas.

–lsrbclass [nombre_clase ...] [–detailed] base_reglasLista las clases de eventos de la base de reglas especificada. Utiliceexpresiones regulares para acotar la lista de clases de eventos que sevisualizará.

nombre_clase ...Especifica los nombres de clases de eventos individuales o unaexpresión regular Perl. Este argumento restringe la lista de clasesque se muestra. De forma predeterminada, se visualizan todas las


clases de eventos de la base de reglas especificada. Separe losdiversos nombres de clases de eventos con un espacio.

base_reglasNombre de la base de reglas que se desea visualizar.

–detailedEspecifica salida detallada. Además de mostrar los nombres de lasclases, se visualizan todos los valores de slot para cada clase.

–lsrbpack [paquete_reglas ...] [–detailed] base_reglasLista los nombres de los paquetes de reglas de la base de reglasespecificada.


paquete_reglas ...Nombre de un paquete de reglas específico o una expresión regularPerl. Si no especifica este argumento, se visualizarán todos lospaquetes de reglas. Separe los diversos paquetes de reglas con unespacio.

–detailedLista los conjuntos de reglas de cada paquete de reglas.

–lsrbrule [archivo_reglas ...] base_reglasLista los nombres de los archivos de conjuntos de reglas que se hanimportado a la base de reglas especificada. Utilice expresiones regularespara acotar la lista de reglas que se visualizará.


archivo_reglas ...Nombre de un archivo de conjunto de reglas específico o unaexpresión regular Perl. Si no especifica este argumento, sevisualizarán todos los archivos de conjuntos de reglas. Separe losdiversos nombres de archivo de conjunto de reglas con un espacio.

–lsrbtarget [destino ...] [–detailed] base_reglasLista los nombres de los destinos de bases de reglas de la base de reglasespecificada.


destino ...Nombre de un destino de base de reglas específico o una expresiónregular Perl. Si no especifica este argumento, se visualizarán todoslos destinos de la base de reglas. Separe los diversos destinos conun espacio.

–detailedLista los conjuntos de reglas y paquetes de reglas de cada destino.

–setrb [–name nombre] [–path ruta [–force]] base_reglasEstablece las propiedades de una base de reglas existente. Puede cambiarel nombre, el directorio que contiene los archivos de bases de reglas oambos. Si se especifica una ruta nueva y hay una base de reglas existenteen la ruta, se comprobará la base de reglas para ver si es coherente. Puedeeludir la comprobación de coherencia con el argumento –force.


base_reglasNombre de la base de reglas que se desea modificar.

–force Fuerza el cambio de la ruta por ruta aunque ésta contenga unabase de reglas existente en un estado incoherente.

–name nombreNuevo nombre de la base de reglas.

–path rutaEspecifica un nuevo directorio de bases de reglas para la base dereglas.

EjemplosEl ejemplo siguiente crea una nueva base de reglas denominada MyRuleBase en eldirectorio /RuleBases/MyRuleBase:wrb -crtrb -path /RuleBases/MyRuleBase MyRuleBase

El archivo siguiente importa el archivo de clases tecad_nt.baroc a la base de reglasMyRuleBase y lo coloca tras el archivo tecad_logfile.baroc:wrb -imprbclass tecad_nt.baroc -after tecad_logfile.baroc \MyRuleBase

El ejemplo siguiente crea un paquete de reglas denominado DefaultRules en labase de reglas MyRuleBase e importa los conjuntos de reglas ov_default.rls ylog_default.rls al paquete de reglas que se acaba de crear:wrb –crtrp DefaultRules -import ov_default \log_default MyRuleBase

El ejemplo siguiente crea un destino de base de reglas denominado SAPServer:wrb -crtarget SAPServer MyRuleBase

El ejemplo siguiente importa el paquete de reglas DefaultRules.rpk al destino debase de reglas SAPServer:wrb -imptgtrule DefaultRules SAPServer \MyRuleBase

El ejemplo siguiente importa el conjunto de reglas tecad_snaevent.rls al destino debase de reglas SAPServer y lo coloca al final de la lista de conjuntos de reglas quese cargará:wrb -imptgtrule tecad_snaevent.rls SAPServer \MyRuleBase

El siguiente ejemplo muestra información detallada sobre las clases definidas en elarchivo tecad_nt.baroc de la base de reglas MyRuleBase:wrb -lsrbclass tecad_nt.baroc -detailed MyRuleBase

El ejemplo siguiente compila la base de reglas MyRuleBase con el rastreohabilitado:wrb -comprules -trace MyRuleBase

El ejemplo siguiente elimina un conjunto de reglas, MyRuleSet, del destinoMyTarget:wrb -deltgtrule all_instances MyTarget MyRuleSet


Una vez eliminado el conjunto de reglas del destino, se puede eliminar de su basede reglas tal como se indica a continuación:wrb -delrbrule all_instances MyRuleSet


wrbupgrade

Actualiza las bases de reglas y los archivos BAROC creados con las versiones deTivoli Enterprise Console anteriores a la 3.7 al formato correspondiente a la versión3.7 y posteriores.

Nota: este comando está situado en el directorio $BINDIR/TME/TEC y no en laubicación estándar ($BINDIR/BIN) de otros comandos de IBM TivoliEnterprise Console.

Al trabajar con una base de reglas creada por otro usuario, deberá tener acceso delectura y escritura al directorio de base de reglas de nivel superior y a lossiguientes archivos y subdirectorios de bases de reglas:v TEC_RULES/

– rule_sets

– rule_sets_EventServer

– rule_sets_target

– rule_packs

v TEC_CLASSES/

– .load_rules

Asimismo, deberá tener acceso de lectura a todos los demás archivos del directoriode base de reglas.

Sintaxiswrbupgrade [ —f —p ruta_de_base_reglas |—n nombre_base_reglas]

DescripciónSólo es necesario que ejecute el comando wrbupgrade si desea emplear paquetesde reglas y destinos de bases de reglas con las bases de reglas creadas conversiones de Tivoli Enterprise Console anteriores a la versión 3.7. No es precisoque ejecute este comando para emplear el comando wrb.

Autorizaciónuser

Opciones—f Especifica que el comando wrbupgrade debe ejecutarse aunque la base de

reglas especificada ya se haya actualizado. Esta opción sólo es válida con laopción -p ruta_de_base_reglas.

—n nombre_base_reglasEspecifica el nombre de la base de reglas que se desea actualizar.

—p ruta_de_base_reglasEspecifica la ruta de la base de reglas que se desea actualizar.


wsendresp

Visualiza un mensaje en el escritorio del operador.

Sintaxiswsendresp operador [host:]ruta_archivo

DescripciónEnvía el contenido del archivo especificado en una ventana emergente a la consolaespecificada. Una regla también puede invocar el comando wsendresp paramostrar un mensaje a un operador. Por ejemplo, al confirmar un eventoHOST_DOWN, una regla puede invocar el comando wsendresp para informar aun operador del curso correcto de la acción para el host afectado. El servidor deeventos debe estar en ejecución para que este comando se ejecute correctamente yla consola del operador especificado debe estar activa.

Autorizaciónadmin

Opciones[host:]ruta_archivo

Especifica el nombre de ruta del archivo que contiene el mensaje deseado.Si lo desea, puede especificar el host que contiene el archivo.

Nota: debe emplear caracteres de barra inclinada (/) para los separadoresde directorio en el argumento de ruta de archivo.

operadorEspecifica el nombre de un operador de Tivoli Enterprise Console.

EjemplosEl ejemplo siguiente muestra el mensaje de respuesta incluido en el archivo/usr/home/carl/fixhost dirigido al administrador Cathy:wsendresp Cathy /usr/home/carl/fixhost


wsetac

Modifica un registro de configuración de adaptador para un perfil deconfiguración de adaptador (ACP).

Sintaxiswsetac detalles_adaptador clave perfil

DescripciónEl comando wsetac permite modificar un registro existente de un ACP.

Cada tipo de adaptador de cada ACP puede recibir el soporte de políticaspredeterminadas para proporcionar valores iniciales para componentes de laconfiguración no suministrados por una invocación de waddac. Del mismo modo,puede haber políticas de validación para garantizar que una configuracióndeterminada sea válida según las necesidades de la implementación del adaptadorde eventos, las particularidades de la instalación local y las consideraciones deseguridad.

El comando wsetac escribe el valor de clave del nuevo registro de configuración deadaptador en la salida estándar. El valor de clave se puede emplear más adelantepara modificar o eliminar el registro.

Autorizaciónadmin



–a Indica que los valores proporcionados en la línea de comandospara los atributos de “lista” (entorno, filtros, acciones dedistribución y comportamiento) deben añadirse a los valoresactuales del perfil en lugar de sustituir por completo los valoresactuales. Tenga en cuenta que la presencia de –a afecta a todos losargumentos –e, –f, –D y –b de una invocación determinada delcomando. Si algunos de estos atributos deben sustituirse y otrosdeben añadirse, serán necesarias varias invocaciones del comando.

Cuando se especifica –a y se añaden nuevos valores a uno o variosde los atributos de lista, los duplicados se eliminan segúncorresponde a la naturaleza de esos atributos modificados. En elcaso de los atributos de entorno y comportamiento, lasasignaciones duplicadas de la misma variable se eliminan(obviamente, las asignaciones nuevas sustituyen a las antiguas). Enel caso de las acciones de distribución, se eliminan las diversascopias efectuadas para el mismo nombre de ruta. En el caso de losfiltros, las entradas duplicadas se eliminan.

–b indicador=valorEstablece el indicador de comportamiento del punto final


determinado en el valor especificado. Los indicadores decomportamiento del punto final se interpretan en situacionesespeciales cuando se distribuyen perfiles, por ejemplo al procesarun registro marcado como suprimido. Los indicadores específicos alos que se da soporte variarán según el punto final, pero entre losque se admiten actualmente se encuentran los siguientes:


ignore omitir todas las anomalías

report informar de las anomalías pero seguir con laactividad de distribución (comportamientopredeterminado)

abort cancelar la distribución anormalmente









Se pueden proporcionar varias opciones –D.




Toda la cadena debe escribirse entre comillas para evitar que elintérprete de línea de comandos tenga en cuenta los caracteres depunto y coma. Para crear un filtro cuyo estado inicial seainhabilitado, se puede añadir el prefijo #ilter: a la cadena. Así,wsetac -a -f ’#ilter:Class=EVENT;’ 12 acp1

añade un único registro de filtro inhabilitado a la clave 12 delperfil acp1. (Si se desea, puede anteponerse Filter: a los filtroshabilitados.)

Se pueden proporcionar muchas opciones –f.



Toda la cadena debe escribirse entre comillas para evitar que elintérprete de línea de comandos tenga en cuenta los caracteres depunto y coma. Para crear una caché de filtro cuyo estado inicial seainhabilitado, se puede añadir el prefijo #ilterCache: a la cadena.Así,wsetac -f ’#ilterCache:Class=LogFile_Base;’ acp1


Se pueden proporcionar muchas opciones –F.


–m modo_prefiltroDefine el Modo prefiltro que se colocará en el archivo deconfiguración del adaptador para los adaptadores de Windows yNetWare. Los valores válidos son IN, in, OUT y out. El valorpredeterminado es OUT. Si utiliza IN o in, también deberáproporcionar el parámetro –p para especificar un Prefiltro. En elejemplo siguiente se muestra un comando que utiliza esteargumento:wsetac -a -m ’OUT’ -p ’Log=System’ 1 ACPprofile

–p prefiltroDefine los Prefiltros que se colocarán en el archivo deconfiguración del adaptador para los adaptadores de Windows yNetWare. Debe especificar como mínimo la especificación deregistro y, si lo desea, las especificaciones EventId, EventType ySource. En el ejemplo siguiente se muestra un comando que utilizaeste argumento:wsetac -a -p ’Log=Security’ 1 ACPprofile

–t destinoNombre del archivo de configuración del adaptador principal,denominado habitualmente archivo .conf. El nombre de archivocompleto de este archivo se forma añadiendo destino al valorproporcionado para dir con una opción –d. Tenga en cuenta que lapolítica predeterminada normalmente estará establecida de modoque defina destino y dir_destino en los valores adecuados.


clave Proporciona la clave del registro de configuración del adaptador existenteque se desea modificar. Puede ver el valor de clave en la parte superiorderecha del panel de entrada de ACP o mediante el comando wlsac.

perfil ACP al que se añadirá el nuevo registro de configuración del adaptador. Siel nombre contiene espacios, escriba todo el nombre entre comillas.


EjemplosEl ejemplo siguiente cambia el valor de ServerLocation del archivo .conf porquasar para la clave 0 en el perfil ACP denominado quasar:wsetac -e ServerLocation=quasar 0 ACP@quasar

Véase tambiénwdelac, waddac, wlsac


wsetaddflt

Añade o establece un registro de configuración de adaptador para un perfil deconfiguración de adaptador o valor predeterminado de tipo de adaptador.

Sintaxiswsetaddflt detalles_adaptador tipo

DescripciónEl comando wsetaddflt también crea o modifica un registro de ACP, pero en lugarde instalarlo en un objeto de perfil, el registro se instala como valorpredeterminado global para el tipo de adaptador de eventos especificado. Losvalores de los atributos del registro se pueden recuperar más adelante con elcomando wlsaddflt de los scripts de política a fin de obtener la informaciónpredeterminada básica para un tipo de adaptador. Posteriormente, los scripts depolítica pueden aplicar filtros o modificaciones. Cada ACP contiene la siguienteinformación de configuración para uno o varios adaptadores de eventos:v Ubicación de los archivos de configuraciónv Definiciones de variables de entorno de adaptador, con información tal como la

ubicación del servidor de eventosv Definiciones de filtros de eventosv Solicitudes de distribuciones de archivos adicionales

Cada tipo de adaptador de cada ACP puede recibir el soporte de políticaspredeterminadas para proporcionar valores iniciales para componentes de laconfiguración no suministrados por una invocación de waddac. Del mismo modo,puede haber políticas de validación para garantizar que una configuracióndeterminada sea válida según las necesidades de la implementación del adaptadorde eventos, las particularidades de la instalación local y las consideraciones deseguridad.

Autorizaciónsenior



–a Indica que los valores proporcionados en la línea de comandospara los atributos de “lista” (entorno, filtros, acciones dedistribución y comportamiento) deben añadirse a los valoresactuales del perfil en lugar de sustituir por completo los valoresactuales. Tenga en cuenta que la presencia de –a afecta a todos losargumentos –e, –f, –D y –b de una invocación determinada delcomando. Si algunos de estos atributos deben sustituirse y otrosdeben añadirse, serán necesarias varias invocaciones del comando.

Cuando se especifica –a y se añaden nuevos valores a uno o variosde los atributos de lista, los duplicados se eliminan segúncorresponde a la naturaleza de esos atributos modificados. En el


caso de los atributos de entorno y comportamiento, lasasignaciones duplicadas de la misma variable se eliminan(obviamente, las asignaciones nuevas sustituyen a las antiguas). Enel caso de las acciones de distribución, se eliminan las diversascopias efectuadas para el mismo nombre de ruta. En el caso de losfiltros, las entradas duplicadas se eliminan.

(La opción –a es válida para wsetac y wsetaddflt.)

–b indicador=valorEstablece el indicador de comportamiento del punto finaldeterminado en el valor especificado. Los indicadores decomportamiento del punto final se interpretan en situacionesespeciales cuando se distribuyen perfiles, por ejemplo al procesarun registro marcado como suprimido. Los indicadores específicos alos que se da soporte variarán según el punto final, pero entre losque se admiten actualmente se encuentran los siguientes:


ignore = omitir todas las anomalías

report = informar de las anomalías pero seguir con laactividad de distribución (comportamientopredeterminado)

abort = cancelar anormalmente la distribución









Se pueden proporcionar muchas opciones –D.




Toda la cadena debe escribirse entre comillas para evitar que elintérprete de línea de comandos tenga en cuenta los caracteres depunto y coma. Para crear un filtro cuyo estado inicial seainhabilitado, se puede añadir el prefijo #ilter: a la cadena. Así,wsetaddflt -a -f ’#ilter:Class=EVENT;’ 12 acp1

añade un único registro de caché de filtro inhabilitado a la clave 12del perfil acp1. (Si se desea, puede anteponerse Filter: a los filtroshabilitados.)

Se pueden proporcionar varias opciones –f.



Toda la cadena debe escribirse entre comillas para evitar que elintérprete de línea de comandos tenga en cuenta los caracteres depunto y coma. Para crear una caché de filtro cuyo estado inicial seainhabilitado, se puede añadir el prefijo #ilterCache: a la cadena.Así,wsetaddflt -F ’#ilterCache:Class=LogFile_Base;’ acp1


Se pueden proporcionar varias opciones –F.


–m modo_prefiltroDefine el Modo prefiltro que se colocará en el archivo deconfiguración del adaptador para los adaptadores de Windows yNetWare. Los valores válidos son IN, in, OUT y out. El valorpredeterminado es OUT. Si utiliza IN o in, también deberáproporcionar el parámetro –p para especificar un Prefiltro. En elejemplo siguiente se muestra un comando que utiliza esteargumento:wsetaddflt -a -m ’OUT’ -p ’Log=System’ 1 ACPprofile

–p prefiltroDefine los Prefiltros que se colocarán en el archivo deconfiguración del adaptador para los adaptadores de Windows yNetWare. Debe especificar como mínimo la especificación deregistro y, si lo desea, las especificaciones EventId, EventType ySource. En el ejemplo siguiente se muestra un comando que utilizaeste argumento:wsetaddflt -a -p ’Log=Security’ 1 ACPprofile

–t destinoNombre del archivo de configuración del adaptador principal,denominado habitualmente archivo .conf. El nombre de archivocompleto de este archivo se forma añadiendo destino al valorproporcionado para dir con una opción –d. Tenga en cuenta que lapolítica predeterminada normalmente estará establecida de modoque defina destino y dir_destino en los valores adecuados.


tipo Proporciona el tipo de adaptador del nuevo adaptador o (para wsetaddflt)el tipo de adaptador cuyos valores predeterminados globales se deseaestablecer. El tipo de adaptador normalmente se utiliza para regir el


funcionamiento de las políticas predeterminadas y de validación. Si seproporcionan tipos de adaptador desconocidos para waddac, las políticasde validación del ACP de destino pueden rechazar el nuevo registro. Paraver los tipos disponibles, utilice el comando wlsaddflt.

Ejemplos1. El ejemplo siguiente establece los valores predeterminados para el tipo

tecad_hpov:wsetaddflt \

-d ’$TECADHOME/etc’ \-t "tecad_hpov.conf" \-c "tecad_hpov Configuration" \-e "ServerLocation=@EventServer" \-e "EventMaxSize=4096" \-e "WellBehavedDaemon=TRUE" \-e ’BufEvtPath=$TIVOLIHOME/tec/${AC_TYPE}.cache’ \-e ’HPOVFilter={CORR{default}} .*’ \-D "!/opt/OV/bin/ovstop tecad_hpov" \-D "tecad_hpov.cds=$ACPHOST:$REPOSITORY/tecad_hpov.cds" \-D "tecad_hpov.err=$ACPHOST:$REPOSITORY/tecad_hpov.err" \-D "tecad_hpov.oid=$ACPHOST:$REPOSITORY/tecad_hpov.oid" \-D "!!/opt/OV/bin/ovstart tecad_hpov" \-b "rm_on_del=yes" \-b "run_actions=yes" \-b "action_fail=report" \-b "expand=yes" \-u "0" -g "0" \tecad_hpov

2. El ejemplo siguiente examina si existe un tipo predeterminado nuevo que se hacreado:wlookup -ar ACPdefaults

3. El ejemplo siguiente suprime el tipo predeterminado añadido test_adapter:wregister -ur ACPdefaults test_adapter

4. El ejemplo siguiente cambia los valores de adaptador predeterminados queafectan a todos los adaptadores:wsetaddflt \

-t ’tecad_$(AC_TYPE).conf’ \-d ’$TECADHOME/etc’ \-c ’Generic Adapter Defaults’ \__generic__

Nota: se recomienda no suprimir el valor predeterminado de ACP __generic__,ya que es la definición base para todos los tipos de adaptador.

Véase tambiénwdelac, wlsac


wsetadenv

Instala una lista de variables de entorno de EIF (Event Integration Facility)reconocidas para un tipo de adaptador.

Sintaxiswsetadenv [–a] nombre_variable... tipo

DescripciónEl comando wsetadenv proporciona a ACF (Adapter Configuration Facility) unalista de las variables de entorno de EIF que el adaptador reconoce pero que noforman parte del conjunto común de variables que emplea directamente el EIF. Losnombres de variables registrados con wsetadenv pasan a estar disponibles para losusuarios de la interfaz gráfica de usuario de ACF (Adapter Configuration Facility)al configurar las listas de variables de entorno. Los scripts de validación de perfilestambién pueden emplear la lista.

El propio recurso ACF (Adapter Configuration Facility) instala la lista de variablesde EIF básicas con el tipo “__generic__”. Esta lista no debe modificarse.

Autorizaciónsenior

Opcionestipo Tipo de adaptador. Si todavía no se ha instalado ninguna información de

entorno ni otra información de tipo, wsetadenv registra automáticamenteel tipo. Para ver los tipos disponibles, utilice el comando wlsaddflt.

nombre_variable...Cero o más variables reconocidas por el tipo de adaptador especificado. Noes ningún error instalar alguna de las variables de EIF estándar aquí, peroes innecesario. Separe los diversos valores nombre_variable con un espacio.

–a Indica a wsetadenv que añada los nombres de variable a la lista que yaestá configurada para el tipo de adaptador especificado. Normalmente,wsetadenv sustituye por completo una lista existente.

EjemplosEl ejemplo siguiente añade las variables de entorno SNMP_PORT ySNMP_TRAP_PORT al adaptador SNMP:wsetadenv SNMP_PORT SNMP_TRAP_PORT tecad_snmp

Véase tambiénwlsadenv, waddac, wsetadgui, wsetadval


wsetadgui

Instala un enlace de la interfaz gráfica de usuario (GUI) de ACF (AdapterConfiguration Facility) con una herramienta de configuración específica del tipo.

Sintaxiswsetadgui clase nombre catálogo texto clave tipo

DescripciónEl comando wsetadgui proporciona a ACF el nombre de un objeto que ofrece unainterfaz estándar para llevar a cabo una configuración gráfica específica del tipoampliada. Asimismo, el comando proporciona una etiqueta que se utilizará en elbotón de “inicio” de la GUI de ACF en el que el usuario puede hacer clic parainvocar las herramientas de configuración ampliadas.

Como los adaptadores de eventos de Tivoli Enterprise Console pueden variarenormemente de tipo y ámbito, el propio recurso ACF no intenta proporcionarherramientas de configuración para otros detalles más allá del subconjunto comúnde configuración de EIF. Sin embargo, como las herramientas de configuracióngráficas pueden resultar adecuadas para una amplia gama de tipos deadaptadores, la interfaz gráfica de ACF puede ampliarse de forma eficaz creandouna herramienta de configuración para un adaptador específico y despuésconectándola a ACF con wsetadgui.

Una herramienta de configuración específica del tipo debe implementarse como unmétodo en un objeto de Tivoli Enterprise. El método debe llamarse acf_extension ydebe coincidir con la siguiente signatura IDL:TMF_CCMS::Database::nmval_listacf_extension(in TMF_Types::StringList uienv,in string prof_name, in string key,in TMF_CCMS::Database::nmval_list);

La interfaz de usuario de ACF invocará el método acf_extension tras la solicituddel usuario y pasará al método el registro de perfil según la configuración actualjunto con la clave de registro y el nombre de perfil. El entorno del servidor de lainterfaz de usuario también se pasa para que las herramientas de configuraciónsepan dónde visualizar los diálogos. La herramienta de configuración ampliadapuede efectuar las modificaciones necesarias en el registro y devolver una nuevaversión del registro cuando haya terminado. Por lo general, las variables deentorno y las solicitudes de distribución serán los atributos del registro modificadode forma más habitual, pero puede modificarse cualquier elemento.

Autorizaciónsenior

Opcionescatálogo

Nombre del catálogo de mensajes que contiene el mensaje que se utilizarácomo etiqueta del botón de “inicio” en la GUI de ACF.

clase Nombre de la clase de Tivoli Enterprise de la que es miembro el objeto deconfiguración.

clave Clave del catálogo de mensajes para la etiqueta del botón de “inicio”.


nombre Nombre del objeto de configuración (el objeto que da soporte al métodoacf_extension para el tipo de adaptador).

texto Texto predeterminado de la etiqueta del botón de “inicio”, que se emplea sino se encuentra el catálogo.

tipo Tipo de adaptador. Si todavía no se ha instalado ninguna información deentorno ni otra información de tipo, wsetadenv registra automáticamenteel tipo. Para ver los tipos disponibles, utilice el comando wlsaddflt.

EjemplosEl ejemplo siguiente añade el editor de formato del archivo de registro a la GUIdel servidor de Tivoli Enterprise Console:wsetadgui LogfileConfiguration LogfileConfiguration _x_ \"Logfile Format Editor..." 1 tecad_logfile

Véase tambiénwlsadgui, waddac, wsetadenv, wsetadval


wsetadval

Instala información de validación para un tipo de adaptador.

Sintaxiswsetadval archivo atributo tipo

DescripciónEl comando wsetadval informa a ACF (Adapter Configuration Facility) de que elarchivo especificado contiene información de validación que debe emplearse alvalidar el valor del atributo indicado en los registros de perfil de configuración deadaptador.

Por lo general, la información de validación consiste en la totalidad o parte de unscript de algún tipo. Los scripts de política de validación instalados en los perfilesde configuración de adaptador posteriormente pueden extraer y utilizar lainformación de validación instalada.

El formato más sencillo de un script de validación de perfil de configuración deadaptador es el siguiente:#!/bin/sh

wlsadval "$1" "$2" | sh –s "$3"

Con este esquema el contenido del registro de validación se utiliza directamentecomo script de validación real. El método de política está escrito de modo queespera que el nombre de atributo se pase como primer argumento y el tipo deregistro como segundo; consulte la página del comando wlsadval. El tercerargumento es el valor que debe validarse, que se transmite al script instalado.

Hay otros modos de emplear el recurso proporcionado por wsetadval. Noobstante, cualquiera que sea el procedimiento elegido, todos los tipos de adaptadordeben utilizarlo de forma coherente para que los scripts de política almacenados enlos objetos de perfil repartidos por la instalación puedan seguir siendo genéricos.Tal como se distribuyen, las políticas de validación de ACF esperan que lainformación de validación de adaptador instalada corresponda a scripts de shell.

Autorizaciónsenior

Opcionesatributo

Nombre del atributo al que se aplica la información de validación. Losatributos de un perfil de configuración de adaptador normalmenteincluyen lo siguiente:

ACPbhvSecuencia de variables de comportamiento del perfil, separadas porlíneas nuevas.

ACPcommentCampo de comentarios.


ACPdistSecuencia de solicitudes de distribución, separadas por líneasnuevas.

ACPevSecuencia de variables de entorno, separadas por líneas nuevas.

ACPfltSecuencia de definiciones de filtro, separadas por líneas nuevas.

ACPgidID de grupo para las acciones de punto final.

ACPtargdirDirectorio de instalación de configuración.

ACPtargetNombre de archivo de configuración principal de destino.

ACPtypeTipo de registro; normalmente no necesita validación.

ACPuidID de usuario para las acciones de punto final.

Puede haber otros atributos si se añaden al perfil con las herramientas deTivoli AEF.

archivo Nombre del archivo que contiene la información de validación. Si archivo esun solo guión, wlsadval lee la información de validación de la entradaestándar.

tipo Tipo de adaptador para el que debe instalarse la información devalidación. Para ver los tipos disponibles, utilice el comando wlsaddflt.

EjemplosEl ejemplo siguiente añade la información de validación del script infile al atributoACPuid para un adaptador de tipo tecad_logfile_hpux10:wsetadval - ACPuid tecad_logfile_hpux10 <<\infilecase "$1" in0 root ) exit 0;;*) exit 1;;esacinfile

Véase tambiénwlsadval, waddac, wsetadenv, wsetadgui


wsetaeenv

Modifica las variables de entorno almacenadas en los puntos finales de perfil deconfiguración de adaptador (ACP).

Sintaxiswsetaeenv [–a] [–d nombre...] nombre=valor... punto_final

wsetaeenv [–a] [–d nombre...] –i archivo punto_final

Descripción

Nota: utilice este comando únicamente en los nodos gestionados; no lo emplee enun punto final.

El comando wsetaeenv permite establecer o modificar la lista de las variables deentorno de configuración de adaptador almacenadas en un objeto de punto finalde perfil. Los valores nuevos se emplearán en la siguiente distribución de ACP deadaptador que se realice al punto_final especificado.

Los ACP utilizan la información de entorno almacenada en los puntos finaleshaciendo referencia a ellos en los valores de los campos de registro. Las referenciasa las variables de entorno tienen el formato $[nombre]. Cuando se recibe el perfil enel punto final durante la distribución, las referencias a la variable de entorno seexpanden de modo que se utilice el valor real de la variable en cualquier contextodonde se realice la referencia. La expansión se efectúa con el control del indicadorde comportamiento expand; consulte la página del comando waddac.

Además de la lista de las variables de entorno establecidas con el control delusuario mediante wsetaeenv, el código de punto final de configuración deadaptador crea automáticamente algunas variables. Estas variables describen elobjeto de punto final, el ACP que contiene el registro donde se hace una referenciay el propio registro. Estas variables de entorno automáticas están disponibles parael uso exactamente del mismo modo que las variables controladas por el usuario.Entre la lista de variables de entorno automáticas se encuentran las siguientes:

ACPEP_NAMENombre del objeto de punto final. Por lo general, el objeto de punto finales un objeto de nodo gestionado de Tivoli.

ACPEP_CLASSNombre de clase del objeto de punto final.

ACPEP_OIDIdentificador de objeto del objeto de punto final.

ACPEP_NODEID de objeto del nodo gestionado donde reside el punto final. En el casohabitual de que el punto final sea el nodo gestionado, este ID de objetocoincide obviamente con el identificador ACPEP_OID.

ACP_NAMENombre del perfil de configuración de adaptador que contiene el registrodonde se hace una referencia a la variable.

ACP_ADMINNombre de usuario del administrador encargado de distribuir el perfil.


ACP_PRFMGRNombre del objeto de gestor de perfiles desde el que se ha distribuido elperfil. (Tenga presente que puede ser el nombre de un objeto de puntofinal de perfil, en cuyo caso coincidiría con el valor de ACPEP_NAME.)

AC_TYPETipo de registro que contiene la referencia de la variable.

AC_ACTIONActividad efectuada para el registro, que puede ser UPDATE o DELETE.

AC_KEYClave de registro del registro que contiene la referencia de la variable.

AC_TARGDIRContenido del campo de directorio de destino del registro que contiene lareferencia de la variable.

Las variables de entorno automáticas se vuelven a configurar cuando se procesacada uno de los registros del perfil (aunque evidentemente las variables ACPEP nocambiarán), de modo que, por ejemplo, las referencias a AC_TYPE de tres registrosde un mismo perfil proporcionan tres valores distintos si los registros son de tiposdistintos.

Autorizaciónsenior

Opcionespunto_final

Nombre del objeto de punto final que se modificará. Se puede hacerreferencia al objeto de punto final con la notación @Classname:etiquetaestándar. Si no se emplea la notación estándar, punto_final se supone que esuna referencia a un objeto de nodo gestionado.

nombre=valor ...Crea un nombre de variable de entorno con el valor especificado en el puntofinal especificado. Separe las diversas expresiones nombre=valor con unespacio.

–a Indica que las asignaciones de variable de entorno deben añadirse a la listaya existente en el objeto de punto final (con la excepción de los duplicados,que se evitan). Sin –a, la lista de variables proporcionada en la línea decomandos pasa a ser la nueva lista del punto final y todas las variablesanteriores se eliminan. Si no se lista ninguna variable nueva pero seespecifica una o varias opciones –d, las opciones –d se procesan y las otrasvariables permanecen sin modificar. Si no se proporciona ninguna variablenueva y no se especifica ninguna opción –d, se elimina todo el entornocontrolado por el usuario del objeto de punto final.

–d nombre ...Suprime la variable especificada del punto final. Se pueden proporcionarmuchas opciones –d. Separe los diversos nombres con un espacio.

–i archivoIndica que la lista de variables de entorno que se debe instalar en el puntofinal debe leerse del archivo especificado en lugar de leerse de la línea decomandos. Las definiciones de variables deben aparecer en el archivo, unaen cada línea. Si archivo es un solo guión, la lista se lee de la entradaestándar de wsetaeenv.


EjemplosEl ejemplo siguiente añade la variable de entorno BufEvtMaxSize al objeto depunto final de perfil del punto final boston-box:wsetaeenv -a BufEvtMaxSize=500000 @Endpoint:boston-box

Véase tambiénwaddac, wdelac, wdistrib (en la publicación IBM Tivoli Management FrameworkReference Manual), wlsaeenv


wsetemsg

Modifica un evento.

Sintaxiswsetemsg [–t estado [–f estado] ] [–r gravedad] [atributo=valor...] consola ID_evento

DescripciónEl comando wsetemsg modifica el estado, la gravedad u otros valores de atributode un evento existente. Debe especificar el evento por la consola que lo harecibido, así como su número de ID de evento; asimismo, debe estar asignadocomo operador de esa consola.

Utilice el comando wlsemsg para ver una lista de los números de ID de evento.

AutorizaciónEl rol de autorización necesario depende de los indicadores empleados. La tablasiguiente indica los roles necesarios:


–f admin o senior

–r user

–t user

Opcionesconsola Especifica el nombre de la consola de eventos que debe emplearse.

ID_eventoEspecifica el ID del evento que se modificará. El ID de evento está formadopor event_handle, server_handle y date_reception.

atributo=valor...Asigna un valor a cualquier atributo válido. El atributo (atributo) debe serel definido para la clase de evento. Separe las diversas expresionesatributo=valor con un espacio.

–r gravedadCambia la gravedad a Muy grave (FATAL), Crítico (CRITICAL), Menor(MINOR), Aviso (WARNING), Inocuo (HARMLESS), Desconocido(UNKNOWN) o un valor personalizado.

–t estado [–f force]Cambia el estado a Abierto (OPEN), Cerrado (CLOSED), Respondido(RESPONSE), Confirmado (ACK) o un valor personalizado.

Nota: no cambie el estado de un evento de Confirmado (ACK) a Abierto(OPEN).

–f forceFuerza el cambio del estado de un evento de Cerrado (CLOSED) aAbierto (OPEN), Confirmado (ACK) o Respondido (RESPONSE).


EjemplosEl ejemplo siguiente confirma el evento 11782052457 para la consola de eventos“Network Events”:wsetemsg –t ACK "Network Events" 11782052457

Véase tambiénwlsemsg, wpostemsg


wsetesvrcfg

Establece los parámetros de configuración para el servidor de eventos. Debedetener y reiniciar el servidor de eventos para que estos parámetros entren envigor.

Sintaxiswsetesvrcfg [–S servidor] [–b eventos] [–c eventos] [–e [segundos] ] [–k segundos] [–msegundos] [–n segundos] [–r [segundos] ] [–t [archivo] ]

DescripciónEl comando wsetesvrcfg establece los parámetros de configuración para el servidorde eventos. El servidor de la región de gestión de Tivoli (TMR) local se modificasalvo que se especifique otro servidor. Debe especificar al menos una opción; de locontrario, el comando devolverá un error.

El servidor puede conservar un número de registros (tales como eventos ymodificaciones de eventos). Los registros tienen una limitación de tiempo; al finaldel periodo especificado, el registro se suprime y se inicia otro nuevo. Nopretenden sustituir a los registros del sistema. Utilícelos para realizar pruebas ydiagnósticos a corto plazo.

Autorizaciónsenior

Opciones–b eventos

Especifica el número máximo de eventos que se guardarán en el búfer derecepción mientras el motor de reglas procese otros eventos. El valorpredeterminado es 500 eventos.

–c eventosEstablece la caché de eventos en el número de eventos especificado poreventos. El valor predeterminado es 1000 eventos. Debe ser un valorsuficientemente alto para manejar un número máximo de eventospendientes. Si la caché es demasiado pequeña, el servidor forzará laeliminación de los eventos más antiguos de la caché.

–e segundosEspecifica el número de segundos que deben conservarse los eventosregistrados en el registro de recepción. Si no se especifica un número desegundos, la función de registro se desactiva. El valor predeterminado es84600 segundos.

Este valor no se aplica automáticamente, sino que lo utiliza la tareaClean_Database de la biblioteca T/EC Tasks. Esta tarea puede ejecutarsedirectamente o programarse como un trabajo.

–k segundosConserva los eventos cerrados con la antigüedad indicada por el númerode segundos especificado. El valor predeterminado es 84600 segundos.

–m segundosEspecifica el número de segundos que se conceden al servidor de eventospara inicializarse. El valor predeterminado es 300 segundos.


–n segundosEspecifica el número de segundos que deben conservarse los eventos queno se han cerrado. El valor predeterminado es 15552000 segundos.


–t archivoEspecifica el nombre de ruta del archivo de rastreo que se utilizará paraajustar y depurar las reglas. Si no se especifica una ruta, el rastreo sedesactiva. El archivo predeterminado es /tmp/rules.trace.

Nota: tras especificar el nombre del archivo de rastreo, debe reiniciar elservidor de eventos.

EjemplosEl ejemplo siguiente establece el tamaño de la caché del servidor de eventos en1536 eventos para el servidor de la TMR AcmeTMR:wsetesvrcfg –c 1536 –S @EventServer#AcmeTMR

Véase tambiénwlsesvrcfg


wsetsrc

Restablece los atributos de las fuentes de eventos.

Sintaxiswsetsrc [–S servidor] [–b mapa_bits] [–l etiqueta] [–n nombre] fuenten

DescripciónEl comando wsetsrc establece el nombre, el mapa de bits o la etiqueta de unafuente registrada en el servidor de eventos. Utilice el comando wlssrc para ver unalista de las fuentes definidas.

Nota: debe especificar como mínimo uno de los argumentos opcionales (–b, –l, –no –S).

Autorizaciónsenior

Opcionesfuente Especifica la fuente que se modificará.

–b mapa_bitsEspecifica el mapa de bits que se utilizará para una fuente. El mapa de bitsespecificado debe estar almacenado en el servidor de eventos.

–l etiquetaEspecifica la etiqueta que se utilizará para identificar la fuente en unaconsola de eventos. De forma predeterminada, el valor especificado por elargumento fuente se emplea para la etiqueta.

–n nombreCambia el nombre de la fuente por nombre, que debe ser un nombre defuente exclusivo. Si crea un duplicado de un nombre ya existente, sereportará un error. El nombre de fuente debe coincidir con el nombre defuente según se ha especificado en el archivo de configuración .cds de unadaptador de eventos.


EjemplosEl ejemplo siguiente establece la etiqueta de la fuente LOGFILE en syslog ydesigna el archivo myNetBitMap como el mapa de bits predeterminado:wsetsrc –b myNetBitMap –l syslog LOGFILE

Véase tambiénwcrtnvgroups, wdelsrc, wlssrc


wstartesvr

Inicia el servidor de eventos.

Sintaxiswstartesvr [–S servidor]

DescripciónDe forma predeterminada, el comando wstartesvr inicia el servidor de eventos dela región de gestión de Tivoli (TMR) local. El servidor de eventos lee los archivosde configuración, la base de datos de eventos, y carga la base de reglas. La cachéde eventos se carga con eventos en función de los parámetros de tiempo y tamañodel búfer y los eventos en cola y en espera (si había eventos en esos estados laúltima vez que se apagó el servidor) se cargan en el búfer de recepción. Acontinuación, el servidor de eventos se establece como disponible para lacomunicación con los adaptadores de eventos y las consolas. De inmediatoempieza a procesar los eventos en cola y en espera y los eventos entrantes.

Una vez que el servidor de eventos está en ejecución, los administradores puedenemplear sus consolas de eventos.

Si un servidor de eventos queda inactivo, las consolas que estaban conectadas almismo se vuelven a conectar automáticamente cuando se reinicia el servidor.

Autorizaciónsenior

Opciones–S servidor

Especifica el nombre del servidor de eventos con el formato del registro denombres. El valor predeterminado es el servidor de eventos local. Paraespecificar un servidor remoto, escriba @EventServer#tmr, donde tmr es elnombre de una región de gestión de Tivoli (TMR).

EjemplosEl ejemplo siguiente inicia el servidor de eventos local:wstartesvr

Véase tambiénwstopesvr


wstatesvr

Visualiza el estado de un servidor de eventos.

Sintaxiswstatesvr [–S servidor]

DescripciónEl comando wstatesvr visualiza el estado del servidor de eventos.

Autorizaciónuser


Especifica el nombre de un servidor de eventos con el formato del registrode nombres. El valor predeterminado es el servidor de eventos local. Paraespecificar un servidor remoto, escriba @EventServer#tmr, donde tmr es elnombre de una región de gestión de Tivoli (TMR).

EjemplosEl ejemplo siguiente visualiza el estado del servidor de eventos local:wstatesvr

Véase tambiénwstartesvr, wstopesvr


wstopesvr

Detiene el servidor de eventos.

Sintaxiswstopesvr [–S servidor]

DescripciónEl comando wstopesvr detiene el servidor de eventos de la región de gestión deTivoli (TMR) local.

Si un servidor de eventos queda inactivo, las consolas que estaban conectadas almismo se vuelven a conectar automáticamente cuando se reinicia el servidor.

Autorizaciónsenior


Especifica el nombre del servidor de eventos con el formato del registro denombres. El valor predeterminado es el servidor de eventos local. Paraespecificar un servidor remoto, escriba @EventServer#tmr, donde tmr es elnombre de una región de gestión de Tivoli (TMR).

EjemplosEl ejemplo siguiente detiene el servidor de eventos local:wstopesvr

Véase tambiénwstartesvr


wstoptecgwDetiene el gateway de Tivoli Enterprise Console.

Sintaxiswstoptecgw

DescripciónEl comando wstoptecgw detiene un gateway de Tivoli Enterprise Console que daservicio a puntos finales. El gateway de Tivoli Enterprise Console se reiniciaráautomáticamente al recibir un evento, por lo que no hay un comandocorrespondiente para iniciar el gateway. Este comando debe ejecutarse en el shellespecificado en el punto final instalado en el host (nodo gestionado) que contieneel gateway.

Para acceder al comando wstoptecgw en el shell especificado en el punto finalinstalado en el host (nodo gestionado) que contiene el gateway, lleve a cabo lasacciones siguientes:1. Instale el perfil de configuración de adaptador (ACP) en el nodo gestionado

para que actúe como gateway de Tivoli Enterprise Console.2. Cree un punto final en ese nodo gestionado.3. Cree una entrada de ACP para el archivo de configuración tec_gateway.4. Distribuya el ACP tec_gateway al punto final. El comando wstoptecgw ahora

residirá en el directorio $LCF_BINDIR/../bin/interp/bin de este punto final.

Autorizaciónuser


wtdbclear

Borra eventos de la base de datos de eventos.

Sintaxiswtdbclear [–e] [–f] [–l] [–c nombre_clase] [–r gravedad] [–s estado] –t segundos [–aregistros] [-p TRUE | FALSE]

DescripciónEl comando wtdbclear suprime eventos del registro de recepción, el repositorio deeventos o ambos. Las tablas de las que suprima las filas dependerán de la opciónespecificada.

El comando wtdbclear debe ejecutarse desde el servidor de eventos.

Autorizaciónsenior

Opciones–a registros

Se efectúa una confirmación tras suprimirse x número de registros.

–c nombre_claseBorra los eventos con el nombre de clase especificado.

Nota: no puede emplear esta opción al borrar registros de recepción con laopción –l.

–e Suprime eventos del repositorio de eventos, el repositorio de tareas y latabla de atributos de eventos ampliados. Debe emplear la opción –t paraespecificar la antigüedad de los eventos que se deben suprimir.

–f Fuerza la supresión de los eventos en cola y en espera del registro derecepción.

Nota: no utilice nunca esta opción mientras está en ejecución el servidorde Tivoli Enterprise Console.

–l Suprime eventos del registro de recepción. Debe emplear la opción –t paraespecificar la antigüedad de los eventos que se deben suprimir.

Nota: no puede emplear las opciones –c, –r o –s al borrar el registro derecepción con esta opción.

–p TRUE | FALSEIndica si debe efectuarse una llamada al procedimiento almacenado,tec_p_clear_events. El valor predeterminado es TRUE. El procedimientotec_p_clear_events mejora el rendimiento en tiempo de ejecución dewtdbclear. -

–r gravedadBorra los eventos con la gravedad especificada. Los valorespredeterminados válidos son Muy grave (FATAL), Crítico (CRITICAL),Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido(UNKNOWN).


Nota: no puede emplear esta opción al borrar el registro de recepción conla opción –l.

–s estadoBorra los eventos con el estado especificado. Los valores predeterminadosválidos son Abierto (OPEN), Cerrado (CLOSED), Respondido(RESPONSE) y Confirmado (ACK).

Nota: no puede emplear esta opción al borrar el registro de recepción conla opción –l.

–t segundosSuprime los eventos que tienen una antigüedad superior al número desegundos especificado. Esta opción es obligatoria.

EjemplosEl ejemplo siguiente suprime todos los eventos del repositorio de eventos:wtdbclear –e –t 0

El ejemplo siguiente borra toda la base de datos:wtdbclear –elf –t 0

El ejemplo siguiente inhabilita el uso del procedimiento almacenado:wtdbclear -elt 0 -p FALSE

Véase tambiénwtdumper, wtdumprl, wtdumptr, wdbmaint.sh


wtdbclear.pl

Borra eventos de la base de datos de eventos.

Sintaxiswtdbclear.pl [–e] [–f] [–l] [–c nombre_clase] [–r gravedad] [–s estado] –t segundos [–aregistros] [-R nombre_rim] [-D]

DescripciónEl comando wtdbclear.pl suprime eventos del registro de recepción, el repositoriode eventos o ambos. Las tablas de las que suprima las filas dependerán de laopción especificada.

Nota: wtdbclear.pl es un script Perl que trunca las tablas cuando se utilizan losargumentos –left 0. Este comando es parecido a la versión binaria dewtdbclear pero borra las tablas con mayor rapidez.

Si se ejecuta wtdbclear.pl desde un nodo que no es el servidor de Tivoli EnterpriseConsole, utilizará la hora de la máquina local para determinar qué eventos debenborrarse, lo que puede generar un comportamiento imprevisto. Se recomienda noejecutar el script wtdbclear.pl en horas de funcionamiento máximo.

Por ejemplo, si la hora del nodo indica las 9:00 y la hora del servidor de TivoliEnterprise Console indica las 9:30, si se ejecuta un comando wtdbclear.pl –let 0desde el nodo se borrarán los eventos recibidos antes de las 9:00. Los últimos 30minutos de eventos permanecerán en la base de datos. Al ejecutar wtdbclear.pl enel servidor de Tivoli Enterprise Console se borraría por completo la base de datos.

Nota: este comando ha quedado obsoleto con la versión 3.8 de IBM TivoliEnterprise Console y puede que no esté disponible en releases posteriores.Utilice en su lugar el comando wtdbclear. Se recomienda emplear elcomando wtdbclear.pl únicamente en las situaciones siguientes:v Si utiliza una base de datos IBM DB2 y el compilador C no está instalado

o no está configurado para el servidor de la base de datos.v Si utiliza una base de datos IBM DB2 y el procedimiento almacenado

tec_p_clear_events no está instalado.

Autorizaciónsenior

Opciones–a registros

Se efectúa una confirmación tras suprimirse el número de registrosespecificado.

–c nombre_claseBorra los eventos con el nombre de clase especificado.

–D Activa el rastreo. Cuando se utiliza esta opción, la actividad de rastreo seescribe en la salida estándar (stdout) de forma predeterminada; si lo desea,puede redirigir la salida del comando a un archivo.


–e Suprime eventos del repositorio de eventos, el repositorio de tareas y latabla de atributos de eventos ampliados. Debe emplear la opción –t paraespecificar la antigüedad de los eventos que se deben suprimir.

–f Fuerza la supresión de los eventos en cola y en espera del registro derecepción.

Nota: no utilice esta opción mientras está en ejecución el servidor de TivoliEnterprise Console.

–l Suprime eventos del registro de recepción.

Nota: no puede emplear las opciones –c, –r o –s al borrar el registro derecepción con esta opción.

–p true | falseIndica si los procedimientos almacenados deben inhabilitarse. El valorpredeterminado es TRUE.

–R Nombre de objeto RIM. El valor predeterminado es tec.

–r gravedadBorra los eventos con la gravedad especificada. Los valorespredeterminados válidos son Muy grave (FATAL), Crítico (CRITICAL),Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido(UNKNOWN).

–s estadoBorra los eventos con el estado especificado. Los valores predeterminadosválidos son Abierto (OPEN), Cerrado (CLOSED), Respondido(RESPONSE) y Confirmado (ACK).

–t segundosSuprime los eventos que tienen una antigüedad superior al número desegundos especificado. Esta opción es obligatoria.

EjemplosEl ejemplo siguiente suprime todos los eventos con una antigüedad superior a 60segundos de los repositorios de eventos y tareas y del registro de recepción, activael rastreo y coloca la salida en el archivo /tmp/output:wtdbclear.pl -elt 60 -D > /tmp/output

Véase tambiénwtdumper, wtdumprl, wtdumptr


wtdbspaceProporciona estadísticas de uso del espacio para la base de datos de eventos.

Sintaxiswtdbspace [-R nombre_objeto_rim] [-t nombre_disp_temp,...] [-d nombre_disp_datos,...]

DescripciónEl comando wtdbspace proporciona estadísticas sobre el espacio empleado y elespacio libre de la base de datos de eventos.

Notas:

1. Debe ejecutarse en el servidor de eventos, salvo que se indique lo contrario.2. La máquina en la que se ejecuta este comando debe tener disponibles los

programas bash y wrimsql, salvo que se indique lo contrario.

Si utiliza una base de datos Informix, debe ejecutar el script wtdbspace comousuario de TEC Informix en el sistema que tiene instalado el servidor de base dedatos Informix y debe especificarse el entorno de la base de datos. Si el servidorInformix está en un sistema distinto al del servidor de eventos, deberá copiar elscript wtdbspace (situado en el directorio $BINDIR/bin del servidor de eventos)en el servidor Informix o hacer que el script esté disponible mediante un montajeNFS. El comando wrimsql no es necesario al ejecutar wtdbspace en el servidor debase de datos Informix.

Si utiliza una base de datos IBM DB2, debe ejecutar el script wtdbspace comousuario de TEC DB2 en el host RIM desde el procesador de línea de comandos deIBM DB2 y debe especificarse el entorno de la base de datos. Si el host RIM está enun sistema distinto al del servidor de IBM Tivoli Enterprise Console, deberá copiarel script wtdbspace (situado en el directorio $BINDIR/bin del servidor de eventos)y el script db2_runstats (situado en el directorio $BINDIR/TME/TEC/sql delservidor de eventos) en el servidor DB2 o hacer que el script esté disponiblemediante un montaje NFS.

Autorizaciónuser

Opciones-d nombre_disp_datos,...

Nombre de los dispositivos de datos sobre los que se informará. La tablasiguiente indica los tipos de dispositivos de datos correspondientes a cadaproducto:

Producto Tipos de dispositivos de datos

IBM DB2 Nombres de espacio de tabla

Informix Nombres de espacio de base de datos

MS SQL Server Nombres de grupo de archivos

Oracle Nombres de espacio de tabla

Sybase Nombres de dispositivo lógico


Cada nombre se separa con una coma o un espacio. Si se utilizan espaciospara separar nombres, toda la lista debe escribirse entre comillas dobles. Sino se especifica ningún nombre, se informará sobre todos los nombres dedispositivo de la base de datos.

Este comando admite el uso del carácter de asterisco como caráctercoincidente. Puede emplearse al principio de un nombre, al final o enambos casos. Por ejemplo, si desea especificar una lista de dispositivos dedatos que empiezan todos por “tec”, especifique “tec*” paranombre_disp_datos.

-R nombre_objeto_rimNombre del objeto RIM. El valor predeterminado es tec.

-t nombre_disp_temp,...

Nombre de los dispositivos temporales sobre los que se informará. La tablasiguiente indica los dispositivos temporales correspondientes a cadaproducto:

Producto Dispositivos temporales

IBM DB2 Espacios de tabla temporales definidos parala base de datos

Informix DBSPACETEMP

MS SQL Server TEMPDB

Oracle Espacios de tabla temporales definidos parala base de datos

Sybase TEMPDB

Cada nombre se separa con una coma. Si no se especifica ningún nombre,se informará sobre todos los nombres de dispositivos temporales de la basede datos.

Este comando admite el uso del carácter de asterisco como caráctercoincidente. Puede emplearse al principio de un nombre, al final o enambos casos. Por ejemplo, si desea especificar una lista de dispositivostemporales que empiezan todos por “tec”, especifique “tec*” paranombre_disp_temp.

-T Muestra todos los dispositivos de datos de Tivoli Enterprise Console ytodos los dispositivos de datos temporales. Este parámetro no se puedeemplear con el parámetro –d.

EjemplosEl ejemplo siguiente muestra el espacio empleado para un objeto RIM denominadomssql_tec y muestra la información correspondiente a los dispositivos de datosTEC_DATA1 y TEC_DATA2 y los dispositivos temporales TEC_TEMP1 yTEC_TEMP2:wtdbspace -R mssql_tec -d TEC_DATA2,TEC_TEMP2 -t “TEC_TEMP1 TEC_TEMP2”

El ejemplo siguiente muestra el espacio empleado para el objeto RIM para losdispositivos de datos que empiezan por “TEC” y los dispositivos temporales queempiezan por “TEC”:wtdbspace -d TEC* -t TEC*


wtdbstat

Comprueba la disponibilidad del servidor de base de datos que utiliza el servidorde Tivoli Enterprise Console.

Sintaxiswtdbstat [–q]

DescripciónEl comando wtdbstat visualiza la disponibilidad del servidor de base de datos.Este comando tarda más en ejecutarse cuando el servidor de base de datos estáinactivo.

Autorizaciónsenior

Opciones–q Especifica que no se imprimirá ninguna salida (el comando wtdbstat se

ejecuta de forma silenciosa). El código de retorno indica el estado. Elcódigo de retorno 0 indica que el servidor está en ejecución. Cualquier otrocódigo de retorno indica un error.

EjemplosEl ejemplo siguiente visualiza la disponibilidad del servidor de base de datos:wtdbstat

Véase tambiénwstatesvr


wtdumper

Genera un informe de eventos.

Sintaxiswtdumper [–f archivo] [–t hora_inicio] [–e hora_finalización] [–o ASC | DESC] [–mnúmero] [–d]

DescripciónEl comando wtdumper genera un informe de eventos a partir del repositorio deeventos. El servidor de Tivoli Enterprise Console mantiene un registro de estoseventos en la base de datos. De forma predeterminada, los eventos figuran en elorden en que se han producido. Sin embargo, el evento más reciente puede constaren primer lugar invocando el indicador –o.

Si se ejecuta wtdumper desde un nodo que no es el servidor de Tivoli EnterpriseConsole, utilizará la hora de la máquina local para determinar qué eventos debenvisualizarse, lo que puede generar un comportamiento imprevisto.

Por ejemplo, si la hora del nodo indica las 9:00 y la hora del servidor de TivoliEnterprise Console indica las 9:30, si se ejecuta un comando wtdumper desde elnodo se visualizarán todos los eventos de la base de datos excepto los acontecidosdurante los 30 minutos especificados. El mismo comando ejecutado en el servidorde Tivoli Enterprise Console visualizaría toda la base de datos.

Autorizaciónsenior

Opciones–d Lista información de formato detallada en el informe de eventos.

–e hora_finalizaciónLista los eventos acontecidos antes de la fecha y la hora especificadas. Elparámetro hora_finalización debe indicar una fecha con el formato “mes ddhh:mm:ss aaaa”. Si se omite este indicador, el comando utilizará la horaactual como hora de finalización.

–f archivoEscribe la salida en el archivo especificado.

–m númeroEspecifica el número máximo de eventos que se registrará en el informe. Siel número de eventos de la base de datos supera el valor especificado, elcomando omitirá entradas a partir del final del informe. Por ejemplo, si sevisualiza el informe en orden ascendente, las entradas más recientes de labase de datos no se incluirán en el informe.

–o ASC | DESCEstablece el orden en que se listarán los eventos. Los valores posibles son:

ASC Lista en primer lugar la entrada más antigua del registro. Éste es elvalor predeterminado.

DESC Lista en primer lugar la entrada más reciente del registro.


–t hora_inicioLista los eventos acontecidos después de la fecha y la hora especificadas. Elparámetro hora_inicio debe indicar una fecha con el formato “mes ddhh:mm:ss aaaa”.

EjemplosEl ejemplo siguiente genera un informe de eventos que incluye los eventosproducidos entre las 19:00 del 9 de marzo de 1999 y las 9:00 del 12 de marzo de1999:wtdumper –t "MAR 09 19:00:00 1999" –e "MAR 12 09:00:00 1999"

Véase tambiénwtdbclear, wtdumprl, wtdumptr


wtdumprl

Genera un informe de los eventos recibidos.

Sintaxiswtdumprl [–f archivo] [–t hora_inicio] [–e hora_finalización] [–o ASC | DESC] [–mnúmero]

DescripciónEl comando wtdumprl genera un informe de los eventos recibidos por el servidorde eventos. El registro de recepción mantiene una lista de estos eventos en la basede datos. De forma predeterminada, los eventos figuran en el orden en que se hanproducido. Sin embargo, el evento más reciente puede constar en primer lugarinvocando el indicador –o.

Si se ejecuta wtdumprl desde un nodo que no es el servidor de Tivoli EnterpriseConsole, utilizará la hora de la máquina local para determinar qué eventos debenvisualizarse, lo que puede generar un comportamiento imprevisto.

Por ejemplo, si la hora del nodo indica las 9:00 y la hora del servidor de TivoliEnterprise Console indica las 9:30, si se ejecuta un comando wtdumprl desde elnodo se visualizarán todos los eventos de la base de datos excepto los acontecidosdurante los 30 minutos especificados. El mismo comando ejecutado en el servidorde Tivoli Enterprise Console visualizaría toda la base de datos.

Autorizaciónsenior, RIM_view

Opciones–e hora_finalización

Lista los eventos recibidos antes de la fecha y la hora especificadas. Elparámetro hora_finalización debe indicar una fecha con el formato “mes ddhh:mm:ss aaaa”. Si se omite este indicador, el comando utilizará la horaactual como hora de finalización.


–m númeroEspecifica el número máximo de eventos que se registrará en el informe. Siel número de eventos del registro supera el valor especificado, el comandoomitirá entradas a partir del final del informe. Por ejemplo, si se visualizael informe en orden ascendente, las entradas más recientes de la base dedatos no se incluirán en el informe.





–t hora_inicioLista los eventos recibidos después de la fecha y la hora especificadas. Elparámetro hora_inicio debe indicar una fecha con el formato “mes ddhh:mm:ss aaaa”.

EjemplosEl ejemplo siguiente genera un informe que incluye todos los eventos recibidosentre las 19:00 del 9 de marzo de 1999 y las 9:00 del 12 de marzo de 1999:wtdumprl –t "MAR 09 19:00:00 1999" –e "MAR 12 09:00:00 1999"

Véase tambiénwtdbclear, wtdumper, wtdumptr


wtdumptr

Genera un informe de las tareas completadas.

Sintaxiswtdumptr [–f archivo] [–t hora_inicio] [–e hora_finalización] [–o ASC | DESC] [–mnúmero]

DescripciónEl comando wtdumptr genera un informe de las tareas realizadas por el servidorde eventos. El repositorio de tareas mantiene un registro de estas tareas en la basede datos. De forma predeterminada, las tareas completadas figuran en el orden enque se han producido. Sin embargo, la tarea más reciente puede constar en primerlugar invocando el indicador –o.

Autorizaciónsenior, RIM_view

Opciones–e hora_finalización

Lista las tareas completadas antes de la fecha y la hora especificadas. Elparámetro hora_finalización debe indicar una fecha con el formato “mes ddhh:mm:ss aaaa”. Si se omite este indicador, el comando utilizará la horaactual como hora de finalización.


–m númeroEspecifica el número máximo de eventos que se registrará en el informe. Siel número de eventos de la base de datos supera el valor especificado, elcomando omitirá entradas a partir del final del informe. Por ejemplo, si sevisualiza el informe en orden ascendente, las entradas más recientes de labase de datos no se incluirán en el informe.




–t hora_inicioLista las tareas completadas después de la fecha y la hora especificadas. Elparámetro hora_inicio debe indicar una fecha con el formato “mes ddhh:mm:ss aaaa”.

EjemplosEl ejemplo siguiente genera un informe que incluye todas las tareas completadasentre las 19:00 del 9 de marzo de 1999 y las 9:00 del 12 de marzo de 1999:wtdumptr –t "MAR 09 19:00:00 1999" –e "MAR 12 09:00:00 1999"

Véase tambiénwtdbclear, wtdumper, wtdumprl


wtecexport

Exporta las definiciones de la consola de eventos de IBM Tivoli Enterprise Consolea un archivo.

Sintaxiswtecexport –h [host [:puerto]] [–u usuario] [–p contraseña] [–O operador1:operador2:...][–c consola1:consola2:...] [–e grupo_eventos1:grupo_eventos2:...] [–f nombre_archivo]

En los sistemas Windows, el comando wtecexport se invoca como wtecexport.cmd.Las opciones son las mismas.

DescripciónLas definiciones de grupos de eventos, consolas y operadores pueden exportarse aun archivo y después importarse a otra TMR mediante el comando wtecimport.Todos los administradores tienen la misma vista de configuración de los objetos deuna TMR. La exportación y la importación de definiciones de consola ofrecen lasventajas siguientes:v Este método permite crear de forma eficaz un conjunto base de consolas de

eventos en una TMR de modo que puedan importarse las consolas de eventos aotras TMR para realizar tareas de configuración o implementación adicionales.

v Las definiciones de consola de una TMR se pueden emplear como un punto decontrol único para la configuración de consolas en un entorno de varias TMR.

v Este método permite crear de forma eficaz copias de seguridad de consolas.

Esta tarea también se puede efectuar desde la consola de eventos.

Las opciones –O, –c y –e se pueden emplear por separado o de forma combinada.Por ejemplo, puede exportar una o varias consolas y cualquier número de gruposde eventos sin exportar los operadores. Si no se especifica como mínimo una de lasopciones –O, –c y –e, se exportarán todas las definiciones de consola.

Observe que wtecexport exporta consolas, grupos de eventos y operadores paratodos los usuarios.

Autorizaciónsenior

Opciones—h [host [:puerto]]

Nombre del servidor de eventos. Especifique esta opción con el formatohost:puerto si se utiliza un puerto distinto del puerto 94.

—c consola1:consola2:...Lista de consolas que se desea exportar, separadas por caracteres de dospuntos.

—e grupo_eventos1:grupo_eventos2:...Lista de grupos de eventos que se desea exportar, separados por caracteresde dos puntos.

—f nombre_archivoRuta y nombre del archivo que contendrá las definiciones exportadas. Si elarchivo no existe, se creará. La ruta ya debe existir.


—O operador1:operador2:...Lista de operadores que se desea exportar, separados por caracteres de dospuntos.

—p contraseñaContraseña del inicio de sesión especificado en el argumento –u.

—u usuarioInicio de sesión del administrador de Tivoli.

Ejemplos1. El ejemplo siguiente lleva a cabo la exportación como el usuario root en el

servidor de eventos mica desde un sistema que ejecuta Windows. Se muestranlos operadores, las consolas y los grupos de eventos que se van a exportar y losrecursos se escriben en un archivo denominado export_file.wtecexport.cmd -h mica -u root -p tivoli \-O mfoster:mbock -c personnel:finance \-e Adap_NT:Adap_Unix_Logfile:DM_NT:DM_Unix \-f export_file

2. El ejemplo siguiente lleva a cabo la exportación como el usuario root en elservidor de eventos mica desde un sistema que ejecuta Windows. En este caso,todos los operadores, las consolas y los grupos de eventos se exportarán aexport_file.wtecexport.cmd -h mica -u root -p tivoli \-f export_file

Véase tambiénwtecimport


wtecimport

Importa definiciones de consola de eventos de un archivo de exportación a unaTMR.

Sintaxiswtecimport –h host[:puerto] [–u usuario] [–p contraseña] [–O operador1:operador2:...][–c consola1:consola2:...] [–e grupo_eventos1:grupo_eventos2:...] [–f nombre_archivo] [–x e| r | c]

En los sistemas Windows, el comando wtecimport se invoca comowtecimport.cmd. Las opciones son las mismas.

DescripciónLas definiciones de grupos de eventos, consolas y operadores pueden exportarse aun archivo con el comando wtecexport y después importarse a otra TMR medianteuna consola de eventos. Todos los administradores tienen la misma vista deconfiguración de los objetos de una TMR. La exportación y la importación dedefiniciones de consola ofrecen las ventajas siguientes:v Este método permite crear de forma eficaz un conjunto base de consolas de

eventos en una TMR de modo que puedan importarse las consolas de eventos aotras TMR para realizar tareas de configuración o implementación adicionales.

v Las definiciones de consola de una TMR se pueden emplear como un punto decontrol único para la configuración de consolas en un entorno de varias TMR.

v Este método permite crear de forma eficaz copias de seguridad de consolas.

Esta tarea también se puede efectuar desde la consola de eventos.

Las opciones –O, –c y –e se pueden emplear por separado o de forma combinada.Por ejemplo, puede importar una o varias consolas y cualquier número de gruposde eventos sin importar los operadores. Si no se especifica como mínimo una delas opciones –O, –c y –e, se importarán todas las definiciones de consola.

Observe que wtecimport importa consolas, grupos de eventos y operadores paratodos los usuarios. Al importar consolas, los operadores o grupos de eventosasignados a las consolas ya deben existir, o deben también importarse a la vez.

Sólo pueden importarse como operadores los administradores de Tivoli definidosen la TMR receptora. No es posible crear un administrador de Tivoli nuevo en unaTMR importando un operador que no esté definido en la TMR receptora.

Autorizaciónsenior

Opciones–c consola1;consola2;...

Lista de consolas que se desea importar, separadas por caracteres de dospuntos.

–e grupo_eventos1;grupo_eventos2;...Lista de grupos de eventos que se desea importar, separados por caracteresde dos puntos.


–f nombre_archivoRuta y nombre del archivo que contiene las definiciones exportadas.

-h [host [:puerto]]Nombre del servidor de eventos. Especifique esta opción con el formatohost:puerto si se utiliza un puerto distinto del puerto 94.

–O operador1;operador2;...Lista de operadores que se desea importar, separados por caracteres de dospuntos.

–p contraseñaContraseña del inicio de sesión especificado en el argumento –u.

–u usuarioInicio de sesión del administrador de Tivoli.

–x e | r | cModo de resolución de los nombres de objeto conflictivos. Utilice –x e paraemplear el objeto existente (consola, grupo de eventos u operador), –x rpara sustituir el objeto existente por el nuevo o –x c para cambiar elnombre del objeto añadiendo un número al nuevo objeto. Los indicadoresson sensibles a las mayúsculas y minúsculas. El espacio entre el argumentoy el indicador es opcional.

Ejemplos1. El ejemplo siguiente lleva a cabo la importación como el usuario root en el

servidor de eventos mica. Se indican los operadores, las consolas y los gruposde eventos que se van a importar y los valores exportados se incluyen en unarchivo denominado export_file. Los operadores, las consolas y los grupos deeventos existentes se sustituirán en caso de que se produzca un conflicto denombres.wtecimport.cmd -h mica -u root -p tivoli \-O mfoster:mbock -c personnel:finance \-e Adap_NT:Adap_Unix_Logfile:DM_NT:DM_Unix \-f export_file -x r

2. El ejemplo siguiente importa todas las consolas, los grupos de eventos y losoperadores incluidos en export_file. Una vez más, la importación se lleva acabo como el usuario root en el servidor de eventos mica. Los operadores, lasconsolas y los grupos de eventos existentes se sustituirán en caso de que seproduzca un conflicto de nombres.wtecimport.cmd -h mica -u root -p tivoli -f export_file -x r

Véase tambiénwtecexport


wtouchac

Actualiza la hora de modificación de un registro de perfil de configuración deadaptador (ACP) para forzar la redistribución.

Sintaxiswtouchac clave... perfil

DescripciónEl comando wtouchac actualiza la indicación de la hora en uno o varios registrosde un ACP. La actualización fuerza la distribución de los registros la próxima vezque se solicite una distribución desde la GUI de ACF (Adapter ConfigurationFacility) o mediante el comando wdist cuando no se especifique la opción de copiaexacta.

Como en las configuraciones de adaptadores intervienen otros archivos que noestán directamente controlados por el mecanismo de perfiles en Tivoli Enterprise,el hecho de que un registro deba redistribuirse debido a que un archivo auxiliar hacambiado no es evidente para la aplicación. Por lo tanto, se utiliza el comandowtouchac cuando ha cambiado un archivo auxiliar pero no el registro.

Autorizaciónadmin

Opcionesclave... Claves de uno o varios registros. Cada registro se leerá y se volverá a

escribir. Separe las diversas claves con un espacio. Puede ver el valor declave en la parte superior derecha del panel de entrada de ACP o medianteel comando wlsac.

perfil Perfil de configuración de adaptador que se verá afectado. Si el nombrecontiene espacios, escriba todo el nombre entre comillas.

EjemplosEl ejemplo siguiente actualiza la indicación de la hora de la entrada de ACPalmacenada en la clave 1 del perfil ACP_Profile:wtouchac 1 @ACP:ACP_Profile

El ejemplo siguiente actualiza la indicación de la hora de la entrada de ACPalmacenada en la clave 1 del perfil ACP Profile (que contiene un espacio en elnombre):wtouchac 1 @"ACP:ACP Profile"

Véase tambiénwdistrib (en la publicación ), waddac


Capítulo 2. Tareas

Este capítulo describe las tareas predefinidas proporcionadas en la biblioteca detareas del producto Tivoli Enterprise Console. El nombre real de esta biblioteca detareas es T/EC Tasks, que aparece en los diálogos de tareas y se utiliza cuando seespecifica la biblioteca de tareas desde una línea de comandos. Existen tres tipos detareas de Tivoli Enterprise Console:

Tareas de consolaEstas tareas se configuran y ejecutan de inmediato desde el visor deeventos. Si una tarea de consola requiere algún valor de atributo de evento,seleccione el evento deseado en la cola de trabajo del visor de eventos paraasociar el evento a la tarea.

Tareas automáticasEstas tareas se configuran con antelación y se ejecutan automáticamentecuando se recibe un evento determinado con los atributos y las clases deeventos especificados en la consola donde se ha visualizado el evento. Lastareas automáticas se configuran con el menú desplegable Tareasautomáticas en el visor de eventos.

Tareas de base de reglasEstas tareas se ejecutan cuando forman parte de una acción para una reglaque se ha desencadenado. Los predicados de lenguaje de reglas exec_tasky exec_task_local se utilizan para ejecutar las tareas de base de reglas. Lastareas de base de reglas también se conocen como respuestas automáticas.Para obtener información sobre la ejecución de tareas a partir de reglas,consulte la publicación Tivoli Enterprise Console Guía del generador de reglas.

Una tarea es un script, que normalmente ejecuta otros comandos de Tivoli. Losvalores de las variables se pasan a una tarea en el momento de la ejecución. Losvalores de las variables pueden proceder de las opciones y los argumentos que seespecifiquen o de los atributos de eventos disponibles para la tarea. Para las tareasde consola que necesitan que los atributos de un evento estén disponibles, debeasociar el evento con la tarea seleccionando el evento en la consola de eventos. Lasopciones y los argumentos que se especifican para las tareas se describen en estecapítulo. Los atributos de eventos disponibles para las tareas se describen en elCapítulo 3, “Variables de entorno disponibles para las tareas” en la página 147.

Los procedimientos para configurar tareas desde una consola de eventos sedescriben en la ayuda en línea de la consola actual.

En el cuadro de diálogo Tareas automáticas, puede definir o modificar laspropiedades siguientes:v Nombrev Descripciónv Cuando un evento coincide conv Ejecutar estas tareas

Cuando una tarea automática finaliza, emite información sobre el éxito o error dela ejecución, y muestra los resultados generados por la misma. Cuando una tareaautomática finaliza, en la primera columna del visor de eventos se muestra elicono de finalización de tarea. Puede hacer clic en el icono de la columna para ver


detalles acerca del resultado de las tareas automáticas. Estos detalles no siguenmostrándose una vez reiniciada la consola.

El resultado de las tareas automáticas también se puede escribir en un archivo detexto, que se configura en el diálogo Propiedades de consola para cada consola. Sidesea obtener más información sobre la ejecución de la función de tareasautomáticas desde la consola de eventos, consulte las entradas Tarea automáticaque se proporcionan en la ayuda en línea.

Al ejecutar una tarea de base de reglas, sólo se emite información sobre el éxito, elerror y el resultado de la tarea si el estado de inspección es YES. De lo contrario,no se visualiza ninguna información sobre la tarea en la consola. Si el estado deinspección es YES, en la primera columna del visor de eventos se muestra el iconode finalización de tarea cuando la tarea finaliza. Puede hacer clic en el icono deesta columna para ver detalles acerca del resultado de las tareas de base de reglas.Estos detalles siguen mostrándose una vez reiniciada la consola.

Puede configurar y ejecutar todas las tareas mediante los diálogos de la consola deeventos. Puede configurar y ejecutar la mayor parte de las tareas desde la línea decomandos. Para obtener información sobre cómo acceder a los diálogosrelacionados con las tareas de Tivoli Enterprise Console, consulte la publicaciónTivoli Enterprise Console Guía del usuario.

El comando wruntask de Tivoli Management Framework se utiliza para configurary ejecutar tareas de consola desde la línea de comandos y se muestra en todos losejemplos de este capítulo. También es posible que una acción de una regla deTivoli Enterprise Console ejecute tareas.

Nota: el término configurar en este capítulo significa especificar los parámetros deentrada y las opciones de ejecución de las tareas de Tivoli EnterpriseConsole, y en el caso de una tarea automática definir un nombre para latarea, definir las restricciones de evento para emparejar los campos deevento a fin de desencadenar la acción de la tarea y definir el nombre de latarea que se debe ejecutar si se cumplen las restricciones de evento.

Nombres y scripts de tareasLa tabla siguiente:v Muestra una lista de las tareas tanto con los nombres de tareas como con los

nombres descriptivos correspondientes. Los nombres de tareas se utilizan desdela línea de comandos para identificar las tareas. Puede ver los nombres de tareaso los nombres descriptivos en el diálogo Tareas T/EC del escritorio de Tivoliseleccionando y deseleccionando el cuadro de selección Mostrar poridentificadores para consultar los nombres de tareas en el visor de eventos.

v Muestra una lista de los nombres de archivo de los scripts de tareas. Estosscripts se encuentran en el directorio$BINDIR/../generic_unix/TAS/TASK_LIBRARY/bin/tmr_number. Si esnecesario, puede modificar estos scripts.

v Indica si puede ejecutar la tarea desde la línea de comandos. Determinadastareas necesitan tener disponibles los atributos de un evento. No puede ejecutaruna tarea que necesite tener disponibles los atributos de un evento desde la líneade comandos.


Nombre de la tarea Nombre descriptivo Nombre de archivo Línea de comandos

Change_Severity Cambiar gravedad deevento

T_EC_Tasks_C_zonctxba

No

Clean_Database Borrar el contenido dela base de datos deTivoli EnterpriseConsole

T_EC_Tasks_C_hmmeleka

Sí

Clear_Closed_Events Borrar eventos cerrados T_EC_Tasks_C_onyloafa

Sí

Clear_Reception_Log Borrar registro derecepción

T_EC_Tasks_C_rgetpzda

Sí

Close_Event Cerrar evento T_EC_Tasks_C_ylzejuna

No

Dump_Event_Repository Volcar repositorio deeventos

T_EC_Tasks_D_ckqiqpka

Sí

Event_Query Consultar repositorio deeventos

T_EC_Tasks_E_wkxovwka

Sí

Find_Similar_Events Buscar eventocoincidente

T_EC_Tasks_F_lozglmea

No

Forward_Event Reenviar evento aservidor TEC

T_EC_Tasks_F_dpstmska

No

Log_Event_To_File Registrar evento enarchivo

T_EC_Tasks_L_jfugucca

No

Popup_Message Mensaje emergente en elescritorio

T_EC_Tasks_P_rsoomfna

Sí

Send_Email Información de eventos T_EC_Tasks_S_rsnlpxda

No

Send_Event Enviar evento a servidorT/EC

T_EC_Tasks_P_lwqpwqla

Sí

Wake_Up_Netscape Ir a URL con nuevaventana de Netscape

T_EC_Tasks_W_mnnqzlga

Sí

Salida de la tareaCuando una tarea finaliza, emite información sobre el éxito o error de ejecución dela misma, así como los resultados generados por la tarea (por ejemplo, losresultados de una consulta de la base de datos de eventos). En el caso de las tareasque se ejecutan desde el visor de eventos, se visualiza un diálogo de salida de latarea con esta información.

Para las tareas que se ejecutan desde la línea de comandos, se escribe el mismonivel de información en stdout y stderr. Para las tareas automáticas, puedenvisualizarse los resultados con el evento relacionado que ha desencadenado latarea. También se puede configurar la tarea para guardar los resultados en unarchivo de registro. Para las tareas de base de reglas, la consola puede visualizarlos resultados; los resultados también se almacenan en la base de datos.

Capítulo 2. Tareas 123

Sintaxis de la línea de comandosLa sintaxis correspondiente a las tareas que puede emitir desde la línea decomandos utiliza los siguientes caracteres especiales:

[ ] Identifica un valor de argumento opcional. Los valores que no estándelimitados por corchetes son obligatorios.

... Indica que puede especificar varios valores para el argumento.

| Indica valores de argumentos que se excluyen mutuamente. Debe utilizaruno de los valores.

{ } Delimita un conjunto de valores de argumentos que se excluyenmutuamente cuando uno de los valores es obligatorio.

Nota: delimite los valores de argumentos que tienen espacios intercalados concomillas simples o dobles.

Por ejemplo:

wruntask –tSend_Event –l″T/EC Tasks″ –hnodo–a{servidor_eventos | ″″}–a{mensaje | ″″}–a{nombre_host | ″″}–a {origen | ″″}–a {gravedad |″″}–a {suborigen | ″″}–a {subfuente | ″″}–a clase_evento–a fuente

Todos los argumentos para ejecutar esta tarea son obligatorios, en el ordenmostrado. Los argumentos –t y –l tienen valores específicos. El argumento –h tieneun valor de variable. Todos los argumentos –a deben tener un valor de variablereal o una área de retención de posición vacía (definida por los caracteres ″″).

Otro ejemplo es:

wruntask–t Event_Query–l ″T/EC Tasks″–h nodo–a{″clase[,clase...]″ |″*″}–a{″estado[,estado...]″| ″*″}–a{″gravedad[,gravedad...]″


| ″*″}–a {″nombre_host[,nombre_host...]″ | ″*″}–a {″fuente[,fuente...]″ | ″*″}–a {″subfuente[,subfuente...]″ | ″*″}–a {″origen[,origen...]″ | ″*″}–a {″suborigen[,suborigen...]″ | ″*″}–a {″mensaje″ | ″*″}–a {″punto_inicio″ | ″*″}–a orden_clasificación–a {″atributo[,atributo...]″ | ″*″]

Los argumentos como el primer argumento –a pueden tener más de un valor devariable (en este ejemplo, nombres de clases de eventos). Cada valor debesepararse con una coma. Si no especifica valores de variables reales, deberáemplear el carácter comodín de asterisco (*) (que indica todas las clases de eventosen este ejemplo). Igualmente en este ejemplo, se necesitan comillas para delimitarcada argumento –a.


Change_SeverityCambia la gravedad de un evento. La gravedad se cambia en el visor de eventos,la caché de eventos y el repositorio de eventos.

Esta tarea supone que el comando wsetemsg está disponible en el host donde seejecuta la tarea. El comando wsetemsg siempre está disponible en el host delservidor de eventos. Además, el servidor de eventos debe estar en ejecución paraque esta tarea se ejecute correctamente.

Autorizaciónsuper, senior, admin, user

Opciones de configuración de diálogoSeverity Nueva gravedad del evento. Los valores válidos son: Muy grave

(FATAL), Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING),Inocuo (HARMLESS) y Desconocido (UNKNOWN).

Sinopsis del comandoEsta tarea no puede ejecutarse desde la línea de comandos.


Clean_Database

Suprime eventos antiguos de la base de datos de eventos. Los eventos se suprimendel registro de recepción en función del valor establecido en el campo Duración dela información del registro de recepción de eventos del diálogo Parámetros delservidor de eventos del servidor de eventos. Los eventos cerrados del repositoriode eventos cuya antigüedad es superior al valor establecido para el campoDuración de eventos cerrados en la memoria caché del diálogo Parámetros delservidor de eventos se suprimen.

Esta tarea supone que el comando wtdbclear está disponible en el host donde seejecuta la tarea. El comando wtdbclear siempre está disponible en el host delservidor de eventos. Si se ha producido algún problema al ejecutar el comandowtdbclear, se emite un mensaje explicativo y el script finaliza de inmediato con uncódigo de retorno. La base de datos de eventos debe estar disponible. El servidorde eventos no tiene que estar en ejecución.

Nota: tras ejecutar esta tarea, los eventos antiguos suprimidos del repositorio deeventos no se eliminan de una consola de eventos hasta que se cierra yvuelve a abrir la consola. Los eventos antiguos de la caché de eventos no seeliminan hasta que se concluye y se reinicia el servidor de eventos, o hastaque los eventos antiguos alcanzan el valor de tiempo de espera establecido.

AutorizaciónRIM_update, RIM_view, super, senior, admin, user

Opciones de configuración de diálogoNo hay ninguna opción para esta tarea. Obtiene sus parámetros de los camposindicados en la descripción de la tarea.

Sinopsis del comandowruntask –t Clean_Database –l ″T/EC Tasks″ –h nodo

Argumentos del comando–t Clean_Database

Tarea que debe ejecutarse.

–l ″T/EC Tasks″Biblioteca de tareas.

–h nodo El nodo gestionado en el que debe ejecutarse la tarea.

Ejemplo del comandowruntask -t Clean_Database -l "T/EC Tasks" \-h orange


Clear_Closed_EventsSuprime los eventos cerrados del repositorio de eventos utilizando el valor deantigüedad especificado.

Esta tarea supone que el comando wtdbclear está disponible en el host donde seejecuta la tarea. El comando wtdbclear siempre está disponible en el host delservidor de eventos.

La base de datos de eventos debe estar disponible. El servidor de eventos no tieneque estar en ejecución.


Opciones de configuración de diálogoSegundos Periodo de tiempo, en segundos, tras el cual se suprimen los

eventos. Por ejemplo, el valor 60 indica que deben suprimirse loseventos cerrados con una antigüedad superior a 60 segundos.

Sinopsis del comandowruntask –t Clear_Closed_Events –l ″T/EC Tasks″ –h nodo –a segundos

Argumentos del comando–a segundos Periodo de tiempo de antigüedad de inicio, en segundos, de los

eventos que deben suprimirse.



–t Clear_Closed_EventsTarea que debe ejecutarse.

Ejemplo del comandowruntask -t Clear_Closed_Events -l "T/EC Tasks" \-h orange -a 6000


Clear_Reception_LogSuprime los eventos del registro de recepción que se han recibido hace más de 30segundos.

Esta tarea supone que el comando wtdbclear está disponible en el host donde seejecuta la tarea. El comando wtdbclear siempre está disponible en el host delservidor de eventos.



Opciones de configuración de diálogoNo hay ninguna opción para esta tarea.

Sinopsis del comandowruntask –t Clear_Reception_Log –l ″T/EC Tasks″ –h nodo

Argumentos del comando–h nodo El nodo gestionado en el que debe ejecutarse la tarea.


–t Clear_Reception_LogTarea que debe ejecutarse.

Ejemplo del comandowruntask -t Clear_Reception_Log -l "T/EC Tasks" \-h orange


Close_Event

Cambia el estado de un evento seleccionado por cerrado (CLOSED). El estado secambia en la consola de eventos, en la caché de eventos y en el repositorio deeventos.

Esta tarea supone que el comando wsetemsg está disponible en el host donde seejecuta la tarea. El comando wsetemsg siempre está disponible en el host delservidor de eventos. Además, el servidor de eventos debe estar en ejecución paraque esta tarea se ejecute correctamente.


Opciones de configuración de diálogoNo hay ninguna opción para esta tarea.



Dump_Event_RepositoryMuestra los detalles de los eventos del repositorio de eventos en el diálogo de lasalida de la tarea.

Esta tarea supone que el comando wtdumper está disponible en el host donde seejecuta la tarea. El comando wtdumper siempre está disponible en el host delservidor de eventos.


AutorizaciónRIM_view, super, senior, admin, user

Opciones de configuración de diálogo¿Orden ascendente o descendente?

Orden en que se listan los eventos en la salida. Las opciones son:

ASC Permite listar en primer lugar la entrada más antigua delrepositorio de eventos.

DESC Permite listar en primer lugar la entrada más reciente delrepositorio de eventos.

Número de eventosNúmero máximo de eventos que se visualizarán en la salida. Si el númerode eventos del repositorio de eventos supera el valor especificado, seomiten entradas a partir del final de la salida. Por ejemplo, si se visualizala salida en orden ascendente, las entradas más recientes de la base dedatos no se visualizan.

Sinopsis del comandowruntask –t Dump_Event_Repository –l ″T/EC Tasks″ –h nodo –aorden_clasificación –a número_eventos

Argumentos del comando–a número_eventos

Número máximo de eventos que se visualizarán en la salida. Si elnúmero de eventos de la base de datos supera el valorespecificado, se omiten entradas a partir del final de la salida. Porejemplo, si se visualiza la salida en orden ascendente, las entradasmás recientes de la base de datos no se visualizan.

–a orden_clasificaciónOrden en que se listan los eventos en la salida. Los valores válidosson:

ASC Permite listar en primer lugar la entrada más antigua delrepositorio de eventos.

DESC Permite listar en primer lugar la entrada más reciente delrepositorio de eventos.




–t Dump_Event_RepositoryTarea que debe ejecutarse.

Ejemplo del comandowruntask -t Dump_Event_Repository -l "T/EC Tasks" \-h orange -a ASC -a 10


Event_QueryConsulta el repositorio de eventos. Los resultados se muestran en el diálogo desalida de la tarea.

Esta tarea supone que el comando wtdumper está disponible en el host donde seejecuta la tarea. El comando wtdumper siempre está disponible en el host delservidor de eventos.



Opciones de configuración de diálogoPara las siguientes opciones de coincidencia (desde Emparejar clase hastaEmparejar mensaje), las selecciones que realice definirán los atributos y valoresque se emplearán para los criterios de selección de la consulta. Todas las opcionesle permiten especificar texto manualmente, incluido el carácter comodín deasterisco (*) si desea especificar todos los valores de un atributo. Si especificamanualmente varios valores para una opción, separe cada uno de ellos con unacoma. Algunas de las opciones también proporcionan un pulsador para visualizaruna lista desplegable en la que puede seleccionar uno o varios valores.

Emparejar claseClases de eventos.

Emparejar estadoEstado de eventos. Los nombres de estado válidos son: Abierto(OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado(CLOSED).

Emparejar gravedadGravedades de eventos. Los valores válidos son: Muy grave(FATAL), Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING),Inocuo (HARMLESS) y Desconocido (UNKNOWN).

Emparejar nombre de hostNombres de los sistemas donde se han producido los eventos.

Emparejar fuenteFuentes de los eventos (por ejemplo, LOGFILE es el nombre de lafuente correspondiente al adaptador de archivos de registro deUNIX). Una fuente viene definida por un tipo de adaptador.

Emparejar subfuenteEspecificaciones más detalladas de las fuentes.

Emparejar origenDirecciones de protocolo o nombres de host de los sistemas fuente.

Emparejar suborigenEspecificaciones más detalladas de los orígenes.

Emparejar mensajeUna o varias cadenas de texto de mensaje de los eventos. Si indicamás de un mensaje, debe especificar todo el valor de la opciónEmparejar mensaje entre un tipo de comillas (por ejemplo,


comillas dobles) y especificar cada uno de los mensajesindividuales entre un tipo de comillas distinto (por ejemplo,comillas simples) separados por una coma. Por ejemplo: "’msgtext1’,’msg text2’". Para especificar todos los mensajes, utilice elcarácter comodín *.

Fecha y hora de inicioEspecifica que deben consultarse los eventos recibidos desde estepunto hasta la actualidad. Para especificar un punto de inicio,utilice el formato siguiente: mesddhh:mm:ssaaaa. Por ejemplo, Jan 0100:01:01 2000. Para consultar todos los eventos, especifique elcarácter comodín *.

Orden de clasificaciónOrden en que se listan los resultados de la consulta en la salida.Los valores válidos son:

ASC Permite listar en primer lugar el evento más antiguo.

DESC Permite listar en primer lugar el evento más reciente.

Mostrar valores para atributosEspecifica qué atributos de eventos básicos se visualizarán en lasalida. Presione el botón Atributos... para ver una lista desplegablede los atributos de eventos básicos en la que puede efectuar laselección. Todos los atributos de eventos que no son básicossiempre se visualizarán. Si no selecciona ningún atributo, todos losatributos (básicos y no básicos) se visualizarán en la salida.

Sinopsis del comandowruntask–t Event_Query–l ″T/EC Tasks″–h nodo–a{″clase[,clase...]″ | ″*″}–a {″estado[,estado...]″ | ″*″}–a {″gravedad[,gravedad...]″ | ″*″}–a {″nombre_host[,nombre_host...]″ | ″*″}–a {″fuente[,fuente...]″ | ″*″}–a {″subfuente[,subfuente...]″ | ″*″}–a {″origen[,origen...]″ | ″*″}–a {″suborigen[,suborigen...]″ | ″*″}–a {″’mensaje’[,’mensaje’...]″ | ″*″}–a {″punto_inicio″ | ″*″}–a orden_clasificación–a {″atributo[,atributo...]″ | ″*″]

Argumentos del comando–a ″clase...″ Uno o varios nombres de clases de eventos. Si especifica más de

una clase, separe cada uno de los nombres con una coma sin dejarningún espacio intercalado. Para especificar todas las clases deeventos, utilice el carácter comodín *. Para obtener másinformación sobre los nombres de clases de eventos, consulte lapublicación Guía del adaptador de Tivoli Enterprise Console o losarchivos BAROC correspondientes a los adaptadores que generanlos eventos.


–a ″estado...″ Uno o varios nombres de estado de evento. Si especifica más de unestado, separe cada uno de los nombres con una coma sin dejarningún espacio intercalado. Para especificar todos los nombres deestados de eventos, utilice el carácter comodín *. Los nombres deestado válidos son: Abierto (OPEN), Confirmado (ACK),Respondido (RESPONSE) y Cerrado (CLOSED).

–a ″gravedad...″ Uno o varios nombres de gravedad de evento. Si especifica más deuna gravedad, separe cada uno de los nombres con una coma sindejar ningún espacio intercalado. Para especificar todos losnombres de gravedad de evento, utilice el carácter comodín *. Losnombres de gravedad válidos son: Muy grave (FATAL), Crítico(CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo(HARMLESS) y Desconocido (UNKNOWN).

–a ″nombre_host...″Uno o varios nombres de los sistemas donde se han producido loseventos. Si especifica más de un host, separe cada uno de losnombres con una coma sin dejar ningún espacio intercalado. Paraespecificar todos los nombres de host, utilice el carácter comodín *.

–a ″fuente...″ Una o varias fuentes de eventos (por ejemplo, LOGFILE es elnombre de la fuente correspondiente al adaptador de archivos deregistro de UNIX). Una fuente viene definida por un tipo deadaptador. Si especifica más de una fuente, separe cada una deellas con una coma sin dejar ningún espacio intercalado. Paraespecificar todas las fuentes, utilice el carácter comodín *.

–a ″subfuente...″Una o varias subfuentes de los eventos. Una subfuente es unaespecificación más detallada de una fuente. Si especifica más deuna subfuente, separe cada uno de ellas con una coma sin dejarningún espacio intercalado. Para especificar todas las subfuentes,utilice el carácter comodín *.

–a ″origen...″ Una o varias direcciones de protocolo o nombres de host de lossistemas fuente. Si especifica más de un origen, separe cada uno deellos con una coma sin dejar ningún espacio intercalado. Paraespecificar todos los orígenes, utilice el carácter comodín *.

–a ″suborigen...″Uno o varios suborígenes de los eventos. Un suborigen es unaespecificación más detallada de un origen. Si especifica más de unsuborigen, separe cada uno de ellos con una coma sin dejar ningúnespacio intercalado. Para especificar todos los suborígenes, utiliceel carácter comodín *.

–a ″’mensaje...’″Una o varias cadenas de texto de mensaje de los eventos. Delimitecada mensaje individual con un tipo de comillas distinto al quedelimita todo el valor del argumento –a; es decir, si todo el valordel argumento está especificado entre comillas dobles (como semuestra en la sinopsis), escriba cada uno de los mensajesindividuales entre comillas simples. Por ejemplo: -a "’msgtext1’,’msg text2’". Para especificar todos los mensajes, utilice elcarácter comodín *.

–a ″punto_inicio″Especifica que deben consultarse los eventos recibidos desde estepunto hasta la actualidad. Para especificar un punto de inicio,


utilice el formato siguiente: mesddhh:mm:ssaaaa. Por ejemplo, Jan 0100:01:01 2000. Para consultar todos los eventos, utilice el caráctercomodín *.

–a ″orden_clasificación″Orden en que se listan los resultados de la consulta en la salida.Los valores válidos son:

ASC Permite listar en primer lugar el evento más antiguo.

DESC Permite listar en primer lugar el evento más reciente.


–a ″atributo...″ Especifica uno o varios atributos de eventos básicos que sevisualizarán en la salida. Todos los atributos de eventos que no sonbásicos siempre se visualizarán. Si especifica más de un atributo,separe cada uno de ellos con una coma sin dejar ningún espaciointercalado. Para especificar todos los atributos, utilice el caráctercomodín *.


–t Event_QueryTarea que debe ejecutarse.

Ejemplo del comandowruntask -t Event_Query -l "T/EC Tasks" -h orange \-a "TEC_Notice" -a "*" -a "*" -a "*" -a "TEC" \-a "*" -a "*" -a "*" -a "*" -a "*" -a ASC \-a "server_handle,date_reception,event_handle"


Find_Similar_EventsConsulta el repositorio de eventos utilizando un evento para comparar atributos.Los resultados se muestran en el diálogo de salida de la tarea.

Debe seleccionar el evento en el visor de eventos antes de configurar esta tarea.Esta tarea supone que el comando wtdumper está disponible en el host donde seejecuta la tarea. El comando wtdumper siempre está disponible en el host delservidor de eventos.

La base de datos de eventos debe estar disponible. Además, el servidor de eventosdebe estar en ejecución para que esta tarea se ejecute correctamente.


Opciones de configuración de diálogoPara las siguientes opciones de coincidencia (desde Emparejar clase hastaEmparejar mensaje), al seleccionar el botón de selección Sí se indica que debeutilizarse el atributo del evento seleccionado para realizar las comparaciones conlos mismos atributos de los eventos de la base de datos. Al seleccionar el botón deselección No se especifica no utilizar el atributo del evento seleccionado pararealizar las comparaciones.

Emparejar claseClase de evento.

Emparejar estadoEstado del evento. Los nombres de estado válidos son: Abierto(OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado(CLOSED).

Emparejar gravedadGravedad del evento. Los valores válidos son: Muy grave (FATAL),Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo(HARMLESS) y Desconocido (UNKNOWN).

Emparejar nombre de hostNombre del sistema en el que se ha producido el evento.

Emparejar fuenteFuente del evento.

Emparejar subfuenteEspecificación más detallada de la fuente.

Emparejar origenDirección de protocolo o nombre de host del sistema fuente.

Emparejar suborigenEspecificación más detallada del origen.

Emparejar mensajeTexto de mensaje del evento.

Fecha y hora de inicioEspecifica que deben consultarse los eventos recibidos desde estepunto hasta la actualidad. Para especificar un punto de inicio,


utilice el formato siguiente: mesddhh:mm:ssaaaa. Por ejemplo, Jan 0100:01:01 2000. Para consultar todos los eventos, especifique unasterisco (*).

Orden de clasificaciónOrden en que se listan los resultados de la consulta en la salida.Los valores válidos son:

AscendentePermite listar en primer lugar el evento más antiguo.

DescendentePermite listar en primer lugar el evento más reciente.

Mostrar valores para atributosEspecifica qué atributos de eventos básicos se visualizarán en lasalida. Presione el botón Atributos... para ver una lista desplegablede los atributos de eventos básicos en la que puede efectuar laselección. Todos los atributos de un evento que no es básicosiempre se visualizarán. Si no selecciona ningún atributo, todos losatributos se visualizarán en la salida.



Forward_EventReenvía un evento a otro servidor de eventos registrado en la región de gestión deTivoli (TMR) actual.

Esta tarea supone que el comando wpostemsg está disponible en el host donde seejecuta la tarea. El comando wpostemsg siempre está disponible en el host delservidor de eventos.


Opciones de configuración de diálogoNombre del servidor de eventos

Servidor de eventos que debe recibir el evento reenviado. Puede escribirun nombre manualmente o seleccionarlo en una lista desplegable deservidores de eventos conocidos pulsando el botón Elegir.... El servidor deeventos local se denomina EventServer. Para especificar un servidor deeventos remoto, escriba EventServer#tmr, donde tmr es el nombre de laTMR en la que se encuentra el servidor de eventos remoto; por ejemplo,EventServer#orange-region.



Log_Event_To_FileEscribe en un archivo detalles acerca de un evento.

Autorizaciónsuper, senior, admin

Opciones de configuración de diálogoNombre de archivo de registro

Ruta y nombre del archivo en el que se escribirá la información del evento.Puede escribir manualmente una ruta y un nombre de archivo o pulsar elbotón Nombre de archivo de registro para visualizar un diálogo deexplorador de archivos.



Popup_MessageVisualiza un mensaje en el escritorio de un operador.

Esta tarea supone que el comando wsendresp está disponible en el host donde seejecuta la tarea. El comando wsendresp siempre está disponible en el host delservidor de eventos. Además, el visor de eventos que recibe el mensaje debe estaren ejecución para que esta tarea se ejecute correctamente.


Opciones de configuración de diálogoNombre de operador

Nombre del operador que recibirá el mensaje. Puede escribir estevalor manualmente o pulsar el botón Operador para ver una listadesplegable de los operadores conocidos.

Nombre de archivoRuta y nombre del archivo que contiene el texto de mensaje que sevisualizará. Puede escribir manualmente una ruta y un nombre dearchivo.

Nodo gestionadoEl nodo gestionado en el que debe ejecutarse la tarea.

Sinopsis del comandowruntask –t Popup_Message –l ″T/EC Tasks″ –h nodo –a administrador –a ruta

Argumentos del comando–a administrador

Nombre de la consola de eventos del administrador de Tivoli querecibirá el mensaje.

–a ruta Ruta y nombre del archivo que contiene el texto de mensaje que sevisualizará. Para especificar un host remoto en el que se encuentrael archivo, utilice el formato: nombre_host:ruta; por ejemplo,red:/tmp/msg.txt.



–t Popup_MessageTarea que debe ejecutarse.

Ejemplo del comandowruntask -t Popup_Message -l "T/EC Tasks" \-h orange -a Root_orange-region \-a /tmp/msg.txt


Send_EmailEnvía detalles en un mensaje de correo electrónico acerca de un evento. Puedeejecutarse desde el visor de eventos o a partir de una regla.

Esta tarea supone que el comando sendmail está disponible en los hosts UNIX yLinux y que el programa $BINDIR/bin/smtp_client.exe está disponible en loshosts Windows NT.

Antes de que se pueda ejecutar esta tarea, debe establecerse un servidor de correoSMTP con el comando wmailhost

. Para obtener más información, consulte la publicación Tivoli ManagementFramework Reference Manual

.


Opciones de configuración de diálogoNombre del administrador

Nombre de la persona que recibirá el mensaje. El nombre apareceen el campo Para: del mensaje de correo electrónico.

Dirección de correo electrónico del administradorIdentificador de correo electrónico de la persona que debe recibir elmensaje.



Send_EventCrea un evento nuevo y lo envía al servidor de eventos especificado registrado enla TMR (región de gestión de Tivoli) actual.

Esta tarea supone que el comando wpostemsg está disponible en el host donde seejecuta la tarea. El comando wpostemsg siempre está disponible en el host delservidor de eventos y los puntos finales que tienen instalado un adaptador deeventos.


Opciones de configuración de diálogoSólo requieren valores las opciones NOMBRE_CLASE y FUENTE. Las demás sonopcionales, lo que significa que puede dejar en blanco las que desee. Aunque lasdeje en blanco, el proceso del servidor de eventos asignará valorespredeterminados.

Nombre del servidor de eventosServidor de eventos que debe recibir el evento. Puede escribir unnombre manualmente o seleccionarlo en una lista desplegable deservidores de eventos conocidos pulsando el botón Elegir.... Elservidor de eventos local se denomina EventServer. Paraespecificar un servidor de eventos remoto, escribaEventServer#tmr, donde tmr es el nombre de la TMR en la que seencuentra el servidor de eventos remoto; por ejemplo,EventServer#orange-region. Si no se especifica ningún valor paraesta opción, se utiliza EventServer como valor predeterminado.

mensaje Texto de mensaje del evento.

nombre_host Nombre del sistema en el que se ha producido el evento.

origen Dirección de protocolo o nombre de host del sistema fuente.

gravedad Gravedad del evento. Las gravedades válidas son: Muy grave(FATAL), Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING),Inocuo (HARMLESS) y Desconocido (UNKNOWN).

suborigen Especificación más detallada del origen.

subfuente Especificación más detallada de la fuente.

NOMBRE_CLASEClase de evento. Esta opción requiere un valor. Para obtener másinformación sobre los nombres de clases de eventos, consulte lapublicación Guía del adaptador de IBM Tivoli Enterprise Console o elarchivo BAROC de un adaptador específico.

FUENTE Fuente del evento (por ejemplo, LOGFILE es el nombre de lafuente correspondiente al adaptador de archivos de registro deUNIX). La fuente viene definida por el tipo de adaptador. Estaopción requiere un valor.

Sinopsis del comandoSólo los argumentos –a clase_evento y –a fuente requieren valores reales. Los valoresde los demás argumentos son opcionales; esto significa que no es necesario queespecifique un valor para el argumento, pero puede seguir especificando el


indicador del argumento con una área de retención de posición vacía, como porejemplo –a ″″. Si lo desea, puede sustituir los pares de comillas dobles mostradospor pares de comillas simples.

wruntask–t Send_Event–l ″T/EC Tasks″–h nodo–a{servidor_eventos |″″}–a {mensaje |″″}–a {nombre_host| ″″}–a {origen | ″″}–a{gravedad |″″}–a {suborigen | ″″}–a {subfuente | ″″}–a clase_evento–a fuente

Argumentos del comando–a servidor_eventos

Servidor de eventos que debe recibir el evento. El servidor deeventos local se denomina EventServer. Para especificar unservidor de eventos remoto, escriba EventServer#tmr, donde tmr esel nombre de la TMR en la que se encuentra el servidor de eventosremoto; por ejemplo, EventServer#orange-region. Si no seespecifica ningún servidor de eventos para este argumento, seutiliza EventServer como valor predeterminado.

–a mensaje Texto de mensaje del evento. Si el texto de mensaje contieneespacios intercalados, delimítelo mediante comillas.

–a nombre_host Nombre del sistema en el que se ha producido el evento.

–a origen Dirección de protocolo o nombre de host del sistema fuente.

–a gravedad Gravedad del evento. Las gravedades válidas son: Muy grave(FATAL), Crítico (CRITICAL), Leve (MINOR), Aviso (WARNING),Inocuo (HARMLESS) y Desconocido (UNKNOWN).

–a suborigen Suborigen del evento. Un suborigen es una especificación másdetallada de un origen.

–a subfuente Subfuente del evento. Una subfuente es una especificación másdetallada de una fuente.

–a clase Nombre de clase de evento. Este argumento requiere un valor. Paraobtener más información sobre los nombres de clases de eventos,consulte la publicación Guía del adaptador de IBM Tivoli EnterpriseConsole o el archivo BAROC de un adaptador específico.

–a fuente Fuente del evento (por ejemplo, LOGFILE es el nombre de la


fuente correspondiente al adaptador de archivos de registro deUNIX). Una fuente viene definida por un tipo de adaptador. Esteargumento requiere un valor.



–t Send_Event Tarea que debe ejecutarse.

Ejemplo del comandowruntask -t Send_Event -l "T/EC Tasks" -h orange \-a EventServer -a "Test for UNIX Logfile Event" \-a redhost -a 123.11.1.14 -a FATAL \-a "" -a "" -a Kernal_Panic -a LOGFILE


Wake_Up_NetscapeMuestra una página web en una ventana nueva del navegador Netscape.

Esta tarea supone que ya hay un proceso del navegador Netscape en ejecución enel host donde se ejecuta la tarea.


Opciones de configuración de diálogoURL a visualizar

Dirección del localizador uniforme de recursos (URL) de la página webque se debe visualizar.

Ruta de NetscapeRuta predeterminada del directorio donde está instalado Netscape en elhost donde se ejecuta la tarea. El valor predeterminado es /usr/local/bin.

Nota: para Windows NT, la variable de entorno PATH debe establecersede modo que contenga el directorio donde está instalado Netscape.Para UNIX, si Netscape no está instalado en el directorio/usr/local/bin, la variable de entorno PATH debe establecerse demodo que contenga el directorio donde está instalado Netscape.

Sinopsis del comandowruntask –t Wake_Up_Netscape –l ″T/EC Tasks″ –h nodo –a url

Nota: si su host está configurado como punto final y nodo gestionado a la vez, ydesea que la tarea se ejecute en el entorno del nodo gestionado, debe utilizarla sintaxis @ManagedNode. Para obtener más información, consulte lapublicación Tivoli Management Framework Reference Manual.

Argumentos del comando–a url URL de la página web que se debe visualizar.


–l T/EC Tasks Biblioteca de tareas.

–t Wake_Up_NetscapeTarea que debe ejecutarse.

Ejemplo del comandowruntask -t Wake_Up_Netscape -l "T/EC Tasks" \-h orange -a http://www.tivoli.com


Capítulo 3. Variables de entorno disponibles para las tareas

Este capítulo describe las variables de entorno disponibles para los programas y lastareas de Tivoli Enterprise Console que se ejecutan con un evento. Puedeespecificar restricciones de valores de atributos para las tareas que se ejecutan conun evento.

Descripciones de las variablesLa tabla siguiente describe las variables de entorno disponibles para los programas,las tareas de consola y las tareas automáticas que se ejecutan con un evento. Estáorganizada del modo siguiente:

Nombre Nombre de la variable de entorno.

Descripción Breve descripción de la variable de entorno.

Disponible paraUna X en alguna de las cuatro subcolumnas situadas bajo estacolumna significa que la variable de entorno está disponible paralas tareas de consola, los programas de consola, las tareas de basede reglas o los programas de base de reglas.

Las variables de entorno que representan atributos de eventos figuran tras lasvariables de entorno generales, en la sección de la tabla titulada Atributos deeventos. Ambas secciones de la tabla aparecen en orden alfabético dentro de cadasección.


Nombre Descripción

Disponible para

Tare

asd

eco

nso

la

Pro

gram

asd

eco

nso

la

Tare

asd

eb

ase

de

regl

as

Pro

gram

asd

eb

ase

de

regl

as

CHILD_OF_OSERV Indica al proceso secundario que es unproceso secundario del proceso oserv ypermite al proceso secundario tomar losdos atajos siguientes:

v No es necesario que vuelva a efectuar laautenticación con el proceso oserv yaque el proceso oserv ha creadocredenciales al crear el procesosecundario.

v No es necesario que inicie una conexiónnueva con el proceso oserv ya que elproceso oserv ha creado un par dezócalo o conducto para comunicarse conel proceso secundario al crear el procesosecundario.

X X

CONSOLE_NAME Nombre de la consola de eventos desdedonde se ha invocado la tarea.

X

DISPLAY Variable de UNIX que controla lavisualización del servidor X.

X

ENDPOINT Nodo donde se ejecuta la tarea. X X

ENDPOINT_OID Identificador de objeto de la ubicacióndonde se ejecuta la tarea.

X X

EVENT_CLASS Clase de evento pasada al predicadoexec_task.

X X

INTERP Tipo de arquitectura de la máquina dondeestá instalado el nodo.

X X X

LANG Identificador del entorno nacional. X X X

LD_LIBRARY_PATH Ruta de las bibliotecas compartidas en losintérpretes solaris2 y sunos4.

X X

LIBPATH Ruta de las bibliotecas compartidas enAIX.

X X

NLSPATH Ruta del directorio empleado por lasaplicaciones para determinar el idioma.

X X X

PATH Ruta de búsqueda de archivos. X X X

PRINCIPAL Usuario de Tivoli que ejecuta la tarea.

SHLIB_PATH Ruta de las bibliotecas compartidas enOpenView.

X X

SLOTS Atributos de evento del evento asociado ala tarea.

X X X X


Nombre Descripción

Disponible para

Tare

asd

eco

nso

la

Pro

gram

asd

eco

nso

la

Tare

asd

eb

ase

de

regl

as

Pro

gram

asd

eb

ase

de

regl

as

TEC_BIN_DIR Directorio donde está instalado elproducto Tivoli Enterprise Console.

X X X

TEC_KB_DIR Ubicación de la base de reglas cargada enel directorio $DBDIR.

X X

TEC_MASTER_PORT Puerto que el proceso tec_server utilizapara comunicarse.

X X

TEC_MASTER_START_TIMEOUT

Número de segundos para la inicializacióndel servidor de eventos.

X X

TEC_RECV_BUFSIZE Número máximo de eventos colocados enel búfer de la memoria del servidor deeventos.

X X

TEC_RECV_LOG Indica si se debe registrar la recepción deeventos en el servidor de eventos.

X X

TEC_RULE_CACHE_CLEAN_FREQ

Frecuencia de depuración, en segundos, delos eventos caducados de la caché dereglas.

X X

TEC_RULE_CACHE_FULL_HISTORY

Periodo de tiempo, en segundos, duranteel cual los eventos cerrados debenconservarse en la caché de reglas.

X X

TEC_RULE_CACHE_NON_CLOSED_HISTORY

Periodo de tiempo, en segundos, duranteel cual los eventos no cerrados debenconservarse en la caché de reglas.

X X

TEC_RULE_CACHE_SIZE

Número máximo de eventos almacenadosen la caché de eventos.

X X

TEC_RULE_TRACE Indica si el proceso de reglas generainformación de rastreo.

X X

TEC_RULE_TRACE_FILE

Archivo que contiene la información derastreo de reglas.

X X

TISDIR Directorio para los archivoscorrespondientes a la internacionalizaciónde Tivoli.

X X X

TZ Huso horario. X X X

WLOCALHOST Nombre del nodo tal como Tivoli loconoce.

X X X

Atributos de eventos

acl Lista de roles de grupo de eventos quepermite a un operador modificar el evento.

X X X X

adapter_host Host en el que se ejecuta el adaptador. X X X X

Capítulo 3. Variables de entorno disponibles para las tareas 149

Nombre Descripción

Disponible para

Tare

asd

eco

nso

la

Pro

gram

asd

eco

nso

la

Tare

asd

eb

ase

de

regl

as

Pro

gram

asd

eb

ase

de

regl

as

administrator Operador que ha confirmado o cerrado elevento.

X X X X

cause_date_reception El atributo cause_date_reception se utilizapara enlazar un evento de efecto con suevento de causa. Este valor se establece enel valor del atributo date_reception delevento de causa.

X X X X

cause_event_handle Se utiliza para enlazar un evento de efectocon un evento de causa y contiene el valordel atributo event_handle del evento decausa.

X X X X

class Nombre de clase de evento. X X

class_name Nombre de clase de evento. X X X

credibility Indica cómo se ha enviado el evento desdeel adaptador. El valor es 1 si un evento seha enviado empleando un canal decomunicaciones proporcionado por losservicios de Tivoli ManagementFramework o un adaptador TME. El valores 0 si el evento se ha enviado desde unadaptador que no es de TME.

X X X X

date Fecha y hora en que se ha generado elevento.

X X

date_event Fecha y hora en que se ha generado elevento.

X X

date_reception Indicación de la hora que muestra la horaen que el servidor de eventos ha recibidoel evento. Es un entero que representa elnúmero de segundos transcurridos desdela indicación de la hora cero (epoch), quees el 1 de enero de 1970. Este valortambién se utiliza como un componentepara identificar un evento de formaexclusiva. Un evento se identifica de formaexclusiva mediante una combinación delos valores de los atributos date_reception,event_handle y server_handle.

X X X X


Nombre Descripción

Disponible para

Tare

asd

eco

nso

la

Pro

gram

asd

eco

nso

la

Tare

asd

eb

ase

de

regl

as

Pro

gram

asd

eb

ase

de

regl

as

duration En el caso de los eventos cerrados,antigüedad (en segundos) del eventodesde que el servidor de eventos lo harecibido hasta que se ha cerrado. Paratodos los eventos no cerrados, el valor es0.

X X X X

ev_key Identificador de evento formado por losvalores de los atributos event_handle,server_handle y date_reception.

X

event_handle Número empleado para hacer referencia alevento. El servidor de eventos asigna estenúmero.

X X X X

event_hndl Número empleado para hacer referencia alevento. El servidor de eventos asigna estenúmero.

X X

hostname Nombre del sistema en el que se haproducido el evento.

X X X X

last_modified_time Hora en que se ha modificado el eventopor última vez.

X X

msg Resumen de texto del evento. X X X X

msg_catalog Para el soporte futuro de los mensajes deeventos internacionalizados; no estáimplementado en la actualidad.

X X X X

msg_index ID de mensaje empleado para obtener elmensaje internacionalizado.

X X X X

num_actions Número de acciones (tareas o programas)de las que en la actualidad está haciendoun rastreo el servidor de eventos para esteevento.

X X X X

o_dispatch Número de puerto empleado por elproceso oserv.

X X X

origin Dirección de protocolo o nombre de hostdel sistema fuente.

X X X X

repeat_count Contador para hacer un seguimiento delnúmero de veces que se ha recibido untipo de evento duplicado.

X X X X


Nombre Descripción

Disponible para

Tare

asd

eco

nso

la

Pro

gram

asd

eco

nso

la

Tare

asd

eb

ase

de

regl

as

Pro

gram

asd

eb

ase

de

regl

as

server_handle Número que identifica el servidor deeventos que ha recibido este evento. Unevento se identifica de forma exclusivamediante una combinación de los valoresde los atributos date_reception,event_handle y server_handle.

X X X X

server_hndl Número que identifica el servidor deeventos que ha recibido este evento. Unevento se identifica de forma exclusivamediante una combinación de los valoresde los atributos date_reception,event_handle y server_handle.

X X

server_path Almacena información que describe losmotores de reglas por los que ha pasadoun evento.

X X X X

severity Gravedad del evento. La base de datosalmacena la gravedad como un número.Esta correlación está definida en el archivode base de reglas root.baroc y estáestablecida para las gravedadespredeterminadas del servidor de eventosdel modo siguiente:10 DESCONOCIDO20 INOCUO30 AVISO40 LEVE50 CRÍTICO60 MUY GRAVE

X X X X

source Fuente del evento (por ejemplo, eladaptador OpenView). La fuente vienedefinida por el tipo de adaptador.

X X X X

status Estado del evento. X X X X

sub_origin Especificación más detallada del origen.Este atributo es opcional.

X X X X

sub_source Especificación más detallada de la fuente.Este atributo es opcional.

X X X X


EjemplosEn este apartado se muestran ejemplos de vuelcos de variables de entorno parauna tarea automática ejecutada desde la consola de eventos, una tarea automáticaejecutada desde una regla de Tivoli Enterprise Console y una tarea de consolaejecutada desde la consola de eventos. Puede que los valores de las variablesaparezcan divididos en varias líneas debido a las limitaciones de espacio de lapágina.

Vuelco de las variables de entorno al ejecutar una tarea desdela consola de eventos

El ejemplo siguiente muestra un vuelco de las variables de entorno al ejecutar unatarea desde una regla de Tivoli Enterprise Console.CHILD_OF_OSERV=ENDPOINT=xerius (ManagedNode)ENDPOINT_OID=1450268534.1.348#TMF_ManagedNode::Managed_Node#EVENT_CLASS=TEC_ErrorINTERP=solaris2LANG=CLD_LIBRARY_PATH=/data/TMP3.6/lib/solaris2:/usr/openwin/lib:/data/ \install/iblib/solaris2:/usr/openwin/lib:/usr/lib:/usr/ucblib:/data/ \TMP3.6/lib/solaris2:/usr/dt/lib:/usr/openwin/lib:/usr/lib:/usr/ucblibNLSPATH=/data/TMP3.6/msg_cat/%L/%N.cat:/data/TMP3.6/msg_cat/%l/ \%N.cat:/data/TMP3.6/msg_cat/C/%N.cat:/data/TMP3.6/msg_cat/%L/ \%N.cat:/data/TMP3.6/msg_cat/%l/%N.cat:/data/TMP3.6/msg_cat/C/%N.catPATH=/data/TMP3.6/bin/solaris2/bin:/bin:/usr/binSLOTS=server_handle date_reception event_handle source sub_source \origin sub_origin hostname adapter_host date status \administrator acl credibility severity msg msg_catalog msg_index \duration num_actions repeat_count cause_date_reception \cause_event_handle server_pathTEC_BIN_DIR=/data/TMP3.6/bin/solaris2/TME/TECTEC_KB_DIR=tec/rb_dirTEC_MASTER_PORT=50561TEC_MASTER_START_TIMEOUT=300TEC_RECV_BUFSIZE=500TEC_RECV_LOG=YESTEC_RULE_CACHE_CLEAN_FREQ=3600TEC_RULE_CACHE_FULL_HISTORY=86400TEC_RULE_CACHE_NON_CLOSED_HISTORY=15552000TEC_RULE_CACHE_SIZE=1000TEC_RULE_TRACE=YESTEC_RULE_TRACE_FILE=/tmp/rules.traceTISDIR=/data/TMP3.6/bin/solaris2/../genericTZ=US/CentralWLOCALHOST=xeriusacl=[admin]adapter_host=administrator=cause_date_reception=0cause_event_handle=0class_name=TEC_Errorcredibility=1date=Aug 8 13:26:57 2000date_reception=965759217duration=0event_handle=1hostname=xeriusmsg=taskmsg_catalog=msg_index=0num_actions=2o_dispatch=94


origin=146.84.39.78repeat_count=0server_handle=1server_path=[]severity=MINORsource=EVENTstatus=OPENsub_origin=sub_source=

Vuelco de las variables de entorno al ejecutar un programadesde la consola de eventos

El ejemplo siguiente muestra un vuelco de las variables de entorno al ejecutar unatarea de consola desde la consola de eventos.EVENT_CLASS=TEC_ErrorINTERP=solaris2LANG=CLD_LIBRARY_PATH=/data/TMP3.6/lib/solaris2:/usr/openwin/lib:/data/ \install/iblib/solaris2:/usr/openwin/lib:/usr/lib:/usr/ucblib:/data/ \TMP3.6/lib/solaris2:/usr/dt/lib:/usr/openwin/lib:/usr/lib:/usr/ucblibNLSPATH=/data/TMP3.6/msg_cat/%L/%N.cat:/data/TMP3.6/msg_cat/%l/ \%N.cat:/data/TMP3.6/msg_cat/C/%N.cat:/data/TMP3.6/msg_cat/%L/ \%N.cat:/data/TMP3.6/msg_cat/%l/%N.cat:/data/TMP3.6/msg_cat/C/%N.catPATH=/data/TMP3.6/bin/solaris2/bin:/bin:/usr/binSLOTS=server_handle date_reception event_handle source sub_source \origin sub_origin hostname adapter_host date status \administrator acl credibility severity msg msg_catalog msg_index \duration num_actions repeat_count cause_date_reception \cause_event_handle server_pathTEC_BIN_DIR=/data/TMP3.6/bin/solaris2/TME/TECTEC_KB_DIR=tec/rb_dirTEC_MASTER_PORT=50561TEC_MASTER_START_TIMEOUT=300TEC_RECV_BUFSIZE=500TEC_RECV_LOG=YESTEC_RULE_CACHE_CLEAN_FREQ=3600TEC_RULE_CACHE_FULL_HISTORY=86400TEC_RULE_CACHE_NON_CLOSED_HISTORY=15552000TEC_RULE_CACHE_SIZE=1000TEC_RULE_TRACE=YESTEC_RULE_TRACE_FILE=/tmp/rules.traceTISDIR=/data/TMP3.6/bin/solaris2/../genericTZ=US/CentralWLOCALHOST=xeriusacl=[admin]adapter_host=administrator=cause_date_reception=0cause_event_handle=0class_name=TEC_Errorcredibility=1date=Aug 8 13:26:57 2000date_reception=965759217duration=0event_handle=1hostname=xeriusmsg=taskmsg_catalog=msg_index=0num_actions=2o_dispatch=94origin=146.84.39.78repeat_count=0server_handle=1server_path=[]


severity=MINORsource=EVENTstatus=OPENsub_origin=sub_source=


Capítulo 4. Flujo de eventos

La arquitectura del servidor de eventos consta de los cinco procesos siguientes, queinfluyen en el desarrollo y la ejecución de las reglas. Los nombres de proceso semuestran entre paréntesis. Existe un proceso adicional, el servidor de interfaz deusuario (UI), que desempeña una función integral en la arquitectura global deTivoli Enterprise Console. El servidor de interfaz de usuario no forma parte delservidor de eventos, aunque se comunica con él. Para obtener informaciónadicional, consulte “Servidor de interfaz de usuario” en la página 161.v Proceso maestro (tec_server)v Proceso del motor de recepción (tec_reception)v Proceso del motor de reglas (tec_rule)v Proceso del motor de asignación (tec_dispatch)v Proceso del motor de tareas (tec_task)

Estos procesos también se denominan servicios cuando se ejecutan en un entornoWindows NT. Los nombres de servicio tienen una extensión de nombre de archivo.exe.

Si alguno de los procesos del servidor de eventos falla, se escribe información deerror en el registro de errores correspondiente. En la tabla siguiente se muestranlos nombres de algunos de los archivos de errores definidos en el archivo$BINDIR/TME/TEC/.tec_diag_config.

Proceso Archivo de errores

tec_server /tmp/tec_master

tec_reception /tmp/tec_reception

tec_rule /tmp/tec_rule

tec_dispatch /tmp/tec_dispatch

tec_task /tmp/tec_task

Los nombres de los archivos de errores se pueden modificar.


La figura siguiente ilustra las relaciones existentes entre los procesos del servidorde eventos. Las flechas representan el flujo de las comunicaciones.

Motor detareas

(tec_task)

Principal(tec_server)

Tareas oprogramasexternos

Servidor UI(tec_ui_server)

Caché deeventos(RAM)

Eventosentrantesde Tivoli

Motor derecepción

(tec_reception)

Búfer derecepción

(RAM)

RDBMS

Motor dereglas

(tec_rule)

Motor deasignación

(tec_dispatch) Consola

Consola

Consola

desde adaptadorque no es TME

Eventosentrantesde Tivoli

desde adaptadorTME

Proceso maestroEl proceso maestro coordina todos los demás procesos del servidor de eventos. Siuno de los demás procesos finaliza de forma imprevista (queda muerto), el procesomaestro intentará reiniciarlo. Si el proceso maestro puede reiniciarlo, el procesomaestro desactivará los demás procesos en el momento adecuado. Además, elproceso maestro recibe inicialmente los eventos entrantes enviados desde losadaptadores TME (los que utilizan Tivoli Management Framework para lascomunicaciones) y los reenvía al motor de recepción.

Proceso del motor de recepciónEl motor de recepción:1. Recibe los eventos entrantes y los registra en el registro de recepción.2. Envía los eventos recibidos al motor de reglas para su proceso.

La figura siguiente muestra los pasos del proceso de recepción de eventos deforma detallada. El estado de un evento durante el proceso de recepción sedescribe tras la figura. Las llamadas de salida de la figura se describen del modosiguiente:1. El motor de recepción recibe los eventos directamente de un adaptador que no

es de TME o del proceso maestro si el evento se ha enviado desde unadaptador TME.

2. Todos los eventos entrantes se escriben en el registro de recepción y se marcancomo en cola (QUEUED) o en espera (WAITING). El registro de recepción enrealidad es una tabla de la base de datos de eventos.

3. Los eventos marcados como en cola (QUEUED) se envían al búfer de recepción.4. Los eventos en cola (QUEUED) se envían del búfer de recepción al motor de

reglas para su proceso.5. El motor de asignación envía una señal al motor de recepción cuando el

proceso del motor de reglas correspondiente a un evento ha finalizado. El


motor de recepción marca el evento como procesado (PROCESSED) en elregistro de recepción y lo elimina del búfer de recepción. Si el motor de reglasno ha podido analizar correctamente el evento para el proceso, éste se marcacomo analizado incorrectamente (PARSING_FAILED) en el registro derecepción.

El estado de un evento durante el proceso de recepción (PARSING_FAILED,PROCESSED, QUEUED y WAITING) es específico del motor de recepción y no esun atributo del evento. Los estados se definen tal como se indica a continuación:

PARSING_FAILEDEl evento no es válido. No es una clase de evento conocida para elservidor de eventos o los atributos de la clase de evento no tienen elformato correcto. El evento se descarta, lo que significa que no se insertaen el repositorio de eventos, pero puede seguir visualizándose en elregistro de recepción.

PROCESSEDEl evento es válido y el motor de reglas lo ha procesado correctamente.

QUEUEDEl evento está esperando en el búfer de recepción a que se lleve a cabo elproceso del motor de reglas. El búfer de recepción es una cola de tipoFIFO. Si ve repetidamente eventos en cola (QUEUED) en la salida delcomando wtdumprl, tiene un motor de reglas que está demasiadoocupado. Si sólo ve eventos procesados (PROCESSED) en la salida delcomando wtdumprl, tiene un búfer de recepción con un tamaño adecuadoy el proceso del motor de reglas es eficaz.

WAITINGEl búfer de recepción está lleno. Cuando el búfer de recepción puedaaceptar el evento, se cambiará a un estado en cola (QUEUED). Si verepetidamente eventos en espera (WAITING) en la salida del comandowtdumprl, puede que el búfer de recepción tenga configurado un tamañodemasiado pequeño, el motor de reglas esté demasiado ocupado o se denambas condiciones.

Capítulo 4. Flujo de eventos 159

Cuando se reinicia el servidor de eventos, el motor de recepción se vuelve a cargarcon los eventos del registro de recepción que están en estado en espera (WAITING)o en cola (QUEUED).

El motor de recepción no procesa los eventos generados internamente (porejemplo, los generados por las reglas). Estos nunca aparecen en el registro derecepción ni el búfer de recepción.

El búfer de recepción consiste en memoria RAM y su tamaño se puede configurarcon el comando wsetesvrcfg o en el diálogo Parámetros de servidor de eventos.

Proceso del motor de reglasEl motor de reglas es un procesador de eventos basado en reglas. El motor derecepción envía un evento al motor de reglas. A continuación, el evento se evalúacon las reglas. Tras el proceso de reglas, el evento se coloca en la caché de eventosdel motor de reglas. El evento del motor de reglas que se evalúa en este momentose denomina evento bajo análisis. Un evento que cumple los criterios deespecificación de una regla hace que la regla se ejecute, lo que significa que sellevan a cabo las acciones de la regla. Esta es la primera secuencia de entrada delmotor de reglas.

Una segunda secuencia de entrada procede del proceso de asignación. Estasecuencia de entrada contiene los cambios efectuados en los eventos que ya harecibido el servidor de eventos, normalmente procedentes de un cambio efectuadopor la actividad llevada a cabo en la consola de eventos.

Una tercera secuencia de entrada procede de las solicitudes de cambios en eventosprocedentes de la ejecución de acciones que lleva a cabo el proceso de tareas. Estasecuencia de entrada se dirige al motor de reglas desde un thread de proceso detareas por medio del proceso de asignación.

La secuencia de salida del motor de reglas se dirige al proceso de asignación. Unavez que se evalúa un evento con las reglas, se reenvía al proceso de asignaciónpara su almacenamiento en el repositorio de eventos.

Es importante tener en cuenta que el motor de reglas evalúa y correlaciona loseventos con otros eventos de la caché de eventos del motor de reglas. La caché deeventos consiste en memoria RAM. El motor de reglas no interactúa con la base dedatos de eventos.

Proceso del motor de asignaciónLas funciones principales del motor de asignación consisten en conservaractualizada la base de datos de eventos y enviar la información de eventosactualizada a las consolas de eventos. El motor de asignación se comunica con elmotor de reglas y el motor de tareas para saber cuándo debe actualizar lainformación de eventos. Si deben ejecutarse tareas o programas para un evento, elmotor de asignación se pone en contacto con el motor de tareas para ejecutarlos. Elmotor de asignación también maneja las solicitudes de cambios de eventosefectuadas desde una consola de eventos (mediante el servidor de UI) y las envíaal motor de reglas. Además, cuando se inicia el servidor de eventos, el motor deasignación recupera los eventos de la base de datos de eventos a fin de volver acargar la caché de eventos para el motor de reglas.


Servidor de interfaz de usuarioEl servidor de interfaz de usuario es un proceso que proporciona servicios decomunicación entre las consolas de eventos y el servidor de eventos, así comoentre las consolas de eventos y la base de datos de eventos. Se comunica con elmotor de asignación cuando necesita ponerse en contacto con el servidor deeventos. El servidor de interfaz de usuario proporciona a las consolas de eventos lainformación de eventos actualizada y suministra al motor de asignación lassolicitudes de cambios en eventos efectuadas desde las consolas de eventos.

El servidor de interfaz de usuario se puede instalar en cualquier nodo gestionadode la TMR, pero sólo en un nodo gestionado. No tiene que ubicarse en el mismohost que el servidor de eventos. El nombre del proceso del servidor de interfaz deusuario es tec_ui_server. Si el servidor de interfaz de usuario falla, se escribenmensajes de error en el archivo /tmp/ui_server. El nombre de este archivo deerrores está definido en el archivo $BINDIR/TME/TEC/.ui_server_diag_config yse puede modificar.

Proceso del motor de tareasEl motor de tareas ejecuta programas, tareas, scripts y comandos iniciados porreglas. Supervisa estos elementos en ejecución y puede devolver su estado desalida al motor de asignación, que escribe el estado en la base de datos de eventos.

El motor de tareas ejecuta estos elementos a medida que recibe solicitudes paraello. No espera a que finalice un elemento en ejecución antes de iniciar otro.

El atributo num_actions de un evento contiene el número de acciones (tareas oprogramas) del evento del que actualmente está realizando el rastreo el servidor deeventos.

Capítulo 4. Flujo de eventos 161

Apéndice. Parámetros de configuración

A continuación se indican los parámetros que se pueden establecer en el archivo.tec_config. Este archivo se encuentra en el directorio $BINDIR/TME/TEC.También se pueden establecer los parámetros en las reglas mediante el predicadoget_config_param.

Nota: los parámetros tec_recv_agent_port, tec_disp_rule_port y tec_rec_rule_portindican qué números de puerto se utilizarán para enviar eventos sinemplear los servicios de comunicación de Tivoli Management Framework.Los números de puerto deben establecerse en un valor superior a 5000 paraevitar conflictos con los puertos asignados automáticamente.

Parámetro Uso

tec_recv_agent_port Especifica el puerto empleado para lacomunicación entre procesos por el procesotec_reception. Este parámetro es obligatorioen UNIX.

tec_disp_rule_port Especifica el puerto empleado para lacomunicación entre procesos para el procesotec_dispatch.

tec_recv_rule_port Especifica el puerto empleado para lacomunicación entre procesos para el procesotec_rule.

tec_tmpfile_dir Especifica el directorio donde se puedencrear y manipular los archivos temporales.Estos archivos temporales se empleancuando las reglas escriben en un directoriode trabajo.

tec_rule_cache_size Especifica el número de eventosalmacenados en la caché de eventos delmotor de reglas.

tec_rule_cache_full_history Especifica, en segundos, el tiempo máximopermitido para un evento abierto en la cachéde eventos del motor de reglas.

tec_rule_cache_non_closed_history Especifica, en segundos, el tiempo máximopermitido para un evento cerrado en lacaché de eventos del motor de reglas.

tec_rule_cache_clean_freq Especifica la frecuencia de vaciado de lacaché de eventos del motor de reglas.

tec_rule_trace Activa o inhibe la compilación de reglas conrastreo. Si se establece en YES, también debeestablecerse el parámetro tec_rule_trace_file.

tec_rule_trace_file Especifica el nombre de archivo donde seescribirá la información de rastreo. Debeestablecerse si tec_rule_trace se haestablecido en YES.

tec_rule_host Especifica el host donde se ejecuta el motorde reglas.

tec_server_handle Especifica el identificador numérico delservidor.


Parámetro Uso

event_cache_file Especifica el nombre de archivo de la cachéde eventos. Se utiliza para almacenar en lacaché los eventos entrantes cuando sereciben eventos con una velocidad superiora la que se pueden procesar.

tec_exectask_dbcs Especifica cómo deben pasarse losparámetros de slot de tipo cadena al motorde tareas. Si se establece en TRUE, losparámetros de slot se convierten al conjuntode códigos local antes de ejecutarse la tarea.Si se establece en FALSE, los parámetros sepasan como UTF8.

always_expect_utf8 Indica si todos los eventos entrantes tendránel formato UTF8.


Avisos

Esta información se ha desarrollado para productos y servicios ofrecidos enEstados Unidos. Es posible que en otros países IBM no ofrezca los productos, losservicios o las funciones que se describen en este documento. Consulte con elrepresentante local de IBM para obtener información acerca de los productos yservicios que actualmente están disponibles en su localidad. Las referencias a unproducto, programa o servicio de IBM no pretenden afirmar ni implicar que sólopueda utilizarse dicho producto, programa o servicio de IBM. En su lugar, puedeutilizarse cualquier producto, programa o servicio funcionalmente equivalente queno vulnere ninguno de los derechos de propiedad intelectual de IBM. No obstante,es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquierproducto, programa o servicio que no sea de IBM.

IBM puede tener patentes o solicitudes de patentes pendientes que afecten a lostemas tratados en este documento. La entrega de este documento no confiereninguna licencia sobre estas patentes. Puede enviar consultas sobre licencias, porescrito, a:

IBM Director of Licensing

IBM Corporation

North Castle Drive

Armonk, NY 10504-1785 EE.UU.

Para realizar consultas sobre licencias relacionadas con los caracteres de doble byte(DBCS), póngase en contacto con el departamento de propiedad intelectual de IBMde su país o envíelas por escrito a la siguiente dirección:

IBM World Trade Asia Corporation

Licensing

2-31 Roppongi 3-chome, Minato-ku

Tokio 106, Japón

El párrafo siguiente no se aplica al Reino Unido ni a ningún otro país dondeestas disposiciones sean incompatibles con la legislación local:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONAESTA PUBLICACIÓN ″TAL CUAL″ SIN GARANTÍAS DE NINGÚN TIPO, YASEAN EXPLÍCITAS O IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE AELLAS, LAS GARANTÍAS IMPLÍCITAS DE NO VULNERACIÓN,COMERCIABILIDAD O ADECUACIÓN A UNA FINALIDAD DETERMINADA.

Algunos estados no permiten la renuncia a garantías explícitas o implícitas endeterminadas transacciones. Por lo tanto, es posible que estas indicaciones no seande aplicación en su caso.


Esta información puede contener imprecisiones técnicas o errores tipográficos.Periódicamente se efectúan cambios en la información aquí contenida; dichoscambios se incorporarán en nuevas ediciones de la publicación. IBM puedeefectuar mejoras o cambios en los productos o programas descritos en estapublicación en cualquier momento y sin previo aviso.

Cualquier referencia realizada en esta información a sitios web que no son de IBMse proporciona únicamente para su comodidad y de ningún modo representa unarecomendación de dichos sitios web. Los materiales de estos sitios web no formanparte de los materiales de este producto de IBM y la utilización de los mismos serápor cuenta y riesgo del usuario.

IBM puede utilizar o distribuir la información que se le envía de la forma queconsidere adecuada sin incurrir por ello en ninguna obligación con respecto alremitente.

Los titulares de licencias de este programa que deseen información sobre el mismocon el fin de permitir: (i) el intercambio de información entre programas creadosindependientemente y otros programas (incluido éste) y (ii) la utilización mutua dela información intercambiada, deben ponerse en contacto con:

IBM Corporation

2Z4A/101

11400 Burnet Road

Austin, TX 78758 EE.UU.

Dicha información puede estar disponible, sujeta a los términos y condicionesapropiados, incluyendo en algunos casos el pago de una tarifa.

IBM proporciona el programa bajo licencia descrito en este documento y todo elmaterial bajo licencia disponible para el mismo según las condiciones del contratode cliente IBM, el contrato internacional de programas bajo licencia IBM ocualquier contrato equivalente entre ambas partes.

Los datos de rendimiento proporcionados en este documento se han obtenido enun entorno controlado. Por consiguiente, los resultados obtenidos en otros entornosoperativos pueden variar de forma significativa. Es posible que algunas medidas sehayan efectuado en sistemas a nivel de desarrollo y no existe ninguna garantía deque estas medidas sean las mismas en los sistemas de disponibilidad general.Además, puede que algunas medidas se hayan calculado por extrapolación. Losresultados reales pueden variar. Los usuarios de este documento deben verificarlos datos aplicables a su entorno específico.

La información relativa a productos que no son IBM se ha obtenido de lossuministradores de dichos productos, de sus anuncios publicados o de cualquierotra fuente disponible públicamente. IBM no ha probado estos productos y nopuede confirmar la veracidad del rendimiento, la compatibilidad u otrasafirmaciones relacionadas con productos que no son IBM. Las consultas acerca delas posibilidades de productos no IBM deben dirigirse a los suministradores deestos productos.


Todas las declaraciones relativas a la dirección o intención futura de IBM estánsujetas a cambios o anulación sin previo aviso y representan únicamente metas yobjetivos.

Esta información contiene ejemplos de datos e informes utilizados en operacionescomerciales diarias. Para ilustrarlos de la forma más completa posible, los ejemplosincluyen nombres de personas, empresas, marcas y productos. Todos estosnombres son ficticios y cualquier parecido con los nombres y direcciones utilizadospor una empresa real es mera coincidencia.

Esta información contiene programas de aplicación de ejemplo en lenguaje fuenteque ilustran las técnicas de programación en diversas plataformas operativas. Elusuario puede copiar, modificar y distribuir estos programas de ejemplo encualquier formato sin pago a IBM, con los fines de desarrollar, utilizar,comercializar o distribuir programas de aplicación compatibles con la interfaz deprogramación de aplicaciones de la plataforma operativa para la que se han escritolos programas de ejemplo. Estos ejemplos no se han probado de modo exhaustivoen todas las condiciones. IBM, por lo tanto, no puede garantizar ni dar por sentadala fiabilidad, la utilidad ni el funcionamiento de estos programas. El usuario puedecopiar, modificar y distribuir estos programas de ejemplo en cualquier formato sinpago a IBM con los fines de desarrollar, utilizar, comercializar o distribuirprogramas de aplicación compatibles con las interfaces de programación deaplicaciones de IBM.

Si está viendo esta información en copia software, es posible que las fotografías ylas ilustraciones en color no aparezcan.

Marcas registradasLos términos siguientes son marcas registradas de International Business MachinesCorporation en Estados Unidos y/o en otros países:

AIX IBMLink Logotipo de Tivoli

DB2 NetView Tivoli Enterprise

IBM OS/390 Tivoli Enterprise Console

Logotipo de IBM Tivoli TME

Java y todas las marcas registradas basadas en Java y sus logotipos sonmarcas registradas de Sun Microsystems, Inc. en Estados Unidos y/o enotros países.

Microsoft y Windows NT son marcas registradas de Microsoft Corporation enEstados Unidos y/o en otros países.

Java y todas las marcas registradas basadas en Java y sus logotipos son marcasregistradas de Sun Microsystems, Inc. en Estados Unidos y/o en otros países.

Otros nombres de empresas, productos y servicios pueden ser marcas registradas ode servicio de terceros.

Avisos 167

Glosario

Este glosario incluye terminología de productos Tivoli, así como términos y definiciones seleccionados de:v El American National Standard Dictionary for Information Systems, ANSI X3.172-1990, copyright 1990 de

American National Standards Institute (ANSI). Se pueden adquirir copias solicitándolas al AmericanNational Standards Institute, 11 West 42nd Street, Nueva York, Nueva York 10036. Las definicionesextraídas de este diccionario se identifican por el símbolo (A) después de la definición.

v El ANSI/EIA Standard--440-A, Fiber Optic Terminology. Se pueden solicitar copias solicitándolas a laElectronic Industries Association, 2001 Pennsylvania Avenue, N.W., Washington, DC 20006. Lasdefiniciones extraídas de este diccionario se identifican por el símbolo (E) después de la definición.

v El Vocabulario de tecnología de la información desarrollado por el subcomité 1, Comité técnico conjunto 1de la Organización internacional para la estandarización y la Comisión electrotécnica internacional(ISO/IEC JTC1/SC1). Las definiciones de las partes publicadas de este vocabulario se identificanmediante el símbolo (I) después de la definición; las definiciones extraídas de estándaresinternacionales, borradores de comités y documentos de trabajo que están desarrollando ISO/IECJTC1/SC1 se identifican mediante el símbolo (T) después de la definición, lo que indica que no se haalcanzado un acuerdo final entre los organismos nacionales participantes de SC1.

v El IBM Dictionary of Computing, Nueva York: McGraw-Hill, 1994.v IRC: 1208, Glossary of Networking Terms.v IRC: 1392, Internet Users’ Glossary.v Object-Oriented Interface Design: IBM Common User Access Guidelines, Carmel, Indiana: Que, 1992.

En este glosario se utilizan las siguientes referencias cruzadas:

Compare con:Remite al lector a un término con significado contrario o substancialmente diferente.

Consulte:Remite al lector a (a) un término relacionado, (b) un término que es la forma desarrollada de unaabreviación o acrónimo o (c) un sinónimo o un término preferible.

Término obsoleto de:Indica que ese término no debe utilizarse y remite al lector al término preferible.

AACF. Consulte Adapter Configuration Facility

ACP. Consulte perfil de configuración del adaptador.

adaptador. (1) Componente que conecta eléctrica ofísicamente un dispositivo a un sistema o a otrodispositivo. (2) Consulte adaptador de eventos.

adaptador de eventos. En un entorno Tivoli, softwareque convierte eventos en un formato que TivoliEnterprise Console puede utilizar y que reenvía eventosal servidor de eventos. Mediante Tivoli EventIntegration Facility, una organización puede desarrollarsus propios adaptadores de eventos adaptados a suentorno de red y a sus necesidades específicas.

Adapter Configuration Facility (ACF). En TivoliEnterprise Console, interfaz gráfica de usuario que

permite a un administrador de Tivoli configurar ypersonalizar adaptadores de eventos de manerasencilla.

API. Consulte application programming interface.

atributo. Característica que identifica y describe unobjeto gestionado. La característica se puededeterminar, y posiblemente cambiar, a través deoperaciones en el objeto gestionado.

BBAROC. Consulte Basic Recorder of Objects in C.

base de datos. (1) Colección de datos con unaestructura determinada para aceptar, almacenar yproporcionar datos, a petición, para varios usuarios. (T)(2) Colección de datos interrelacionados que seorganizan según un esquema de base de datos para


servir a una o más aplicaciones. (T) (3) Colección dedatos fundamental para un sistema. (A) (4) Colecciónde datos fundamental para una empresa (A)

base de reglas. En Tivoli Enterprise Console, uno omás conjuntos de reglas y las definiciones de las clasesde eventos para las que se escriben las reglas. TivoliEnterprise Console utiliza la base de reglas en lagestión de eventos. Una organización puede crearmuchas bases de reglas y establecer que cada base dereglas cumpla una serie distinta de necesidades para lagestión de entornos informáticos.

Basic Recorder of Objects in C (BAROC). En elservidor de eventos de Tivoli Enterprise Console,representación interna de las clases de eventosdefinidas.

Cclase. (1) En diseño o programación orientada alobjeto, modelo o plantilla que se puede instanciar paracrear objetos con una definición común y, por lo tanto,propiedades, operaciones y funcionamiento comunes.Un objeto es una instancia de una clase. (2) En elsistema operativo AIX, perteneciente a lascaracterísticas de E/S de un dispositivo. Losdispositivos de sistema se clasifican como dispositivosde bloque o de caracteres.

clase de evento. En Tivoli Enterprise Console,clasificación de un evento que indica el tipo deinformación que el adaptador de eventos enviará alservidor de eventos.

CLI. Consulte interfaz de línea de comandos.

conjunto de reglas. En Tivoli Enterprise Console,archivo que contiene una o más reglas. Consulte tambiénbase de reglas.

consola de eventos. En Tivoli Enterprise Console,interfaz gráfica de usuario (GUI) que permite a losadministradores del sistema ver y responder a loseventos asignados desde el servidor de eventos. TivoliEvent Integration Facility no utiliza directamente niafecta a las consolas de eventos.

correlación de eventos. En Tivoli Enterprise Console,proceso que consiste en correlacionar distintos eventoscon una causa común. Por ejemplo, Tivoli EnterpriseConsole puede recibir varios eventos que indican que elservidor NFS no responde de diferentes aplicaciones,así como un evento de host inactivo para el servidorNFS. Tivoli Enterprise Console puede correlacionar losdistintos eventos que indican que el servidor NFS noresponde con su causa común, que es que el servidorNFS está “inactivo”. Consulte regla.

Eevento. (1) Incidencia significativa que se produce enuna tarea (como puede ser abrir una ventana o realizaruna operación asíncrona). (2) En el entorno Tivoli,cualquier cambio significativo en el estado de unrecurso del sistema, un recurso de red o una aplicaciónde red. Se puede generar un evento para un problema,para la resolución de un problema o para la realizacióncorrecta de una tarea. Ejemplos de eventos son el inicioy la detención normal de un proceso, la terminaciónanómala de un proceso y el funcionamiento erróneo deun servidor.

Ffiltro de eventos. (1) En un entorno Tivoli, softwareque determina los eventos que se reenvían a un destinoespecificado. El filtro de eventos ayuda a reducir eltráfico de red. Los administradores de Tivoli configurarlos filtros de eventos. (2) En Tivoli NetView, expresiónlógica de criterio que determina qué eventos sereenvían al programa de aplicación que registra el filtrode eventos en el agente de tamiz de eventos. Un filtrose denomina “simple” o “compuesto” en función decómo lo maneja el editor de filtros.

Ggrupo de eventos. En Tivoli Enterprise Console,conjunto de eventos que cumplen ciertos criterios. Cadagrupo de eventos se representa mediante un icono en laconsola de eventos. Los administradores de Tivolipueden supervisar los grupos de eventos que sonrelevantes para sus áreas de responsabilidadespecíficas.

GUI. Consulte interfaz gráfica de usuario.

Hhost. (1) Sistema que está conectado a una red (comopuede ser Internet o una red SNA) y que proporcionaun punto de acceso a esa red. Asimismo, en función delentorno, el host puede proporcionar controlcentralizado de la red. El host puede ser un cliente, unservidor o ambos simultáneamente. (2) En un entornoTivoli, sistema que sirve como nodo gestionado parauna distribución de perfiles.

Iinterfaz de línea de comandos (CLI). Tipo de interfazde sistema en el que el comando de entrada es unacadena de caracteres de texto. Compare con interfazgráfica de usuario.


interfaz de programación de aplicaciones (API).Interfaz de software que permite a las aplicacionescomunicarse entre sí. Una API es el conjunto desentencias o construcciones del lenguaje que es posiblecodificar en un programa de aplicación para obtener lasfunciones y los servicios específicos proporcionados porun sistema operativo o programa de serviciosubyacente.

interfaz gráfica de usuario (GUI). Tipo de interfaz desistema que consta de una metáfora visual de unaescena del mundo real, a menudo de un escritorio. Enesa escena existen iconos que representan objetos reales,a los que el usuario puede acceder y que se puedenmanipular con un dispositivo de puntero. Compare coninterfaz de línea de comandos.

IP. Consulte Internet Protocol.

IP (Internet Protocol). En el conjunto de protocolos deInternet, protocolo sin conexión que dirige los datospor medio de una red o varias redes interconectadas yactúa de intermediario entre las capas de protocolosuperiores y la red física.

Nnivel de gravedad. En Tivoli Enterprise Console,clasificación de un evento que indica su grado degravedad. Un usuario o una regla de Tivoli EnterpriseConsole pueden modificar los niveles de gravedad. Losniveles de gravedad predefinidos, en ordendescendente de gravedad son: muy grave, crítico, aviso,leve, inocuo y desconocido.

nodo gestionado. (1) En comunicaciones de Internet,estación de trabajo, servidor o direccionador quecontiene un agente de gestión de red. En IP (InternetProtocol), el nodo gestionado contiene normalmente unagente SNMP (Simple Network Management Protocol).(2) En un entorno Tivoli, cualquier recurso gestionadoen el que se instala Tivoli Management Framework.

nombre registrado. En un entorno Tivoli, nombre porel que se registra un recurso determinado en el registrode nombres cuando se crea.

Pperfil. En un entorno Tivoli, contenedor deinformación específica de aplicaciones sobre un tipoconcreto de recurso. Una aplicación Tivoli especifica laplantilla de sus perfiles; la plantilla incluye informaciónsobre los recursos que esa aplicación Tivoli puedegestionar.

Un perfil se crea en el contexto de un gestor deperfiles; el gestor de perfiles enlaza un perfil con elrecurso Tivoli (por ejemplo, un nodo gestionado) queutiliza la información que contiene el perfil. Un perfilno tiene abonados directos.

perfil de configuración del adaptador (ACP). En unentorno Tivoli, perfil de Tivoli Enterprise Console quecontiene información de uno o más adaptadores deeventos.

Perl. Lenguaje de scripts diseñado inicialmente porLarry Wall como una herramienta para escribirprogramas en el entorno UNIX pero que haevolucionado hasta incluir las posibilidades y laflexibilidad de un lenguaje de programación de altonivel como C. El acrónimo Perl corresponde a PracticalExtraction and Report Language. Perl es un lenguaje defuente abierto.

política. En un entorno Tivoli, conjunto de reglasaplicables a recursos gestionados. Una regla específicade una política se denomina método de política.

política de validación. En un entorno Tivoli, políticaque garantiza que todos los recursos de una región depolítica cumplen la política establecida de la región. Lapolítica de validación impide que los administradoresde Tivoli creen o modifiquen recursos que no se ajustena la política de la región de política en que se hancreado los recursos.

Rrecurso. (1) Cualquier recurso de un sistemainformático o de un sistema operativo que un trabajo otarea necesita y que incluye el almacenamientoprincipal, los dispositivos de entrada/salida, la unidadde proceso, los conjuntos de datos y los programas decontrol o proceso. (2) En Tivoli NetView para OS/390,hardware o software que proporciona funciones a lared. (3) Consulte recurso gestionado.

recurso gestionado. En un entorno Tivoli, cualquierentidad de hardware o software (máquina, servicio,sistema o recurso) representada por un objeto de basede datos y un icono en el escritorio Tivoli. Los recursosgestionados deben ser de un tipo de recurso gestionadocon soporte de una región de políticas y están sujetos aun conjunto de reglas. Los recursos gestionados son,entre otros, los nodos gestionados, las bibliotecas detareas, los supervisores, los perfiles y los tablones deanuncios.

región de gestión de Tivoli (TMR). En un entornoTivoli, un servidor Tivoli y el conjunto de clientes a losque sirve. Una organización puede disponer de más deuna TME. Una TMR estudia la conectividad física delos recursos, mientras que una región de políticasestudia la organización lógica de los recursos.

región de políticas. En un entorno Tivoli, grupo derecursos gestionados que comparten una o máspolíticas comunes. Los administradores de Tivoliutilizan regiones de políticas para dar forma a lagestión y a la estructura organizativa de un e ntorno desistemas de red. Los administradores pueden agruparrecursos similares, definir el acceso y el control de los

Glosario 171

recursos y asociar reglas para regir los recursos. Laregión de políticas contiene tipos de recursos y la listaque se debe gestionar. Una región de políticas serepresenta en el escritorio de Tivoli mediante un iconoque parece un edificio con capitolio (icono de cúpula).Cuando se crea una región de gestión de Tivoli (TMR),se crea también una región de políticas con el mismonombre. En este caso, la TMR sólo dispone de unaregión de políticas. Sin embargo, en la mayor parte delos casos, un administrador de Tivoli crea regiones ysubregiones de políticas para representar laorganización de la TMR. Una TMR estudia laconectividad física de los recursos, mientras que unaregión de políticas estudia la organización lógica de losrecursos.

registro de nombres. En un entorno Tivoli, servicio denombres que consiste en una tabla bidimensional quecorrelaciona nombres de recurso con identificadores derecurso, así como la información correspondiente, enuna región de gestión de Tivoli.

regla. En Tivoli Enterprise Console, una o mássentencias lógicas que permiten al servidor de eventosreconocer las relaciones entre los eventos (correlaciónde eventos) y ejecutar respuestas automáticas deacuerdo con ello. Consulte también base de reglas yconjunto de reglas.

ruta de objeto. En un entorno Tivoli, ruta absoluta orelativa a un objeto Tivoli, parecida a las rutas de lossistemas de archivos.

Sscript. Programa informático que se interpreta.Consultescript de shell.

script de shell. En el sistema operativo UNIX, serie decomandos, combinados en un archivo, que llevan acabo una función concreta cuando se ejecuta el archivoo cuando se especifica el archivo como valor para elcomando sh.

servidor de eventos. En Tivoli Enterprise Console,servidor central que procesa eventos. El servidor deeventos crea una entrada para cada evento entrante yevalúa el evento contra una base de reglas paradeterminar si puede responder o modificar el evento demanera automática. El servidor de eventos actualizatambién las consolas de eventos con la informaciónactual de eventos. Si el servidor de eventos primario noestá disponible, los eventos se pueden enviar a unservidor de eventos secundario.

SNMP. Consulte Simple Network ManagementProtocol.

SNMP (Simple Network Management Protocol). Enla suite de protocolos de Internet, protocolo de gestiónde red que se utiliza para supervisar direccionadores yredes conectadas. SNMP es un protocolo de capas de

aplicaciones. La información sobre los dispositivosgestionados se define y almacena en la MIB(Management Information Base) de la aplicación.

software Tivoli Enterprise. Conjunto integrado deproductos Tivoli para la gestión de sistemas en unaorganización de gran tamaño. Estos productos permitena los administradores gestionar la empresa de suentorno informático de red según las disciplinas degestión de la disponibilidad, gestión del despliegue,operaciones y administración, gestión de seguridad ygestión a nivel de servicio. Este conjunto incluye TivoliGlobal Enterprise Manager, Tivoli NetView paraOS/390 y Tivoli Decision Support.

Ttarea. (1) En un entorno de multiprogramación omultiproceso, una o más secuencias de instruccionesque un programa de control trata como un elemento detrabajo que debe realizar un sistema. (I) (A) (2) Enun entorno Tivoli, definición de una acción que se debellevar a cabo rutinariamente en varios modosgestionados a través de la red. Una tarea define losejecutables que deben ejecutarse cuando se ejecuta latarea, el rol de aut orización necesario para ejecutar latarea y el usuario o el nombre del grupo bajo el que seejecutará la tarea.

TEC. Consulte Tivoli Enterprise Console.

Tivoli Enterprise Console (TEC). Producto Tivoli querecopila, procesa e inicia automáticamente accionescorrectoras para eventos de sistema, aplicación, red ybase de datos; es el punto central de control para loseventos procedentes de todas las fuentes. TivoliEnterprise Console proporciona una vista globalcentralizada del entorno de gestión de red. Utilizasupervisores de eventos distribuidos para recopilarinformación, un servidor de eventos central paraprocesar la información y consolas de eventosdistribuidas para presentar la información a losadministradores del sistema.

Tivoli Event Integration Facility. Juego deherramientas que proporciona una interfaz deprogramación de aplicaciones (API) sencilla quepermite a los clientes y los Partners de Tivolidesarrollar nuevos adaptadores de eventos que puedenreenviar eventos a Tivoli Enterprise Console.

TME 10. Consulte software Tivoli Enterprise.

TMR. Consulte región de gestión de Tivoli.

Vvalidación. Comprobación de los datos para verificarque sean correctos o que cumplan los estándares, lasreglas y los convenios aplicables. (A)


Índice

Caracteres Especiales’ (comilla simple) 8, 59.tec_diag_config, archivo 157.ui_server_diag_config, archivo 161

Aacciones, descripción 160acciones de reglas, descripción 160ACF. Consulte Adapter Configuration Facility 6acl, variable de entorno 149ACP, véase perfil de configuración del adaptador 13actualizar, bases de reglas anteriores a la versión 3.7 75actualizar, hora de modificación de registro de ACP 120actualizar reglas del generador de reglas 12adaptador

instalar información de validación para 90instalar variables de entorno para 87mostrar información de validación instalada 49

adapter_host, variable de entorno 149adición

filtros de grupos de eventos 21registro de configuración de adaptador para un ACP 13registro de configuración de adaptador para un valor

predeterminado de tipo de adaptador 82administrator, variable de entorno 150archivo .baroc, importar a una base de reglas 68archivo de clases

suprimir 67archivo de definiciones de clases de eventos, comprobar la

validez 7, 17archivo rule_builder.pro 12archivos

.tec_diag_config 157

.ui_server_diag_config 161archivos de errores 157, 161tec_dispatch 157tec_master 157tec_rule 157tec_task 157ui_server_diag_config 161

archivos de errores 157argumento opcional 2argumentos (utilización en la línea de comandos) 124asignados, listar grupos de eventos 25asignar

grupo de eventos 23grupos de eventos, desasignar 27operadores a una consola 23

atributorestablecer fuente de eventos 99

atributos de eventosnum_actions 161

Bbase de datos, reorganizar 38base de datos de eventos

borrar eventos de 104, 106

base de reglasactualizar versiones anteriores a la 3.7 75cargar en el servidor de eventos 71comandos 5condiciones de estado coherente 62copiar 64crear, en el servidor de eventos 65establecer propiedades 72gestionar 62importar a 63listar cargada 71listar definida 71suprimir, del servidor de eventos 67

borrar, eventos de la base de datos de eventos 104, 106búfer de recepción 158, 160

Ccaché de eventos, especificar el número de eventos de 97cadena, límite de tamaño 3caracteres especiales

’ (comilla simple) 8, 59cargar, base de reglas en el servidor de eventos 71cause_date_reception, variable de entorno 150cause_event_handle, variable de entorno 150class, variable de entorno 150class_name, variable de entorno 150Clean_Database, tarea 123, 127Clear_Closed_Events, tarea 123, 128Clear_Reception_Log, tarea 123, 129Close_Event, tarea 123, 130comando

Véase también línea de comandos 124comandos

chkclass 7postemsg 8postzmsg 9tec_console 10upgrade_gui.sh 12waddac 13wconsole 18wcrtnvgroups 34wcrtsrc 33wchkclass 17wdbconfig.sh 35wdbmaint.sh 38wdelac 40wdelsrc 41wlsac 42wlsaddflt 45wlsadenv 47wlsadgui 48wlsadval 49wlsaeenv 51wlsemsg 52wlsesvrcfg 54wlssrc 56wmigcon 57wpostemsg 59wpostzmsg 9wrb 62


comandos (continuación)wrbupgrade 75wruntask 124wsendresp 76wsetac 77wsetaddflt 82wsetadenv 87wsetadgui 88wsetadval 90wsetaeenv 92wsetemsg 95wsetesvrcfg 97wsetsrc 99wstartesvr 100wstatesvr 101wstopesvr 102wstoptecgw 103wtdbclear 104wtdbclear.pl 106wtdbspace 108wtdbstat 110wtdumper 111wtdumprl 113wtdumptr 115wtecexport 116wtecimport 118wtouchac 120

comandos de ACF (Adapter Configuration Facility)resumen 6

comandos de base de datosresumen 6

comandos de base de reglasresumen 5

comandos de consolaresumen 4

comandos de mensajes de eventosresumen 5

comandos de servidor de eventosresumen 5

comandos fuenteresumen 5

Comentarios sobre las publicaciones vicompilar, reglas 64componente de ruta

absoluta 4directorio actual 4directorio padre 4relativa 4

componente de ruta del directorio padre 4comprobar

archivo de definiciones de clases de eventos 17disponibilidad del servidor de base de datos 110validez del archivo de definiciones de clases de eventos 7

configurar (definición en contexto de tareas) 122conjunto de reglas

importar a un destino de base de reglas 70importar a un paquete de reglas 69importar a una base de reglas 69listar 72suprimir de un paquete de reglas 68suprimir de una base de reglas 67

consola de eventosasignados, lista de grupos de eventos 25asignar grupo de eventos 23asignar operadores 23cambiar nombre 26copiar 23

consola de eventos (continuación)crear 23crear grupo de eventos 24desasignar grupos de eventos 27desasignar operadores 27filtro de grupo de eventos, cambiar nombre 26filtros, añadir grupo de eventos 21filtros, suprimir grupo de eventos 25gestionar 18grupo de eventos, cambiar nombre 26grupos de eventos, lista 26iniciar 10mostrar definidas 25suprimir 24suprimir grupo de eventos 25

CONSOLE_NAME, variable de entorno 148Contacto por correo electrónico vicopiar

base de reglas 64consola de eventos 23

crearbase de reglas en el servidor de eventos 65consola de eventos 23destino de base de reglas 66fuente en el servidor de eventos 33grupo de eventos 24grupos de eventos para netview.rls 34paquete de reglas 65

credibility, variable de entorno 150

CHChange_Severity, tarea 123, 126CHILD_OF_OSERV, variable de entorno 148chkclass, comando 7

Ddate, variable de entorno 150date_event, variable de entorno 150date_reception, variable de entorno 150desasignar

operadores de una consola 27desasignar grupos de eventos 27destino de base de reglas

crear 66listar 72suprimir 68

detenergateway 103servidor de eventos 102

DISPLAY, variable de entorno 148Dump_Event_Repository, tarea 123, 131duration, variable de entorno 151

Eeliminar

registro de configuración de adaptador de un ACP 40ENDPOINT, variable de entorno 148ENDPOINT_OID, variable de entorno 148enlace con herramientas de configuración ampliadas,

mostrar 48enlace instalado con herramientas de configuración ampliadas,

mostrar 48


enlazar, interfaz de ACF con una herramienta deconfiguración 88

entorno Tivoli, configuración 1enviar un evento al servidor de eventos 8, 59especificaciones de clase de evento, importar a una base de

reglas 68establecimiento

parámetros de configuración para el servidor deeventos 97

periodo de conservación en registro de recepción 97propiedades de base de reglas 72

estadísticas de base de datos, actualizar 38estados de eventos

descripción 159PARSING_FAILED 159PROCESSED 159QUEUED 159WAITING 160

ev_key, variable de entorno 151EVENT_CLASS, variable de entorno 148event_handle, variable de entorno 151event_hndl, variable de entorno 151Event_Query, tarea 123, 133evento

borrar de base de datos de eventos 104, 106comandos de mensajes 5en base de datos del servidor, listar 52enviar al servidor de eventos 8, 59especificar número, para caché de eventos 97generar informe sobre 111generar informes de eventos recibidos por servidor de

eventos 113modificar evento 95niveles de seguridad 9restablecer atributos de fuentes de eventos 99

evento bajo análisis 160eventos

actual 160bajo análisis 160estados 159

Véase también estados de eventos 159evento bajo análisis 160eventos internos, proceso 160

eventos internos, proceso 160

Ffiltros, añadir grupo de eventos 21filtros, suprimir grupo de eventos 25filtros de grupos de eventos, añadir 21filtros de grupos de eventos, cambiar nombres 26filtros de grupos de eventos, suprimir 25Find_Similar_Events, tarea 123, 137Forward_Event, tarea 123, 139fuente

comandos 5crear, en el servidor de eventos 33en servidor de eventos, listar 56suprimir de una lista de servidores de eventos 41

Ggateway

detener 103generar

informe de eventos 111

generar (continuación)informe sobre tareas completadas 115

grupos de eventos, añadir para netview.rls 34grupos de eventos, cambiar nombres 26grupos de eventos, listar 26grupos de eventos, listar asignados 25

Hherramientas de configuración

enlazar con interfaz de ACF 88mostrar enlace instalado con 48

hora de modificación, actualizar en un registro de ACP 120hostname, variable de entorno 151

Iimportar

archivo .baroc a una base de reglas 68conjunto de reglas a un destino de base de reglas 70conjunto de reglas a un paquete de reglas 69conjunto de reglas a una base de reglas 69especificaciones de clase de evento a una base de

reglas 68paquete de reglas a un destino de base de reglas 70

información de validacióninstalar para un tipo de adaptador 90tipo de adaptador, mostrar 49

informeseventos recibidos por servidor de eventos 113tareas completadas 115

iniciar, servidor de eventos 100iniciar consola de eventos 10instalar

enlace de interfaz de ACF con herramientas deconfiguración 88

información de validación para un tipo de adaptador 90variables de entorno para un adaptador 87

interfaz de ACF, enlazar con herramientas deconfiguración 88

internacionalización, aspectos relacionados con postemsg 8internacionalización, aspectos relacionados con

wpostemsg 59INTERP, variable de entorno 148

LLANG, variable de entorno 148last_modified_time, variable de entorno 151LD_LIBRARY_PATH, variable de entorno 148LIBPATH, variable de entorno 148línea de comandos

argumentos 124ejemplos 124sintaxis 124tareas ejecutables 123

lista de clases de eventos 71lista de servidores de eventos, suprimir una fuente de 41listar

base de reglas, cargada 71base de reglas, definida en el servidor de eventos 71clases de eventos 71conjuntos de reglas 72consolas de eventos definidas 25destinos de bases de reglas 72eventos en base de datos 52

Índice 175

listar (continuación)eventos recibidos 52fuentes en el servidor de eventos 56grupo de eventos 26grupos de eventos asignados 25paquetes de reglas 72parámetros de configuración para un servidor de

eventos 54Log_Event_To_File, tarea 123, 140

Mmensaje, visualizar en el escritorio de un administrador 76modificar

evento 95registro de configuración de adaptador para un ACP 77registro de configuración de adaptador para un valor

predeterminado de tipo de adaptador 82variables de entorno en puntos finales de ACP 92

mostrarinformación de validación instalada para el tipo de

adaptador 49registros de configuración de adaptador en un ACP 42variables de entorno de EIF específicas del adaptador 47Véase también listar 42

motor de reglasproceso 157, 160tec_rule, proceso 157, 160

msg, variable de entorno 151msg_catalog, variable de entorno 151msg_index, variable de entorno 151

Nnivel de gravedad, eventos 9nivel de gravedad Aviso (WARNING) 9nivel de gravedad Crítico (CRITICAL) 9nivel de gravedad Desconocido (UNKNOWN) 9nivel de gravedad Inocuo (HARMLESS) 9nivel de gravedad Leve (MINOR) 9nivel de gravedad Muy grave (FATAL) 9NLSPATH, variable de entorno 148nombre registrado, descripción 3nombres de directorio, notación viinombres de ruta, notación viinum_actions, atributo 161num_actions, variable de entorno 151

Oo_dispatch, variable de entorno 151objeto

referencia 3referencia desde comando 3rutas 3, 4

opcional, argumento 2operadores, asignar a una consola 23operadores, desasignar de una consola 27origin, variable de entorno 151

Ppaquete de reglas

crear 65importar a un destino de base de reglas 70

paquete de reglas (continuación)listar 72suprimir 67

parámetros de configuraciónestablecer para el servidor de eventos 97listar para un servidor de eventos 54

PARSING_FAILED, estado de evento 159PATH, variable de entorno 148perfil de configuración del adaptador (ACP)

actualizar hora de modificación de registro de ACP 120añadir un registro de configuración de adaptador para 13añadir un valor predeterminado de tipo de adaptador

para 82eliminar registro de configuración de adaptador de 40modificar un registro de configuración de adaptador

para 77modificar un valor predeterminado de tipo de adaptador

para 82modificar variables de entorno en puntos finales de

ACP 92mostrar registros de configuración de adaptador de 42mostrar variables de entorno para puntos finales 51

Popup_Message, tarea 123, 141postemsg, comando 8postzmsg, comando 9PRINCIPAL, variable de entorno 148proceso de recepción 157proceso del motor de asignación 157, 160proceso del motor de recepción 158proceso del motor de tareas 157, 161proceso del servidor de interfaz de usuario (UI) 157, 161proceso del servidor de UI

Véase proceso del servidor de interfaz de usuario 161proceso maestro 157, 158procesos

maestro 157, 158motor de asignación 157, 160motor de recepción 157, 158motor de reglas 157, 160motor de tareas 157, 161servidor de interfaz de usuario (UI) 157, 161tec_dispatch 157, 160tec_reception 157, 158tec_rule 157, 160tec_server 157, 158tec_task 157, 161tec_ui_server 157, 161

PROCESSED, estado de evento 159Publicaciones en línea vipunto final

modificar variables de entorno en 92mostrar variables de entorno para un ACP 51

QQUEUED, estado de evento 159

Rreferencia a objeto absoluta 3registrados, nombres 3registro de configuración de adaptador

añadir, para un ACP 13añadir, para un valor predeterminado de tipo de

adaptador 82eliminar de un ACP 40


registro de configuración de adaptador (continuación)modificar, para un ACP 77modificar, para un valor predeterminado de tipo de

adaptador 82mostrar, en un ACP 42

registro de nombres, descripción 3registro de recepción, descripción 158registro de recepción, especificar periodo de conservación de

eventos 97regla

compilar 23, 24, 25, 26, 27, 64reglas del generador de reglas, actualizar 12repeat_count, variable de entorno 151restablecer

atributos de fuentes de eventos 99resúmenes de comandos

comandos de ACF 6comandos de base de datos 6comandos de base de reglas 5comandos de consola 4comandos de mensajes de eventos 5comandos de servidor de eventos 5comandos fuente 5

ruta absoluta 4ruta relativa 4rutas de objeto 3, 4

SSalida de la tarea, diálogo 123scripts de configuración de base de datos, ejecutar 35Send_Email, tarea 123, 142Send_Event, tarea 123, 143server_handle, variable de entorno 152server_hndl, variable de entorno 152server_path, variable de entorno 152servicios

Véase procesos 158servidor de base de datos, comprobar disponibilidad 110servidor de eventos 52

comandos 5descripción de la arquitectura 157detener 102enviar un evento a 8, 59establecer parámetros de configuración para 97generar informe sobre tareas completadas por 115generar informes de eventos recibidos por 113iniciar 100listar fuentes en 56listar parámetros de configuración para 54visualizar estado de 101

severity, variable de entorno 152SHLIB_PATH, variable de entorno 148sintaxis, línea de comandos 124SLOTS, variable de entorno 148Soporte al cliente viiSoporte al cliente de Tivoli viisource, variable de entorno 152status, variable de entorno 152sub_origin, variable de entorno 152sub_source, variable de entorno 152suprimir

archivo de clases 67base de reglas del servidor de eventos 67conjunto de reglas de un paquete de reglas 68conjunto de reglas de una base de reglas 67consola de eventos 24

suprimir (continuación)destino de base de reglas 68filtros de grupos de eventos 25fuente de una lista de servidores de eventos 41grupo de eventos 25paquete de reglas 67

Ttarea

Clean_Database 123, 127Clear_Closed_Events 123, 128Clear_Reception_Log 123, 129Close_Event 123, 130Change_Severity 123, 126Dump_Event_Repository 123, 131Event_Query 123, 133Find_Similar_Events 123, 137Forward_Event 123, 139Log_Event_To_File 123, 140nombres de archivo de script 123nombres descriptivos 123Popup_Message 123, 141salida 123Send_Email 123, 142Send_Event 123, 143visión general 121Wake_Up_Netscape 123, 146

tareas completadas, generar informe sobre 115Tareas T/EC, diálogo 122TEC_BIN_DIR, variable de entorno 149tec_console, comando 10tec_diag_config, archivo 157tec_dispatch, archivo de errores 157tec_dispatch, proceso 157, 160TEC_KB_DIR, variable de entorno 149tec_master, archivo de errores 157TEC_MASTER_PORT, variable de entorno 149TEC_MASTER_START_TIMEOUT, variable de entorno 149tec_reception, proceso 157, 158TEC_RECV_BUFSIZE, variable de entorno 149TEC_RECV_LOG, variable de entorno 149tec_rule, archivo de errores 157tec_rule, proceso 157, 160TEC_RULE_CACHE_CLEAN_FREQ, variable de entorno 149TEC_RULE_CACHE_FULL_HISTORY, variable de

entorno 149TEC_RULE_CACHE_NON_CLOSED_HISTORY, variable de

entorno 149TEC_RULE_CACHE_SIZE, variable de entorno 149TEC_RULE_TRACE, variable de entorno 149TEC_RULE_TRACE_FILE, variable de entorno 149tec_server, proceso 157, 158tec_task, archivo de errores 157tec_task, proceso 157, 161tec_ui_server, proceso 161TISDIR, variable de entorno 149TZ, variable de entorno 149

Uui_server_diag_config, archivo 161upgrade_gui.sh, comando 12

Índice 177

Vvariable de atributo de evento 149variable de entorno

acl 149adapter_host 149administrator 150atributo de evento 149cause_date_reception 150cause_event_handle 150class 150class_name 150CONSOLE_NAME 148credibility 150CHILD_OF_OSERV 148date 150date_event 150date_reception 150descripciones 147DISPLAY 148disponibilidad para tareas que se ejecutan con evento 147duration 151ejemplos

programa desde consola Java 154tarea desde consola Java 153

en puntos finales de ACP, modificar 92ENDPOINT 148ENDPOINT_OID 148ev_key 151EVENT_CLASS 148event_handle 151event_hndl 151hostname 151instalar para un adaptador 87INTERP 148LANG 148last_modified_time 151LD_LIBRARY_PATH 148LIBPATH 148mostrar de EIF específica del adaptador 47msg 151msg_catalog 151msg_index 151NLSPATH 148num_actions 151o_dispatch 151origin 151para un punto final de ACP, mostrar 51PATH 148PRINCIPAL 148repeat_count 151server_handle 152server_hndl 152server_path 152severity 152SHLIB_PATH 148SLOTS 148source 152status 152sub_origin 152sub_source 152TEC_BIN_DIR 149TEC_KB_DIR 149TEC_MASTER_PORT 149TEC_MASTER_START_TIMEOUT 149TEC_RECV_BUFSIZE 149TEC_RECV_LOG 149TEC_RULE_CACHE_CLEAN_FREQ 149

variable de entorno (continuación)TEC_RULE_CACHE_FULL_HISTORY 149TEC_RULE_CACHE_NON_CLOSED_HISTORY 149TEC_RULE_CACHE_SIZE 149TEC_RULE_TRACE 149TEC_RULE_TRACE_FILE 149TISDIR 149TZ 149WLOCALHOST 149

visor de eventos 140visualizar

estado del servidor de eventos 101mensaje en el escritorio de un administrador 76

Wwaddac, comando 13WAITING, estado de evento 160Wake_Up_Netscape, tarea 123, 146wconsole, comando 18wcrtnvgroups, comando 34wcrtsrc, comando 33wchkclass, comando 17wdbconfig.sh, comando 35wdbmaint.sh, comando 38wdelac, comando 40wdelsrc, comando 41WLOCALHOST, variable de entorno 149wlsac, comando 42wlsaddflt, comando 45wlsadenv, comando 47wlsadgui, comando 48wlsadval, comando 49wlsaeenv, comando 51wlsemsg, comando 52wlsesvrcfg, comando 54wlssrc, comando 56wmigcon, comando 57wpostemsg, comando 59wpostzmsg, comando 9wrb, comando 62wrbupgrade, comando 75wruntask, comando 122, 124wsendresp, comando 76wsetac, comando 77wsetaddflt, comando 82wsetadenv, comando 87wsetadgui, comando 88wsetadval, comando 90wsetaeenv, comando 92wsetemsg, comando 95wsetesvrcfg, comando 97wsetsrc, comando 99wstartesvr, comando 100wstatesvr, comando 101wstopesvr, comando 102wstoptecgw, comando 103wtdbclear, comando 104wtdbclear.pl, comando 106wtdbspace, comando 108wtdbstat, comando 110wtdumper, comando 111wtdumprl, comando 113wtdumptr, comando 115wtecexport, comando 116wtecimport, comando 118wtouchac, comando 120


Impreso en España

GC10-3624-00

Manual de consulta - IBMpublib.boulder.ibm.com/tividd/td/tec/GC32-0666-02/es_ES/... ·...

Documents

Transcript of Manual de consulta - IBMpublib.boulder.ibm.com/tividd/td/tec/GC32-0666-02/es_ES/... ·...