Manual de Consulta de Comandos de Tivoli

IBM Tivoli Enterprise Console
Manual de consulta de comandos y tareas

V ersin 3.9
SC10-3980-00
IBM Tivoli Enterprise Console
Manual de consulta de comandos y tareas

V ersin 3.9
SC10-3980-00
Nota Antes de utilizar esta informacin y el producto al que da soporte, lea la informacin del apartado Avisos en la pgina 181.
Primera edicin (agosto 2003) Este manual es la traduccin del original en ingls IBM Tivoli Enterprise Console Command and Task Reference, SC32-1232-00. Esta edicin se aplica a la versin 3, release 9, de IBM Tivoli Enterprise Console (nmero de producto 5698-TEC) y a todos los releases y modificaciones posteriores hasta que se indique lo contrario en nuevas ediciones. Copyright International Business Machines Corporation 2002. Reservados todos los derechos.
Contenido
Acerca de este libro . . . . . . . . . v
A quin va dirigida esta publicacin . . . . . . v Publicaciones . . . . . . . . . . . . . . v Biblioteca de IBM Tivoli Enterprise Console . . . v Publicaciones relacionadas . . . . . . . . vi Cmo acceder a las publicaciones en lnea . . . vi Pedidos de publicaciones . . . . . . . . . vii Cmo ponerse en contacto con el servicio de soporte de software . . . . . . . . . . . vii Participacin en grupos de noticias . . . . . . vii Convenios utilizados en esta gua . . . . . . viii Convenios tipogrficos . . . . . . . . . viii Rutas y variables que dependen del sistema operativo . . . . . . . . . . . . . . ix Sintaxis de la lnea de comandos . . . . . . ix wlsadval . . . . . . . . . . . wlsaeenv . . . . . . . . . . . wlsemsg . . . . . . . . . . . wlsesvrcfg . . . . . . . . . . . wlssrc . . . . . . . . . . . . wmigcon . . . . . . . . . . . wpostemsg (versin de punto final) . . wpostemsg (versin de nodo gestionado) wpostzmsg (versin de punto final) . . wpostzmsg (versin de nodo gestionado) wrb . . . . . . . . . . . . . wrb_default_rb . . . . . . . . . wrbupgrade . . . . . . . . . . wsendresp . . . . . . . . . . . wsetac . . . . . . . . . . . . wsetaddflt . . . . . . . . . . . wsetadenv . . . . . . . . . . wsetadgui . . . . . . . . . . wsetadval . . . . . . . . . . wsetaeenv . . . . . . . . . . wsetemsg . . . . . . . . . . . wsetesvrcfg . . . . . . . . . . wsetsrc . . . . . . . . . . . wsighup . . . . . . . . . . . wstartesvr . . . . . . . . . . wstartmaint.sh . . . . . . . . . wstatesvr . . . . . . . . . . . wstopesvr . . . . . . . . . . wstopmaint.sh . . . . . . . . . wstoptecgw . . . . . . . . . . wtdbclear . . . . . . . . . . wtdbclear.pl . . . . . . . . . . wtdbspace . . . . . . . . . . wtdbstat . . . . . . . . . . . wtdumper . . . . . . . . . . wtdumprl . . . . . . . . . . wtdumptr . . . . . . . . . . wtecexport . . . . . . . . . . wtecimport . . . . . . . . . . wtouchac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 . 58 . 59 . 61 . 63 . 64 . 66 . 68 . 70 . 72 . 74 . 91 . 92 . 93 . 94 . 99 . 105 . 106 . 108 . 110 . 113 . 115 . 117 . 118 . 119 . 120 . 121 . 122 . 123 . 124 . 125 . 127 . 129 . 131 . 132 . 134 . 136 . 137 . 139 . 142
Captulo 1. Comandos. . . . . . . . . 1
Establecimiento del entorno Tivoli . . . . . Utilizacin de los comandos de Tivoli . . . . Referencias a objetos . . . . . . . . . . Nombres registrados . . . . . . . . . Rutas de objeto . . . . . . . . . . Comandos de Tivoli Enterprise Console . . . Comandos de consola . . . . . . . . Comandos de fuentes . . . . . . . . Comandos de mensajes de eventos . . . . Comandos de servidor de eventos . . . . Comandos de base de reglas . . . . . . Comandos de base de datos . . . . . . Comandos del Recurso de configuracin del adaptador . . . . . . . . . . . . Comandos de adaptador . . . . . . . chkclass . . . . . . . . . . . . . . postemsg . . . . . . . . . . . . . postzmsg . . . . . . . . . . . . . tec_console . . . . . . . . . . . . TECAgent . . . . . . . . . . . . . upgrade_gui.sh . . . . . . . . . . . waddac . . . . . . . . . . . . . . wchkclass . . . . . . . . . . . . . wconsole . . . . . . . . . . . . . wcrtdefcfg . . . . . . . . . . . . . wcrtebizgroups . . . . . . . . . . . wcrtmtgroups . . . . . . . . . . . wcrtnvgroups . . . . . . . . . . . wcrtsrc . . . . . . . . . . . . . . wcrtteccfg . . . . . . . . . . . . . wdbconfig.sh . . . . . . . . . . . . wdbmaint.sh . . . . . . . . . . . . wdelac . . . . . . . . . . . . . . wdelsrc . . . . . . . . . . . . . . wlsac . . . . . . . . . . . . . . wlsaddflt . . . . . . . . . . . . . wlsadenv . . . . . . . . . . . . . wlsadgui . . . . . . . . . . . . .
Copyright IBM Corp. 2002
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . .
1 1 2 2 3 3 4 4 4 5 5 5
. 6 . 6 . 7 . 8 . 10 . 12 . 14 . 16 . 17 . 22 . 23 . 37 . 38 . 40 . 41 . 42 . 43 . 44 . 45 . 47 . 48 . 49 . 52 . 54 . 55
Captulo 2. Tareas . . . . . . . . . 143

Nombres y scripts de tareas Salida de las tareas . . . Change_Severity . . . . Clean_Database . . . . Clear_Closed_Events . . . Clear_Reception_Log . . . Close_Event . . . . . . Dump_Event_Repository . Event_Query . . . . . Find_Similar_Events . . . Forward_Event . . . . . Log_Event_To_File . . . Popup_Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144 145 146 147 148 149 150 151 153 157 159 160 161
iii
Send_Email . . . Send_Event . . . Start_Maintenance . Wake_Up_Netscape
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
162 163 166 169
Vuelco de variables de entorno al ejecutar un programa desde la consola de eventos . . .
. 177
Captulo 3. Variables de entorno disponibles para las tareas . . . . . 171

Descripciones de las variables . . . . . . . . 171 Ejemplos . . . . . . . . . . . . . . . 176 Vuelco de variables de entorno al ejecutar una tarea desde una regla . . . . . . . . . . 176
Apndice. Parmetros de configuracin . . . . . . . . . . . 179 Avisos . . . . . . . . . . . . . . 181

Marcas registradas. . . . . . . . . . . . 183
ndice . . . . . . . . . . . . . . . 185
iv
IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas
Acerca de este libro

El producto IBM Tivoli Enterprise Console es una aplicacin de gestin de eventos basado en reglas que integra la gestin del sistema, la red, las bases de datos y las aplicaciones para garantizar una disponibilidad ptima de los servicios de TI de una organizacin. En la publicacin IBM Tivoli Enterprise Console Manual de consulta de comandos y tareas se describen los comandos de Tivoli Enterprise Console, las tareas proporcionadas en la biblioteca de tareas incluida en el producto Tivoli Enterprise Console y las variables de entorno disponibles para las tareas de la biblioteca de tareas.
A quin va dirigida esta publicacin

Esta publicacin est dirigida a los administradores de Tivoli Enterprise Console que desean utilizar la interfaz de lnea de comandos y configurar las tareas de Tivoli Enterprise Console. Debe estar familiarizado con el software siguiente: v Los sistemas operativos utilizados en su empresa v Tivoli Management Framework
Publicaciones
En este apartado se enumeran las publicaciones incluidas en la biblioteca de Tivoli Enterprise Console y los documentos relacionados. Tambin se describe cmo acceder a las publicaciones de Tivoli en lnea y cmo realizar pedidos de publicaciones de Tivoli.
Biblioteca de IBM Tivoli Enterprise Console

En la biblioteca de Tivoli Enterprise Console encontrar los documentos siguientes: v IBM Tivoli Enterprise Console Adapters Guide, SC32-1242 Proporciona informacin acerca de los adaptadores soportados, incluida la informacin para instalar y configurar estos adaptadores. v IBM Tivoli Enterprise Console Manual de consulta de comandos y tareas, SC10-3980. Proporciona informacin detallada acerca de los comandos de Tivoli Enterprise Console, las tareas predefinidas incluidas en la biblioteca de tareas y las variables de entorno que estn disponibles para las tareas que se ejecutan contra un evento. v IBM Tivoli Enterprise Console Gua de instalacin, SC10-3979 Describe la instalacin, actualizacin y desinstalacin del producto Tivoli Enterprise Console. v IBM Tivoli Enterprise Console Release Notes, SC32-1238 Proporciona informacin especfica del release que no est disponible hasta el momento de lanzar el producto al mercado. v IBM Tivoli Enterprise Console Rule Developers Guide, SC32-1234 Describe cmo desarrollar reglas e integrarlas para la correlacin de eventos y la gestin automatizada de eventos. v IBM Tivoli Enterprise Console Rule Set Reference, SC32-1282
Proporciona informacin de consulta acerca de los conjuntos de reglas Tivoli Enterprise Console. v IBM Tivoli Enterprise Console Gua del usuario, SC10-3981 Proporciona informacin general sobre el producto Tivoli Enterprise Console y describe cmo configurar y utilizar Tivoli Enterprise Console para gestionar los eventos. v IBM Tivoli Enterprise Console Warehouse Enablement Pack: Implementation Guide, SC32-1236 Describe cmo instalar y configurar el paquete de activacin del almacn para el producto Tivoli Enterprise Console; tambin describe las estructuras y el flujo de datos utilizados por el paquete del almacn. v Tivoli Event Integration Facility Reference, SC32-1241 Describe cmo desarrollar sus propios adaptadores de eventos adaptados a su entorno de red y a las necesidades especficas de su empresa. En este manual tambin se describe cmo filtrar los eventos en la fuente.
Publicaciones relacionadas
El glosario de software de Tivoli contiene las definiciones de muchos de los trminos tcnicos relacionados con el software de Tivoli. El glosario de software de Tivoli est disponible en el sitio web siguiente (nicamente en ingls): http://www.ibm.com/software/tivoli/library/ Para acceder al glosario, haga clic en el enlace Glossary del panel izquierdo de la ventana de la biblioteca de software de Tivoli.
Cmo acceder a las publicaciones en lnea

El CD de documentacin contiene las publicaciones existentes en la biblioteca del producto. El formato de las publicaciones puede ser PDF, HTML o ambos. Consulte el archivo readme del CD para ver las instrucciones necesarias para acceder a la documentacin. IBM publica en el sitio web de Tivoli Software Information Center las publicaciones de este y de otros productos Tivoli en cuanto estn disponibles y siempre que se actualizan. Para acceder a Tivoli Software Information Center, debe dirigirse primero a la biblioteca de software de Tivoli, en la direccin web siguiente: http://www.ibm.com/software/tivoli/library/ Desplcese hacia abajo por la pgina y haga clic en el enlace Product manuals. En la ventana Tivoli Technical Product Documents Alphabetical Listing, haga clic en el enlace IBM Tivoli Enterprise Console para acceder a la biblioteca del producto en Tivoli Information Center. Nota: si imprime los documentos PDF en un tamao de papel que no sea carta (letter), marque el cuadro de seleccin Ajustar a pgina de la ventana Imprimir de Adobe Acrobat. Para abrir esta ventana, haga clic en Archivo Imprimir. La opcin Ajustar a pgina garantiza que se imprimir todo el contenido de las pginas de tamao carta en el papel que utilice.
vi
Pedidos de publicaciones
Puede solicitar muchas de las publicaciones de Tivoli en lnea en el sitio web siguiente: http://www.elink.ibmlink.ibm.com/public/applications/publications/ cgibin/pbi.cgi Tambin puede solicitarlas por telfono llamando a uno de los siguientes nmeros: v En los Estados Unidos: 800-879-2755 v En Canad: 800-426-4968 En los dems pases, consulte el sitio web siguiente para ver una lista de los nmeros de telfono correspondientes: http://www.ibm.com/software/tivoli/order-lit/
Cmo ponerse en contacto con el servicio de soporte de software

Si tiene algn problema con algn producto de Tivoli, visite el siguiente sitio web de soporte de software de IBM: http://www.ibm.com/software/sysmgmt/products/support/ Si desea ponerse en contacto con el servicio de soporte de software, consulte la publicacin IBM Software Support Guide en este sitio web: http://techsupport.services.ibm.com/guides/handbook.html En esta gua se proporciona informacin que permite ponerse en contacto con el servicio de soporte de software de IBM en funcin de la gravedad del problema y tambin se proporciona la informacin siguiente: v Registro y condiciones exigidas. v Nmeros de telfono y direcciones de correo electrnico dependiendo del pas en que se encuentre. v Informacin de la que debe disponer antes de ponerse en contacto con el servicio de soporte de software de IBM.
Participacin en grupos de noticias

Los grupos de usuarios proporcionan a los profesionales del software un foro en el que intercambiar ideas, conocimientos tcnicos y experiencia acerca de un producto. Se encuentran en Internet y estn disponibles mediante programas de lector de noticias estndar. Estos grupos estn destinados principalmente para la comunicacin entre usuarios y no sustituyen el soporte formal. Para acceder a un grupo de noticias, utilice las instrucciones correspondientes a su navegador. Utilice estas instrucciones si su navegador es Microsoft Internet Explorer. 1. Abra un navegador Internet Explorer. 2. En el men Herramientas, haga clic en Opciones de Internet. 3. En la ventana Opciones de Internet, haga clic en la pestaa Programas.
vii
4. En la lista Grupos de noticias, haga clic en la fecha hacia abajo y despus haga clic en Outlook Express. 5. Haga clic en Aceptar. 6. Cierre el navegador Internet Explorer y bralo de nuevo. 7. Corte y pegue la direccin del grupo de noticias de un producto en el campo Direccin del navegador y pulse Intro para abrir el grupo de noticias. Utilice estas instrucciones si su navegador es Netscape Navigator. 1. Abra un navegador Netscape Navigator. 2. En el men Editar, haga clic en Preferencias. Se visualiza la ventana Preferencias. 3. En la vista Categora, haga clic en Correo/Grupos de noticias para visualizar la configuracin de Correo/Grupos de noticias. 4. Marque el cuadro de seleccin Utilizar Netscape Mail como aplicacin de correo predeterminada. 5. Haga clic en Aceptar. 6. Cierre el navegador Netscape Navigator y bralo de nuevo. 7. Corte y pegue la direccin del grupo de noticias de un producto en el campo Direccin del navegador y pulse Intro para abrir el grupo de noticias. IBM Tivoli Enterprise Console: news://news.software.ibm.com/ibm.software.tivoli.enterprise-console IBM Tivoli NetView para UNIX y IBM Tivoli NetView para Windows: news://news.software.ibm.com/ibm.software.tivoli.netview-unix-windows
Convenios utilizados en esta gua

En esta gua se utilizan convenios para los trminos y acciones especiales, para las rutas y los comandos que dependen del sistema operativo, y para la sintaxis de los comandos.
Convenios tipogrficos
En esta gua se utilizan los siguientes convenios tipogrficos: Negrita v Comandos en minscula o en una combinacin de minsculas y maysculas que de no destacarse seran difciles de distinguir del resto de texto v Controles de la interfaz (cuadros de seleccin, pulsadores, botones de seleccin, botones cclicos, campos, carpetas, iconos, cuadros de lista, elementos de los cuadros de lista, listas de varias columnas, contenedores, opciones de men, nombres de mens, pestaas, hojas de propiedades), etiquetas (como Sugerencia: y Consideraciones sobre el sistema operativo:) v Palabras clave y parmetros dentro del texto Cursiva v Palabras definidas en el texto v Para dar nfasis a palabras (palabras como tales)
viii
v Trminos nuevos en el texto (excepto en las listas de definiciones) v Variables y valores que debe proporcionar el usuario Monoespaciado v Ejemplos y cdigo de ejemplo v Nombres de archivos, palabras clave de programacin y otros elementos difciles de distinguir del resto del texto v Texto de mensajes y solicitudes dirigidas al usuario v Texto que el usuario debe especificar v Valores para los argumentos o las opciones de los comandos
Rutas y variables que dependen del sistema operativo

En esta gua se utiliza el convenio de UNIX para especificar las variables de entorno y para la notacin de directorios. Si utiliza la lnea de comandos de Windows, sustituya $variable por %variable% en las variables de entorno y reemplace todas las barras inclinadas (/) por barras inclinadas invertidas (\) en las rutas de directorios. Nota: si utiliza el shell bash en un sistema Windows, puede utilizar los convenios de UNIX.
Sintaxis de la lnea de comandos

Este documento utiliza los caracteres especiales siguientes para definir la sintaxis de los comandos: [] ... | Identifica un argumento opcional. Los argumentos que no estn delimitados por corchetes son obligatorios. Indica que puede especificar varios valores para el argumento anterior. Indica informacin que se excluye mutuamente. Puede emplear o bien el argumento situado a la izquierda del separador o bien el argumento situado a la derecha del separador. No es posible emplear ambos argumentos en un solo uso del comando. Delimita un conjunto de argumentos que se excluyen mutuamente cuando uno de los argumentos es obligatorio. Si los argumentos son opcionales, se delimitan mediante corchetes ([ ]).
{}
Notas: 1. El nmero de caracteres mximo de un argumento es 256. 2. Especifique los valores de los argumentos que tienen espacios intercalados entre comillas simples o dobles. Por ejemplo: wsetsrc [S servidor] [l etiqueta] [n nombre] fuente El argumento fuente es el nico argumento obligatorio del comando wsetsrc. Los corchetes que delimitan los dems argumentos indican que stos son opcionales. El comando wlsac proporciona otro ejemplo: wlsac [l | f formato] [clave... ] perfil
ix
En este ejemplo, los argumentos l y f formato se excluyen mutuamente y son opcionales. El argumento perfil es obligatorio. El argumento clave es opcional. Asimismo, los puntos suspensivos (...) que figuran tras el argumento clave indican que 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 excluyen mutuamente, aunque debe especificarse uno de los argumentos. Asimismo, los puntos suspensivos (...) indican que puede especificar varios paquetes o conjuntos de reglas.
Captulo 1. Comandos
En este captulo se describe cmo establecer un entorno Tivoli para utilizar comandos de Tivoli y se proporciona informacin detallada acerca de cada comando de Tivoli Enterprise Console.
Establecimiento del entorno Tivoli

Cuando se instala Tivoli Management Framework, se crean dos archivos de configuracin que puede utilizar para establecer fcilmente las rutas de bsqueda y las variables de entorno correctas. Estos archivos estn disponibles en cualquier cliente o en el servidor de la regin de gestin de Tivoli. Siga estos pasos para configurar el entorno del sistema UNIX para ejecutar los comandos de Tivoli Enterprise: 1. Inicie la sesin en un cliente Tivoli Enterprise o en el servidor Tivoli Enterprise en el que el administrador de Tivoli Enterprise tenga un alias con la funcin super para la regin de gestin de Tivoli. Consulte la publicacin Tivoli Management Framework Gua del usuario para obtener informacin detallada sobre la creacin de administradores de Tivoli Enterprise con funciones de autorizacin para la regin. 2. Hay disponibles dos scripts de inicializacin y configuracin del entorno: uno para el shell Bourne y otro para el shell C. Si utiliza el shell Bourne, ejecute el comando siguiente:
. /etc/Tivoli/setup_env.sh
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 para 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 son scripts y deben ejecutarse con sh; muchos comandos pueden ejecutarse desde la lnea de comandos. Ahora ya tiene un entorno preparado para llevar a cabo operaciones de Tivoli.
Utilizacin de los comandos de Tivoli

Los comandos de Tivoli sirven para llevar a cabo operaciones del sistema desde una lnea de comandos en lugar de utilizar el escritorio de Tivoli. A menudo resulta til o ms apropiado llamar una operacin de la aplicacin de gestin de Tivoli desde la lnea de comandos que desde el escritorio; por ejemplo: v Si no tiene acceso a una pantalla grfica, como sucede cuando se inicia la sesin a travs de una lnea telefnica o cuando se ejecutan scripts de mantenimiento. 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 ratn sino llamar un comando desde un shell.
v Si una operacin no est disponible mediante el escritorio de Tivoli. La mayor parte de los comandos de usuario final de Tivoli empiezan por la letra w, que los identifica como comandos de Tivoli. Los comandos de usuario final de Tivoli que no utilizan los servicios Tivoli no empiezan por la letra w. La mayora de los comandos tambin se han desarrollado con la sintaxis w+verbo+objeto, que coincide con la descripcin que se dara de la accin. Por ejemplo, para crear un usuario, utilice el comando wcrtusr. Para suprimir un usuario, utilice el comando wdelusr.
Referencias a objetos
Cuando se hace una referencia a un objeto desde un comando, la referencia no es una referencia a objeto absoluta como las que se utilizan en programacin. En su lugar, se utiliza un nombre que sea fcil de emplear. Este nombre de uso sencillo se obtiene a partir de un nombre dado al objeto por el usuario de la aplicacin (por ejemplo, cuando se crea una regin de poltica). Se pueden emplear dos formatos de nombres distintos con los comandos de la interfaz de lnea de comandos, tal como se indica a continuacin: v Nombres registrados v Rutas de objeto Los programas de lnea de comandos de Tivoli admiten ambos mtodos de denominacin. En ocasiones le resultar ms cmodo utilizar un formato que el otro.
Nombres registrados
Cada regin de Tivoli contiene un registro de nombres. El registro de nombres es una tabla bidimensional que contiene los nombres y los tipos de objetos. Los nombres registrados son nombres de objetos que se pueden consultar en el registro de nombres por el nombre de instancia y el tipo de recurso. Cada objeto o recurso tiene un nombre y un tipo. Por ejemplo, una impresora puede tener el nombre apple y el tipo impresora. Todos los objetos de la regin de Tivoli que necesiten consultarse deben registrarse en el registro de nombres al crearse, deben eliminarse del registro al suprimirse y deben moverse al cambiar su etiqueta. Para la mayor parte de los recursos del producto Tivoli Enterprise Console, estas acciones se efectan automticamente. Consulte la publicacin IBM Tivoli Management Framework Planning for Deployment Guide para ver una lista completa de los tipos de recursos y la informacin de intercambio. El uso del registro de nombres facilita el intercambio de recursos entre varias regiones de Tivoli. Consulte la publicacin IBM Tivoli Management Framework Planning for Deployment Guide para ver una descripcin completa de las regiones de Tivoli y las conexiones entre regiones. Utilice el comando wlookup para consultar un recurso. Por ejemplo, para ver todos los tipos de recursos registrados, emplee el comando siguiente:
% wlookup R
Consulte en la publicacin IBM Tivoli Management Framework Reference Manual una descripcin 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 el comando siguiente:
wls @Administrator:jerry
donde Administrator es el recurso y jerry es la instancia.
Rutas de objeto
Las rutas de objeto son parecidas a los nombres de ruta de los sistemas de archivos y pueden ser relativas o absolutas. Una ruta absoluta es una ruta que empieza por un carcter de barra inclinada (/). Una ruta relativa puede empezar por cualquier otro carcter que no sea una barra inclinada (/), como por ejemplo los componentes de rutas especiales correspondientes al directorio actual (.) y al directorio padre (..). A continuacin se indican algunos ejemplos de nombres de ruta 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 es la siguiente: /distintivo/padre/[tipo:]nombre donde: distintivo Es un tipo de recurso. padre tipo Es el principio del nombre de ruta de objeto. Es una etiqueta explcita opcional.
nombre Es la instancia concreta en la que desea efectuar alguna operacin. Utilice el especificador tipo opcional si debe especificar un recurso concreto que tiene el mismo nombre que otro recurso de otro tipo. Por ejemplo, imagine que la regin de poltica Engineering tiene un gestor de perfiles denominado Servers y una subregin de poltica llamada Servers. Para especificar el gestor de perfiles con un nombre de ruta de objeto, podra emplear el comando siguiente:
wls /Regions/Engineering/ProfileManager:Servers
Comandos de Tivoli Enterprise Console

En los apartados siguientes se describen brevemente los comandos de Tivoli Enterprise Console por componente.
Captulo 1. Comandos
Comandos de consola
Comando tec_console wconsole wcrtdefcfg wcrtebizgroups wcrtmtgroups wcrtnvgroups wcrtteccfg wlsemsg wmigcon Finalidad Inicia una consola de eventos. Gestiona las consolas de eventos. Crea una configuracin predeterminada en la consola de eventos. Crea los grupos de e-business en la consola de eventos. Crea un grupo de eventos para ver los hosts que estn en modo de mantenimiento en la consola de eventos. Crea los grupos de eventos necesarios para emplear el conjunto de reglas netview.rls. Crea una configuracin predeterminada para el producto Tivoli Enterprise Console. Muestra una lista de los eventos recibidos para una consola. Este comando requiere los servicios de Tivoli Management Framework. Efecta la migracin de las consolas, los grupos de eventos, los filtros de grupo de eventos y los operadores de la versin 3.6 de Tivoli Enterprise Console a las versiones 3.7.x, 3.8 y 3.9. Visualiza una respuesta dirigida a un administrador. Modifica un evento. Este comando requiere los servicios de Tivoli Management Framework. Exporta las definiciones de la consola de eventos a un archivo. Importa definiciones de consola de eventos de un archivo a otra regin de Tivoli.
wsendresp wsetemsg wtecexport wtecimport
Comandos de fuentes
Comando wcrtsrc wdelsrc wlssrc wsetsrc Finalidad Crea una fuente en el servidor de eventos. Suprime una fuente de la lista de servidores de eventos. Proporciona una lista de las fuentes existentes en el servidor de eventos. Restablece los atributos de las fuentes de eventos.
Comandos de mensajes de eventos

Comando postemsg postzmsg TECAgent wpostemsg (versin de punto final) wpostemsg (versin de nodo gestionado) wpostzmsg (versin de punto final) Finalidad Enva un evento al servidor de eventos. Este comando no requiere los servicios de Tivoli Management Framework. Enva un evento al servidor de eventos mediante comunicaciones no de Tivoli. Enva un evento al servidor de eventos mediante comunicaciones Tivoli o no de Tivoli. Enva un evento al servidor de eventos. Este comando requiere los servicios de Tivoli Management Framework. Enva un evento al servidor de eventos. Este comando requiere los servicios de Tivoli Management Framework. Enva un evento al servidor de eventos mediante comunicaciones de punto final Tivoli a un gateway de Tivoli Enterprise Console o mediante comunicaciones no de Tivoli directamente al servidor de eventos.
Comando wpostzmsg (versin de nodo gestionado)
Finalidad Enva un evento al servidor de eventos mediante comunicaciones de nodo gestionado Tivoli o mediante comunicaciones no de Tivoli.
Comandos de servidor de eventos

Comando wlsesvrcfg wsetesvrcfg wstartesvr wstartmaint.sh wstatesvr wstopesvr wstopmaint.sh Finalidad Muestra una lista de los parmetros de configuracin de un servidor de eventos en ejecucin. Establece los parmetros de configuracin para el servidor de eventos. Inicia el servidor de eventos. Informa al servidor de eventos de que un host ha entrado en modo de mantenimiento. Visualiza el estado del servidor de eventos. Detiene el servidor de eventos. Informa al servidor de eventos de que se est cancelando el modo de mantenimiento continuado o planificado para un recurso de red.
Comandos de base de reglas

Comando chkclass Finalidad Comprueba si un archivo de definiciones de clases de eventos es vlido cotejndolo con un directorio de base de reglas. Este comando permite desarrollar clases en un entorno en el que se utilizan las comunicaciones no de Tivoli. Actualiza las reglas generadas por la versin 3.6.2 y anteriores del generador de reglas a la sintaxis soportada por el compilador de reglas proporcionado en esta versin del producto Tivoli Enterprise Console. Comprueba si un archivo de definiciones de clases de eventos es vlido cotejndolo con un directorio de base de reglas. Este comando permite desarrollar clases en un entorno Tivoli Enterprise Console. Gestiona las bases de reglas. Desactiva los conjuntos de reglas activos en la base de reglas predeterminadas. Actualiza las bases de reglas y los archivos BAROC de eventos creados con las versiones de Tivoli Enterprise Console anteriores a la 3.7 al formato correspondiente a la versin 3.7 y posteriores.
upgrade_gui.sh
wchkclass
wrb wrb_default_rb wrbupgrade
Comandos de base de datos

Comando wdbconfig.sh wdbmaint.sh wtdbclear wtdbclear.pl wtdbspace wtdbstat Finalidad Ejecuta los scripts de configuracin de la base de datos generados. Actualiza las estadsticas de distribucin de datos de la base de datos y reorganiza la base de datos. Borra eventos de la base de datos de eventos. Borra eventos de la base de datos de eventos. Proporciona estadsticas de la base de datos. Visualiza el estado del servidor de base de datos.
Captulo 1. Comandos
Comando wtdumper wtdumprl wtdumptr
Finalidad Genera un informe de eventos correspondiente a los eventos procesados del repositorio de eventos. Genera un informe de los eventos recibidos del registro de recepcin. Genera un informe de las tareas completadas.
Comandos del Recurso de configuracin del adaptador

Comando waddac wdelac wlsac wlsaddflt wlsadenv wlsadgui wlsadval wlsaeenv wsetac wsetaddflt wsetadenv wsetadgui wsetadval wsetaeenv wstoptecgw wtouchac Finalidad Agrega un registro de configuracin de adaptador para un perfil de configuracin de adaptador. Elimina un registro de configuracin de adaptador de un perfil de configuracin de adaptador. Muestra los registros de configuracin de adaptador de un perfil de configuracin de adaptador. Muestra los registros de configuracin de adaptador de un perfil de configuracin de adaptador. Muestra una lista instalada de las variables de entorno de EIF (Recurso de integracin de eventos) especficas del adaptador. Muestra un enlace instalado con las herramientas de configuracin ampliadas especficas del adaptador. Muestra la informacin de validacin instalada para un tipo de adaptador. Muestra las variables de entorno disponibles en un punto final de perfil de configuracin de adaptador. Modifica un registro de configuracin de adaptador existente en un perfil de configuracin de adaptador. Agrega o establece un registro de configuracin de adaptador para un valor predeterminado de tipo de adaptador. Instala una lista de variables de entorno de EIF (Recurso de integracin de eventos) reconocidas para un tipo de adaptador. Instala un enlace de la GUI del Recurso de configuracin del adaptador con una herramienta de configuracin especfica del tipo. Instala informacin de validacin para un tipo de adaptador. Modifica las variables de entorno almacenadas en los puntos finales del perfil de configuracin de adaptador. Detiene el gateway de Tivoli Enterprise Console. Actualiza la hora de modificacin de un registro de perfil de configuracin de adaptador para forzar la redistribucin.
Comandos de adaptador
Comando wsighup Finalidad Vuelve a cargar los archivos de configuracin y formato para el adaptador del registro de eventos de Windows y el adaptador de registro de eventos de Windows NT.
chkclass
Comprueba si un archivo de definiciones de clases de eventos es vlido cotejndolo con un directorio de base de reglas.
Sintaxis
chkclass [k dir_base_reglas] archivo_clases
Descripcin
El comando chkclass comprueba que un archivo de definiciones de clases de eventos sea vlido para el directorio de base de reglas especificado por el argumento dir_base_reglas. El argumento dir_base_reglas que se utiliza con la opcin k slo es opcional si no se ha establecido la variable de entorno $TEC_KB_DIR (que no se establece automticamente). Este comando se proporciona para desarrollar clases en un sistema que no tiene instalado Tivoli Management Framework. Nota: si el sistema tiene instalado Tivoli Management Framework, utilice el comando wchkclass.
Autorizacin
Ninguna.
Opciones
archivo_clases Especifica la ruta del archivo de definiciones de clases de eventos que se va a comprobar. El argumento ruta debe especificarse como un nombre de ruta absoluto. k dir_base_reglas Especifica el directorio de base de reglas. El valor predeterminado es el directorio definido por la variable de entorno $TEC_KB_DIR.
Ejemplos
El ejemplo siguiente comprueba el archivo de definiciones de clases de eventos /install/bin/hpux/TME/TEC/classfile1 cotejndolo con el directorio de base de reglas especificado por la variable de entorno $TEC_KB_DIR:
chkclass /install/bin/hpux/TME/TEC/classfile1
Vase tambin
wchkclass
Captulo 1. Comandos
postemsg
Enva un evento al servidor de eventos mediante comunicaciones no de Tivoli.
Sintaxis
postemsg S servidor | f archivo_configuracin [m mensaje] [r gravedad] [atributo=valor...] clase fuente
Descripcin
El comando postemsg enva un evento a un servidor de eventos. Este comando no requiere el uso de los servicios Tivoli Management Framework y funciona en aquellos entornos en los que no hay software Tivoli instalado. Notas: 1. Aunque este comando sigue estando admitido, es preferible utilizar el comando postzmsg para enviar eventos mediante comunicaciones no de Tivoli. 2. Si Tivoli Management Framework est instalado en el sistema, puede utilizar los comandos wpostzmsg (versin de nodo gestionado) o wpostzmsg (versin de punto final). 3. Puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador). Puesto que este comando no tiene acceso a los catlogos de mensajes de los paquetes de soporte de idiomas, postemsg muestra los mensajes de error en ingls nicamente.
Autorizacin
Ninguna.
Opciones
atributo=valor Asigna un valor a cualquier atributo vlido. El atributo debe estar definido para la clase de evento. Separe las diversas expresiones atributo=valor con espacios. clase Especifica la clase del evento. Debe coincidir con una clase configurada en el servidor. El adaptador define las clases y stas se indican en el archivo BAROC del adaptador. Si hay algn espacio en blanco en el nombre de la clase, especifique el nombre de la clase entre comillas dobles. Especifica la fuente del evento. Si hay algn espacio en blanco en el nombre de la fuente, especifquelo entre comillas dobles.
fuente
f archivo_configuracin Especifica el nombre del archivo de configuracin del adaptador. Debe especificar el argumento S o el argumento f. Consulte la publicacin IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Especifica el texto del evento, entre comillas dobles.
r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento. S servidor Especifica el nombre de host o la direccin IP del servidor. Utilice esta opcin nicamente si el correlacionador de puertos se ejecuta en el servidor de eventos. Debe especificar el argumento S o el argumento f.
Ejemplos
El ejemplo siguiente para los entornos UNIX enva un mensaje de prueba que muestra un evento Su_Failure en las consolas de eventos:
postemsg -S tecbox -r AVISO -m "Error de inicio de sesin su". Su_Failure LOGFILE
Vase tambin
postzmsg, TECAgent, wpostemsg (versin de punto final), wpostemsg (versin de nodo gestionado), wpostzmsg (versin de punto final), wpostzmsg (versin de nodo gestionado), wsetemsg
Captulo 1. Comandos
postzmsg
Enva un evento al servidor de eventos mediante comunicaciones no de Tivoli.
Sintaxis
postzmsg S servidor | f archivo_configuracin [m mensaje] [r gravedad] [atributo=valor...] clase fuente
Descripcin
El comando postzmsg enva un evento a un servidor de eventos. Este comando no requiere el uso de los servicios Tivoli Management Framework y funciona en aquellos entornos en los que no hay software Tivoli instalado. Puesto que este comando no tiene acceso a los catlogos de mensajes de los paquetes de soporte de idiomas, postzmsg muestra los mensajes de error en ingls nicamente. Notas: 1. Si Tivoli Management Framework est instalado en el sistema, puede utilizar los comandos wpostzmsg (versin de punto final) o wpostzmsg (versin de nodo gestionado). 2. Puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador).
Autorizacin
Ninguna.
Opciones
fuente
f archivo_configuracin Especifica el nombre del archivo de configuracin. Debe especificar el argumento S o el argumento f. Consulte la publicacin IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Texto del evento, entre comillas dobles. r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento. S servidor Especifica el nombre de host o la direccin IP del servidor. Utilice esta
10
opcin nicamente si el correlacionador de puertos se ejecuta en el servidor de eventos. Debe especificar el argumento S o el argumento f.
Ejemplos
El ejemplo siguiente para los entornos UNIX enva un mensaje de prueba que muestra un evento Su_Failure en las consolas de eventos:
postzmsg -S tecbox r AVISO m "Error de inicio de sesin su". Su_Failure LOGFILE
Vase tambin
postemsg, TECAgent, wpostemsg (versin de punto final), wpostemsg (versin de nodo gestionado), wpostzmsg (versin de punto final), wpostzmsg (versin de nodo gestionado), wsetemsg
Captulo 1. Comandos
11
tec_console
Inicia la consola de eventos de Tivoli Enterprise Console.
Sintaxis
tec_console [u ID_usuario] [p contrasea] [h nombre_host[:puerto]] [e grupo_eventos] [nowindow] [&]
Descripcin
El comando tec_console inicia la consola de eventos. Este comando se encuentra en $BINDIR/bin en un nodo gestionado con la consola de eventos instalada. En cualquier otro host, el comando se 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 de comandos de la sesin. Al ejecutar este comando en un nodo gestionado, el entorno Tivoli debe estar inicializado. Si emite el comando tec_console desde un shell bash en un sistema Windows, incluya la extensin del nombre de archivo .cmd; por ejemplo:
tec_console.cmd &
El proceso del servidor de la interfaz de usuario (UI) acta de interfaz con la consola de eventos para obtener eventos del repositorio de eventos y empaquetar las solicitudes de actualizacin de base de datos y pasarlas al proceso de asignacin de Tivoli Enterprise Console. En el directorio inicial del usuario se crea un directorio denominado .tmeconsole que guarda los valores globales de la consola del usuario. Debe tener la opcin de inicio de sesin de cliente remoto permitido de Tivoli Management Framework establecida en TRUE para que este comando funcione. Puede ver el valor actual establecido con el comando odadmin odinfo. Para establecer esta opcin, ejecute el siguiente comando:
odadmin set_allow_rconnect TRUE
El cambio entra en vigor de inmediato.
Autorizacin
Para los operadores: user, RIM_view, RIM_update Para los administradores: user, RIM_view, RIM_update, senior Los administradores y los operadores de Tivoli Enterprise Console requieren las funciones de regin de gestin de Tivoli que se muestran en la tabla siguiente. Tambin se muestran las vistas de Tivoli Enterprise Console disponibles para los dos tipos de usuarios. Consulte la publicacin Tivoli Enterprise Console Gua del usuario para obtener informacin adicional acerca de las funciones necesarias para los usuarios de Tivoli Enterprise Console.
12
Usuario de la consola Administrador Operador
Funciones de regin de gestin de Tivoli RIM_view, RIM_update, senior
Vistas de la consola Vistas de configuracin, resumen y prioridad y visor de eventos
RIM_view, RIM_update, user Vistas de resumen y prioridad y visor de eventos
Opciones
& Ejecute el comando en segundo plano para que el indicador de comandos est disponible y pueda utilizarse.
e grupo_eventos Muestra el grupo de eventos especificado en el visor de eventos cuando se inicia la consola. Nota: para esta opcin, debe indicar los nombres de grupo de eventos formados por varias palabras de forma diferente en funcin de si utiliza el sistema operativo UNIX o Windows. En todos los sistemas operativos, el nombre de grupo de eventos es sensible a las maysculas y minsculas. En el caso de los sistemas operativos UNIX, especifique el nombre de grupo de eventos entre comillas dobles:
tec_console -e "Todos los eventos"
En el caso de los sistemas operativos Windows, no utilice comillas dobles para especificar el nombre de grupo de eventos:
tec_console.cmd -e Todos los eventos
h nombre_host[:puerto] El host debe ser un nodo gestionado en el que el ID de usuario y la contrasea deben ser autenticadas por Tivoli Management Framework. Especifique esta opcin con el formato nombre_host:puerto si se utiliza un puerto distinto del puerto 94. nowindow Suprime la ventana de DOS (slo para sistemas Windows). p contrasea Contrasea del ID de inicio de sesin del administrador de Tivoli. u ID_usuario ID de inicio de sesin del administrador de Tivoli.
Ejemplos
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 de sesin y la contrasea.
tec_console &
El ejemplo siguiente inicia una consola de eventos en un host Windows en segundo plano y muestra el grupo de eventos NT en el visor de eventos. Se solicita al usuario el nombre de host, el ID de inicio de sesin y la contrasea.
tec_console.cmd -e NT &
Captulo 1. Comandos
13
TECAgent
Enva un evento al servidor de eventos mediante comunicaciones Tivoli o no de Tivoli.
Sintaxis
java com.tivoli.tec.event_delivery.TECAgent SENDER f archivo_configuracin [m mensaje] [r gravedad] [atributo=valor...] clase fuente
Descripcin
El comando TECAgent enva un evento a un servidor de eventos. Este comando puede funcionar utilizando el transporte de punto final, el transporte de nodo gestionado o las comunicaciones no de Tivoli, en funcin de la configuracin. Nota: puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador). El comando TECAgent est contenido en evd.jar, que se encuentra en $BINDIR/../generic_unix/TME/TEC. Antes de ejecutar este comando, realice las acciones siguientes: v Si va a utilizar el transporte de nodo gestionado (TME) o de punto final (LCF) en el archivo de configuracin, debe especificar como fuente el entorno Tivoli adecuado (setup_env.sh o lcf_env.sh). v Agregue el archivo ejecutable Java en la ruta. En $BINDIR/TME/TEC/jre/bin encontrar un archivo ejecutable Java que se entrega con el producto Tivoli Enterprise Console. v Agregue los archivos jar adecuados desde $BINDIR/../generic_unix/TME/TEC a la sentencia CLASSPATH: evd.jar y log.jar jcf.jar, ibmjsse.jar y jsafe.zip si va a utilizar el transporte de nodo gestionado (TME) zce.jar y xerces-3.2.1.jar si va a ejecutar la correlacin basada en estados.
Autorizacin
user
Opciones
atributo=valor... Asigna un valor a cualquier atributo vlido. El atributo debe estar definido para la clase de evento. Separe las diversas expresiones atributo=valor con espacios. clase Especifica la clase del evento. Debe coincidir con una clase configurada en el servidor. El adaptador define las clases y stas se indican en el archivo BAROC del adaptador. Si hay algn espacio en blanco en el nombre de la clase, especifique el nombre de la clase entre comillas dobles. Especifica la fuente del evento. Si hay algn espacio en blanco en el nombre de la fuente, especifquelo entre comillas dobles.
fuente
f archivo_configuracin Especifica el nombre del archivo de configuracin. Consulte la publicacin
14
IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Texto del evento, entre comillas dobles. r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento.
Ejemplos
El siguiente ejemplo enva un mensaje de prueba que muestra un evento Su_Failure en las consolas de eventos:
java com.tivoli.tec.event_delivery.TECAgent SENDER f myconfig.conf m "Error de inicio de sesin su". Su_Failure LOGFILE
Vase tambin
postemsg, postzmsg, wpostemsg (versin de punto final), wpostemsg (versin de nodo gestionado), wpostzmsg (versin de punto final), wpostzmsg (versin de nodo gestionado), wsetemsg
Captulo 1. Comandos
15
upgrade_gui.sh
Actualiza las reglas generadas por la versin 3.6.2 y anteriores del generador de reglas a la sintaxis soportada por el compilador de reglas proporcionado en esta versin del producto Tivoli Enterprise Console.
Sintaxis
upgrade_gui.sh dir_base_reglas
Descripcin
Si tiene reglas generadas por la versin 3.6.2 y anteriores del generador de reglas de Tivoli Enterprise Console, stas se encuentran almacenadas en el archivo $BINDIR/TME/TEC/base_reglas/TEC_RULES/.rule_builder.pro. Puede utilizar el script upgrade_gui.sh del directorio $BINDIR/TME/RULE_BUILDER para convertir estas reglas a la sintaxis soportada por el compilador de reglas proporcionado en esta versin del producto Tivoli Enterprise Console. Las reglas convertidas utilizan las funciones implementadas por la nueva versin del compilador y son ms fciles de leer. Si convierte reglas con este script, ya no podr editar las reglas convertidas con el generador de reglas; deber utilizar un editor de texto. Nota: efecte una copia de seguridad del archivo .rule_builder.pro antes de ejecutar 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 del subdirectorio TEC_RULES de la base de reglas. El archivo .rule_builder.pro queda vaco.
Autorizacin
Ninguna.
Opciones
dir_base_reglas Directorio que contiene la base de reglas que contiene las reglas del generador de reglas que se desea actualizar.
Ejemplos
El ejemplo siguiente actualiza las reglas del generador de reglas para la base de reglas situada en el directorio /rulebases/test/test001:
upgrade_gui.sh /rulebases/test/test001
16
waddac
Agrega un registro de configuracin de adaptador para un perfil de configuracin de adaptador.
Sintaxis
waddac detalles_adaptador tipo perfil
Descripcin
El comando waddac agrega un registro para configurar un adaptador de eventos de Tivoli Enterprise Console a un perfil de configuracin de adaptador existente. Cuando se distribuye a los nodos gestionados de abono, el nuevo registro hace que entre en vigor la configuracin del adaptador que reflejan los argumentos detalles_adaptador proporcionados, en combinacin con los valores predeterminados especficos del tipo que haya instalados. Cada tipo de adaptador de cada perfil de configuracin de adaptador puede estar soportado por polticas predeterminadas para proporcionar valores iniciales para componentes de la configuracin no suministrados por una llamada de waddac. Del mismo modo, puede haber polticas de validacin para garantizar que una configuracin determinada sea vlida segn las necesidades de la implementacin del adaptador de eventos, las particularidades de la instalacin y las consideraciones de seguridad. El comando waddac escribe el valor de clave del nuevo registro de configuracin de adaptador en la salida estndar. El valor de clave se puede emplear ms adelante para modificar o eliminar el registro. Puede ver el valor de clave en la parte superior derecha del panel de entrada del perfil de configuracin del adaptador o mediante el comando wlsac.
Autorizacin
admin
Opciones
detalles_adaptador Proporciona la informacin de configuracin especfica del adaptador como, por ejemplo, las rutas de distribucin, los ID de usuario y los filtros del adaptador empleados para los parmetros de distribucin del adaptador. b indicador=valor Establece el indicador de comportamiento del punto final determinado en el valor especificado. Los indicadores de comportamiento del punto final se interpretan en situaciones especiales cuando se distribuyen perfiles, por ejemplo al procesar un registro marcado como suprimido. Los indicadores especficos a los que se da soporte varan segn el punto final, pero entre los que se admiten actualmente se encuentran los siguientes: action_fail Controla el manejo de anomalas de las peticiones de distribucin anteriores (!comando) y posteriores (!!comando). Para obtener ms informacin acerca de estas peticiones, consulte la opcin D. Los valores son:
Captulo 1. Comandos
17
abort
Detener la distribucin.
ignore Pasar por alto todas las anomalas. report Informar de las anomalas pero seguir con la actividad de distribucin (comportamiento predeterminado). expand Controla si, al distribuir el perfil, el cdigo del punto final debe expandir las referencias a las variables de contexto del punto final con el formato $variable dentro de los atributos del registro. El valor de la variable puede ser no para inhabilitar la expansin, yes a fin de habilitarla para todos los atributos (comportamiento predeterminado), o una lista de nombres de atributo separados por comas para efectuar una expansin selectiva nicamente en los valores de esos atributos. rm_on_del Indica al cdigo del punto final si debe eliminar los archivos de configuracin y archivos distribuidos cuando se distribuye el registro tras eliminarse. El valor puede ser yes (para forzar la eliminacin, que es el comportamiento predeterminado), no (para inhabilitar la eliminacin y, por consiguiente, conservar los archivos en su ubicacin tras la supresin del registro) o conf (para eliminar nicamente el archivo de configuracin del adaptador principal). run_actions Controla si se realizan las peticiones de distribucin anteriores (!comando) y posteriores (!!comando). Para obtener ms informacin acerca de estas peticiones, consulte la opcin D. El valor puede ser yes o no, siendo yes el valor predeterminado. El cdigo del punto final admite (salvo que la poltica de validacin los rechace) y omite los indicadores o los valores de los indicadores de comportamiento no reconocidos. c comentario Texto de comentario que se asociar al nuevo registro de perfil de configuracin de adaptador. El texto de comentario se escribir en el archivo de configuracin cuando se cree la prxima vez que se distribuya el perfil. D destino=fuente Solicita que el archivo fuente se distribuya al archivo de destino en cada host de abono cuando se distribuya el perfil. Si el nombre de destino no empieza por un carcter de barra inclinada, el nombre de archivo real se formar agregando destino al directorio de destino segn la especificacin de una opcin d (o de los valores predeterminados de la poltica). En lugar del formato destino=fuente para una peticin de distribucin, la cadena puede tener el formato !comando o !!comando. El comando proporcionado, que puede ser cualquier sentencia vlida para el intrprete de lnea de comandos dependiente del sistema operativo presente en los nodos de abono (normalmente, /bin/sh, aunque en los sistemas operativos
18
distintos de UNIX puede ser diferente), se ejecuta antes (!) o despus (!!) de la informacin de configuracin y todos los archivos distribuidos se escriben. Se pueden proporcionar muchas opciones D. d dir Directorio de los nodos de abono al que deben distribuirse los archivos de configuracin del adaptador. e nombre=valor Define una variable de entorno que se colocar en el archivo de configuracin del adaptador. Pueden proporcionarse tantos argumentos e como se desee para crear un nmero de variables de entorno arbitrario. Algunas variables de entorno, que las bibliotecas del adaptador de eventos reconocen directamente, controlan el funcionamiento bsico del adaptador. Otras variables pueden ser utilizadas en un nivel superior por adaptadores especficos. f filtro Define un filtro de eventos que se colocar en el archivo de configuracin del adaptador. La cadena filtro debe tener el formato siguiente: Atributo=Valor;Atributo=Valor;Atributo=Valor;... Toda la cadena debe escribirse entre comillas para evitar que el intrprete de lnea de comandos tenga en cuenta los caracteres de punto y coma. Para crear un filtro cuyo estado inicial sea inhabilitado, se puede agregar el prefijo #ilter: a la cadena. As,
waddac -f #ilter:Class=LogFile_Base; acp1
agrega un nico registro de filtro inhabilitado al nuevo perfil acp1. (Los filtros habilitados tienen el prefijo Filter:.) Se pueden proporcionar muchas opciones f. F cach_filtro Define una cach de filtro de eventos que se colocar en el archivo de configuracin del adaptador. La cadena cach_filtro debe tener el formato siguiente: Atributo=Valor;Atributo=Valor;Atributo=Valor;... Toda la cadena debe escribirse entre comillas para evitar que el intrprete de lnea de comandos tenga en cuenta los caracteres de punto y coma. Para crear una cach de filtro cuyo estado inicial sea inhabilitado, se puede agregar el prefijo #FilterCache: a la cadena. As,
waddac -F #FilterCache:Class=LogFile_Base; acp1
agrega un nico registro de cach de filtro inhabilitada al nuevo perfil acp1. (Las cachs de filtro inhabilitadas tienen el prefijo FilterCache:.) Se pueden proporcionar muchas opciones F. g gid Valor de ID de grupo que se utilizar para los archivos distribuidos
Captulo 1. Comandos
19
y los comandos en los puntos finales de abono. El valor de gid se puede proporcionar como un nombre o un valor numrico. i on|off[,nombre_id] Especifica si se debe asignar al adaptador un identificador exclusivo y el identificador que se utilizar. Utilice esta opcin cuando se ejecuten varios adaptadores en el mismo sistema con el fin de asignar identificadores exclusivos a los adaptadores. Especifique on|off para indicar si se utilizar un identificador, y especifique nombre_id para indicar el identificador que se utilizar. Si especifica i on sin nombre_id, el adaptador no tendr un ID tras la distribucin del perfil. Si especifica i off con nombre_id, el registro de configuracin contendr el ID pero el adaptador no tendr un ID tras la distribucin del perfil. Puede cambiar el registro de configuracin mediante el comando wsetac. m modo_prefiltro Define el modo prefiltro que se colocar en el archivo de configuracin de los adaptadores Windows y NetWare. Los valores vlidos son IN, in, OUT y out. El valor predeterminado es OUT. Si utiliza IN o in, tambin deber proporcionar el parmetro p para especificar un prefiltro. En el ejemplo siguiente se muestra un comando que utiliza este argumento:
waddac -a -m OUT -p Log=System 1 ACPprofile
p prefiltro Define los prefiltros que se colocarn en el archivo de configuracin de los adaptadores Windows y NetWare. Debe especificar como mnimo la especificacin de registro y, si lo desea, las especificaciones EventId, EventType y Source. En el ejemplo siguiente se muestra un comando que utiliza este argumento:
waddac -a -p Log=Security 1 ACPprofile
t destino Nombre del archivo de configuracin del adaptador principal, denominado habitualmente archivo CONF. El nombre de archivo completo de este archivo se forma agregando destino al valor proporcionado para dir con la opcin d.Tenga en cuenta que la poltica predeterminada normalmente est establecida de modo que defina destino y dir_destino en los valores adecuados. u uid Valor de ID de usuario que se utilizar para los archivos distribuidos y los comandos en los puntos finales de abono. El valor de uid se puede proporcionar como un nombre o un valor de ID numrico. perfil tipo Perfil de configuracin de adaptador al que se agregar el nuevo registro de configuracin del adaptador. Proporciona el tipo de adaptador del nuevo adaptador. El tipo de adaptador normalmente se utiliza para regir el funcionamiento de las polticas predeterminadas y de validacin. Si se proporcionan tipos de adaptador desconocidos para waddac, las polticas de validacin del perfil de configuracin de adaptador de destino pueden rechazar el nuevo registro. Para ver los tipos disponibles, utilice el comando wlsaddflt.
20
Ejemplos
El ejemplo siguiente agrega una entrada de perfil de configuracin de adaptador con el comentario My Logfile en el archivo CONF, el ID de usuario 0 y el ID de grupo 0 para un adaptador de tipo tecad_logfile_solaris2 en el perfil denominado ACP Profile:
waddac -c "My_Logfile" -u 0 -g 0 tecad_logfile_solaris2 "ACP Profile"
Vase tambin
wdelac, wlsac, wsetac, wsetaddflt
Captulo 1. Comandos
21
wchkclass
Comprueba si un archivo de definiciones de clases de eventos es vlido cotejndolo con un directorio de base de reglas.
Sintaxis
wchkclass [S servidor] [a archivo_clases | b archivo_clases] [[host:]ruta] ... base_reglas
Descripcin
El comando wchkclass comprueba que un archivo de definiciones de clases de eventos sea vlido para el directorio de base de reglas especificado por el argumento base_reglas. Este comando se proporciona para desarrollar clases en un sistema que tiene instalado Tivoli Management Framework. Si Tivoli Management Framework no est instalado, debe emplear el comando chkclass.
Autorizacin
user
Opciones
host:ruta Especifica el host que contiene el archivo de clases que debe comprobarse y la ruta del archivo de clases que debe comprobarse. Si no especifica este argumento, se comprobar la base de reglas actual para determinar la validez. Separe las diversas rutas de archivo con un espacio. base_reglas Especifica el nombre de la base de reglas con la que se comprobar el archivo de definiciones de clases. a archivo_clases Iniciar la comprobacin como si el archivo de clases especificado estuviera insertado tras el archivo de clases especificado en la base de reglas. b archivo_clases Iniciar la comprobacin como si el archivo de clases especificado estuviera insertado antes del archivo de clases especificado en la base de reglas. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli.
Ejemplos
El ejemplo siguiente comprueba el archivo de definiciones de clases de eventos /install/bin/hpux/TME/TEC /classfile1 cotejndolo con la base de reglas rb1:
wchkclass /install/bin/hpux/TME/TEC/classfile1 rb1
Vase tambin
chkclass
22
wconsole
Gestiona las consolas de eventos.
Sintaxis
wconsole [opcin [subopcin]]
Descripcin
Utilice el comando wconsole para crear, copiar, suprimir y listar consolas de eventos, as como configurar, asignar y gestionar de otro modo grupos de eventos y filtros de grupos de eventos. La primera opcin del comando wconsole especifica su funcin principal. Las subopciones posteriores slo son vlidas en el contexto de la primera opcin.
Autorizacin
senior (funcin de regin slo para el comando, sin opciones) En la tabla siguiente se muestran las funciones de regin para opciones especficas del comando wconsole, junto con breves descripciones de las opciones.
Opcin addegflt assigneg Descripcin Agrega un nuevo filtro a un grupo de eventos. Asigna un grupo de eventos a una definicin de consola de eventos. Asigna operadores a una definicin de consola de eventos. Funciones de regin RIM_view, RIM_update, senior RIM_view, RIM_update, senior RIM_view, RIM_update, senior
assignop
copyconsole
Copia los grupos de eventos, RIM_view, RIM_update, los filtros de grupos de senior eventos y las asignaciones de funciones de autorizacin de una consola de eventos en otra definicin de consola. Crea una nueva definicin de RIM_view, RIM_update, consola de eventos. senior Crea un nuevo grupo de eventos. Crea un nuevo operador de consola. Suprime una definicin de consola de eventos. RIM_view, RIM_update, senior RIM_view, RIM_update, senior RIM_view, RIM_update, senior
crtconsole crteg crtoperator delconsole deleg delegflt deloperator
Suprime uno o varios grupos RIM_view, RIM_update, de eventos. senior Suprime uno o varios filtros de un grupo de eventos. Suprime un operador de consola existente. RIM_view, RIM_update, senior RIM_view, RIM_update, senior
Captulo 1. Comandos
23
Opcin lsassigneg
Descripcin Lista los grupos de eventos asignados a una definicin de consola de eventos. Lista las definiciones de consola de eventos. Lista las consolas que estn en ejecucin en este momento. Lista los grupos de eventos. Lista la definicin de operador.
Funciones de regin RIM_view, RIM_update, user
lsconsole lsconsoleup
RIM_view, RIM_update, user RIM_view, RIM_update, user
lseg lsoperator setconsole
RIM_view, RIM_update, user RIM_view, RIM_update, user
Cambia el nombre y la RIM_view, RIM_update, descripcin de una definicin senior de consola de eventos. Cambia el nombre y la descripcin de un grupo de eventos. Cambia el nombre y la descripcin de un filtro de grupo de eventos. Desasigna uno o varios grupos de eventos de una definicin de consola de eventos. RIM_view, RIM_update, senior RIM_view, RIM_update, senior RIM_view, RIM_update, senior
seteg
setegflt
unassigneg
unassignop
Desasigna operadores de una RIM_view, RIM_update, definicin de consola de senior eventos.
Notas
v Si emite el comando wconsole desde un shell bash en un sistema Windows, incluya la extensin 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 que el entorno Tivoli est inicializado. v Apague las consolas de eventos en ejecucin cuyas propiedades deban modificarse. Una vez realizados los cambios, reinicie las consolas para que los cambios entren en vigor.
Opciones
Cada opcin del comando wconsole contiene las subopciones h, u y p opcionales para especificar el nombre de host, el ID de usuario y la contrasea, respectivamente, a fin de iniciar la sesin en el host del nodo gestionado en el que Tivoli Management Framework debe autenticar el ID de usuario y la contrasea. Si no especifica estas subopciones y est ejecutando el comando wconsole en un nodo gestionado, se utiliza el ID del usuario que haya iniciado la sesin; de lo contrario, si lo ejecuta en un host en un entorno no Tivoli, se muestra la ventana de inicio de sesin.
24
Nota: si ejecuta el comando wconsole en un nodo gestionado con el sistema operativo AIX y ha iniciado la sesin como root, debe utilizar las subopciones h, u y p para especificar explcitamente el nombre del host, el ID de usuario y la contrasea para evitar que se visualice la ventana de inicio de sesin. Esto no es necesario si inicia la sesin en un sistema AIX con otro ID de usuario. Las subopciones h, u y p aparecen en las sentencias de sintaxis de este apartado, aunque las definiciones de las mismas slo se muestran en la tabla siguiente.
Subopcin comn h host[:puerto] Definicin Nombre del host del nodo gestionado en el que el ID de usuario y la contrasea deben ser autenticadas por Tivoli Management Framework. Especifique el nmero de puerto si el puerto empleado por el host no es el 94. ID de inicio de sesin del administrador de Tivoli. Contrasea asociada al ID de inicio de sesin del administrador de Tivoli.
u usuario p contrasea
Notas: 1. Los argumentos que contengan espacios debern escribirse entre comillas dobles. Por ejemplo, los nombres y las descripciones pueden contener espacios. 2. Las cadenas deben delimitarse mediante comillas simples. 3. Los valores numricos no pueden delimitarse con ningn tipo de comilla. 4. Los valores enumerados deben especificarse por sus nombres de enumeracin, no sus valores numricos. Los valores enumerados deben delimitarse mediante comillas simples. addegflt [h host[:puerto]] [u usuario] [p contrasea] E grupo_eventos n nombre [D descripcin] [s restricciones] [S SQL_formato_libre] Agrega un nuevo filtro a un grupo de eventos. Un filtro de grupo de eventos es en realidad una clusula SQL WHERE, que se utiliza para consultar la base de datos de eventos a fin de extraer los eventos que cumplen los criterios del filtro. Estos eventos aparecen normalmente en el visor de eventos de la consola del operador. La visibilidad de estos eventos en un visor de eventos la puede anular un operador en el visor de eventos o una regla. Los filtros de grupos de eventos permiten configurar los criterios de seleccin para que se incluyan eventos en un grupo de eventos. Un grupo de eventos puede no tener ningn filtro o tener alguno. Un evento se incluye en un grupo de eventos si satisface como mnimo los criterios de un filtro. Si no hay ningn filtro configurado para un grupo de eventos, todos los eventos se incluirn en el grupo de eventos. Cada filtro de un grupo de eventos puede constar de cero o ms restricciones para los atributos de los eventos recibidos y sentencias SQL de formato libre. Una restriccin se construye empleando atributos de eventos, operadores SQL y valores de atributos de eventos. Las restricciones de un filtro pueden unirse con el operador AND. Una sentencia SQL de formato libre puede ser cualquier sentencia vlida para una clusula WHERE.
Captulo 1. Comandos
25
Notas: 1. El comando wconsole no efectuar ninguna comprobacin de sintaxis en las sentencias SQL de formato libre que especifique, por lo que usted es el responsable de que las sentencias SQL de formato libre sean correctas para un filtro de eventos. 2. El operador LIKE admite los siguientes caracteres comodn en casi todas las bases de datos:
Carcter comodn % _ [] Significado Cualquier cadena de cero o ms caracteres. Cualquier carcter nico. Cualquier carcter nico dentro del rango especificado. Por ejemplo, [a-f] o [abcedf] Cualquier carcter nico que no se encuentre dentro del rango especificado. Por ejemplo, [^a - f] o [^abcdef]
[^]
3. La sintaxis de la clusula WHERE debe cumplir los requisitos del RDBMS empleado para la base de datos de eventos. D descripcin Descripcin de texto del nuevo filtro. E grupo_eventos Nombre del grupo de eventos que contendr el nuevo filtro. n nombre Nombre del nuevo filtro. s restricciones Una o varias restricciones para el nuevo filtro. No especifique la palabra clave WHERE inicial, ya que se maneja automticamente. Vincule varias restricciones con el operador AND. Cada una de las restricciones debe delimitarse mediante parntesis. El argumento de restricciones completo debe escribirse entre comillas dobles; por ejemplo:
-s "(severity IN (CRITICAL,FATAL))AND \ (source=NT)"
Los operadores vlidos para una restriccin son =, <>, <, <=, >, >=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, BETWEEN y NOT BETWEEN. La tabla siguiente muestra diversos atributos de eventos establecidos en indicaciones de la hora y el formato que debe emplearse al especificar valores para estos atributos con la subopcin s. Los valores de indicacin de la hora deben delimitarse mediante comillas simples. Los valores de indicacin de la hora con formato especificados en una restriccin se convierten de forma interna en los tipos de datos correspondientes que requiere la base de datos de eventos.
26
Atributos que contienen valores de indicacin de la hora cause_date_reception date_reception last_modified_time
Formato
Ejemplos
m/d/aa h:mm:ss a z 4/1/01 9:36:24 AM CST a corresponde a AM o PM. z es la abreviatura del huso horario. 3/13/01 9:36:24 AM CST 10/5/01 10:59:55 PM EST
Notas: 1. la especificacin de una restriccin de filtro funciona como el dilogo Editor de restricciones de la consola de eventos. Puede especificar los mismos atributos de eventos, operadores y valores de atributos en el Editor de restricciones que con la subopcin s de la opcin addegflt. 2. Para especificar varias restricciones, utilice el operador AND. No utilice la subopcin s ms de una vez en un solo comando wconsole. S SQL_formato_libre Sentencias SQL vlidas para una clusula WHERE y permitidas por el RDBMS empleado para la base de datos de eventos. No especifique la palabra clave WHERE inicial, ya que se maneja automticamente. Escriba el argumento SQL_formato_libre completo entre comillas. Puede emplear caracteres comodn de SQL siempre que el RDBMS empleado para la base de datos de eventos los admita. Notas: 1. El comando wconsole no efectuar ninguna comprobacin de sintaxis en las sentencias SQL de formato libre que especifique, por lo que usted es el responsable de que las sentencias SQL de formato libre sean correctas para un filtro de eventos. 2. Para especificar varias sentencias SWL, utilice el operador AND. No utilice la subopcin S ms de una vez en un solo comando wconsole. assigneg [h host[:puerto]] [u usuario] [p contrasea] C consola E grupo_eventos [r rol:...] Asigna un grupo de eventos a una definicin de consola de eventos. Si lo desea, tambin puede asignar los roles del grupo de eventos. Los roles determinan si un operador puede confirmar y cerrar los eventos pertenecientes al grupo de eventos. C consola Nombre de la consola a la que se asignar el grupo de eventos. E grupo_eventos Nombre del grupo de eventos que se asignar. r rol:... Roles que se asignarn al grupo de eventos. Separe cada rol con un carcter de dos puntos (:). El valor predeterminado es admin. Los valores vlidos son super, senior, admin y user. Si desea obtener
Captulo 1. Comandos
27
ms informacin sobre las funciones de Tivoli Enterprise Console, consulte la publicacin IBM Tivoli Enterprise Console Gua del usuario. assignop [h host[:puerto]] [u usuario] [p contrasea] C consola O operador:... Asigna operadores a una definicin de consola de eventos. C consola Nombre de la consola a la que se asignarn los operadores. O operador:... Lista de operadores que se asignarn a la consola. Separe cada operador con un carcter de dos puntos (:). Los operadores especificados ya deben haberse creado como administradores de Tivoli y no pueden estar asignados en ese momento a otra consola. Asimismo, ya debe haber creado el operador especificado con la opcin de creacin de un operador en la consola de eventos o mediante el comando wconsole crtoperator. Si un operador todava no se ha definido como administrador de Tivoli o en ese momento est asignado a otra consola, se emitir un mensaje de error y el proceso del comando continuar. Consulte la opcin lsconsole para obtener informacin sobre cmo obtener una lista de todas las consolas definidas en ese momento y los operadores asignados a las mismas. copyconsole [h host[:puerto]] [u usuario] [p contrasea] n nombre C consola Copia los grupos de eventos, los filtros de grupos de eventos y las asignaciones de funciones de autorizacin de una consola de eventos en otra definicin de consola. Las preferencias del visor de eventos no se copian. Las preferencias del visor de eventos se almacenan de forma local en los hosts donde estn instalados los clientes de la consola. La consola de destino debe existir. C consola Nombre de la consola de destino. n nombre Nombre de la consola fuente. crtconsole [h host[:puerto]] [u usuario] [p contrasea] [C consola] [n nombre] [D descripcin] [O operador:...] Crea una nueva definicin de consola de eventos. C consola Nombre de la consola fuente de la que se copiarn los grupos de eventos y sus funciones de autorizacin, as como los filtros de grupos de eventos, en la nueva definicin de consola. D descripcin Descripcin de texto de la nueva consola. El valor predeterminado es Nueva descripcin. n nombre Nombre de la nueva consola. El valor predeterminado es Nuevo. O operador:... Lista de operadores que se asignarn a la nueva consola. Separe cada operador con un carcter de dos puntos (:). Los operadores especificados ya deben haberse creado como administradores de Tivoli y no pueden estar asignados en ese momento a otra consola. Asimismo, ya debe haber creado los operadores especificados con
28
la opcin de creacin de un operador de la consola de eventos o mediante el comando wconsole crtoperator. Si un operador todava no se ha definido como administrador de Tivoli o en ese momento est asignado a otra consola, se emitir un mensaje de error y el proceso del comando continuar. Consulte la opcin lsconsole para obtener informacin sobre cmo obtener una lista de todas las consolas definidas en ese momento y los operadores asignados a las mismas. crtoperator [h host[:puerto]] [u usuario] [contrasea] O operador:... [-C consola] Crea un nuevo operador de consola. O operador:... Lista de operadores que se crearn. Separe cada operador con un carcter de dos puntos (:). Los operadores especificados ya deben haberse creado como administradores de Tivoli y no pueden estar asignados en ese momento a otra consola. Si un operador todava no se ha definido como administrador de Tivoli o en ese momento est asignado a otra consola, se emitir un mensaje de error y el proceso del comando continuar. Consulte la opcin lsconsole para obtener informacin sobre cmo obtener una lista de todas las consolas definidas en este momento y los operadores asignados a las mismas. C consola Nombre de una consola existente a la que se asignarn los nuevos operadores creados. crteg [h host[:puerto]] [u usuario] [p contrasea] n nombre [D descripcin] [E grupo_eventos] Crea un nuevo grupo de eventos. D descripcin Descripcin de texto del nuevo grupo de eventos. E grupo_eventos Nombre de un grupo de eventos fuente que se copiar como el nuevo grupo de eventos. Tambin se copian los filtros del grupo de eventos fuente. n nombre Nombre del nuevo grupo de eventos. delconsole [h host[:puerto]] [u usuario] [p contrasea] n nombre Suprime una definicin de consola de eventos. Si hay instancias de la consola que estn en ejecucin cuando se emite esta opcin, la definicin no se eliminar hasta que no haya ninguna instancia en ejecucin. n nombre Nombre de la definicin de consola que se va a suprimir. deleg [h host[:puerto]] [u usuario] [p contrasea] e grupo_eventos:... Suprime uno o varios grupos de eventos, incluidos los filtros. Si alguno de los grupos de eventos especificados con esta opcin est asignado a una consola, se desasignar de la consola antes de suprimirse. e grupo_eventos:... Nombres de los grupos de eventos que se desea suprimir. Separe cada nombre de grupo de eventos con un carcter de dos puntos (:).
Captulo 1. Comandos
29
delegflt [h host[:puerto]] [u usuario] [p contrasea] 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_eventos Nombre del grupo de eventos que contiene los filtros que se desea suprimir. n nombre Nombre del filtro que se desea suprimir. deloperator [-h host[:puerto]] [u usuario] [p contrasea] O operador:... Suprime un operador de consola existente. O operador:... Lista de operadores que se suprimirn. Separe cada operador con un carcter de dos puntos (:). Las consolas asignadas primero se desasignan. Consulte la opcin lsconsole para obtener informacin sobre cmo obtener una lista de todas las consolas definidas en este momento y los operadores asignados a las mismas. lsassigneg [h host[:puerto]] [u usuario] [p contrasea] C consola Lista los grupos de eventos asignados a una definicin de consola de eventos. C consola Nombre de la consola que se desea listar. lsconsole [h host[:puerto]] [u usuario] [p contrasea] [a] [c consola:...] Lista las definiciones de consola de eventos. Esta opcin no muestra los clientes de la consola que estn instalados. a Lista la descripcin de la consola, los grupos de eventos asignados y sus funciones de autorizacin, as como los operadores asignados para cada definicin de consola. Si no se especifica esta opcin, slo se muestran los nombres de consola.
c consola:... Nombres de las definiciones de consola especficas que se desea listar. Separe cada nombre de consola con un carcter de dos puntos (:). Si no se especifica esta subopcin, se listarn todas las definiciones de consola. -lsconsoleup [h host[:puerto]] [u usuario] [p contrasea] Muestra una lista de las consolas que estn en ejecucin en este momento para el servidor de la interfaz de usuario en la regin de Tivoli en la que el usuario que ejecuta el comando wconsole -lsconsoleup tiene iniciada una sesin. lseg [h host[:puerto]] [u usuario] [p contrasea] [a] [e grupo_eventos:...] Lista los grupos de eventos. a Lista la descripcin y los filtros de cada grupo de eventos. Si no se especifica esta subopcin, slo se muestran los nombres de los grupos de eventos.
e grupo_eventos:... Nombres de los grupos de eventos especficos que se desea listar.
30
Separe cada nombre de grupo de eventos con un carcter de dos puntos (:). Si no se especifica esta subopcin, se listarn todos los grupos de eventos. lsoperator [h host[:puerto]] [u usuario] [p contrasea] [a] [O operador:...] Lista las definiciones de operadores de consola. a Lista la definicin de consola asignada. Si no se especifica esta opcin, slo se muestran los nombres de operador.
O operador:... Nombres de los operadores de consola especficos que se desea listar. Separe cada operador con un carcter de dos puntos (:). Si no se especifica esta subopcin, se listarn todos los operadores de consola. setconsole [h host[:puerto]] [u usuario] [p contrasea] C consola [n nombre] [D descripcin] Cambia el nombre y la descripcin de una definicin de consola de eventos. C consola Nombre de la consola que se desea cambiar. D descripcin Nueva descripcin de texto de la consola. n nombre Nuevo nombre de la consola. El nombre no cambiar si se especifica uno que ya se utiliza en otra consola. seteg [h host[:puerto]] [u usuario] [p contrasea] [n nombre] [D descripcin] E grupo_eventos Cambia el nombre y la descripcin de un grupo de eventos. Los cambios se replican en los grupos de eventos asignados. D descripcin Nueva descripcin de texto del grupo de eventos. E grupo_eventos Nombre del grupo de eventos que se cambiar. n nombre Nuevo nombre del grupo de eventos. El nombre no cambiar si se especifica uno que ya se utiliza en otro grupo de eventos. setegflt [h host[:puerto]] [u usuario] [p contrasea] [n nombre] [D descripcin] E grupo_eventos F filtro Cambia el nombre y la descripcin de un filtro de grupo de eventos. D descripcin Nueva descripcin de texto del filtro. E grupo_eventos Nombre del grupo de eventos que contiene el filtro que se cambiar. F filtro Nombre del filtro que se cambiar. n nombre Nuevo nombre del filtro. El nombre no cambiar si se especifica uno que ya se utiliza en otro filtro del grupo de eventos.
Captulo 1. Comandos
31
unassigneg [h host[:puerto]] [u usuario] [p contrasea] C consola e grupo_eventos:... Desasigna uno o varios grupos de eventos de una definicin de consola de eventos. C consola Nombre de la consola que contiene los grupos de eventos que se desea desasignar. e grupo_eventos:... Nombres de los grupos de eventos que se desea desasignar de la consola. Separe cada grupo de eventos con un carcter de dos puntos (:). unassignop [h host[:puerto]] [u usuario] [p contrasea] C consola O operador:... Desasigna operadores de una definicin de consola de eventos. C consola Nombre de la consola de la que se desasignarn los operadores. O operador:... Lista de operadores que se desasignarn de la consola. Separe cada operador con un carcter de dos puntos (:). Consulte la opcin lsconsole para obtener informacin sobre cmo obtener una lista de todas las consolas definidas en ese momento y los operadores asignados a las mismas.
Valores de retorno
El comando wconsole devuelve uno de los valores siguientes. Los valores de retorno se pueden obtener con la variable de shell $? del shell UNIX, Linux o bash, o bien con la variable de shell %ERRORLEVEL% en los sistemas operativos Windows. El texto de mensaje de error se escribe en stderr (el canal de error estndar). 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 error interno; por ejemplo, puede que no se pueda contactar con la base de datos. v 2 indica que el comando wconsole ha finalizado para ha generado una condicin de aviso por uno de los motivos siguientes: No se ha podido crear un objeto porque ya existe. No se ha podido eliminar, modificar o asignar un objeto porque no existe. No se ha podido modificar o asignar un objeto porque el usuario no tiene los derechos de acceso necesarios.
Ejemplos
En la lista siguiente se proporcionan ejemplos de uso de las opciones del comando wconsole. En los ejemplos, el carcter de barra inclinada invertida (\) situado al final de una lnea indica que el texto que aparece en la lnea siguiente se ha separado debido a las limitaciones de espacio de la pgina. El ejemplo se debe interpretar como si estuviera en una sola lnea. addegflt - Ejemplos 1. El ejemplo siguiente crea el filtro de grupo de eventos Immediate Attention en el grupo de eventos Operators. El grupo de eventos Operators ya debe existir. El filtro Immediate Attention contiene una
32
restriccin: el atributo de evento de gravedad est establecido en un valor Grave (CRITICAL) o Muy grave (FATAL).
wconsole -addegflt -E Operators \ -n "Immediate Attention" \ -s "(severity IN (CRITICAL,FATAL))"
2. El ejemplo siguiente crea el filtro de grupo de eventos LowRepeats en el grupo de eventos Logfile. El grupo de eventos Logfile ya debe existir. El filtro LowRepeats contiene las dos restricciones siguientes, que deben cumplirse para que los eventos pasen este filtro y se incluyan 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 agrega un nuevo filtro denominado Router Ports al grupo de eventos Subnet. El grupo de eventos Subnet ya debe existir. El filtro Router Ports contiene las dos restricciones siguientes y una sentencia SQL de formato libre. Deben cumplirse las tres restricciones para que los eventos pasen este filtro y se incluyan en el grupo de eventos: 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 restriccin es especfico de un RDBMS Microsoft SQL Server. El carcter de barra inclinada invertida antepuesto al operador es un carcter de escape para que el shell UNIX interprete correctamente el signo de exclamacin.
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 las funciones super y senior a la consola NetAdmin:
wconsole.cmd -assigneg -C NetAdmin \ -E Subnet -r super:senior
assignop - Ejemplos El ejemplo siguiente asigna el operador denominado Root_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 funciones, as como los filtros de grupos de eventos de la consola Personnel Systems en la consola Personnel Systems Audit. Observe que los operadores no se copian y la consola de destino debe existir.
Captulo 1. Comandos
33
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 definicin de consola denominada Personnel Systems y especifica su descripcin. No se asigna ningn grupo 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 definicin de consola denominada Personnel Systems, especifica su descripcin y asigna el operador denominado mf_viewer a la consola. No se asigna ningn grupo de eventos a la consola.
wconsole.cmd -crtconsole \ -n "Personnel Systems" -D "Console \ Definition for Managing Personnel \ Systems Events" -O mf_viewer
3. El ejemplo siguiente crea una definicin de consola denominada Personnel Systems, especifica su descripcin, asigna el operador denominado mf_viewer y copia los grupos de eventos y sus funciones de la consola AdministratorConsole en la consola Personnel Systems. Tenga presente que la opcin C corresponde a una operacin de copia, no de traslado.
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
crtoperator - Ejemplos El ejemplo siguiente crea un operador denominado achan.

wconsole -crtoperator -O achan
crteg - Ejemplos El ejemplo siguiente crea un grupo de eventos denominado Subnet. Los filtros del grupo de eventos Network se copian en el nuevo grupo de eventos.
wconsole.cmd -crteg -n Subnet -D "Subset \ of the Network event group" -E Network
delconsole - Ejemplos El ejemplo siguiente suprime la definicin de consola Personnel Systems:

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
34
1. El ejemplo siguiente suprime los filtros SNMP y OpenView del grupo de eventos Network:
wconsole.cmd -delegflt -E Network \ -n SNMP:OpenView
2. El ejemplo siguiente suprime todos los filtros del grupo de eventos Performance:
wconsole.cmd -delegflt -E Performance -a
lsassigneg - Ejemplos El ejemplo siguiente lista los grupos de eventos asignados a la consola NetAdmin:
wconsole.cmd -lsassigneg -C NetAdmin
La salida que visualiza este comando es:

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

Administrator New Test1 Test2
2. El ejemplo siguiente lista las definiciones de consola Administrator y New con detalles (subopcin a):
wconsole.cmd -lsconsole -h mfoster:6688 \ -u Administrator -p chief10 \ -a -c Administrator:New

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 description Event Group: newEG2 (User, Admin) Event Group: newEG1 (User, Admin)
-lsconsoleup - Ejemplo A continuacin se muestra un ejemplo de la salida de la opcin lsconsoleup con los valores predeterminados:
Actualmente existen 3 consolas TEC activas. Console Administrator/Operator _________________________________________ Root_jbr01-region Admin1 test1 TestAdmin DB2 DB2Admin
Captulo 1. Comandos
35
setconsole - Ejemplos El ejemplo siguiente cambia el nombre de la consola Personnel Systems por 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 Subnet por Subnetwork y cambia la descripcin:
wconsole.cmd -seteg -n Subnetwork \ -D "Subnetwork Event Data" -E Subnet
unassigneg - Ejemplos El ejemplo siguiente desasigna los grupos de eventos Network y System de la consola NetAdmin:
wconsole.cmd -unassigneg -C NetAdmin \ -e Network:System
unassignop - Ejemplos El ejemplo siguiente desasigna el operador denominado Root_hmckinne-nt-region de la consola NetAdmin:
wconsole.cmd -unassignop -C NetAdmin \ -O Root_hmckinne-nt-region
36
wcrtdefcfg
Crea una configuracin predeterminada en la consola de eventos.
Sintaxis
wcrtdefcfg operador [host[:puerto] usuario contrasea]
Descripcin
El comando wcrtdefcfg crea un grupo de eventos predeterminado y una consola de eventos predeterminada, y asigna un operador a la consola de eventos. El grupo de eventos predeterminado contiene todos los eventos abiertos.
Autorizacin
senior
Opciones
operador Especifica el operador que se asignar a la consola predeterminada. host[:puerto] Especifica el nombre del host en el que se ejecuta la consola de eventos y, opcionalmente, el puerto utilizado por el host; si no se utiliza el puerto 94, debe especificarse el puerto. usuario Especifica el nombre de usuario del administrador. Si no especifica esta opcin, se utiliza el ID del usuario que tenga una sesin iniciada en este momento. contrasea Especifica la contrasea del administrador. Esta opcin es obligatoria si especifica un usuario.
Ejemplos
El ejemplo siguiente crea una configuracin predeterminada para el operador Root_adasilva-region en el host calculus; el nombre y la contrasea del administrador son root y mi_contrasea:
wcrtdefcfg Root_adasilva-region calculus root mi_contrasea
Vase tambin
wconsole
Captulo 1. Comandos
37
wcrtebizgroups
Crea los grupos de eventos necesarios para emplear el conjunto de reglas e-business.rls.
Sintaxis
wcrtebizgroups [host[:puerto] usuario contrasea]
Descripcin
El script wcrtebizgroups utiliza el comando wconsole para crear los grupos de eventos que requiere el conjunto de reglas e-business.rls. Estos grupos son: Sin supervisin de eventos eBusiness Este grupo de eventos incluye todos los eventos TEC_ITS_Not_Monitoring_eBusiness abiertos, que se generan cuando el componente NetView no est configurado para supervisar correctamente las aplicaciones de e-business. Eventos probables en la asociacin de eventos Este grupo de eventos contiene todos los eventos TEC_Probable_Event_Association abiertos. Todos los eventos WAS, DB2 y MQ Este grupo de eventos incluye todos los dems eventos de e-business relacionados con los servicios de DB2, WebSphere Application Server y WebSphere MQ supervisados.
Autorizacin
senior
Opciones
host[:puerto] Especifica el nombre del host en el que se ejecuta la consola de eventos y, opcionalmente, el puerto utilizado por el host; si no se utiliza el puerto 94, debe especificarse el puerto. usuario Especifica el nombre de usuario del administrador. Si no especifica esta opcin, se utiliza el ID del usuario que tenga una sesin iniciada en este momento. contrasea Especifica la contrasea del administrador. Esta opcin es obligatoria si especifica un usuario. Nota: si est trabajando en un sistema AIX y ha iniciado la sesin como root, debe especificar explcitamente el nombre de host, el ID de usuario y la contrasea para evitar que se visualice la ventana de inicio de sesin. Esto no es necesario si inicia la sesin en un sistema AIX con otro ID de usuario.
38
Ejemplos
El ejemplo siguiente crea los grupos de eventos en un sistema denominado phizer:
wcrtebizgroups phizer.dev.tivoli.com jford mi_contrasea
Vase tambin
wconsole
Captulo 1. Comandos
39
wcrtmtgroups
Crea los grupos de eventos necesarios para emplear el conjunto de reglas maintenance_mode.rls.
Sintaxis
wcrtmtgroups [host[:puerto] usuario contrasea]
Descripcin
El script wcrtmtgroups utiliza el comando wconsole para crear el grupo de eventos que requiere el conjunto de reglas maintenance_mode.rls. El grupo Abrir eventos de mantenimiento incluye todos los eventos TEC_Maintenance abiertos, que se generan cuando un sistema supervisado entra en el modo de mantenimiento o sale de l.
Autorizacin
senior
Opciones
Ejemplos
wcrtmtgroups phizer.dev.tivoli.com jford mi_contrasea
Vase tambin
wconsole
40
wcrtnvgroups
Crea los grupos de eventos necesarios para emplear el conjunto de reglas netview.rls.
Sintaxis
wcrtnvgroups [host[:puerto] usuario contrasea]
Descripcin
El script wcrtnvgroups utiliza el comando wconsole para crear los grupos de eventos de Tivoli NetView que requiere el conjunto de reglas netview.rls. Estos dos grupos son el grupo de eventos OpenNetview y el grupo de eventos ClosedNetview. El grupo de eventos OpenNetview contiene los eventos del producto Tivoli NetView que estn abiertos en el producto Tivoli Enterprise Console. El grupo de eventos ClosedNetview contiene los eventos del producto Tivoli NetView que tienen un estado distinto del estado abierto en el producto Tivoli Enterprise Console.
Autorizacin
senior
Opciones
Ejemplos
wcrtnvgroups phizer.dev.tivoli.com jford mi_contrasea
Vase tambin
wconsole
Captulo 1. Comandos
41
wcrtsrc
Crea una fuente en el servidor de eventos.
Sintaxis
wcrtsrc [S servidor] [l etiqueta] fuente
Descripcin
El comando wcrtsrc agrega una fuente a la lista de fuentes actuales del servidor de eventos. El comando wcrtsrc llena la base de datos de objetos de Tivoli que las consolas de eventos utilizan para crear filtros de eventos. El nombre de fuente se comprueba para asegurarse de que no es un duplicado antes de agregarse a la lista. Las fuentes envan informacin de eventos a la consola de eventos por medio de los adaptadores de eventos. El adaptador de eventos define el nombre de una fuente.
Autorizacin
senior
Opciones
fuente Especifica el nombre de la fuente que se va a crear. El nombre debe corresponderse con el nombre especificado por el adaptador de eventos.
l etiqueta Utiliza la etiqueta especificada como nombre de la fuente en las consolas de eventos. Si no se especifica este argumento, se utilizar como etiqueta el valor especificado en el argumento fuente. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli.
Ejemplos
El ejemplo siguiente agrega la fuente LOGFILE a la regin de Tivoli local y da a la fuente la etiqueta Logfile:
wcrtsrc l "Logfile" LOGFILE
Vase tambin
wdelsrc, wlssrc, wsetsrc
42
wcrtteccfg
Crea una configuracin predeterminada de Tivoli Enterprise Console.
Sintaxis
wcrtteccfg host[:puerto] usuario contrasea [operador]
Descripcin
El comando wcrtteccfg crea una configuracin predeterminada de Tivoli Enterprise Console. Utilice este comando si los datos de la configuracin predeterminada de Tivoli Enterprise Console no se crean debido a una anomala durante la instalacin del servidor UI. Este comando tambin se puede ejecutar en cualquier momento si por cualquier motivo se pierden los datos de configuracin. Nota: debido a una limitacin de los sistemas AIX, los administradores deben ejecutar este comando para crear los datos iniciales.
Autorizacin
senior
Opciones
host[:puerto] Especifica el nombre del host en el que se ejecuta la consola de eventos y, opcionalmente, el puerto utilizado por el host; si no se utiliza el puerto 94, debe especificarse el puerto. usuario Especifica el nombre de usuario del administrador. contrasea Especifica la contrasea del administrador. operador Especifica el operador que se asignar a la consola predeterminada. Este parmetro es opcional.
Ejemplos
El ejemplo siguiente crea una configuracin predeterminada de Tivoli Enterprise Console para el operador Root_adasilva-region en el host calculus; el nombre y la contrasea del administrador son root y mi_contrasea:
wcrtteccfg calculus root mi_contrasea Root_adasilva-region
Captulo 1. Comandos
43
wdbconfig.sh
Ejecuta los scripts de configuracin de la base de datos.
Sintaxis
wdbconfig.sh [rm | rm_tbl | cr | cr_tbl | upg | upg_362]
Descripcin
El script wdbconfig.sh ejecuta los scripts de configuracin de la base de datos generados durante la instalacin de Tivoli Enterprise Console realizada mediante el asistente de la base de datos. Se utiliza cuando los scripts generados deben copiarse en un sistema de host RIM que se encuentra en un sistema distinto del sistema del servidor de eventos. El script wdbconfig.sh se encuentra en el mismo directorio que los scripts de instalacin de la base de datos de eventos generados. El usuario debe haber iniciado la sesin como el mismo usuario que el ID de usuario RIM especificado para el objeto RIM de base de datos de eventos. Este usuario debe tener acceso DBA a las tablas de la base de datos de eventos. Asimismo, el usuario debe tener un inicio de sesin correspondiente para el administrador de Tivoli. Para la base de datos Informix, el script wdbconfig.sh slo se puede ejecutar en el sistema en el que est instalado el servidor de la base de datos.
Autorizacin
user
Opciones
rm rm_tbl Ejecuta el script dbConfigure_rm_tbl.sh para eliminar las tablas, los ndices y las vistas de la base de datos. cr Ejecuta el script dbConfigure_cr.sh para efectuar una nueva instalacin de la base de datos. Si tiene una base de datos existente, sta debe eliminarse antes de realizar una nueva instalacin. Ejecuta el script dbConfigure_rm.sh para eliminar por completo la base de datos.
cr_tbl Ejecuta el script dbConfigure_cr_tbl.sh para agregar las tablas, los ndices y las vistas de la base de datos. upg Ejecuta el script dbConfigure_upg.sh para actualizar la base de datos de un esquema de versin 3.7.1 al esquema de las versiones 3.8 y 3.9.
upg_362 Ejecuta el script dbConfigure_upg_362.sh para actualizar la base de datos de un esquema de versin 3.6.2 al esquema de las versiones 3.8 y 3.9.
Ejemplos
El ejemplo siguiente crea una nueva base de datos:
wdbconfig.sh cr
44
wdbmaint.sh
Actualiza las estadsticas de distribucin de datos de la base de datos o reorganiza la base de datos.
Sintaxis
wdbmaint.sh [reorg | stats] [nombre_objeto_rim db2server | db2client]
Descripcin
El comando wdbmaint.sh mejora el rendimiento en tiempo de ejecucin de la base de datos actualizando las estadsticas de la base de datos o reorganizando la base de datos. Al actualizar las estadsticas de la base de datos para reflejar la cantidad actual de datos y los valores de distribucin de datos se facilita la tarea del gestor interno de la base de datos de elegir el mejor plan de acceso para recuperar datos de la base de datos. Para algunas bases de datos, como la base de datos DB2, la actualizacin de las estadsticas tambin actualiza la informacin acerca de las pginas libres en una tabla. Esto permite que la base de datos reutilice las pginas de tabla que contienen filas suprimidas. Las estadsticas de la base de datos deben actualizarse regularmente para evitar que se produzcan errores de espacio de tabla lleno; siempre deben actualizarse despus de depurar los datos mediante el comando wtdbclear. Al reorganizar la base de datos se pueden volver a colocar los ndices o las tablas en el orden de ndice secuencial, con lo que se reduce la fragmentacin. Tras ejecutarse el programa de utilidad de reorganizacin, las estadsticas se actualizan automticamente. Al reorganizar la base de datos DB2 tambin se liberan las ampliaciones asignadas a una tabla de un espacio de tabla que la tabla ya no necesita. Para la base de datos DB2, una ampliacin asignada por una tabla de un espacio de tablas slo se libera si la tabla se reorganiza; por este motivo, el informe wtdbspace sigue mostrando que el espacio de tablas tiene mucho espacio asignado incluso despus de ejecutar el comando wtdbclear. Nota: la reorganizacin de las bases de datos debe llevarse a cabo mientras el servidor de eventos est desconectado. Las estadsticas se pueden actualizar mientras el servidor de eventos est en ejecucin. Se recomienda ejecutar estos programas de utilidad con frecuencia. En concreto, los programas de utilidad deben ejecutarse despus de que se produzcan grandes cantidades de supresiones o inserciones. Por este motivo, se recomienda ejecutar el programa de utilidad reorg tras wtdbclear. Los programas bash y wrimsql deben estar disponibles en el sistema en el que se ejecuta este comando. Para las bases de datos Sybase, DB2 y Microsoft SQL Server que ejecutan la opcin reorg, este comando debe ejecutarse desde el host RIM. Para todas las dems bases de datos, este comando se ejecuta desde el servidor de eventos. Para la base de datos DB2, debe iniciar la sesin como usuario RIM de Tivoli Enterprise Console DB2 y el comando debe ejecutarse desde el procesador de lnea de comandos de DB2 en el host RIM. Si este comando no se ejecuta en el servidor de eventos, copie el script wdbmaint.sh del directorio $BINDIR/TME/TEC/sql en el sistema en el que se ejecuta el script.
Captulo 1. Comandos
45
El usuario que ejecuta el comando wdbmaint.sh debe tener permiso de escritura sobre el directorio en el que se ejecuta el comando para que se puedan crear los archivos de trabajo temporales.
Autorizacin
user
Opciones
reorg stats Permite reorganizar los ndices y las tablas de la base de datos. Permite actualizar las estadsticas internas de distribucin de datos.
nombre_objeto_rim Especifica el nombre del objeto RIM asociado con la base de datos de eventos. El valor predeterminado es TEC. db2client Especifica que el cliente DB2 est instalado en el host RIM y es la conexin empleada por RIM. Este parmetro slo se utiliza con las conexiones DB2 a RIM. El cliente DB2 solicita la contrasea que se utilizar para conectar con la base de datos correspondiente al usuario definido en el objeto RIM especificado. db2server Especifica que el servidor DB2 est instalado en el host RIM y es la conexin empleada por RIM. Este parmetro slo se utiliza con las conexiones DB2 a RIM. Para una base de datos DB2, si no especifica db2client ni db2server, el valor predeterminado es db2server.
Ejemplos
$BINDIR/TME/TEC/sql/wdbmaint.sh reorg $BINDIR/TME/TEC/sql/wdbmaint.sh stats $BINDIR/TME/TEC/sql/wdbmaint.sh reorg tec db2client
Vase tambin
wtdbclear, wtdbspace
46
wdelac
Elimina un registro de configuracin de adaptador de un perfil de configuracin de adaptador.
Sintaxis
wdelac clave... perfil
Descripcin
El comando wdelac suprime los registros seleccionados por las claves proporcionadas del perfil de configuracin de adaptador especificado. La prxima vez que se distribuya el perfil, se eliminarn los archivos de configuracin antiguos o que no se basan en el valor del indicador de comportamiento rm_on_del.
Autorizacin
admin
Opciones
clave... 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 de clave en la parte superior derecha del panel de entrada del perfil de configuracin del adaptador o mediante el comando wlsac. perfil Nombre del perfil de configuracin del adaptador del que deben eliminarse los registros. Si el nombre contiene espacios, escriba todo el nombre entre comillas.
Ejemplos
El ejemplo siguiente suprime los registros con los valores de clave 0, 1 y 4 del perfil denominado ACP Logfile Profile:
wdelac 0 1 4 "ACP Logfile Profile"
Vase tambin
waddac, wlsac, wsetac, wsetaddflt
Captulo 1. Comandos
47
wdelsrc
Suprime una fuente de la lista de servidores de eventos.
Sintaxis
wdelsrc [S servidor] fuente...
Descripcin
El comando wdelsrc suprime una fuente de la lista de fuentes actuales del servidor de eventos. La fuente suprimida no se elimina de las consolas de eventos, ni tampoco se suprimen los eventos existentes de la fuente eliminada de la cach de eventos. Por lo tanto, la fuente se puede agregar de nuevo sin volver a configurar los grupos de eventos. Para visualizar una lista de las fuentes disponibles, utilice el comando wlssrc.
Autorizacin
senior
Opciones
fuente... Especifica el nombre de la fuente que se desea suprimir. Debe especificarse al menos una fuente. Separe las distintas fuentes con un espacio. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli.
Ejemplos
El ejemplo siguiente suprime la fuente SNMP de la regin de Tivoli local:
wdelsrc SNMP
Vase tambin
wcrtnvgroups, wlssrc, wsetsrc
48
wlsac
Muestra los registros de configuracin de adaptador de un perfil de configuracin de adaptador.
Sintaxis
wlsac [ l | f formato] [clave... ] perfil
Descripcin
El comando wlsac escribe en la salida estndar uno o varios registros de un perfil de configuracin de adaptador. Es posible proporcionar una o varias claves de registro para elegir registros individuales. Si no se especifica ninguna clave, se imprimirn todos los registros. Los registros se imprimen con uno de los dos formatos posibles. El formato predeterminado incluye la clave, el tipo de adaptador y el nombre de archivo de destino completo (es decir, el nombre del archivo en los hosts abonados donde se escribir la configuracin del adaptador al efectuar la distribucin). Se puede especificar otro formato con la opcin f. Con la opcin l, cada registro se imprime como una autntica configuracin de adaptador con el mismo formato empleado cuando se crean los archivos de configuracin al efectuar la distribucin.
Autorizacin
admin
Opciones
clave... Clave de los registros que se desea imprimir. Si se omite la clave, se imprimirn todos los registros. Separe las diversas claves con un espacio. Puede ver el valor de clave en la parte superior derecha del panel de entrada del perfil de configuracin de adaptador o mediante este comando. perfil Nombre del perfil de configuracin del adaptador cuyos registros se van a imprimir. Si el nombre contiene espacios, escriba todo el nombre entre comillas.
f formato Proporciona un formato alternativo para imprimir registros. La cadena de formato puede contener texto arbitrario as como referencias a los datos del registro. Estas referencias tienen el mismo formato que el empleado al construir catlogos de mensajes, es decir, un valor de ndice y una solicitud de formato. Los valores siguientes estn disponibles para el formato: %1 %2 %3 %4 %5 %6 %7 %8 Clave Tipo de adaptador Directorio de destino Nombre de archivo de destino Campo de comentarios del registro Secuencia de definiciones de variables de entorno Secuencia de definiciones de filtros de eventos Secuencia de peticiones de distribucin de archivo
Captulo 1. Comandos
49
%9 %10 %11 %12 %13 %14 %15 %16
Secuencia de indicadores de comportamiento de punto final ID de usuario para las acciones de distribucin ID de grupo para las acciones de distribucin Modo de prefiltro Secuencia de definiciones de prefiltro Secuencia de definiciones de cach de filtro Nombre del identificador del adaptador Conmutador del identificador del adaptador
Los valores de clave, tipo, directorio de destino y nombre de archivo son cadenas y es necesario darles el formato $s. Los valores de secuencia son listas de cadenas; el formato ms sencillo para esos valores es del tipo $I{%1$s}{\n}, que imprime cada cadena de la secuencia en una lnea aparte. Toda la cadena debe escribirse entre comillas simples. As, el formato 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 los productos Tivoli Enterprise Console y Tivoli ADE, consulte la publicacin Tivoli ADE Application Services Manual, Volume 1, para obtener completa informacin sobre los formatos de los mensajes y los catlogos de mensajes. l Muestra todos los registros seleccionados como configuraciones de adaptador completas.
Ejemplos
El ejemplo siguiente muestra cmo 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.conf Record comment tecad_nt Configuration! Env Var Defs BEGIN ServerLocation=@EventServer EventMaxSize=4096 PollInterval=30 BufEvtPath=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\adapters\etc\ \ tecad_nt.cache AdapterCdsFile=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\adapters\ \ etc\tecad_nt.cds AdapterErrorFile=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\adapters\ \ etc\tecad_nt.err AdapterSpecificFile=C:\usr\local\Tivoli\bin\w32-ix86\TME\TEC\ \ adapters\etc\tecad_nt.conf Env Var Defs END Event Filters BEGIN
50
Filter:Class=NT_Base Filter: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 END File Dists BEGIN tecad_nt.err=/usr/local/Tivoli/bin/generic_unix/TME/ACF_REP/ \ tecad_nt.err tecad_nt.fmt=/usr/local/Tivoli/bin/generic_unix/TME/ACF_REP/ \ tecad_nt.fmt tecad_nt.cds=/usr/local/Tivoli/bin/generic_unix/TME/ACF_REP/ \ tecad_nt.cds !net stop TECNTAdapter c: cd \usr\local\Tivoli\bin\w32-ix86 cd TME\TEC\adapters\etc del tecad_nt.* cd \temp del 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 TECNTAdapter File Dists END Endpt Behavior Flags rm_on_del=yes! UID Operator! GID 0!
Vase tambin
waddac, wdelac, wsetac, wsetaddflt
Captulo 1. Comandos
51
wlsaddflt
Muestra informacin predeterminada global sobre los tipos de adaptador definidos.
Sintaxis
wlsaddflt [ l | f formato] [tipo... ]
Descripcin
El comando wlsaddflt recupera informacin predeterminada global para uno o varios tipos de adaptador. Si no se especifica ningn tipo, wlsaddflt imprime informacin predeterminada para todos los tipos de adaptador conocidos. Los registros se imprimen con uno de los dos formatos posibles. El formato predeterminado incluye el tipo de adaptador y el nombre de archivo de destino completo (es decir, el nombre del archivo en los hosts abonados donde se escribir la configuracin del adaptador al efectuar la distribucin). Se puede especificar otro formato con la opcin f. Con la opcin l, cada registro se imprime como una autntica configuracin de adaptador con el mismo formato empleado cuando se crean los archivos de configuracin al efectuar la distribucin.
Autorizacin
admin
Opciones
tipo... Tipo de adaptador cuyos valores predeterminados globales se van a imprimir. Separe los diversos tipos con un espacio. Para ver los tipos disponibles, utilice el comando wlsaddflt.
f formato Proporciona un formato alternativo para imprimir registros. La cadena de formato puede contener texto arbitrario as como referencias a los datos del registro. Estas referencias tienen el mismo formato que el empleado al construir catlogos de mensajes, es decir, un valor de ndice y una solicitud de formato. Los valores siguientes estn disponibles para el formato: %1 %2 %3 %4 %5 %6 %7 %8 %9 %10 %11 Tipo de adaptador (igual que %2) Tipo de adaptador Directorio de destino Nombre de archivo de destino Campo de comentarios del registro Secuencia de definiciones de variables de entorno Secuencia de definiciones de filtros de eventos Secuencia de peticiones de distribucin de archivo Secuencia de indicadores de comportamiento de punto final ID de usuario para las acciones de distribucin ID de grupo para las acciones de distribucin
52
Los valores de tipo, directorio de destino y nombre de archivo son cadenas y es necesario darles el formato $s. Los valores de secuencia son listas de cadenas; el formato ms sencillo para esos valores es del tipo $I{%1$s}{\n}, que imprime cada cadena de la secuencia en una lnea aparte. Toda la cadena debe escribirse entre comillas simples. As, el formato 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 los productos Tivoli Enterprise Console y Tivoli ADE, consulte la publicacin Tivoli ADE Application Services Manual, Volume 1, para obtener completa informacin sobre los formatos de los mensajes y los catlogos de mensajes. l Muestra todos los registros seleccionados como configuraciones de adaptador completas.
Ejemplos
El ejemplo siguiente muestra el registro de configuracin 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=@EventServer EventMaxSize=4096 WellBehavedDaemon=TRUE BufEvtPath=$TIVOLIHOME/tec/${AC_TYPE}.cache
Vase tambin
waddac, wdelac
Captulo 1. Comandos
53
wlsadenv
Muestra una lista instalada de las variables de entorno de EIF (Recurso de integracin de eventos) especficas del adaptador.
Sintaxis
wlsadenv tipo
Descripcin
El comando wlsadenv escribe en la salida estndar la lista de variables de entorno del Recurso de integracin de eventos reconocidas por el tipo de adaptador especificado, separadas por lneas nuevas. El Recurso de configuracin del adaptador utiliza el tipo __generic__ para la lista de variables reconocidas por la propia biblioteca del Recurso de integracin de eventos.
Autorizacin
admin
Opciones
tipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comando wlsaddflt.
Ejemplos
El ejemplo siguiente lista las variables de entorno del Recurso de integracin de eventos para el tipo de adaptador tecad_logfile:
wlsadenv tecad_logfile
Este ejemplo devuelve la siguiente informacin:

UnmatchLog LogSources
Vase tambin
waddac, wsetadenv, wlsadgui, wlsadval
54
wlsadgui
Muestra un enlace instalado con las herramientas de configuracin ampliadas especficas del adaptador.
Sintaxis
wlsadgui tipo
Descripcin
El comando wlsadgui escribe en la salida estndar el nombre de clase, el nombre de instancia y la etiqueta de botn instalada con wsetadgui para el tipo de adaptador especificado. Si un adaptador tiene herramientas de configuracin ampliadas especiales destinadas al uso con las herramientas de configuracin grficas del archivo de configuracin del adaptador, debe establecerse un enlace al instalar el adaptador.
Autorizacin
admin
Opciones
tipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comando wlsaddflt.
Ejemplos
El ejemplo siguiente muestra las herramientas de configuracin ampliadas para el tipo tecad_logfile:
# wlsadgui tecad_logfile @LogfileConfiguration:LogfileConfiguration Logfile Format Editor...
Vase tambin
wlsac, wlsadenv, wsetadgui, wlsadval
Captulo 1. Comandos
55
wlsadval
Muestra la informacin de validacin instalada para un tipo de adaptador.
Sintaxis
wlsadval atributo tipo
Descripcin
El comando wlsadval escribe en la salida estndar la informacin de validacin almacenada anteriormente con el comando wsetadval para el atributo especificado del tipo de adaptador proporcionado.
Autorizacin
admin
Opciones
atributo Nombre del atributo de perfil cuya informacin de validacin debe imprimirse. La lista siguiente muestra los atributos de un perfil de configuracin de adaptador tpico: ACPbhv Secuencia de variables de comportamiento del perfil, separadas por lneas nuevas. ACPcomment Campo de comentarios. ACPdist Secuencia de peticiones de distribucin, separadas por lneas nuevas. ACPev Secuencia de variables de entorno, separadas por lneas nuevas. ACPflt Secuencia de definiciones de filtro, separadas por lneas nuevas. ACPgid ID de grupo para las acciones de punto final. ACPtargdir Directorio de instalacin de configuracin. ACPtarget Nombre de archivo de configuracin principal de destino. ACPtype Tipo de registro. Normalmente este atributo no necesita validacin. ACPuid ID de usuario para las acciones de punto final. Puede haber otros atributos si se agregan al perfil con las herramientas de Tivoli Application Extension Facility (AEF). tipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comando wlsaddflt.
56
Ejemplos
El ejemplo siguiente muestra la informacin de validacin para el atributo ACPtarget y el tipo tecad_logfile_solaris2:
wlsadval ACPtarget tecad_logfile_solaris2 case "$1" in "tecad_logfile.conf") echo TRUE ;; *) echo FALSE ;; esac exit 0
Vase tambin
wlsac, wlsadenv, wsetadgui
Captulo 1. Comandos
57
wlsaeenv
Muestra las variables de entorno disponibles en un punto final de perfil de configuracin de adaptador.
Sintaxis
wlsaeenv [a] punto_final
Descripcin
El comando wlsaeenv imprime en la salida estndar la lista de variables de entorno y sus valores para un punto final determinado. Cada una de las variables se imprime en una lnea con el formato nombre=valor. Este formato se puede emplear con wsetaeenv cuando ese comando se ejecuta con la opcin i. Por consiguiente, es posible emplear wlsaeenv y wsetaeenv en combinacin para copiar el entorno de un punto final en otro.
Autorizacin
admin
Opciones
punto_final Nombre del objeto de punto final que se modificar. Se puede hacer referencia al objeto de punto final con la notacin @Classname:etiqueta estndar; de lo contrario, se supone que es una referencia a un objeto de nodo gestionado. a Solicita que se impriman las cuatro variables automticas especficas del punto final (ACPEP_NAME, ACPEP_CLASS, ACPEP_NODE y ACPEP_OID) junto con todas las establecidas con wsetaeenv. La variable ACPEP_NODE slo se imprime para los nodos gestionados, no para los puntos finales. Si se hace referencia al nombre del punto final como @Endpoint:etiqueta, la variable ACPEP_NODE no se imprimir ya que no tiene ningn sentido para este nombre de clase.
Ejemplos
El ejemplo siguiente muestra las variables de entorno y sus valores para el punto final ep1:
wlsaeenv -a @Endpoint:ep1
Este comando devuelve la siguiente informacin:

ACPEP_NAME=@Endpoint:xerius ACPEP_OID=1170507881.2.508+#TMF_Endpoint::Endpoint# ACPEP_CLASS=Endpoint
Vase tambin
waddac, wdelac, wdistrib (en la publicacin IBM Tivoli Management Framework Reference Manual), wsetaeenv
58
wlsemsg
Lista los eventos recibidos.
Sintaxis
wlsemsg [k clave] [r gravedad] [t estado] consola [grupo_eventos...]
Descripcin
El comando wlsemsg lista los eventos recibidos en la base de datos de eventos. Debe emplear las opciones para especificar un conjunto de eventos determinado o se devolvern todos los eventos. Si desea especificar varios valores para un indicador, utilice el indicador varias veces, salvo que se indique lo contrario para la opcin. Cuando utilice las opciones, slo se devolvern los eventos que cumplan la especificacin de todas las opciones. Utilice la opcin k para especificar claves de clasificacin para los eventos devueltos.
Autorizacin
user
Opciones
consola Lista los eventos que corresponden a 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 diversos grupos de eventos con un espacio. Slo se indicarn los eventos que pasen los filtros del grupo de eventos. k clave Especifica los campos por los que se efectuar la clasificacin. Los eventos se clasifican en orden ascendente por event_handle, server_handle y date_reception. Otros valores son administrator, class, hostname, id, message, origin, repeat_count, severity, source, status, sub_source y sub_origin. El campo id se define como la concatenacin de event_handle, server_handle y date_reception. Separe los diversos valores con una coma seguida de un espacio (, ) y escriba todo el conjunto de valores entre comillas dobles, como en el ejemplo siguiente:
wlsemsg -k "Class, Date, Status" ConsoleName
r gravedad Especifica un nivel de gravedad Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) o Desconocido (UNKNOWN). La ubicacin tambin puede configurar gravedades adicionales. t estado Especifica un estado Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE) o Confirmado (ACK).
Captulo 1. Comandos
59
Ejemplos
El ejemplo siguiente visualiza todos los eventos abiertos con la gravedad de aviso (WARNING) que se han enviado a la consola de eventos Network Events:
wlsemsg r WARNING t OPEN "Network Events"
Vase tambin
wtdumper en la pgina 132, wtdumprl en la pgina 134, wpostemsg (versin de punto final), wsetemsg
60
wlsesvrcfg
Lista los parmetros de configuracin de un servidor de eventos en ejecucin.
Sintaxis
wlsesvrcfg [S servidor] [b] [c] [e] [k] [m] [n] [r] [t]
Descripcin
El comando wlsesvrcfg lista los parmetros de configuracin de un servidor de eventos en ejecucin. El servidor de la regin de Tivoli local es el servidor predeterminado salvo que se especifique otro servidor. Si no se especifica ninguna opcin, se visualizarn todos los parmetros.
Autorizacin
user
Opciones
b c e k m n Visualiza el nmero mximo de mensajes de eventos colocados en el bfer de recepcin. Visualiza el nmero de eventos que pueden almacenarse en la cach de eventos. Visualiza el nmero de segundos que se conservan los eventos recibidos en el registro de recepcin. Visualiza el nmero de segundos que deben conservarse los eventos cerrados en la cach de eventos. Visualiza el nmero de segundos que deben concederse al servidor de eventos para inicializarse. Visualiza el nmero de segundos que deben conservarse los eventos que no se han cerrado.
S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli. t Visualiza si el seguimiento de reglas est habilitado y el nombre de ruta del archivo de seguimiento.
Captulo 1. Comandos
61
Ejemplos
El ejemplo siguiente lista informacin correspondiente al servidor de eventos instalado en la regin de Tivoli denominada gray-region:
# wlsesvrcfg -S @EventServer#gray-region -t
A continuacin se muestra la salida de este comando:

Trace rule execution: No Rule trace output file: /tmp/rules.trace
Vase tambin
wsetesvrcfg
62
wlssrc
Proporciona una lista de las fuentes existentes en el servidor de eventos.
Sintaxis
wlssrc [S servidor] [l] [fuente...]
Descripcin
El comando wlssrc lista las fuentes que estn configuradas en este momento en el servidor de eventos. Si no se especifica ninguna fuente, se listarn todas. Puede emplear opciones para ver la etiqueta para cada fuente. LA etiqueta representa la fuente en las consolas de eventos de los administradores.
Autorizacin
user
Opciones
fuente... Especifica una fuente para obtener una lista de la misma o una expresin regular Perl. Si no se especifica ninguno, se listarn todas las fuentes. Separe las distintas fuentes con un espacio. l Visualiza la etiqueta que identifica cada fuente.
S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli.
Ejemplos
El ejemplo siguiente lista toda la informacin acerca de todas las fuentes del servidor de eventos local:
wlssrc bl
Vase tambin
wcrtsrc, wdelsrc, wsetsrc
Captulo 1. Comandos
63
wmigcon
Efecta la migracin de las consolas, los grupos de eventos, los filtros de grupo de eventos y los operadores de la versin 3.6 de Tivoli Enterprise Console a las versiones 3.7.x, 3.8 y 3.9.
Sintaxis
wmigcon [h host:puerto] [u usuario] [p contrasea] [x e | r | c]
Descripcin
El comando wmigcon lleva a cabo una migracin automtica de las consolas, los grupos de eventos y los operadores de una instalacin de la versin 3.6 de Tivoli Enterprise Console existente al formato adecuado para la consola de eventos de la versin 3.7, 3.8 y 3.9. Este comando normalmente se utiliza slo una vez, durante la configuracin inicial del producto Tivoli Enterprise Console, versin 3.7, 3.8 o 3.9. La tabla siguiente indica cmo se cambian los filtros de grupos de eventos.
Filtro antiguo LOG ^LOG LOG$ ^LOGFILE$ LOG* LOG+ LOG? LO[G,T] 123.84.12.[0-5][0-9] 123.84.12.0\b ^LO[G,T] LO[G,T]$ ^123.84.12.[0-5][0-9]$ Filtro nuevo LIKE %LOG% LIKE LOG% LIKE %LOG LIKE LOGFILE LIKE %LOG% LIKE %LOG% LIKE %LOG% LIKE %LO[G,T]% LIKE %123.84.12.[0-5][0-9]% LIKE %123.84.12.0 % LIKE LO[G,T] LIKE %LO[G,T] LIKE 123.84.12.[0-5][0-9]
Notas: 1. Este comando intenta convertir cada filtro con la mayor precisin posible, pero no es posible obtener una coincidencia exacta para cada filtro. Los filtros antiguos se especifican como expresiones regulares Perl, mientras que los filtros nuevos se especifican con el operador LIKE de SQL. Las expresiones regulares y las sentencias SQL no se correlacionan entre s de modo preciso. Por consiguiente, se recomienda examinar cada uno de los filtros una vez que el comando wmigcon los haya convertido para asegurarse de que el filtro SQL obtenido sea correcto. 2. El comando wmigcon migra la totalidad de las consolas, los grupos de eventos y los operadores. No es posible migrar estos objetos de forma selectiva. 3. El filtro de eventos de la versin 3.6 de Tivoli Enterprise Console realiza el filtrado basndose en cinco atributos de un evento: class, source, sub_source, origin y sub_origin. El comando wmigcon trata el atributo source de forma distinta a los dems atributos. El comando wmigcon crea un nuevo filtro que
64
coincide exactamente con una sola fuente. Es decir, no hay ningn carcter comodn (%) en el filtro de la versin 3.9 de Tivoli Enterprise Console. Por lo tanto, si la fuente (source) y una subfuente (sub_source) de un filtro de la versin 3.6 de Tivoli Enterprise Console son las siguientes:
source: LOG sub_source: LOGFILE
el filtro de la versin 3.9 de Tivoli Enterprise Console resultante es el siguiente:

source Equal to (=) LOG sub_source LIKE (LIKE) %LOGFILE%
donde el nuevo sub_source contiene caracteres comodn, lo que le permite coincidir con cualquier cadena que contenga la subcadena LOGFILE, pero el atributo source slo coincide con las cadenas que son exactamente LOG.
Autorizacin
super, senior
Opciones
h host[:puerto] Nombre del nodo gestionado que contiene la consola de eventos de Tivoli Enterprise Console versin 3.6. Especifique esta opcin con el formato host:puerto si se utiliza un puerto distinto del puerto 94. p contrasea Contrasea del inicio de sesin especificado en el argumento u usuario. Esta opcin es obligatoria si utiliza la opcin u para especificar un usuario. u usuario Inicio de sesin empleado como administrador de Tivoli. Si no especifica esta opcin, se utiliza el ID del usuario que tenga una sesin iniciada en este momento. x e | r | c Modo de resolucin de los nombres de objeto conflictivos. Utilice x e para emplear el objeto existente (consola, grupo de eventos u operador), x r para sustituir el objeto existente por el nuevo o x c para cambiar el nombre del objeto agregando un nmero al nuevo objeto.Los indicadores son sensibles a las maysculas y minsculas. El espacio entre la opcin y el indicador es opcional. Nota: si est trabajando en un sistema AIX y ha iniciado la sesin como root, debe utilizar las subopciones h, u y p para especificar explcitamente el nombre del host, el ID de usuario y la contrasea para evitar que se visualice la ventana de inicio de sesin. Esto no es necesario si inicia la sesin en un sistema AIX con otro ID de usuario.
Ejemplos
El ejemplo siguiente lleva a cabo la migracin como el usuario root en el nodo gestionado mica. Los conflictos de nombres se resuelven cambiando el nombre del nuevo objeto.
wmigcon -h mica -u root -p tivoli -x c
Captulo 1. Comandos
65
wpostemsg (versin de punto final)

Enva un evento al servidor de eventos mediante comunicaciones de punto final Tivoli a un gateway de Tivoli Enterprise Console.
Sintaxis
wpostemsg [S servidor | f archivo_configuracin] [m mensaje] [r gravedad ] [ atributo=valor... ] clase fuente
Descripcin
El comando wpostemsg enva un evento a un servidor de eventos mediante comunicaciones de punto final Tivoli a un gateway Tivoli Enterprise Console. Notas: 1. Aunque este comando sigue estando admitido, es preferible utilizar el comando wpostzmsg para enviar eventos mediante comunicaciones Tivoli. 2. Puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador). Este comando requiere la instalacin de un punto final Tivoli en el sistema en el que se ejecuta este comando. Si ha distribuido un adaptador al punto final, este comando se encuentra en el directorio $LCF_BINDIR/../bin. Este comando depende de las variables de entorno del punto final, que se pueden establecer mediante los scripts lcf_env.sh o lcf_env.csh incluidos en la instalacin del punto final. Si utiliza wpostemsg en un sistema configurado como punto final y como nodo gestionado, puede crear un alias de shell para la versin de punto final del comando. Los ejemplos siguientes ilustran cmo hacerlo: v Shell C: alias wpostemsgep "$LCF_BINDIR/../bin/wpostemsg" v Shell Korn: alias wpostemsgep="$LCF_BINDIR/../bin/wpostemsg" v Shell bash (en sistemas Windows): alias wpostemsgep="/Archivos de\ programa/Tivoli/lcf/bin/w32-ix86/bin/wpostemsg.exe Asegrese de que la sentencia PATH no incluya ambas versiones del comando.
Autorizacin
user
Opciones
atributo=valor... Asigna un valor a cualquier atributo vlido. El atributo debe estar definido para la clase de evento. Separe las diversas expresiones atributo=valor con espacios. clase Especifica la clase del evento. Debe coincidir con una clase configurada en el servidor. El adaptador de eventos define las clases y stas se indican en el archivo BAROC del adaptador. Si hay algn espacio en blanco en el nombre de la clase, especifique el nombre de la clase entre comillas dobles.
66
fuente
Especifica la fuente del evento. Si hay algn espacio en blanco en el nombre de la fuente, especifquelo entre comillas dobles.
f archivo_configuracin Especifica el nombre del archivo de configuracin. Consulte la publicacin IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Texto del evento, entre comillas dobles. r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. Especifique @EventServer para que los eventos se enven al servidor de eventos con nombre local del gateway Tivoli Enterprise Console. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli. Si no especifica la opcin S o f, el evento se enva al servidor de eventos definido en el gateway Tivoli Enterprise Console. Si en el servidor de eventos se est ejecutando el correlacionador de puertos, puede especificar una direccin IP o un nombre de host TCP/IP en su lugar. El resultado es que habr comunicaciones no de Tivoli entre el gateway Tivoli Enterprise Console y el servidor de eventos.
Ejemplos
El siguiente ejemplo enva un mensaje de prueba que muestra un evento Su_Failure con el nivel de gravedad de aviso en las consolas de eventos:
wpostemsg r AVISO m "error de su" Su_Failure LOGFILE
Vase tambin
postemsg, postzmsg, TECAgent, wpostemsg (versin de nodo gestionado), wpostzmsg (versin de punto final), wpostzmsg (versin de nodo gestionado), wsetemsg
Captulo 1. Comandos
67
wpostemsg (versin de nodo gestionado)

Enva un al servidor de eventos mediante comunicaciones de nodo gestionado Tivoli.
Sintaxis
wpostemsg [S servidor | f archivo_configuracin] [m mensaje] [r gravedad] [atributo=valor...] clase fuente
Descripcin
El comando wpostemsg enva un evento a un servidor de eventos mediante comunicaciones de nodo gestionado Tivoli. Notas: 1. Aunque este comando sigue estando admitido, es preferible utilizar el comando wpostzmsg para enviar eventos mediante comunicaciones Tivoli. 2. Puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador). Este comando requiere la instalacin de Tivoli Management Framework en el sistema en el que se ejecuta este comando. Este comando se encuentra en el directorio $BINDIR/bin. La versin de nodo gestionado de wpostemsg depende de las variables de entorno de Tivoli, que se pueden establecer mediante los scripts setup_env.sh o setup_env.cmd incluidos en la instalacin.
Autorizacin
user
Opciones
atributo=valor... Asigna un valor a cualquier atributo vlido. El atributo debe estar definido para la clase de evento. Separe las diversas expresiones atributo=valor con espacios. clase Especifica la clase del evento. Debe coincidir con una clase configurada en el servidor. El archivo BAROC del adaptador de eventos define las clases. Si hay algn espacio en blanco en el nombre de la clase, especifique el nombre de la clase entre comillas dobles. Especifica la fuente del evento. Si hay algn espacio en blanco en el nombre de la fuente, especifquelo entre comillas dobles.
fuente
f archivo_configuracin Especifica el nombre del archivo de configuracin del adaptador. Consulte la publicacin IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Texto del evento, entre comillas dobles.
68
r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El valor predeterminado es @EventServer, el servidor de eventos local. Para especificar un servidor remoto, especifique @EventServertmr, siendo tmr el nombre de una regin de Tivoli. Si no se especifica la opcin S ni f, el evento se enva al servidor de eventos con nombre local.
Ejemplos
El siguiente ejemplo enva un mensaje de prueba que muestra un evento Su_Failure con el nivel de gravedad de aviso en las consolas de eventos:
wpostemsg r AVISO m "error de su" Su_Failure LOGFILE
Vase tambin
postemsg, postzmsg, TECAgent, wpostemsg (versin de punto final), wpostzmsg (versin de punto final), wpostzmsg (versin de nodo gestionado), wsetemsg
Captulo 1. Comandos
69
wpostzmsg (versin de punto final)

Enva un evento al servidor de eventos mediante comunicaciones de punto final Tivoli a un gateway de Tivoli Enterprise Console o mediante comunicaciones no de Tivoli directamente al servidor de eventos.
Sintaxis
wpostzmsg [S servidor | f archivo_configuracin] [m mensaje] [rgravedad] [atributo=valor...] clase fuente
Descripcin
El comando wpostzmsg enva un evento a un servidor de eventos mediante comunicaciones de punto final Tivoli a un gateway Tivoli Enterprise Console. Este comando requiere la instalacin de un punto final Tivoli en el sistema en el que se ejecuta este comando. Si ha distribuido un adaptador al punto final, este comando se encuentra en el directorio $LCF_BINDIR/../bin. Nota: puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador). Este comando depende de las variables de entorno del punto final, que se pueden establecer mediante los scripts lcf_env.sh o lcf_env.csh incluidos en la instalacin del punto final. Si utiliza wpostzmsg en un sistema configurado como punto final y como nodo gestionado, puede crear un alias de shell para la versin de punto final del comando. Los ejemplos siguientes ilustran cmo hacerlo: v Shell C: alias wpostzmsgep "$LCF_BINDIR/../bin/wpostzmsg" v Shell Korn: alias wpostzmsgep="$LCF_BINDIR/../bin/wpostzmsg" v Shell bash (en sistemas Windows): alias wpostzmsgep="/Archivos de\ programa/Tivoli/lcf/bin/w32-ix86/bin/wpostzmsg.exe Asegrese de que la sentencia PATH no incluya ambas versiones del comando.
Autorizacin
user
Opciones
fuente
f archivo_configuracin Especifica el nombre del archivo de configuracin. Para realizar el envo
70
directamente al servidor de eventos, especifique el transporte SOCKET en el archivo de configuracin. Consulte la publicacin IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Texto del evento, entre comillas dobles. r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. Especifique @EventServer para que los eventos se enven al servidor de eventos con nombre local del gateway Tivoli Enterprise Console. Para indicar un servidor remoto, especifique @EventServertmr, siendo tmr el nombre de una regin de Tivoli. Si no especifica la opcin S o f, el evento se enva al servidor de eventos definido en el gateway Tivoli Enterprise Console. Si en el servidor de eventos se est ejecutando el correlacionador de puertos, puede especificar una direccin IP o un nombre de host TCP/IP en su lugar. El resultado es que habr comunicaciones no de Tivoli entre el gateway Tivoli Enterprise Console y el servidor de eventos.
Ejemplos
El ejemplo siguiente para los entornos UNIX enva un mensaje de prueba que muestra un evento Su_Failure con el nivel de gravedad de aviso en las consolas de eventos:
wpostzmsg -r WARNING m "Error de inicio de sesin su." Su_Failure LOGFILE
Vase tambin
postemsg, postzmsg, TECAgent, wpostemsg (versin de punto final), wpostemsg (versin de nodo gestionado), wpostzmsg (versin de nodo gestionado), wsetemsg
Captulo 1. Comandos
71
wpostzmsg (versin de nodo gestionado)

Enva un evento al servidor de eventos mediante comunicaciones de nodo gestionado Tivoli o mediante comunicaciones no de Tivoli.
Sintaxis
wpostzmsg [S servidor | f archivo_configuracin] [m mensaje] [rgravedad] [atributo=valor...] clase fuente
Descripcin
El comando wpostzmsg enva un evento a un servidor de eventos mediante comunicaciones de nodo gestionado Tivoli o mediante comunicaciones no de Tivoli. Este comando requiere la instalacin de Tivoli Management Framework en el sistema en el que se ejecuta este comando. Este comando se encuentra en el directorio $BINDIR/bin. Nota: puesto que las aplicaciones no pueden compartir los archivos de la cach, para este comando no debe utilizar un archivo de configuracin que est siendo utilizado por otro programa (como por ejemplo un adaptador). La versin de nodo gestionado de wpostzmsg depende de las variables de entorno de Tivoli, que se pueden establecer mediante los scripts setup_env.sh o setup_env.cmd incluidos en la instalacin.
Autorizacin
user
Opciones
fuente
f archivo_configuracin Especifica el nombre del archivo de configuracin. Consulte la publicacin IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener ms informacin acerca de los archivos de configuracin. m mensaje Texto del evento, entre comillas dobles. r gravedad Especifica el nivel de gravedad. La gravedad debe estar definida para la clase de evento. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El valor predeterminado es @EventServer, el servidor de eventos
72
local. Para indicar un servidor remoto, especifique @EventServertmr, siendo tmr el nombre de una regin de Tivoli. Si no se especifica la opcin S ni f, el evento se enva al servidor de eventos con nombre local.
Ejemplos
El ejemplo siguiente para los entornos UNIX enva un mensaje de prueba que muestra un evento Su_Failure con el nivel de gravedad de aviso en las consolas de eventos:
wpostzmsg -r WARNING m "Error de inicio de sesin su." Su_Failure LOGFILE
Vase tambin
postemsg, postzmsg, TECAgent, wpostemsg (versin de punto final), wpostemsg (versin de nodo gestionado), wpostzmsg (versin de punto final), wsetemsg
Captulo 1. Comandos
73
wrb
Permite gestionar las bases de reglas en el servidor de eventos.
Sintaxis
wrb [opcin [subopcin]]
Descripcin
Utilice el comando wrb para gestionar las bases de reglas. Puede llevar a cabo tareas tales como crear, ver informacin, manipular, suprimir, compilar, cargar y activar bases de reglas con este comando. La primera opcin de este comando especifica su funcin principal. Las subopciones posteriores slo son vlidas en el contexto del primer argumento. Al trabajar con bases de reglas, su cuenta deber tener acceso de lectura y escritura al directorio de base de reglas de nivel superior y a los siguientes 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 dems archivos del directorio de base de reglas. Este acceso no se otorga agregando un usuario al inicio de sesin de administrador. Determinadas tareas llevadas a cabo con el comando wrb requieren que la base de reglas est en un estado coherente antes de finalizar el comando. Si la base de reglas no 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 esos archivos en diversos archivos de definicin de base de reglas. Para que una base de reglas est en un estado coherente, deben darse las condiciones siguientes: v Los tipos enumerados a los que hace referencia una definicin 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 (relacin ISA) se han definido en el archivo BAROC. v Los valores de atributo y faceta son del tipo correcto y estn dentro del rango. v No se ha definido ninguna enumeracin ni clase de evento ms de una vez. v No se ha definido ms de una vez ningn 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 archivo BAROC. v Los conjuntos de reglas a los que hace referencia un paquete de reglas se han definido en la base de reglas. v Los conjuntos de reglas o paquetes de reglas a los que hace referencia un destino de base de reglas se han definido en la base de reglas.
74
Cualquier comando que compruebe la coherencia de la base de reglas acepta el argumento force para efectuar la tarea sin comprobar primero la coherencia de la base de reglas. Al importar archivos de definiciones de clases (con la extensin de archivo .baroc) o archivos de conjunto de reglas (con la extensin de archivo .rls) a una base de reglas, es preciso especificar el nombre del archivo (con la extensin). Una vez que estos objetos se hayan importado a una base de reglas, deber utilizar el nombre lgico (es decir, sin la extensin) en las opciones de comando. 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 sustituirlo por una versin ms reciente del objeto. Cada opcin de comando siguiente especifica si es necesario especificar el nombre del archivo o el nombre del objeto. Nota: para obtener informacin sobre los convenios de denominacin de todos los objetos de reglas (bases de reglas, conjuntos de reglas, paquetes de reglas, etc.), consulte la publicacin IBM Tivoli Enterprise Console Rule Developers Guide.
Autorizacin
user (funcin de regin para el comando wrb) En la tabla siguiente se listan las funciones de regin para las opciones del comando wrb.
Opcin de comando comprules cprb cprb classes cprb rulepacks cprb rulesets cprb targets crtrb crtrp crttarget deldp delrb delrbclass delrbpack delrbrule delrbtarget delrprule deltgtdata deltgtrule imprbclass imprbrule Autorizacin user senior senior user senior user senior user user user senior senior user senior user user user user senior senior
Captulo 1. Comandos
75
Opcin de comando imprprule imptdp imptgtdata imptgtrule loadrb lscurrb lsrb lsrbclass lsrbpack lsrbrule lsrbtarget setrb
Autorizacin user user user user senior senior user user user user user senior
Opciones
comprules [deprecation] [profile] [trace] base_reglas Compila las reglas de la base de reglas especificada por el argumento base_reglas en archivos de objetos Prolog que el motor de reglas pueda procesar. Asimismo, se crea un directorio para cada destino de base de reglas. Cada directorio contiene una base de reglas completa que un motor de 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_reglas Nombre de la base de reglas que se desea compilar. deprecation Emite un aviso de desuso para cada uso de una funcin de lenguaje de regla o BAROC que ha quedado obsoleta. profile Habilita los perfiles para la base de reglas en la compilacin. Para habilitar o suprimir los perfiles en el nivel del conjunto de reglas o la regla de una base de reglas, consulte la informacin sobre directivas de perfiles de la publicacin IBM Tivoli Enterprise Console Rule Developers Guide. trace Habilita el seguimiento para la base de reglas en la compilacin. Para habilitar o suprimir el seguimiento en el nivel del conjunto de reglas o la regla de una base de reglas, consulte la informacin sobre directivas del compilador de reglas trace de la publicacin IBM Tivoli Enterprise Console Rule Developers Guide. cprb [classes] [rulesets] [rulepacks] [targets] [delete | overwrite] [force] fuente destino Copia una base de reglas existente en otra base de reglas existente. Si no especifica ninguno de los argumentos classes, rulesets, rulepacks o targets, se copia los conjuntos de clases, los conjuntos de reglas, los paquetes de reglas y los destinos de bases de reglas. La base de reglas
76
fuente debe encontrarse en un estado coherente para que se pueda copiar. Puede eludir la comprobacin de coherencia con el argumento force. Notas: 1. Al copiar un conjunto de reglas o paquete de reglas de otra base de reglas, deber importarlo a un destino de base de reglas antes de que lo pueda emplear el motor de reglas, a menos que se especifique la opcin overwrite; por ejemplo:
wrb -cprb -overwrite sbase_reglas_fuente base_reglas_destino
2. Si se copian conjuntos de reglas, los conjuntos de reglas inactivas de la base de reglas fuente tambin se copian en la base de reglas de destino. destino Nombre de la base de reglas en la que se copiar la informacin. fuente Nombre de la base de reglas de la que se copiar la informacin.
classes Copia clases de eventos. delete Suprime todos los archivos existentes de la base de reglas de destino antes de escribir informacin procedente de la base de reglas fuente. force Fuerza la copia de la base de reglas fuente aunque como consecuencia de ello pueda producirse una incoherencia de base de reglas. overwrite Los archivos duplicados se sobrescriben en la base de reglas de destino. La accin predeterminada es que los archivos duplicados no se copien. rulepacks Copia paquetes de reglas. rulesets Copia conjuntos de reglas. targets Copia destinos de bases de reglas. crtrb [path ruta] [force] base_reglas Crea una base de reglas en el servidor de eventos de la regin de Tivoli actual. Si en la ruta hay una base de reglas existente, se comprueba la base de reglas para ver si es coherente y se utiliza esa base de reglas. Puede eludir la comprobacin de coherencia con el argumento force. Automticamente se crea un destino de base de reglas denominado EventServer en la nueva base de reglas para el servidor de eventos local. Puede definir varias bases de reglas en el servidor, pero slo es posible cargar y activar una a la vez. base_reglas Nombre de la base de reglas que se desea crear. force Fuerza la creacin de la base de reglas en la ruta aunque sta contenga una base de reglas existente con un estado incoherente. path ruta Ruta donde desea ubicar la nueva base de reglas. Si no se especifica este argumento, la base de reglas se crear en el directorio de trabajo actual del usuario.
Captulo 1. Comandos
77
crtrp paquete_reglas [import conjunto_reglas ...] base_reglas Crea un paquete de reglas en la base de reglas. Un paquete de reglas es una coleccin de conjuntos de reglas. Un paquete de reglas se puede importar a un destino de base de reglas igual que un conjunto de reglas. base_reglas Nombre de la base de reglas en la que se desea crear el paquete de reglas. paquete_reglas Nombre del paquete de reglas que se desea crear. import conjunto_reglas ... Nombre de uno o varios conjuntos de reglas opcionales que se importarn al nuevo paquete de reglas. Separe los diversos nombres de conjunto de reglas con un espacio. No es posible importar los conjuntos de reglas inactivas a un paquete de reglas. Los conjuntos de reglas se agregan al paquete de reglas en el orden especificado en la lnea de comandos. Los conjuntos de reglas que se importan al paquete de reglas primero deben haberse importado a la base de reglas. crttarget destino [import {paquete_reglas | conjunto_reglas} ...] base_reglas Crea un destino de base de reglas en la base de reglas. El destino de base de reglas representa el motor de reglas al que se distribuirn estas reglas. El servidor de eventos local se representa mediante el destino de base de reglas EventServer. Este destino de base de reglas se crea automticamente al crearse una base de reglas. Cuando se compila la base de reglas, se genera una base de reglas completa para cada destino de base de reglas en la base de reglas. El servidor AIM distribuye y carga cada una de las bases de reglas en el destino de base de reglas correspondiente. base_reglas Nombre 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 reglas opcionales que se importarn. Puede especificar conjuntos de reglas y paquetes de reglas a la vez. Sin embargo, los conjuntos de reglas y los paquetes de reglas no pueden tener el mismo nombre en una base de reglas. Separe los diversos conjuntos de reglas y paquetes de reglas con un espacio. No es posible importar los conjuntos de reglas inactivas a un destino de base de reglas. Los conjuntos de reglas y paquetes de reglas se agregan al destino de base de reglas en el orden especificado en la lnea de comandos. El conjunto de reglas o paquete de reglas que se importa al destino de base de reglas primero debe existir en la base de reglas. deldp nombre_archivo Suprime las relaciones de dependencia de la base de conocimientos. Antes de ejecutar el comando wrb deldp, el servidor de eventos debe estar en ejecucin y el conjunto de reglas dependency.rls debe estar cargado y activo; para obtener ms informacin acerca del conjunto de reglas dependency.rls, consulte la publicacin Tivoli Enterprise Console Rule Set Reference. Nota: esta opcin utiliza el programa de utilidad wpostemsg para enviar al servidor de eventos la informacin de dependencias como
78
eventos. Puede definir la configuracin del programa de utilidad wpostemsg al que llama la opcin deldp creando un archivo de configuracin denominado $BINDIR/bin/wrb_eif.conf. Si este archivo de configuracin tiene la acumulacin de eventos desactivada (BufferEvents=NO), en el caso de que el servidor de eventos no est en ejecucin el comando wrb deldp fallar y devolver un error. Sin embargo, si se utiliza la configuracin de wpostemsg predeterminada, los eventos se acumulan en el bfer y, aunque no se envan al servidor de eventos, el comando wrb deldp no informa de error alguno. nombre_archivo Nombre de un archivo de texto que contiene las sentencias de dependencias que se eliminarn de la base de conocimientos. Para obtener informacin acerca de este archivo y de la definicin de relaciones de dependencia para el conjunto de reglas de e-business, consulte la publicacin Tivoli Enterprise Console Rule Set Reference. deltgtrule [conjunto_reglas | paquete_reglas] destino base_reglas Suprime un conjunto de reglas o paquete de reglas de un destino de base de reglas. conjunto_reglas Nombre del conjunto de reglas que se desea suprimir. paquete_reglas Nombre del paquete de reglas que se desea suprimir. destino Nombre del destino de base de reglas del que se va a suprimir el conjunto de reglas o paquete de reglas. base_reglas Nombre de la base de reglas cuyo destino se modificar. delrb base_reglas ... Suprime una o varias bases de reglas del servidor de eventos. No se suprime el directorio de base de reglas ni su contenido. base_reglas ... Nombre de la base de reglas que se desea suprimir. Debe especificar al menos una base de reglas. Separe las diversas bases de reglas con un espacio. delrbclass archivo_clases [force] base_reglas Suprime un archivo de clases de una base de reglas. Se emite un mensaje de error si alguna otra clase o alguna regla hace referencia a alguna clase de evento del archivo de clases. Especifique el argumento force para suprimir el archivo de clases de todos modos. Nota: con esta opcin, se suprime el archivo BAROC especificado de la base de reglas. Copie el archivo BAROC en una ubicacin distinta por si fuese necesario en el futuro. archivo_clases Nombre del archivo de clases que se va a suprimir de la base de reglas especificada con base_reglas. base_reglas Nombre de la base de reglas de la que se va a suprimir el archivo de clases.
Captulo 1. Comandos
79
force Suprime el archivo de clases aunque con ello pueda producirse una incoherencia de base de reglas. delrbpack paquete_reglas [force] base_reglas Suprime un paquete de reglas de una base de reglas. Se visualizar un mensaje de error si el paquete de reglas que se va a suprimir est definido en un destino de base de reglas. Especifique el argumento force para suprimir el paquete de reglas de todos modos. base_reglas Nombre de la base de reglas de la que se va a suprimir el paquete de reglas. paquete_reglas Nombre del paquete de reglas que se desea suprimir. force Suprime el paquete de reglas aunque con ello pueda producirse una incoherencia de base de reglas. delrbrule conjunto_reglas [force] base_reglas Suprime un conjunto de reglas de una base de reglas. Se visualizar un mensaje de error si el conjunto de reglas que se va a suprimir est definido en un destino de base de reglas o paquete de reglas, o est inactivo. Especifique el argumento force para suprimir el conjunto de reglas de todos modos. Nota: con esta opcin se elimina el archivo de conjunto de reglas de una base de reglas para el conjunto de reglas especificado. Copie el archivo de conjunto de reglas en una ubicacin distinta por si fuese necesario en el futuro. base_reglas Nombre de la base de reglas de la que se va a suprimir el conjunto de reglas. conjunto_reglas Nombre del conjunto de reglas que se desea suprimir. force Suprime el conjunto de reglas aunque con ello pueda producirse una incoherencia de base de reglas. delrbtarget destino base_reglas Suprime un destino de base de reglas de una base de reglas. base_reglas Nombre 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_reglas Suprime un conjunto de reglas de un paquete de reglas. base_reglas Nombre de la base de reglas en la que existe el paquete de reglas. paquete_reglas Nombre del paquete de reglas del que se va a suprimir el conjunto de reglas. conjunto_reglas Nombre del conjunto de reglas que se va a suprimir. deltgtdata archivo_datos destino base_reglas Suprime un archivo de datos de soporte de un destino de base de reglas.
80
archivo_datos Especifica el nombre del archivo que se va a suprimir del destino de base de reglas indicado. Debe ser el nombre completo del archivo en el directorio de base de reglas. destino Especifica el nombre del destino de base de reglas del que se va a suprimir el archivo de datos. base_reglas Especifica el nombre de la base de reglas que contiene el destino. imprbclass archivo_clases [encoding codificacin ] [before archivo_clases | after archivo_clases] [force] base_reglas Importa un archivo de especificaciones de clase de evento (un archivo BAROC) a una base de reglas, agregndolo al final de las especificaciones de clase salvo que se especifique lo contrario con argumentos. Se visualizar un mensaje de error si el archivo de conjunto de clases contiene errores de sintaxis o referencias a enumeraciones o clases de eventos inexistentes, o si hay definidas clases de eventos o enumeraciones duplicadas. Si las clases de un archivo de clases se obtienen de las clases de otro archivo, importe los archivos de clase a la base de reglas en un orden que mantenga la estructura heredada. Por ejemplo, si el archivo de clases B.baroc contiene clases derivadas del archivo de clases A.baroc, primero debe importar el archivo de clases A.baroc. archivo_clases Especifica el nombre del archivo de clases que se va a importar. Debe ser una ruta del archivo BAROC. base_reglas Nombre de la base de reglas que va a recibir el conjunto de clases importado. after archivo_clases Especifica el nombre del archivo de clases tras el cual se colocar el archivo de clases importado. before archivo_clases Especifica el nombre del archivo de clases antes del cual se colocar el archivo de clases importado. encoding codificacin Especifica la codificacin de caracteres del archivo de clases. Si no se especifica esta opcin, los archivos de clases que se importen a una base de reglas se abrirn con la codificacin UTF-8. Para obtener ms informacin acerca de las codificaciones internacionales, consulte el apartado Notas en la pgina 86. force Importa el archivo de clases aunque con ello pueda producirse una incoherencia de base de reglas. imprbrule archivo_reglas [encoding codificacin ] [force] base_reglas Importa un archivo de conjunto de reglas a la base de reglas. Como los conjuntos de reglas que se han importado a la base de reglas deben importarse a un destino de base de reglas antes de ejecutarse, el orden en que 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 base de 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 importa hace referencia a una clase de evento inexistente. Puede eludir esta comprobacin de coherencia con el argumento force.
Captulo 1. Comandos
81
base_reglas Nombre de la base de reglas que va a recibir el archivo de conjunto de reglas importado. archivo_reglas Nombre de archivo del conjunto de reglas que se importar a la base de reglas. Debe ser una ruta del archivo del conjunto de reglas (con la extensin de archivo .rls). encoding codificacin Especifica la codificacin de caracteres del archivo de clases. Si no se especifica esta opcin, los archivos de clases que se importen a una base de reglas se abrirn con la codificacin UTF-8. Para obtener ms informacin acerca de las codificaciones internacionales, consulte el apartado Notas en la pgina 86. force Agrega el conjunto de reglas a la base de reglas aunque una regla haga 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 de reglas especificada. Los conjuntos de reglas inactivas no se importan a los paquetes de reglas. base_reglas Nombre de la base de reglas en la que se encuentra el paquete de reglas. paquete_reglas Nombre del paquete de reglas que va a recibir el conjunto de reglas importado. El paquete de reglas primero debe haberse creado con la opcin de comando crtrp. conjunto_reglas Nombre del conjunto de reglas que se importar al paquete de reglas. El conjunto de reglas primero debe haberse importado a la base de reglas. after conjunto_reglas Especifica el nombre del conjunto de reglas tras el cual se colocar el conjunto de reglas importado. before conjunto_reglas Especifica el nombre del conjunto de reglas antes del cual se colocar el conjunto de reglas importado. imptdp nombre_archivo Carga las relaciones de dependencia en la base de conocimientos. Antes de ejecutar el comando wrb imptdp, el servidor de eventos debe estar en ejecucin y el conjunto de reglas dependency.rls debe estar cargado y activo; para obtener ms informacin acerca del conjunto de reglas dependency.rls, consulte la publicacin Tivoli Enterprise Console Rule Set Reference. Nota: esta opcin utiliza el programa de utilidad wpostemsg para enviar al servidor de eventos la informacin de dependencias como eventos. Puede definir la configuracin del programa de utilidad wpostemsg al que llama la opcin imptdp creando un archivo de configuracin denominado $BINDIR/bin/wrb_eif.conf. Si este archivo de configuracin tiene la acumulacin de eventos
82
desactivada (BufferEvents=NO), en el caso de que el servidor de eventos no est en ejecucin el comando wrb imptdp fallar y devolver un error. Sin embargo, si se utiliza la configuracin de wpostemsg predeterminada, los eventos se acumulan en el bfer y, aunque no se envan al servidor de eventos, el comando wrb imptdp no informa de error alguno. nombre_archivo Nombre de un archivo de texto que contiene las sentencias de dependencias que se agregarn a la base de conocimientos como hechos de dependencias. Para obtener informacin acerca de este archivo y de la definicin de relaciones de dependencia para el conjunto de reglas de e-business, consulte la publicacin Tivoli Enterprise Console Rule Set Reference. imptgtdata archivo_datos destino base_reglas Importa un archivo de datos de soporte a una base de reglas para distribuirse a un destino de base de reglas. Este archivo se distribuye con la base de reglas del subdirectorio TEC_RULES. Por ejemplo, un archivo de configuracin de Recurso de integracin de eventos o un archivo de datos o hechos Prolog puede importarse como un archivo de datos de soporte. archivo_datos Especifica el nombre del archivo que se va a importar al destino de base de reglas indicado. Debe ser una ruta del archivo. destino Especifica el nombre del destino de base de reglas que recibir el archivo de datos importado. base_reglas Especifica 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 de reglas. Los conjuntos de reglas y los paquetes de reglas de una base de reglas no pueden tener el mismo nombre. Los conjuntos de reglas inactivas no se importan a los destinos de base de reglas. base_reglas Nombre de la base de reglas que contiene el destino de base de reglas. paquete_reglas Nombre del paquete de reglas que se desea importar. El paquete de reglas primero debe haberse importado a la base de reglas. conjunto_reglas Nombre del conjunto de reglas que se desea importar. El conjunto de reglas primero debe haberse importado a la base de reglas. destino Nombre del destino de base de reglas que va a recibir el conjunto o paquete de reglas importado. Primero debe haberse creado el destino con la opcin de comando crttarget. after conjunto_reglas | paquete_reglas Especifica el nombre del conjunto o paquete de reglas tras el cual debe colocarse el conjunto o paquete de reglas importado. before conjunto_reglas | paquete_reglas Especifica el nombre del conjunto o paquete de reglas antes del cual debe colocarse el conjunto o paquete de reglas importado.
Captulo 1. Comandos
83
loadrb [use] base_reglas Carga 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 el servidor de eventos. La base de reglas ya debe estar definida en el servidor y los archivos de especificaciones de clase de evento y archivos de reglas del directorio deben ser vlidos. La base de reglas cargada sustituye a todas las especificaciones de clase de evento y reglas definidas actualmente en el servidor. Slo puede haber una base de reglas activa a la vez. Al cargar otra base de reglas se sobrescribe la base de reglas activa en este momento. Si no compila la base de reglas antes de intentar cargarla, recibir un mensaje de error. Nota: si no compila la base de reglas antes de intentar cargarla, obtendr un mensaje de error. base_reglas Nombre de la base de reglas que se desea cargar. use Activa la base de reglas inmediatamente despus de cargarla. Si se han efectuado cambios de clase de evento en la base de reglas, reinicie el servidor de eventos tras la carga a fin de que los cambios de clase de evento entren en vigor.
lscurrb Lista el nombre de la base de reglas que est cargada en este momento. lsrb [path] [base_reglas ...] Lista las bases de reglas que estn definidas en este momento en el servidor de eventos. Puede haber muchas bases de reglas definidas en el servidor de eventos, aunque slo puede haber una cargada y activa. Utilice el comando wrb lscurrb para visualizar la base de reglas que est cargada en este momento. Una base de reglas tiene un nombre exclusivo y un nombre de ruta que hace referencia a un directorio que contiene archivos de definiciones de clases de eventos (cuya extensin de archivo es .baroc), archivos de reglas (cuya extensin de archivo es .rls), archivos de paquetes de reglas (cuya extensin de archivo es .rpk) y archivos de destinos de bases de reglas (rule_sets_target). base_reglas Especifica los nombres de bases de reglas individuales o una expresin regular Perl. La accin predeterminada es que se visualicen todas las bases de reglas. Separe los diversos nombres de base de reglas con un espacio. path Lista la ruta del directorio de la base de reglas as como el nombre de la base de reglas. La accin predeterminada es que slo se visualice el nombre de la base de reglas.
lsrbclass [nombre_clase ...] [detailed] base_reglas Lista las clases de eventos de la base de reglas especificada. Utilice expresiones regulares para acotar la lista de clases de eventos que se visualizar. nombre_clase ... Especifica los nombres de clases de eventos individuales o una expresin regular Perl. Este argumento restringe la lista de clases que se muestra. La accin predeterminada es que se visualicen todas las clases de eventos de la base de reglas especificada. Separe los diversos nombres de clases de eventos con un espacio.
84
base_reglas Nombre de la base de reglas que se desea visualizar. detailed Especifica salida detallada. Muestra los nombres de clase y todos los valores de ranura para cada clase. lsrbpack [paquete_reglas ...] [detailed] base_reglas Lista los nombres de los paquetes de reglas de la base de reglas especificada. base_reglas Nombre de la base de reglas que se desea visualizar. paquete_reglas ... Nombre de un paquete de reglas especfico o una expresin regular Perl. Si no especifica este argumento, se visualizarn todos los paquetes de reglas. Separe los diversos paquetes de reglas con un espacio. detailed Lista los conjuntos de reglas de cada paquete de reglas. lsrbrule [archivo_reglas ...] base_reglas Lista los nombres de los archivos de conjuntos de reglas que se han importado a la base de reglas especificada. Utilice expresiones regulares para acotar la lista de reglas que se visualizar. base_reglas Nombre de la base de reglas que se desea visualizar. archivo_reglas ... Nombre de un archivo de conjunto de reglas especfico o una expresin regular Perl. Si no especifica este argumento, se visualizarn todos los archivos de conjuntos de reglas. Separe los diversos nombres de archivo de conjunto de reglas con un espacio. lsrbtarget [destino ...] [detailed] base_reglas Lista los nombres de los destinos de bases de reglas de la base de reglas especificada. base_reglas Nombre de la base de reglas que se desea visualizar. destino ... Nombre de un destino de base de reglas especfico o una expresin regular Perl. Si no especifica este argumento, se visualizarn todos los destinos de la base de reglas. Separe los diversos destinos con un espacio. detailed Lista los conjuntos de reglas y paquetes de reglas de cada destino. setrb [name nombre] [path ruta [force]] base_reglas Establece las propiedades de una base de reglas existente. Puede cambiar el nombre, el directorio que contiene los archivos de bases de reglas o ambos. Si se especifica una ruta nueva y hay una base de reglas existente en la ruta, se comprobar la base de reglas para ver si es coherente. Puede eludir la comprobacin de coherencia con el argumento force. base_reglas Nombre de la base de reglas que se desea modificar.
Captulo 1. Comandos
85
force Fuerza el cambio de la ruta por ruta aunque sta contenga una base de reglas existente en un estado incoherente. name nombre Nuevo nombre de la base de reglas. path ruta Especifica un nuevo directorio de bases de reglas para la base de reglas.
Notas
Normalmente, cada sistema operativo codifica el texto de diferente manera. Por ejemplo, los sistemas operativos de PC utilizan SJIS (pgina de cdigos 932) para el texto en japons, pero los sistemas UNIX suelen utilizar EUC_JP. Si importa un archivo de especificaciones de clase de evento (BAROC) o un archivo de conjunto de reglas que tenga una codificacin distinta de la predeterminada en el sistema local, especifique la opcin encoding junto con el nombre de la codificacin de caracteres de archivo en el comando wrb imprbclass o wrb imprbrule. Puede especificar cualquiera de las codificaciones de caracteres siguientes: ASCII Cdigo estndar americano para el intercambio de informacin (American Standard Code for Information Interchange) Cp1252 Windows Latino-1 ISO8859_1 ISO 8859, alfabeto latino nmero 1 UTF-16BE Formato de transformacin de Unicode de 16 bits, orden de bytes big-endian UTF-16LE Formato de transformacin de Unicode de 16 bits, orden de bytes little-endian UTF-8 Formato de transformacin de Unicode de 8 bits UTF-16 Formato de transformacin de Unicode de 16 bits, orden de bytes especificado por una marca de orden de byte inicial obligatoria Big5 Big5, chino tradicional Big5_HKSCS Big5 con extensiones para Hong Kong, chino tradicional Cp037 EE.UU., Canad (bilinge, francs), Pases Bajos, Portugal, Brasil, Australia Cp273 IBM Austria, Alemania Cp277 IBM Dinamarca, Noruega Cp278 IBM Finlandia, Suecia Cp280 IBM Italia Cp284 IBM Cataln/Espaa, espaol de Latinoamrica Cp285 IBM Reino Unido, Irlanda Cp297 IBM Francia Cp420 IBM rabe Cp424 IBM Hebreo Cp437 MS-DOS EE.UU., Australia, Nueva Zelanda, Sudfrica Cp500 EBCDIC 500V1 Cp737 PC Griego Cp775 PC Bltico Cp838 IBM Tailandia SBCS ampliado Cp850 MS-DOS Latino-1 Cp852 MS-DOS Latino-2 Cp855 IBM Cirlico Cp856 IBM Hebreo
86
Cp857 Cp858 Cp860 Cp861 Cp862 Cp863 Cp864 Cp865 Cp866 Cp868 Cp869 Cp870 Cp871 Cp874 Cp875 Cp918 Cp921 Cp922 Cp930 Cp933 Cp935 Cp937 Cp939 Cp942 Cp942C Cp943 Cp943C Cp948 Cp949 Cp949C Cp950 Cp964 Cp970 Cp1006 Cp1025 Cp1026 Cp1046 Cp1097 Cp1098 Cp1112 Cp1122 Cp1123 Cp1124 Cp1140 Cp1141 Cp1142 Cp1143 Cp1144 Cp1145
IBM Turco Variante de Cp850 con el carcter del euro MS-DOS Portugus MS-DOS islands PC Hebreo MS-DOS Francs de Canad PC rabe MS-DOS Nrdico MS-DOS Ruso MS-DOS Pakistn IBM Griego moderno IBM multilinge Latino 2 IBM Islandia IBM Tailandia IBM Griego IBM Pakistn (Urdu) IBM Letonia, Lituania (AIX, DOS) IBM Estonia (AIX, DOS) Japons Katakana-Kanji combinado con 4370 UDC, superconjunto de 5026 Coreano combinado con 1880 UDC, superconjunto de 5029 Chino simplificado para host combinado con 1880 UDC, superconjunto de 5031 Chino simplificado para host combinado con 6204 UDC, superconjunto de 5033 Japons Latino Kanji combinado con 4370 UDC, superconjunto de 5035 IBM OS/2 Japons, superconjunto de Cp932 Variante de Cp942 IBM OS/2 Japons, superconjunto de Cp932 y Shift-JIS Variante de Cp943 OS/2 Chino (Taiwn), superconjunto de Cp938 PC Coreano Variante de Cp949 PC Chino (Hong Kong, Taiwn) AIX Chino (Taiwn) AIX Coreano IBM AIX Pakistn (Urdu) IBM Multilinge cirlico: Bulgaria, Bosnia, Hercegovina, Macedonia IBM Latino-5, Turqua IBM rabe Windows IBM Irn (Farsi)/Persa IBM Irn (Farsi)/Persa (PC) IBM Letonia, Lituania IBM Estonia IBM Ucrania IBM AIX Ucrania Variante de Cp037 con el carcter del euro Variante de Cp273 con el carcter del euro Variante de Cp277 con el carcter del euro Variante de Cp278 con el carcter del euro Variante de Cp280 con el carcter del euro Variante de Cp284 con el carcter del euro
Captulo 1. Comandos
87
Cp1146 Cp1147 Cp1148 Cp1149 Cp1250 Cp1251 Cp1253 Cp1254 Cp1255 Cp1256 Cp1257 Cp1258 Cp1381 Cp1383 Cp33722 EUC_CN EUC_JP EUC_JP_LINUX EUC_KR EUC_TW GBK ISO2022CN ISO2022JP ISO2022KR ISO8859_2 ISO8859_3 ISO8859_4 ISO8859_5 ISO8859_6 ISO8859_7 ISO8859_8 ISO8859_9 ISO8859_13 ISO8859_15_FDIS JIS0201 JIS0208 JIS0212 JISAutoDetect Johab KOI8_R MS874 MS932 MS936 MS949 MS950 MacArabic MacCentralEurope MacCroatian MacCyrillic MacDingbat MacGreek MacHebrew MacIceland
Variante de Cp285 con el carcter del euro Variante de Cp297 con el carcter del euro Variante de Cp500 con el carcter del euro Variante de Cp871 con el carcter del euro Windows Europeo Oriental Windows Cirlico Windows Griego Windows Turco Windows Hebreo Windows rabe Windows Bltico Windows Vietnamita IBM OS/2, DOS Repblica Popular de China (RPC) IBM AIX Repblica Popular de China (RPC) IBM-eucJP Japons (superconjunto de 5050) GB2312, codificacin EUC, chino simplificado JIS X 0201, 0208, 0212, codificacin EUC, japons JIS X 0201, 0208, codificacin EUC, japons KS C 5601, codificacin EUC, coreano CNS11643 (plano 13), codificacin EUC, chino tradicional GBK, chino simplificado ISO 2022 CN, chino (nicamente conversin a Unicode) JIS X 0201, 0208 en formato ISO 2022, japons ISO 2022 KR, coreano ISO 88592, alfabeto latino nmero 2 ISO 88593, alfabeto latino nmero 3 ISO 88594, alfabeto latino nmero 4 ISO 88595, alfabeto latino/cirlico ISO 88596, alfabeto latino/arbigo ISO 88597, alfabeto latino/griego ISO 88508, alfabeto latino/hebreo ISO 88599, alfabeto latino nmero 5 ISO 885913, alfabeto latino nmero 7 ISO 885915, alfabeto latino nmero 9 JIS X 0201, japons JIS X 0208, japons JIS X 0212, japons Detecta Shift-JIS, EUC-JP, ISO 2022 JP y los convierte (nicamente conversin a Unicode) Johab, coreano KOI8R, ruso Windows Tailands Windows Japons Windows Chino simplificado Windows Coreano Windows Chino tradicional Macintosh Arbe Macintosh Latino-2 Macintosh Croata Macintosh Cirlico Macintosh Dingbat Macintosh Griego Macintosh Hebreo Macintosh Islandia
88
MacRoman MacRomania MacSymbol MacThai MacTurkish MacUkraine SJIS TIS620
Macintosh Romano Macintosh Rumana Macintosh Symbol Macintosh Tailands Macintosh Turco Macintosh Ucrania Shift-JIS, japons TIS620, Tailands
Ejemplos
El ejemplo siguiente crea una nueva base de reglas denominada MyRuleBase en el directorio /RuleBases/MyRuleBase:
wrb -crtrb -path /RuleBases/MyRuleBase MyRuleBase
El archivo siguiente importa el archivo de clases tecad_nt.baroc a la base de reglas MyRuleBase 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 la base de reglas MyRuleBase e importa los conjuntos de reglas ov_default.rls y log_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 de base de reglas SAPServer:
wrb -imptgtrule DefaultRules SAPServer \ MyRuleBase
El ejemplo siguiente importa el conjunto de reglas tecad_snaevent.rls al destino de base de reglas SAPServer y lo coloca al final de la lista de conjuntos de reglas que se cargar:
wrb -imptgtrule tecad_snaevent.rls SAPServer \ MyRuleBase
El siguiente ejemplo muestra informacin detallada sobre las clases definidas en el archivo 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 seguimiento habilitado:

wrb -comprules -trace MyRuleBase
El ejemplo siguiente elimina un conjunto de reglas, MyRuleSet, del destino MyTarget:

wrb -deltgtrule all_instances MyTarget MyRuleSet
Una vez eliminado el conjunto de reglas del destino, se puede eliminar de su base de reglas tal como se indica a continuacin:
wrb -delrbrule all_instances MyRuleSet
Captulo 1. Comandos
89
El ejemplo siguiente copia todo, incluidos los conjuntos de clases, los conjuntos de reglas, los paquetes de reglas y el destino de base de reglas:
wrb -cprb DefaultRuleBase NewRuleBase
mientras que el ejemplo siguiente copia solamente los conjuntos de reglas:

wrb -cprb -rulesets DefaultRuleBase NewRuleBase
90
wrb_default_rb
Desactiva los conjuntos de reglas activos en la base de reglas predeterminadas.
Sintaxis
wrb_default_rb inactivate conjuntos_reglas
Descripcin
El comando wrb_default_rb desactiva todos los conjuntos de reglas de la base de reglas predeterminada que estn activados de forma predeterminada, es decir, los conjuntos de reglas maintenance_mode, netview, ebusiness, heartbeat y cleanup. Nota: el conjunto de reglas de dependencia tambin est activo de forma predeterminada, pero su actividad est vinculada al conjunto de reglas de e-business y slo se puede cambiar modificando la actividad del conjunto de reglas de e-business; es decir, para desactivar el conjunto de reglas de dependencia, debe desactivar el conjunto de reglas de e-business.
Autorizacin
Ninguna.
Opciones
rulesets Especifica los nombres de los conjuntos de reglas que se van a desactivar. Para desactivar ms de un conjunto de reglas, inserte espacios en blanco entre los nombres.
Ejemplos
El ejemplo siguiente desactiva los conjuntos de reglas netview y heartbeat:
wrb_default_rb -inactivate netview heartbeat
Captulo 1. Comandos
91
wrbupgrade
Actualiza las bases de reglas y los archivos BAROC creados con las versiones de Tivoli Enterprise Console anteriores a la 3.7 al formato correspondiente a la versin 3.7 y posteriores. Nota: este comando est situado en el directorio $BINDIR/TME/TEC y no en la ubicacin estndar ($BINDIR/BIN) de otros comandos de Tivoli Enterprise Console. Al trabajar con una base de reglas creada por otro usuario, deber tener acceso de lectura y escritura al directorio de base de reglas de nivel superior y a los siguientes 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 dems archivos del directorio de base de reglas.
Sintaxis
wrbupgrade [ f p ruta_de_base_reglas |n nombre_base_reglas]
Descripcin
Slo es necesario ejecutar el comando wrbupgrade si desea emplear paquetes de reglas y destinos de bases de reglas con las bases de reglas creadas con versiones de Tivoli Enterprise Console anteriores a la versin 3.7. No es preciso que ejecute este comando para emplear el comando wrb.
Autorizacin
user
Opciones
f Especifica que el comando wrbupgrade debe ejecutarse aunque la base de reglas especificada ya se haya actualizado. Esta opcin slo es vlida con la opcin -p ruta_de_base_reglas.
n nombre_base_reglas Especifica el nombre de la base de reglas que se desea actualizar. p ruta_de_base_reglas Especifica la ruta de la base de reglas que se desea actualizar.
92
wsendresp
Visualiza un mensaje en el escritorio del operador.
Sintaxis
wsendresp operador [host:]ruta_archivo
Descripcin
Enva el contenido del archivo especificado en una ventana emergente a la consola especificada. Una regla tambin puede emitir el comando wsendresp para mostrar un mensaje a un operador. Por ejemplo, al confirmar un evento HOST_DOWN, una regla puede emitir el comando wsendresp para informar a un operador de la accin que debe llevarse a cabo para el host afectado. Para que este comando se ejecute correctamente, el servidor de eventos y la consola del operador especificado deben estar en ejecucin.
Autorizacin
admin
Opciones
[host:]ruta_archivo Especifica el nombre de ruta del archivo que contiene el mensaje preferido. Si lo desea, puede especificar el host que contiene el archivo. Nota: debe emplear caracteres de barra inclinada (/) para los separadores de directorio en el argumento ruta_archivo. operador Especifica el nombre de un operador de Tivoli Enterprise Console.
Ejemplos
El 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
Captulo 1. Comandos
93
wsetac
Modifica un registro de configuracin de adaptador para un perfil de configuracin de adaptador.
Sintaxis
wsetac detalles_adaptador clave perfil
Descripcin
El comando wsetac permite modificar un registro existente de un perfil de configuracin de adaptador. Cada tipo de adaptador de cada perfil de configuracin de adaptador puede estar soportado por polticas predeterminadas para proporcionar valores iniciales para componentes de la configuracin no suministrados por una llamada de waddac. Del mismo modo, podra haber polticas de validacin para garantizar que una configuracin determinada sea vlida segn las necesidades de la implementacin del adaptador de eventos, las particularidades de la instalacin local y las consideraciones de seguridad. El comando wsetac escribe el valor de clave del nuevo registro de configuracin de adaptador en la salida estndar. El valor de clave se puede emplear ms adelante para modificar o eliminar el registro.
Autorizacin
admin
Opciones
detalles_adaptador Proporciona la informacin de configuracin especfica del adaptador como, por ejemplo, las rutas de distribucin, los ID de usuario y los filtros del adaptador empleados para los parmetros de distribucin del adaptador. a Indica que los valores proporcionados en la lnea de comandos para los atributos de lista (entorno, filtros, acciones de distribucin y comportamiento) deben agregarse a los valores actuales del perfil en lugar de sustituir por completo los valores actuales. Tenga en cuenta que la presencia de a afecta a todos los argumentos e, f, D y b de una llamada determinada del comando. Si algunos de estos atributos deben sustituirse y otros deben agregarse, son necesarias varias llamadas del comando. Cuando se especifica a y se agregan nuevos valores a uno o varios de los atributos de lista, los duplicados se eliminan segn corresponde a la naturaleza de esos .En el caso de los atributos de entorno y comportamiento, las asignaciones duplicadas de la misma variable se eliminan (obviamente, las asignaciones nuevas sustituyen a las antiguas). En el caso de las acciones de distribucin, se eliminan las diversas copias efectuadas para el mismo nombre de ruta. En el caso de los filtros, las entradas duplicadas se eliminan.
94
b indicador=valor Establece el indicador de comportamiento del punto final determinado en el valor especificado. Los indicadores de comportamiento del punto final se interpretan en situaciones especiales cuando se distribuyen perfiles, por ejemplo al procesar un registro marcado como suprimido. Los indicadores especficos a los que se da soporte varan segn el punto final, pero entre los que se admiten actualmente se encuentran los siguientes: action_fail Controla el manejo de anomalas de las peticiones de distribucin de !comando y !!comando. Los valores son: ignore Pasar por alto todas las anomalas. report Informar de las anomalas pero seguir con la actividad de distribucin (comportamiento predeterminado). abort expand Controla si, al distribuir el perfil, el cdigo del punto final debe expandir las referencias a las variables de contexto del punto final con el formato $variable dentro de los atributos del registro. El valor de la variable puede ser no para inhabilitar la expansin, yes a fin de habilitarla para todos los atributos (comportamiento predeterminado), o una lista de nombres de atributo separados por comas para efectuar una expansin selectiva nicamente en los valores de esos atributos. rm_on_del Indica al cdigo del punto final si debe eliminar los archivos de configuracin y archivos distribuidos cuando se distribuye el registro tras eliminarse. El valor puede ser yes (para forzar la eliminacin, que es el comportamiento predeterminado), no (para inhabilitar la eliminacin y, por consiguiente, conservar los archivos en su ubicacin tras la supresin del registro) o conf (para eliminar nicamente el archivo de configuracin del adaptador principal). run_actions Controla si se llevan a cabo peticiones de distribucin de !comando y !!comando. El valor puede ser yes o no, siendo yes el valor predeterminado. El cdigo del punto final admite (salvo que la poltica de validacin los rechace) y omite los indicadores o los valores de los indicadores de comportamiento no reconocidos. c comentario Texto de comentario que se asociar al nuevo registro de perfil de configuracin de adaptador. El texto de comentario se escribir en el archivo de configuracin cuando se cree la prxima vez que se distribuya el perfil. D destino=fuente Solicita que el archivo fuente se distribuya al archivo de destino en cada host de abono cuando se distribuya el perfil. Si el nombre de
Captulo 1. Comandos
Detener la distribucin.
95
destino no empieza por un carcter de barra inclinada, el nombre de archivo real se formar agregando destino al directorio de destino segn la especificacin de una opcin d (o de los valores predeterminados de la poltica). En lugar del formato destino=fuente para una peticin de distribucin, la cadena puede tener el formato !comando o !!comando. El comando proporcionado, que puede ser cualquier sentencia vlida para el intrprete de lnea de comandos dependiente del sistema operativo presente en los nodos de abono (normalmente, /bin/sh, aunque en los sistemas operativos distintos de UNIX puede ser diferente), se ejecuta antes (!) o despus (!!) de la informacin de configuracin y todos los archivos distribuidos se escriben. Se pueden proporcionar varias opciones D. d dir Directorio de los nodos de abono al que deben distribuirse los archivos de configuracin del adaptador. e nombre=valor Define una variable de entorno que se colocar en el archivo de configuracin del adaptador. Pueden proporcionarse tantos argumentos e como se desee para crear un nmero de variables de entorno arbitrario. Algunas variables de entorno, que las bibliotecas del adaptador de eventos reconocen directamente, controlan el funcionamiento bsico del adaptador. Otras variables pueden ser utilizadas en un nivel superior por adaptadores especficos. f filtro Define un filtro de eventos que se colocar en el archivo de configuracin del adaptador. La cadena filtro debe tener el formato siguiente: Atributo=Valor;Atributo=Valor;Atributo=Valor;... Toda la cadena debe escribirse entre comillas para evitar que el intrprete de lnea de comandos tenga en cuenta los caracteres de punto y coma. Para crear un filtro cuyo estado inicial sea inhabilitado, se puede agregar el prefijo #ilter: a la cadena. As,
wsetac -a -f #ilter:Class=EVENT; 12 acp1
agrega un nico registro de filtro inhabilitado a la clave 12 del perfil acp1. (Los filtros habilitados tienen el prefijo Filter:.) Se pueden proporcionar muchas opciones f. F cach_filtro Define una cach de filtro de eventos que se colocar en el archivo de configuracin del adaptador. La cadena cach_filtro debe tener el formato siguiente: Atributo=Valor;Atributo=Valor;Atributo=Valor;... Toda la cadena debe escribirse entre comillas para evitar que el intrprete de lnea de comandos tenga en cuenta los caracteres de
96
punto y coma. Para crear una cach de filtro cuyo estado inicial sea inhabilitado, se puede agregar el prefijo #FilterCache: a la cadena. As,
wsetac -f #FilterCache:Class=LogFile_Base; acp1
agrega un nico registro de cach de filtro inhabilitada al nuevo perfil acp1. (Las cachs de filtro inhabilitadas tienen el prefijo FilterCache:.) Se pueden proporcionar muchas opciones F. g gid Valor de ID de grupo que se utilizar para los archivos distribuidos y los comandos en los puntos finales de abono. El valor de gid se puede proporcionar como un nombre o un valor numrico. i on|off[,nombre_id] Especifica si se debe asignar al adaptador un identificador exclusivo y el identificador que se utilizar. Utilice esta opcin cuando se ejecuten varios adaptadores en el mismo sistema con el fin de asignar identificadores exclusivos a los adaptadores. Especifique on|off para indicar si se utilizar un identificador, y especifique nombre_id para indicar el identificador que se utilizar. Si especifica i on sin nombre_id, se utiliza el adaptador definido anteriormente. Si especifica i off con nombre_id, el registro de configuracin contendr el ID pero el adaptador no tendr un ID tras la distribucin del perfil. m modo_prefiltro Define el modo prefiltro que se colocar en el archivo de configuracin de los adaptadores Windows y NetWare. Los valores vlidos son IN, in, OUT y out. El valor predeterminado es OUT. Si utiliza IN o in, tambin deber proporcionar el parmetro p para especificar un prefiltro. En el ejemplo siguiente se muestra un comando que utiliza este argumento:
wsetac -a -m OUT -p Log=System 1 ACPprofile
wsetac -a -p Log=Security 1 ACPprofile
t destino Nombre del archivo de configuracin del adaptador principal, denominado habitualmente archivo CONF. El nombre de archivo completo de este archivo se forma agregando destino al valor proporcionado para dir con una opcin d. Tenga en cuenta que la poltica predeterminada normalmente est establecida de modo que defina destino y dir_destino con los valores adecuados. u uid Valor de ID de usuario que se utilizar para los archivos distribuidos y los comandos en los puntos finales de abono. El valor de uid se puede proporcionar como un nombre o un valor de ID numrico. clave Proporciona la clave del registro de configuracin del adaptador existente
Captulo 1. Comandos
97
que se desea modificar. Puede ver el valor de clave en la parte superior derecha del panel de entrada del perfil de configuracin del adaptador o mediante el comando wlsac. perfil Perfil de configuracin de adaptador al que se agregar el nuevo registro de configuracin del adaptador. Si el nombre contiene espacios, escriba todo el nombre entre comillas.
Ejemplos
El ejemplo siguiente cambia el valor de ServerLocation del archivo CONF por quasar para la clave 0 en el perfil de configuracin de adaptador denominado quasar:
wsetac -e ServerLocation=quasar 0 @ACP:quasar
Vase tambin
waddac, wdelac, wlsac, wsetaddflt
98
wsetaddflt
Agrega o establece un registro de configuracin de adaptador para un perfil de configuracin de adaptador o valor predeterminado de tipo de adaptador.
Sintaxis
wsetaddflt detalles_adaptador tipo
Descripcin
El comando wsetaddflt tambin crea o modifica un registro de perfil de configuracin de adaptador, pero en lugar de instalarlo en un objeto de perfil, el registro se instala como registro predeterminado global para el tipo de adaptador de eventos especificado. Los valores de los atributos del registro se pueden recuperar ms adelante con el comando wlsaddflt de los scripts de poltica a fin de obtener la informacin predeterminada bsica para un tipo de adaptador. Posteriormente, los scripts de poltica pueden aplicar filtros o modificaciones. Cada perfil de configuracin de adaptador contiene la siguiente informacin de configuracin para uno o varios adaptadores de eventos: v Ubicacin de los archivos de configuracin v Definiciones de variables de entorno de adaptador, con informacin tal como la ubicacin del servidor de eventos v Definiciones de filtros de eventos v Peticiones de distribucin de archivos adicionales Cada tipo de adaptador de cada perfil de configuracin de adaptador puede estar soportado por polticas predeterminadas para proporcionar valores iniciales para componentes de la configuracin no suministrados por una llamada de waddac. Del mismo modo, podra haber polticas de validacin para garantizar que una configuracin determinada sea vlida segn las necesidades de la implementacin del adaptador de eventos, las particularidades de la instalacin local y las consideraciones de seguridad.
Autorizacin
senior
Opciones
detalles_adaptador Proporciona la informacin de configuracin especfica del adaptador como, por ejemplo, las rutas de distribucin, los ID de usuario y los filtros del adaptador empleados para los parmetros de distribucin del adaptador. a Indica que los valores proporcionados en la lnea de comandos para los atributos de lista (entorno, filtros, acciones de distribucin y comportamiento) deben agregarse a los valores actuales del perfil en lugar de sustituir por completo los valores actuales. Tenga en cuenta que la presencia de a afecta a todos los argumentos e, f, D y b de una llamada determinada del comando. Si algunos de estos atributos deben sustituirse y otros deben agregarse, son necesarias varias llamadas del comando. Cuando se especifica a y se agregan nuevos valores a uno o varios de los atributos de lista, los duplicados se eliminan segn
Captulo 1. Comandos
99
corresponde a la naturaleza de esos atributos modificados. En el caso de los atributos de entorno y comportamiento, las asignaciones duplicadas de la misma variable se eliminan (obviamente, las asignaciones nuevas sustituyen a las antiguas). En el caso de las acciones de distribucin, se eliminan las diversas copias efectuadas para el mismo nombre de ruta. En el caso de los filtros, las entradas duplicadas se eliminan. (La opcin a es vlida para wsetac y wsetaddflt.) b indicador=valor Establece el indicador de comportamiento del punto final determinado en el valor especificado. Los indicadores de comportamiento del punto final se interpretan en situaciones especiales cuando se distribuyen perfiles, por ejemplo al procesar un registro marcado como suprimido. Los indicadores especficos a los que se da soporte varan segn el punto final, pero entre los que se admiten actualmente se encuentran los siguientes: action_fail Controla el manejo de anomalas de las peticiones de distribucin de !comando y !!comando. Los valores reconocidos son: ignore Pasar por alto todas las anomalas. report Informar de las anomalas pero seguir con la actividad de distribucin (comportamiento predeterminado). abort expand Controla si, al distribuir el perfil, el cdigo del punto final debe expandir las referencias a las variables de contexto del punto final con el formato $variable dentro de los atributos del registro. El valor de la variable puede ser no para inhabilitar la expansin, yes a fin de habilitarla para todos los atributos (comportamiento predeterminado), o una lista de nombres de atributo separados por comas para efectuar una expansin selectiva nicamente en los valores de esos atributos. rm_on_del Indica al cdigo del punto final si debe eliminar los archivos de configuracin y archivos distribuidos cuando se distribuye el registro tras eliminarse. El valor puede ser yes (para forzar la eliminacin, que es el comportamiento predeterminado), no (para inhabilitar la eliminacin y, por consiguiente, conservar los archivos en su ubicacin tras la supresin del registro) o conf (para eliminar nicamente el archivo de configuracin del adaptador principal). run_actions Controla si se llevan a cabo peticiones de distribucin de !comando y !!comando. El valor puede ser yes o no, siendo yes el valor predeterminado. Detener la distribucin.
100
El cdigo del punto final admite (salvo que la poltica de validacin los rechace) y omite los indicadores o los valores de los indicadores de comportamiento no reconocidos. c comentario Texto de comentario que se asociar al nuevo registro de perfil de configuracin de adaptador. El texto de comentario se escribir en el archivo de configuracin cuando se cree la prxima vez que se distribuya el perfil. D destino=fuente Solicita que el archivo fuente se distribuya al archivo de destino en cada host de abono cuando se distribuya el perfil. Si el nombre de destino no empieza por un carcter de barra inclinada, el nombre de archivo real se formar agregando destino al directorio de destino segn la especificacin de una opcin d (o de los valores predeterminados de la poltica). En lugar del formato destino=fuente para una peticin de distribucin, la cadena puede tener el formato !comando o !!comando. El comando proporcionado, que puede ser cualquier sentencia vlida para el intrprete de lnea de comandos dependiente del sistema operativo presente en los nodos de abono (normalmente, /bin/sh, aunque en los sistemas operativos distintos de UNIX puede ser diferente), se ejecuta antes (!) o despus (!!) de la informacin de configuracin y todos los archivos distribuidos se escriben. Se pueden proporcionar muchas opciones D. d dir Directorio de los nodos de abono al que deben distribuirse los archivos de configuracin del adaptador. e nombre=valor Define una variable de entorno que se colocar en el archivo de configuracin del adaptador. Pueden proporcionarse tantos argumentos e como se desee para crear un nmero de variables de entorno arbitrario. Algunas variables de entorno, que las bibliotecas del adaptador de eventos reconocen directamente, controlan el funcionamiento bsico del adaptador. Otras variables pueden ser utilizadas en un nivel superior por adaptadores especficos. f filtro Define un filtro de eventos que se colocar en el archivo de configuracin del adaptador. La cadena filtro debe tener el formato siguiente: Atributo=Valor;Atributo=Valor;Atributo=Valor;... Toda la cadena debe escribirse entre comillas para evitar que el intrprete de lnea de comandos tenga en cuenta los caracteres de punto y coma. Para crear un filtro cuyo estado inicial sea inhabilitado, se puede agregar el prefijo #ilter: a la cadena. As,
wsetaddflt -a -f #ilter:Class=EVENT; 12 acp1
agrega un nico registro de cach de filtro inhabilitado a la clave 12 del perfil acp1. (Los filtros habilitados tienen el prefijo Filter:.)
Captulo 1. Comandos
101
Se pueden proporcionar varias opciones f. F cach_filtro Define una cach de filtro de eventos que se colocar en el archivo de configuracin del adaptador. La cadena cach_filtro debe tener el formato siguiente: Atributo=Valor;Atributo=Valor;Atributo=Valor;... Toda la cadena debe escribirse entre comillas para evitar que el intrprete de lnea de comandos tenga en cuenta los caracteres de punto y coma. Para crear una cach de filtro cuyo estado inicial sea inhabilitado, se puede agregar el prefijo #FilterCache: a la cadena. As,
wsetaddflt -F #FilterCache:Class=LogFile_Base; acp1
agrega un nico registro de cach de filtro inhabilitada al nuevo perfil acp1. (Las cachs de filtro habilitadas tienen el prefijo FilterCache:.) Se pueden proporcionar varias opciones F. g gid Valor de ID de grupo que se utilizar para los archivos distribuidos y los comandos en los puntos finales de abono. El valor de gid se puede proporcionar como un nombre o un valor numrico. i on|off[,nombre_id] Especifica si se debe asignar al adaptador un identificador exclusivo y el identificador que se utilizar. Utilice esta opcin cuando se ejecuten varios adaptadores en el mismo sistema con el fin de asignar identificadores exclusivos a los adaptadores. Especifique on|off para indicar si se utilizar un identificador, y especifique nombre_id para indicar el identificador que se utilizar. Si especifica i on sin nombre_id, se utiliza el adaptador definido anteriormente. Si especifica i off con nombre_id, el registro de configuracin contendr el ID pero el adaptador no tendr un ID tras la distribucin del perfil. m modo_prefiltro Define el modo prefiltro que se colocar en el archivo de configuracin de los adaptadores Windows y NetWare. Los valores vlidos son IN, in, OUT y out. El valor predeterminado es OUT. Si utiliza IN o in, tambin deber proporcionar el parmetro p para especificar un prefiltro. En el ejemplo siguiente se muestra un comando que utiliza este argumento:
wsetaddflt -a -m OUT -p Log=System 1 ACPprofile
wsetaddflt -a -p Log=Security 1 ACPprofile
t destino Nombre del archivo de configuracin del adaptador principal, denominado habitualmente archivo CONF. El nombre de archivo
102
completo de este archivo se forma agregando destino al valor proporcionado para dir con una opcin d. Tenga en cuenta que la poltica predeterminada normalmente est establecida de modo que defina destino y dir_destino con los valores adecuados. u uid Valor de ID de usuario que se utilizar para los archivos distribuidos y los comandos en los puntos finales de abono. El valor de uid se puede proporcionar como un nombre o un valor de ID numrico. tipo Proporciona el tipo de adaptador del nuevo adaptador o (para wsetaddflt) el tipo de adaptador cuyos valores predeterminados globales se desea establecer. El tipo de adaptador normalmente se utiliza para regir el funcionamiento de las polticas predeterminadas y de validacin. Si se proporcionan tipos de adaptador desconocidos para waddac, las polticas de validacin del perfil de configuracin de adaptador de destino pueden rechazar el nuevo registro. Para ver los tipos disponibles, utilice el comando wlsaddflt.
Ejemplos
1. 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 ha creado:

wlookup -ar ACPdefaults
3. El ejemplo siguiente suprime el tipo predeterminado agregado test_adapter:

wregister -ur ACPdefaults test_adapter
4. El ejemplo siguiente cambia los valores de adaptador predeterminados que afectan a todos los adaptadores:
wsetaddflt \ -t tecad_$(AC_TYPE).conf \ -d $TECADHOME/etc \ -c Generic Adapter Defaults \ __generic__
Captulo 1. Comandos
103
Nota: se recomienda no suprimir la definicin predeterminada del perfil de configuracin de adaptador __generic__, ya que es la definicin base para todos los tipos de adaptador.
Vase tambin
waddac, wdelac, wlsac, wsetac
104
wsetadenv
Instala una lista de variables de entorno de Recurso de integracin de eventos reconocidas para un tipo de adaptador.
Sintaxis
wsetadenv [a] nombre_variable... tipo
Descripcin
El comando wsetadenv proporciona al Recurso de configuracin del adaptador una lista de las variables de entorno de Recurso de integracin de eventos que el adaptador reconoce pero que no forman parte del conjunto comn de variables que emplea directamente el Recurso de integracin de eventos. Los nombres de variables registrados con wsetadenv pasan a estar disponibles para los usuarios de la interfaz grfica de usuario del Recurso de configuracin del adaptador al configurar las listas de variables de entorno. Los scripts de validacin de perfiles tambin pueden emplear la lista. El propio Recurso de configuracin del adaptador instala la lista de variables del Recurso de integracin de eventos bsicas con el tipo __generic__. Esta lista no debe modificarse.
Autorizacin
senior
Opciones
tipo Tipo de adaptador. Si todava no se ha instalado ninguna informacin de entorno ni otra informacin de tipo, wsetadenv registra automticamente el tipo. Para ver los tipos disponibles, utilice el comando wlsaddflt.
nombre_variable... Cero o ms variables reconocidas por el tipo de adaptador especificado. No es ningn error instalar alguna de las variables del Recurso de integracin de eventos estndar aqu, pero es innecesario. Separe los diversos valores nombre_variable con un espacio. a Indica a wsetadenv que agregue los nombres de variable a la lista que ya est configurada para el tipo de adaptador especificado. Normalmente, wsetadenv sustituye por completo una lista existente.
Ejemplos
El ejemplo siguiente agrega las variables de entorno SNMP_PORT y SNMP_TRAP_PORT al adaptador SNMP:
wsetadenv SNMP_PORT SNMP_TRAP_PORT tecad_snmp
Vase tambin
wlsadenv, waddac, wsetadgui, wsetadval
Captulo 1. Comandos
105
wsetadgui
Instala un enlace de la interfaz grfica de usuario (GUI) de Recurso de configuracin del adaptador con una herramienta de configuracin especfica del tipo.
Sintaxis
wsetadgui class nombre catlogo texto clave tipo
Descripcin
El comando wsetadgui proporciona al Recurso de configuracin del adaptador el nombre de un objeto que ofrece una interfaz estndar para llevar a cabo una configuracin grfica especfica del tipo ampliada. Asimismo, el comando proporciona una etiqueta que se utilizar en el botn de inicio de la GUI del Recurso de configuracin del adaptador en el que el usuario puede hacer clic para iniciar las herramientas de configuracin ampliada. Como los adaptadores de eventos de Tivoli Enterprise Console pueden variar enormemente de tipo y mbito, el propio Recurso de configuracin del adaptador no intenta proporcionar herramientas de configuracin para otros detalles ms all del subconjunto comn de configuracin del Recurso de integracin de eventos. Sin embargo, como las herramientas de configuracin grficas pueden resultar adecuadas para una amplia gama de tipos de adaptadores, la interfaz grfica del Recurso de configuracin del adaptador puede ampliarse de forma eficaz creando una herramienta de configuracin para un adaptador especfico y despus conectndola al Recurso de configuracin del adaptador con wsetadgui. Una herramienta de configuracin especfica del tipo debe implementarse como un mtodo en un objeto de Tivoli Enterprise. El mtodo debe llamarse acf_extension y debe coincidir con la siguiente signatura IDL:
TMF_CCMS::Database::nmval_list acf_extension(in TMF_Types::StringList uienv, in string prof_name, in string key, in TMF_CCMS::Database::nmval_list);
La interfaz de usuario del Recurso de configuracin del adaptador llama al mtodo acf_extension tras la solicitud del usuario y pasa al mtodo el registro de perfil segn la configuracin actual junto con la clave de registro y el nombre de perfil. El entorno del servidor de la interfaz de usuario tambin se pasa para que las herramientas de configuracin sepan dnde visualizar los dilogos. La herramienta de configuracin ampliada puede efectuar las modificaciones necesarias en el registro y devolver una nueva versin del registro cuando haya terminado. Por lo general, las variables de entorno y las peticiones de distribucin son los atributos del registro modificado de forma ms habitual, pero puede modificarse cualquier elemento.
Autorizacin
senior
106
Opciones
catlogo Nombre del catlogo de mensajes que contiene el mensaje que se utilizar como etiqueta del botn de inicio en la GUI del Recurso de configuracin del adaptador. clase clave Nombre de la clase de Tivoli Enterprise de la que es miembro el objeto de configuracin. Clave del catlogo de mensajes para la etiqueta del botn de inicio.
nombre Nombre del objeto de configuracin (el objeto que da soporte al mtodo acf_extension para el tipo de adaptador). texto tipo Texto predeterminado de la etiqueta del botn de inicio, que se emplea si no se encuentra el catlogo. Tipo de adaptador. Si todava no se ha instalado ninguna informacin de entorno ni otra informacin de tipo, wsetadenv registra automticamente el tipo. Para ver los tipos disponibles, utilice el comando wlsaddflt.
Ejemplos
El ejemplo siguiente agrega el editor de formato del archivo de registro a la GUI del servidor de Tivoli Enterprise Console:
wsetadgui LogfileConfiguration LogfileConfiguration _x_ \ "Logfile Format Editor..." 1 tecad_logfile
Vase tambin
wlsadgui, waddac, wsetadenv, wsetadval
Captulo 1. Comandos
107
wsetadval
Instala informacin de validacin para un tipo de adaptador.
Sintaxis
wsetadval archivo atributo tipo
Descripcin
El comando wsetadval informa al Recurso de configuracin del adaptador de que el archivo especificado contiene informacin de validacin que debe emplearse al validar el valor del atributo indicado en los registros de perfil de configuracin de adaptador. Por lo general, la informacin de validacin consiste en la totalidad o parte de un script de algn tipo. Los scripts de poltica de validacin instalados en los perfiles de configuracin de adaptador posteriormente pueden extraer y utilizar la informacin de validacin instalada. El formato ms sencillo de un script de validacin de perfil de configuracin de adaptador es el siguiente:
#!/bin/sh wlsadval "$1" "$2" | sh s "$3"
Con este esquema el contenido del registro de validacin se utiliza directamente como script de validacin real. El mtodo de poltica est escrito de modo que espera que el nombre de atributo se pase como primer argumento y el tipo de registro como segundo; consulte la pgina del comando wlsadval. El tercer argumento es el valor que debe validarse, que se transmite al script instalado. Hay otros modos de emplear el recurso proporcionado por wsetadval. No obstante, cualquiera que sea el procedimiento elegido, todos los tipos de adaptador deben utilizarlo de forma coherente para que los scripts de poltica almacenados en los objetos de perfil repartidos por la instalacin puedan seguir siendo genricos. Tal como se distribuyen, las polticas de validacin del Recurso de configuracin del adaptador esperan que la informacin de validacin de adaptador instalada corresponda a scripts de shell.
Autorizacin
senior
Opciones
atributo Nombre del atributo al que se aplica la informacin de validacin. Los atributos de un perfil de configuracin de adaptador suelen ser los siguientes: ACPbhv Secuencia de variables de comportamiento del perfil, separadas por lneas nuevas. ACPcomment Campo de comentarios.
108
ACPdist Secuencia de peticiones de distribucin, separadas por lneas nuevas. ACPev Secuencia de variables de entorno, separadas por lneas nuevas. ACPflt Secuencia de definiciones de filtro, separadas por lneas nuevas. ACPgid ID de grupo para las acciones de punto final. ACPtargdir Directorio de instalacin de configuracin. ACPtarget Nombre de archivo de configuracin principal de destino. ACPtype Tipo de registro; normalmente no necesita validacin. ACPuid ID de usuario para las acciones de punto final. Puede haber otros atributos si se agregan al perfil con las herramientas de Tivoli AEF. archivo Nombre del archivo que contiene la informacin de validacin. Si archivo es un solo guin, wlsadval lee la informacin de validacin de la entrada estndar. tipo Tipo de adaptador para el que debe instalarse la informacin de validacin. Para ver los tipos disponibles, utilice el comando wlsaddflt.
Ejemplos
El ejemplo siguiente agrega la informacin de validacin del script infile al atributo ACPuid para un adaptador de tipo tecad_logfile_hpux10:
wsetadval - ACPuid tecad_logfile_hpux10 <<\infile case "$1" in 0 root ) exit 0;; *) exit 1;; esac infile
Vase tambin
wlsadval, waddac, wsetadenv, wsetadgui
Captulo 1. Comandos
109
wsetaeenv
Modifica las variables de entorno almacenadas en los puntos finales del perfil de configuracin de adaptador.
Sintaxis
wsetaeenv [a] [d nombre...] nombre=valor... punto_final wsetaeenv [a] [d nombre...] i archivo punto_final
Descripcin
Nota: utilice este comando nicamente en los nodos gestionados; no lo emplee en un punto final. El comando wsetaeenv permite establecer o modificar la lista de las variables de entorno de configuracin de adaptador almacenadas en un objeto de punto final de perfil. Los valores nuevos se emplearn en la siguiente distribucin de perfil de configuracin de adaptador que se realice al punto_final especificado. Los perfiles de configuracin de adaptador utilizan la informacin de entorno almacenada en los puntos finales haciendo referencia a ellos en los valores de los campos de registro. Las referencias a las variables de entorno tienen el formato $[nombre]. Cuando se recibe el perfil en el punto final durante la distribucin, las referencias a la variable de entorno se expanden de modo que se utilice el valor real de la variable en cualquier contexto donde se realice la referencia. La expansin se efecta con el control del indicador de comportamiento expand; consulte la pgina del comando waddac. Adems de las variables de entorno establecidas con el control del usuario mediante wsetaeenv, el cdigo de punto final de configuracin de adaptador crea automticamente algunas variables. Estas variables describen el objeto de punto final, el perfil de configuracin de adaptador que contiene el registro donde se hace una referencia y el propio registro. Estas variables de entorno automticas estn disponibles para el uso exactamente del mismo modo que las variables controladas por el usuario. Entre la lista de variables de entorno automticas se encuentran las siguientes: ACPEP_NAME Nombre del objeto de punto final. Por lo general, el objeto de punto final es un objeto de nodo gestionado de Tivoli. ACPEP_CLASS Nombre de clase del objeto de punto final. ACPEP_OID Identificador de objeto del objeto de punto final. ACPEP_NODE ID de objeto del nodo gestionado donde reside el punto final. En el caso habitual de que el punto final sea el nodo gestionado, este ID de objeto coincide obviamente con el identificador ACPEP_OID. ACP_NAME Nombre del perfil de configuracin de adaptador que contiene el registro donde se hace una referencia a la variable.
110
ACP_ADMIN Nombre de usuario del administrador encargado de distribuir el perfil. ACP_PRFMGR Nombre del objeto de gestor de perfiles desde el que se ha distribuido el perfil. (Tenga presente que puede ser el nombre de un objeto de punto final de perfil, en cuyo caso coincidira con el valor de ACPEP_NAME.) AC_TYPE Tipo de registro que contiene la referencia de la variable. AC_ACTION Actividad efectuada para el registro, que puede ser UPDATE o DELETE. AC_KEY Clave de registro del registro que contiene la referencia de la variable. AC_TARGDIR Contenido del campo de directorio de destino del registro que contiene la referencia de la variable. Las variables de entorno automticas se vuelven a configurar cuando se procesa cada uno de los registros del perfil (aunque evidentemente las variables ACPEP no cambian), de modo que, por ejemplo, las referencias a AC_TYPE de tres registros de un mismo perfil proporcionan tres valores distintos si los registros son de tipos distintos.
Autorizacin
senior
Opciones
punto_final Nombre del objeto de punto final que se modificar. Se puede hacer referencia al objeto de punto final con la notacin @Classname:etiqueta estndar. Si no se emplea la notacin estndar, se supone que punto_final es una referencia a un objeto de nodo gestionado. nombre=valor ... Crea un nombre de variable de entorno con el valor especificado en el punto final especificado. Separe las diversas expresiones nombre=valor con un espacio. a Indica que las asignaciones de variable de entorno deben agregarse a la lista ya existente en el objeto de punto final (con la excepcin de los duplicados, que se evitan). Sin a, la lista de variables proporcionada en la lnea de comandos pasa a ser la nueva lista del punto final y todas las variables anteriores se eliminan. Si no se lista ninguna variable nueva pero se especifica una o varias opciones d, las opciones d se procesan y las otras variables permanecen sin modificar. Si no se proporciona ninguna variable nueva y no se especifica ninguna opcin d, se elimina todo el entorno controlado por el usuario del objeto de punto final.
d nombre ... Suprime la variable especificada del punto final. Se pueden proporcionar muchas opciones d.Separe los diversos nombres con un espacio. i archivo Indica que la lista de variables de entorno que se debe instalar en el punto final debe leerse del archivo especificado en lugar de leerse de la lnea de
Captulo 1. Comandos
111
comandos. Las definiciones de variables deben figurar en el archivo, una en cada lnea. Si archivo es un solo guin, la lista se lee de la entrada estndar de wsetaeenv.
Ejemplos
El ejemplo siguiente agrega la variable de entorno BufEvtMaxSize al objeto de punto final de perfil del punto final boston-box:
wsetaeenv -a BufEvtMaxSize=500000 @Endpoint:boston-box
Vase tambin
waddac, wdelac, wdistrib (en la publicacin IBM Tivoli Management Framework Reference Manual), wlsaeenv
112
wsetemsg
Modifica un evento.
Sintaxis
wsetemsg [t estado [f] [r gravedad] [atributo=valor...] consola ID_evento
Descripcin
El comando wsetemsg modifica el estado, la gravedad u otros valores de atributo de un evento existente. Debe especificar el evento por la consola que lo ha recibido, as como su nmero de ID de evento; asimismo, debe estar asignado como operador de esa consola. Utilice el comando wlsemsg para ver una lista de los nmeros de ID de evento.
Autorizacin
La funcin de autorizacin necesaria depende de los indicadores empleados. La tabla siguiente indica las funciones necesarias:
Opcin de comando f r t Autorizacin admin o senior user user
Opciones
consola Especifica el nombre de la consola de eventos que debe emplearse. ID_evento Especifica el ID del evento que se modificar. El ID de evento est formado por event_handle, server_handle y date_reception. atributo=valor... Asigna un valor a cualquier atributo vlido. El atributo debe estar definido para la clase de evento. Separe las diversas expresiones atributo=valor con un espacio. r gravedad Cambia el valor de gravedad a Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS), Desconocido (UNKNOWN) o un valor personalizado. t estado [f ] Cambia el estado a Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE), Confirmado (ACK) o un valor personalizado. f Fuerza el cambio del estado de un evento de Cerrado (CLOSED) a Abierto (OPEN), Confirmado (ACK) o Respondido (RESPONSE). Tambin fuerza el cambio del estado de Confirmado (ACK) a Abierto (OPEN). Si no especifica la opcin f , no puede cambiar el estado de un evento de Confirmado (ACK) a Abierto (OPEN), de Cerrado (CLOSED) a Abierto (OPEN), de Cerrado (CLOSED) a Confirmado (ACK), de Respondido (RESPONSE) a Confirmado (ACK), de Respondido (RESPONSE) a Abierto (OPEN) ni de Cerrado (CLOSED) a Respondido (RESPONSE).
Captulo 1. Comandos
113
Ejemplos
El ejemplo siguiente confirma el evento 11782052457 para la consola de eventos Network Events:
wsetemsg t ACK "Network Events" 11782052457
Vase tambin
wlsemsg, wpostemsg (versin de punto final), wpostzmsg (versin de punto final)
114
wsetesvrcfg
Establece los parmetros de configuracin para el servidor de eventos. Debe detener y reiniciar el servidor de eventos para que estos parmetros entren en vigor.
Sintaxis
wsetesvrcfg [S servidor] [b eventos] [c eventos] [e [segundos] ] [k segundos] [m segundos] [n segundos] [r [segundos] ] [t [archivo] ]
Descripcin
El comando wsetesvrcfg establece los parmetros de configuracin para el servidor de eventos. Se modifica el servidor de la regin de Tivoli local salvo que se especifique otro servidor. Debe especificar al menos una opcin; de lo contrario, el comando devolver un error. El servidor puede conservar un nmero de registros (tales como eventos y modificaciones de eventos). Los registros tienen una limitacin de tiempo; al final del periodo especificado, el registro se suprime y se inicia otro nuevo. No pretenden sustituir a los registros del sistema. Utilcelos para realizar pruebas y diagnsticos a corto plazo.
Autorizacin
senior
Opciones
b eventos Especifica el nmero mximo de eventos que se guardarn en el bfer de recepcin mientras el motor de reglas procese otros eventos. El valor predeterminado es 500 eventos. c eventos Establece la cach de eventos en el nmero de eventos especificado por eventos. El valor predeterminado es 1000 eventos. Debe ser un valor suficientemente alto para manejar un nmero mximo de eventos pendientes. Si la cach es demasiado pequea, el servidor fuerza la eliminacin de los eventos ms antiguos de la cach. e segundos Especifica el nmero de segundos que deben conservarse los eventos registrados en el registro de recepcin. Si no se especifica un nmero de segundos, la funcin de registro se desactiva. El valor predeterminado es 86400 segundos (1 da). Este valor no se aplica automticamente, sino que lo utiliza la tarea Clean_Database de la biblioteca T/EC Tasks. Esta tarea puede ejecutarse directamente o programarse como un trabajo. k segundos Conserva los eventos cerrados con la antigedad indicada por el nmero de segundos especificado. El valor predeterminado es 86400 segundos (1 da).
Captulo 1. Comandos
115
m segundos Especifica el nmero de segundos que se conceden al servidor de eventos para inicializarse. El valor predeterminado es 300 segundos. n segundos Especifica el nmero de segundos que deben conservarse los eventos que no se han cerrado. El valor predeterminado es 15552000 segundos (180 das). S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli. t archivo Especifica el nombre de ruta del archivo de seguimiento que se utilizar para ajustar y depurar las reglas. Si no se especifica una ruta, el seguimiento se desactiva. El archivo predeterminado es /tmp/rules.trace. Nota: tras especificar el nombre del archivo de seguimiento, debe reiniciar el servidor de eventos.
Ejemplos
El ejemplo siguiente establece el tamao de la cach del servidor de eventos en 1536 eventos para el servidor de la regin AcmeTMR:
wsetesvrcfg c 1536 S @EventServer#AcmeTMR
Vase tambin
wlsesvrcfg
116
wsetsrc
Restablece los atributos de las fuentes de eventos.
Sintaxis
wsetsrc [S servidor] [l etiqueta] [n nombre] fuente
Descripcin
El comando wsetsrc establece el nombre o la etiqueta de una fuente registrada en el servidor de eventos. Utilice el comando wlssrc para ver una lista de las fuentes definidas. Nota: debe especificar como mnimo uno de los argumentos opcionales (1, n o S).
Autorizacin
senior
Opciones
fuente Especifica la fuente que se modificar. l etiqueta Especifica la etiqueta que se utilizar para identificar la fuente en una consola de eventos. El valor predeterminado es el valor especificado en el argumento fuente. n nombre Cambia el nombre de la fuente por nombre, que debe ser un nombre de fuente exclusivo. Si crea un duplicado de un nombre ya existente, se informar de un error. El nombre de fuente debe coincidir con el nombre de fuente segn se ha especificado en el archivo de configuracin CDS de un adaptador de eventos. S servidor Especifica el nombre del servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli.
Ejemplos
El ejemplo siguiente establece la etiqueta de la fuente LOGFILE en syslog:
wsetsrc -l syslog LOGFILE
Vase tambin
wcrtsrc, wdelsrc, wlssrc
Captulo 1. Comandos
117
wsighup
Indica al adaptador del registro de eventos de Windows o de Windows NT que debe volver a cargar los archivos de configuracin y de formato.
Sintaxis
wsighup adaptador pid
Descripcin
El comando wsighup hace que el adaptador del registro de eventos de Windows o de Windows NT vuelva a cargar los archivos de configuracin y formato. Utilice este comando si ha realizado modificaciones en el archivo de configuracin o de formato y desea empezar a utilizar la configuracin modificada sin detener el adaptador. Nota: utilice el comando wsighup solamente en los sistemas Windows. Si utiliza el sistema operativo UNIX, utilice el comando kill -HUP pid_adaptador para volver a cargar los archivos de configuracin y formato.
Autorizacin
Ninguna.
Opciones
adaptador Nombre del servicio del adaptador pid ID de proceso del adaptador
Ejemplos
El ejemplo siguiente vuelve a cargar los archivos de configuracin y de formato correspondientes al adaptador tecwinadapter_myid con el ID de proceso 712:
wsighup tecwinadapter_myid 712
118
wstartesvr
Inicia el servidor de eventos.
Sintaxis
wstartesvr [S servidor]
Descripcin
De forma predeterminada, el comando wstartesvr inicia el servidor de eventos de la regin de Tivoli local. El servidor de eventos lee los archivos de configuracin y la base de datos de eventos, y carga la base de reglas. La cach de eventos se carga con eventos en funcin de los parmetros de tiempo y tamao del bfer y los eventos en cola y en espera (si haba eventos en esos estados la ltima vez que se apag el servidor) se cargan en el bfer de recepcin. A continuacin, el servidor de eventos se establece como disponible para la comunicacin con los adaptadores de eventos y las consolas. De inmediato empieza a procesar los eventos en cola y en espera y los eventos entrantes. Una vez que el servidor de eventos est en ejecucin, los administradores pueden emplear sus consolas de eventos. Si un servidor de eventos se detiene, las consolas que estaban conectadas al mismo se vuelven a conectar automticamente cuando se reinicia el servidor.
Autorizacin
senior
Opciones
Ejemplos
El ejemplo siguiente inicia el servidor de eventos local:
wstartesvr
Vase tambin
wstopesvr
Captulo 1. Comandos
119
wstartmaint.sh
Informa al servidor de eventos de que un host ha entrado en modo de mantenimiento.
Sintaxis
wstartmaint.sh nombre_host duracin "info_propietario" [hora_inicio]
Descripcin
El comando wstartmaint.sh informa al servidor de eventos de que un recurso de red ha entrado en modo de mantenimiento mediante el envo de un evento de control TEC_Maintenance. Puede utilizar este comando manualmente o puede automatizarlo mediante el planificador del sistema. La salida de este comando es la misma que la salida de la tarea Start_Maintenance.
Autorizacin
Ninguna.
Opciones
nombre_host Especifica el nombre totalmente calificado del host que ha entrado en modo de mantenimiento. duracin Especifica el tiempo, en minutos, que el host permanecer en modo de mantenimiento. "info_propietario" Especifica la informacin sobre el usuario que ha iniciado el mantenimiento. hora_inicio Indica la hora en la que el host entra en modo de mantenimiento, con el formato AAAA MM DD HH MM SS. Si no se especifica, el valor predeterminado es la hora actual del sistema.
Ejemplos
Este ejemplo informa al servidor de eventos de que el host myhost va a entrar en modo de mantenimiento inmediatamente y estar en este modo durante 30 minutos:
wstartmaint.sh myhost.mynet.com 30 "my.email.com"
Este ejemplo informa al servidor de eventos de que el host myhost estar en modo de mantenimiento durante 1 hora a partir del 1 de julio de 2003 a las 7 de la tarde:
wstartmaint.sh myhost.mynet.com 60 "my.email.com" 2003 07 01 19 00 0
Este ejemplo informa al servidor de eventos de que todos los hosts estarn en modo de mantenimiento durante 1 minuto:
wstartmaint.sh "*" 1 "my.email.com"
Vase tambin
wstopmaint.sh
120
wstatesvr
Visualiza el estado de un servidor de eventos.
Sintaxis
wstatesvr [S servidor]
Descripcin
El comando wstatesvr visualiza el estado del servidor de eventos.
Autorizacin
user
Opciones
S servidor Especifica el nombre de un servidor de eventos con el formato del registro de nombres. El servidor predeterminado es el servidor de eventos local. Para indicar un servidor remoto, especifique @EventServer#tmr, siendo tmr el nombre de una regin de Tivoli.
Ejemplos
El ejemplo siguiente visualiza el estado del servidor de eventos local:
wstatesvr
Vase tambin
wstartesvr, wstopesvr
Captulo 1. Comandos
121
wstopesvr
Detiene el servidor de eventos.
Sintaxis
wstopesvr [S servidor]
Descripcin
El comando wstopesvr detiene el servidor de eventos de la regin de Tivoli local. Si un servidor de eventos se detiene, las consolas que estaban conectadas al mismo se vuelven a conectar automticamente cuando se reinicia el servidor.
Autorizacin
senior
Opciones
Ejemplos
El ejemplo siguiente detiene el servidor de eventos local:
wstopesvr
Vase tambin
wstartesvr
122
wstopmaint.sh
Informa al servidor de eventos de que se est cancelando el modo de mantenimiento continuado o planificado para un recurso de red.
Sintaxis
wstopmaint.sh nombre_host [hora_inicio]
Descripcin
El comando wstopmaint.sh informa al servidor de eventos que se va a cancelar un intervalo de mantenimiento en curso para un recurso de red antes de la hora de finalizacin planificada o bien de que se va a cancelar un intervalo de mantenimiento planificado para ms adelante para un recurso de red.
Autorizacin
Ninguna.
Opciones
nombre_host Especifica el nombre totalmente calificado del host que dejar de estar en modo de mantenimiento. hora_inicio Indica la hora en la que el host entr en modo de mantenimiento, con el formato AAAA MM DD HH MM SS. Si no se especifica esta hora, se cancelan los intervalos de mantenimiento actual y futuros.
Ejemplos
Este ejemplo informa al servidor de eventos de que el intervalo de mantenimiento actual del host myhost se va a cancelar antes:
wstopmaint.sh myhost.mynet.com 2003 04 21 12 10 00
Este ejemplo informa al servidor de eventos de que todos el intervalo de mantenimiento actual y los intervalos futuros del host myhost se van a cancelar:
wstopmaint.sh myhost.mynet.com
Vase tambin
wstartmaint.sh
Captulo 1. Comandos
123
wstoptecgw
Detiene el gateway de Tivoli Enterprise Console.
Sintaxis
wstoptecgw
Descripcin
El comando wstoptecgw detiene un gateway de Tivoli Enterprise Console que da servicio a puntos finales. El gateway de Tivoli Enterprise Console se reinicia automticamente al recibir un evento, por lo que no hay un comando correspondiente para iniciar el gateway. Este comando debe ejecutarse en el shell especificado en el punto final instalado en el host (nodo gestionado) que contiene el gateway. Para acceder al comando wstoptecgw en el shell especificado en el punto final instalado en el host (nodo gestionado) que contiene el gateway, siga estos pasos: 1. Instale el Recurso de configuracin del adaptador en el nodo gestionado para que acte como gateway de Tivoli Enterprise Console. 2. Cree un punto final en ese nodo gestionado. 3. Cree una entrada de perfil de configuracin de adaptador para el archivo de configuracin tec_gateway. 4. Distribuya el perfil de configuracin de adaptador tec_gateway al punto final. El comando wstoptecgw reside ahora en el directorio $LCF_BINDIR/../bin/ de este punto final. Nota: el comando wstoptecgw tambin se distribuye al distribuir el perfil de configuracin de adaptador tec_gateway_sce.
Autorizacin
user
124
wtdbclear
Borra eventos de la base de datos de eventos.
Sintaxis
wtdbclear [e] [f] [l] [c nombre_clase] [r gravedad] [s estado] t segundos [a registros] [-p TRUE | FALSE] [w]
Descripcin
El comando wtdbclear suprime eventos del registro de recepcin, el repositorio de eventos o ambos. Las tablas de las que suprima las filas dependern de las opciones especificadas. El comando wtdbclear debe ejecutarse desde el servidor de eventos.
Autorizacin
senior
Opciones
a registros Se efecta una confirmacin tras suprimirse x nmero de registros. c nombre_clase Borra los eventos con el nombre de clase especificado. Nota: no puede emplear esta opcin al borrar el registro de recepcin con la opcin l. e Suprime eventos del repositorio de eventos, del repositorio de tareas y de la tabla de atributos de eventos ampliados. Debe emplear la opcin t para especificar la antigedad de los eventos que se deben suprimir. Fuerza la supresin de los eventos en cola y en espera del registro de recepcin. Nota: no utilice nunca esta opcin mientras est en ejecucin el servidor de Tivoli Enterprise Console. l Suprime eventos del registro de recepcin. Debe emplear la opcin t para especificar la antigedad de los eventos que se deben suprimir. Nota: no puede emplear las opciones c, r o s al borrar el registro de recepcin con esta opcin. p TRUE | FALSE Indica si debe efectuarse una llamada al procedimiento almacenado, tec_p_clear_events. El valor predeterminado es TRUE. El procedimiento tec_p_clear_events mejora el rendimiento en tiempo de ejecucin de wtdbclear. r gravedad Borra los eventos con la gravedad especificada. Los valores predeterminados vlidos son Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN).
Captulo 1. Comandos
125
Nota: no puede emplear esta opcin al borrar el registro de recepcin con la opcin l. s estado Borra los eventos con el estado especificado. Los valores predeterminados vlidos son Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE) o Confirmado (ACK). Nota: no puede emplear esta opcin al borrar el registro de recepcin con la opcin l. t segundos Suprime los eventos que tienen una antigedad superior al nmero de segundos especificado. Esta opcin es obligatoria. w Fuerza la supresin de eventos que todava no han sido procesados por el proceso ETL (extraccin, transformacin y carga) del almacn de datos. Si el paquete de activacin del almacn de Tivoli Enterprise Console est instalado, el proceso ETL del almacn procesa peridicamente los eventos del repositorio. Si emite el comando wtdbclear y especifica un intervalo de tiempo que incluya los eventos que el proceso ETL del almacn an no ha procesado, el comando wtdbclear devuelve un mensaje de aviso. Utilice la opcin w para forzar la supresin de estos eventos.
Notas
Si se especifica ms de una de las opciones c, s y r, el resultado es un OR lgico.
Ejemplos
El 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
El ejemplo siguiente, puesto que especifica ms de una de las opciones c, s y r, suprime todos los eventos cuyo nivel de gravedad es Inocuo (HARMLESS) o bien todos los eventos cuya clase es TEC_Start:
wtdbclear -r HARMLESS -c TEC_Start -et 0
Vase tambin
wdbmaint.sh, wtdumper, wtdumprl, wtdumptr
126
wtdbclear.pl
Borra eventos de la base de datos de eventos.
Sintaxis
wtdbclear.pl [e] [f] [l] [c nombre_clase] [r gravedad] [s estado] t segundos [a registros] [-R nombre_rim] [-D] [w]
Descripcin
El comando wtdbclear.pl suprime eventos del registro de recepcin, el repositorio de eventos o ambos. Las tablas de las que suprima las filas dependern de la opcin especificada. Si el script wtdbclear.pl se ejecuta desde un nodo que no es el servidor de Tivoli Enterprise Console, utilizar la hora del sistema local para determinar qu eventos deben borrarse, lo que puede generar un comportamiento imprevisto. Se recomienda no ejecutar el script wtdbclear.pl en horas de funcionamiento mximo. Por ejemplo, si la hora del nodo indica las 9:00 y la hora del servidor de Tivoli Enterprise Console indica las 9:30, si se ejecuta un comando wtdbclear.pl let 0 desde el nodo se borrarn los eventos recibidos antes de las 9:00. Los ltimos 30 minutos de eventos permanecern en la base de datos. Al ejecutar wtdbclear.pl en el servidor de Tivoli Enterprise Console se borrara por completo la base de datos. Nota: este comando ha quedado obsoleto con la versin 3.8 de Tivoli Enterprise Console, y puede que no est disponible en releases posteriores. Utilice en su lugar el comando wtdbclear. Se recomienda emplear el comando wtdbclear.pl nicamente en las situaciones siguientes: v Si utiliza una base de datos 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 DB2 y el procedimiento almacenado tec_p_clear_events no est instalado.
Autorizacin
senior
Opciones
a registros Se efecta una confirmacin tras suprimirse el nmero de registros especificado. c nombre_clase Borra los eventos con el nombre de clase especificado. Nota: no puede emplear esta opcin al borrar registros de recepcin con la opcin l. D Activa el seguimiento. Cuando se utiliza esta opcin, la accin predeterminada es que la actividad de seguimiento se escriba en la salida estndar (stdout); si lo desea, puede redirigir la salida del comando a un archivo. Suprime eventos del repositorio de eventos, el repositorio de tareas y la
Captulo 1. Comandos
127
tabla de atributos de eventos ampliados. Debe emplear la opcin t para especificar la antigedad de los eventos que se deben suprimir. f Fuerza la supresin de los eventos en cola y en espera del registro de recepcin. Nota: no utilice esta opcin mientras est en ejecucin el servidor de Tivoli Enterprise Console. l Suprime eventos del registro de recepcin. Nota: no puede emplear las opciones c, r o s al borrar el registro de recepcin con esta opcin. R Nombre de objeto RIM. El valor predeterminado es tec.
r gravedad Borra los eventos con la gravedad especificada. Los valores predeterminados vlidos son Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Nota: no puede emplear esta opcin al borrar registros de recepcin con la opcin l. s estado Borra los eventos con el estado especificado. Los valores predeterminados vlidos son Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE) o Confirmado (ACK). Nota: no puede emplear esta opcin al borrar registros de recepcin con la opcin l. t segundos Suprime los eventos que tienen una antigedad superior al nmero de segundos especificado. Esta opcin es obligatoria. w Fuerza la supresin de eventos que todava no han sido procesados por el proceso ETL (extraccin, transformacin y carga) del almacn de datos. Si el paquete de activacin del almacn de Tivoli Enterprise Console est instalado, el proceso ETL del almacn procesa peridicamente los eventos del repositorio. Si ejecuta el script wtdbclear.pl y especifica un intervalo de tiempo que incluya los eventos que el proceso ETL del almacn an no ha procesado, el script wtdbclear.pl devuelve un mensaje de aviso. Utilice la opcin w para forzar la supresin de estos eventos.
Ejemplos
El ejemplo siguiente suprime todos los eventos con una antigedad superior a 60 segundos de los repositorios de eventos y tareas y del registro de recepcin, activa el seguimiento y coloca la salida en el archivo /tmp/output:
wtdbclear.pl -elt 60 -D > /tmp/output
Vase tambin
wdbmaint.sh, wtdbclear, wtdumper, wtdumprl, wtdumptr
128
wtdbspace
Proporciona estadsticas de uso del espacio para la base de datos de eventos.
Sintaxis
wtdbspace [-R nombre_objeto_rim] [-t nombre_disp_temp,...] [-d nombre_disp_datos,... | -T ]
Descripcin
El comando wtdbspace proporciona estadsticas sobre el espacio empleado y el espacio libre de la base de datos de eventos. Notas: 1. Debe ejecutarse en el servidor de eventos, salvo que se indique lo contrario. 2. El sistema en el que se ejecuta este comando debe tener disponibles los programas bash, perl y wrimsql, salvo que se indique lo contrario. Ejecute este programa desde bash. Si utiliza una base de datos Informix, debe ejecutar el script wtdbspace como usuario de Tivoli Enterprise Console Informix en el sistema en el que est instalado el servidor de base de datos Informix y debe especificarse el entorno de la base de datos. Si el servidor Informix est en un sistema distinto al del servidor de eventos, deber copiar el script wtdbspace (situado en el directorio $BINDIR/bin del servidor de eventos) en el servidor Informix o hacer que el script est disponible mediante un montaje NFS. El comando wrimsql no es necesario al ejecutar wtdbspace en el servidor de base de datos Informix. Si utiliza una base de datos DB2, debe ejecutar el script wtdbspace como usuario de Tivoli Enterprise Console DB2 en el host RIM desde el procesador de lnea de comandos de DB2 y debe especificarse el entorno de la base de datos. Si el host RIM est en un sistema distinto al del servidor de Tivoli Enterprise Console, deber copiar el 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 del servidor de eventos) en el servidor DB2 o hacer que los scripts estn disponibles mediante un montaje NFS. El comando wrimsql no es necesario cuando se ejecuta el comando wtdbspace para una base de datos DB2.
Autorizacin
user
Opciones
-d nombre_disp_datos,... Nombre de los dispositivos de datos sobre los que se informar. La tabla siguiente indica los tipos de dispositivos de datos correspondientes a cada producto:
Producto DB2 Informix Microsoft SQL Server Oracle Sybase Tipos de dispositivos de datos Nombres de espacio de tabla Nombres de espacio de base de datos Nombres de grupo de archivos Nombres de espacio de tabla Nombres de dispositivo lgico
Captulo 1. Comandos
129
Cada nombre se separa con una coma o un espacio. Si se utilizan espacios para separar nombres, toda la lista debe escribirse entre comillas dobles. Si no se especifica ningn nombre, se informa sobre todos los nombres de dispositivo de la base de datos. Este comando admite el uso del carcter de asterisco como carcter coincidente. Puede emplearse al principio de un nombre, al final o en ambos casos. Por ejemplo, si desea especificar una lista de dispositivos de datos que empiezan todos por tec, especifique tec* para nombre_disp_datos. R nombre_objeto_rim Nombre del objeto RIM. El valor predeterminado es tec. t nombre_disp_temp,... Nombre de los dispositivos temporales sobre los que se informar. La tabla siguiente indica los dispositivos temporales correspondientes a cada producto:
Producto DB2 Informix Microsoft SQL Server Oracle Sybase Dispositivos temporales Espacios de tabla temporales definidos para la base de datos DBSPACETEMP TEMPDB Espacios de tabla temporales definidos para la base de datos TEMPDB
Cada nombre se separa con una coma. Si no se especifica ningn nombre, se informar sobre todos los dispositivos temporales con nombre de la base de datos. Este comando admite el uso del carcter de asterisco como carcter coincidente. Puede emplearse al principio de un nombre, al final o en ambos casos. Por ejemplo, si desea especificar una lista de dispositivos temporales que empiezan todos por tec, especifique tec* para nombre_disp_temp. T Muestra todos los dispositivos de datos de Tivoli Enterprise Console y todos los dispositivos de datos temporales. Este parmetro no se puede emplear con el parmetro d.
Ejemplos
El ejemplo siguiente muestra el espacio empleado para un objeto RIM denominado mssql_tec y muestra la informacin correspondiente a los dispositivos de datos TEC_DATA1 y TEC_DATA2 y los dispositivos temporales TEC_TEMP1 y TEC_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 los dispositivos de datos que empiezan por TEC y los dispositivos temporales que empiezan por TEC:
wtdbspace -d TEC* -t TEC*
130
wtdbstat
Comprueba la disponibilidad del servidor de base de datos que utiliza el servidor de Tivoli Enterprise Console.
Sintaxis
wtdbstat [q]
Descripcin
El comando wtdbstat visualiza la disponibilidad del servidor de base de datos. Este comando tarda ms en ejecutarse cuando el servidor de base de datos est inactivo.
Autorizacin
senior
Opciones
q Especifica que no se imprimir ninguna salida (el comando wtdbstat se ejecuta de forma silenciosa). El cdigo de retorno indica el estado. El cdigo de retorno 0 indica que el servidor est en ejecucin. Cualquier otro cdigo de retorno indica un error.
Ejemplos
El ejemplo siguiente visualiza la disponibilidad del servidor de base de datos:
wtdbstat
Vase tambin
wstatesvr
Captulo 1. Comandos
131
wtdumper
Genera un informe de eventos correspondiente a los eventos procesados del repositorio de eventos.
Sintaxis
wtdumper [f archivo] [t hora_inicio] [e hora_finalizacin] [o ASC | DESC] [m nmero] [d] [w clusula_where]
Descripcin
El comando wtdumper genera un informe de eventos a partir del repositorio de eventos. El servidor de Tivoli Enterprise Console mantiene un registro de estos eventos en la base de datos. La accin predeterminada es que los eventos figuren en el orden en que se han producido. Sin embargo, el evento ms reciente puede constar en primer lugar utilizando el indicador o. Si se ejecuta wtdumper desde un nodo que no es el servidor de Tivoli Enterprise Console, utilizar la hora del sistema local para determinar qu eventos deben visualizarse, lo que puede generar un comportamiento imprevisto. Por ejemplo, si la hora del nodo indica las 9:00 y la hora del servidor de Tivoli Enterprise Console indica las 9:30, si se ejecuta un comando wtdumper desde el nodo se visualizarn todos los eventos de la base de datos excepto los acontecidos durante los 30 minutos especificados. El mismo comando ejecutado en el servidor de Tivoli Enterprise Console visualizara toda la base de datos.
Autorizacin
senior
Opciones
d Lista informacin de formato detallada en el informe de eventos. e hora_finalizacin Lista los eventos acontecidos antes de la fecha y la hora especificadas. El parmetro hora_finalizacin debe indicar una fecha con el formato mes dd hh:mm:ss aaaa. Si se omite este indicador, el comando utilizar la hora actual como hora de finalizacin. f archivo Escribe la salida en el archivo especificado. m nmero Especifica el nmero mximo de eventos que se registrar en el informe. Si el nmero de eventos de la base de datos supera el valor especificado, el comando omitir entradas a partir del final del informe. Por ejemplo, si se visualiza el informe en orden ascendente, las entradas ms recientes de la base de datos no se incluirn en el informe. o ASC | DESC Establece el orden en que se listarn los eventos. Los valores posibles son: ASC Lista en primer lugar el registro de evento ms antiguo. ste es el valor predeterminado.
DESC Lista en primer lugar el registro de evento ms reciente.
132
t hora_inicio Lista los eventos acontecidos despus de la fecha y la hora especificadas. El parmetro hora_inicio debe indicar una fecha con el formato mes dd hh:mm:ss aaaa. w clusula_where Especifica una clusula WHERE de SQL parcial para la consulta de la base de datos de eventos. Esta clusula parcial se agrega a la clusula WHERE generada internamiento con el operador AND. Nota: esta opcin es muy til si est familiarizado con las sentencias SQL.
Ejemplos
El ejemplo siguiente genera un informe de eventos que incluye los eventos producidos entre las 19:00 del 9 de marzo de 1999 y las 9:00 del 12 de marzo de 1999:
wtdumper t "MAR 09 19:00:00 1999" e "MAR 12 09:00:00 1999"
El ejemplo siguiente especifica una clusula WHERE de SQL parcial para la consulta de la base de datos de eventos:
wtdumper -w "msg = Se ha producido un error de impresin"
Vase tambin
wtdbclear, wtdumprl, wtdumptr
Captulo 1. Comandos
133
wtdumprl
Genera un informe de los eventos recibidos del registro de recepcin.
Sintaxis
wtdumprl [f archivo] [t hora_inicio] [e hora_finalizacin] [o ASC | DESC] [m nmero]
Descripcin
El comando wtdumprl genera un informe de los eventos recibidos por el servidor de eventos. El registro de recepcin mantiene una lista de estos eventos en la base de datos. La accin predeterminada es que los eventos figuren en el orden en que se han producido. Sin embargo, el evento ms reciente puede constar en primer lugar utilizando el indicador o. Si se ejecuta wtdumprl desde un nodo que no es el servidor de Tivoli Enterprise Console, utilizar la hora del sistema local para determinar qu eventos deben visualizarse, lo que puede generar un comportamiento imprevisto. Por ejemplo, si la hora del nodo indica las 9:00 y la hora del servidor de Tivoli Enterprise Console indica las 9:30, si se ejecuta un comando wtdumprl desde el nodo se visualizarn todos los eventos de la base de datos excepto los acontecidos durante los 30 minutos especificados. El mismo comando ejecutado en el servidor de Tivoli Enterprise Console visualizara toda la base de datos.
Autorizacin
senior, RIM_view
Opciones
e hora_finalizacin Lista los eventos recibidos antes de la fecha y la hora especificadas. El parmetro hora_finalizacin debe indicar una fecha con el formato mes dd hh:mm:ss aaaa. Si se omite este indicador, el comando utilizar la hora actual como hora de finalizacin. f archivo Escribe la salida en el archivo especificado. m nmero Especifica el nmero mximo de eventos que se registrar en el informe. Si el nmero de eventos del registro supera el valor especificado, el comando omitir entradas a partir del final del informe. Por ejemplo, si se visualiza el informe en orden ascendente, las entradas ms recientes de la base de datos no se incluirn en el informe. o ASC | DESC Establece el orden en que se listarn los eventos. Los valores posibles son: ASC Lista en primer lugar la entrada ms antigua del registro. ste es el valor predeterminado.
DESC Lista en primer lugar la entrada ms reciente del registro.
134
t hora_inicio Lista los eventos recibidos despus de la fecha y la hora especificadas. El parmetro hora_inicio debe indicar una fecha con el formato mes dd hh:mm:ss aaaa.
Ejemplos
El ejemplo siguiente genera un informe que incluye todos los eventos recibidos entre 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"
Vase tambin
wtdbclear, wtdumper, wtdumptr
Captulo 1. Comandos
135
wtdumptr
Genera un informe de las tareas en ejecucin o completadas.
Sintaxis
wtdumptr [f archivo] [t hora_inicio] [e hora_finalizacin] [o ASC | DESC] [m nmero]
Descripcin
El comando wtdumptr genera un informe de las tareas realizadas por el servidor de eventos. El repositorio de tareas mantiene un registro de estas tareas en la base de datos. La accin predeterminada es que las tareas completadas figuren en el orden en que se han producido. Sin embargo, la tarea ms reciente puede constar en primer lugar utilizando el indicador o.
Autorizacin
senior, RIM_view
Opciones
e hora_finalizacin Lista las tareas completadas antes de la fecha y la hora especificadas. El parmetro hora_finalizacin debe indicar una fecha con el formato mes dd hh:mm:ss aaaa. Si se omite este indicador, el comando utilizar la hora actual como hora de finalizacin. f archivo Escribe la salida en el archivo especificado. m nmero Especifica el nmero mximo de eventos que se registrar en el informe. Si el nmero de eventos de la base de datos supera el valor especificado, el comando omitir entradas a partir del final del informe. Por ejemplo, si se visualiza el informe en orden ascendente, las entradas ms recientes de la base de datos no se incluirn en el informe. o ASC | DESC Establece el orden en que se listarn los eventos. Los valores posibles son: ASC Lista en primer lugar el registro de evento ms antiguo. ste es el valor predeterminado.
DESC Lista en primer lugar el registro de evento ms reciente. t hora_inicio Lista las tareas completadas despus de la fecha y la hora especificadas. El parmetro hora_inicio debe indicar una fecha con el formato mes dd hh:mm:ss aaaa.
Ejemplos
El ejemplo siguiente genera un informe que incluye todas las tareas completadas entre 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"
Vase tambin
wtdbclear, wtdumper, wtdumprl
136
wtecexport
Exporta las definiciones de la consola de eventos de Tivoli Enterprise Console a un archivo.
Sintaxis
wtecexport h [host [:puerto]] [u usuario] [p contrasea] [O operador1:operador2:...] [c consola1:consola2:...] [e grupo_eventos1:grupo_eventos2:...] [f nombre_archivo] En los sistemas Windows, al comando wtecexport se le llama utilizando wtecexport.cmd. Las opciones son las mismas.
Descripcin
Las definiciones de grupos de eventos, consolas y operadores pueden exportarse a un archivo y despus importarse a otra regin de Tivoli mediante el comando wtecimport. Todos los administradores tienen la misma vista de configuracin de los objetos de una regin. La exportacin y la importacin de definiciones de consola ofrecen las ventajas siguientes: v Este mtodo permite crear de forma eficaz un conjunto base de consolas de eventos en una regin de Tivoli de modo que puedan importarse las consolas de eventos a otras regiones para realizar tareas de configuracin o implementacin adicionales. v Las definiciones de consola de una regin de Tivoli se pueden emplear como un punto de control nico para la configuracin de consolas en un entorno de varias regiones. v Este mtodo permite crear de forma eficaz copias de seguridad de consolas. Esta tarea tambin se puede efectuar desde la interfaz de usuario de 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 nmero de grupos de eventos sin exportar los operadores. Si no se especifica como mnimo una de las opciones O, c y e, se exportarn todas las definiciones de consola. Observe que wtecexport exporta consolas, grupos de eventos y operadores para todos los usuarios.
Autorizacin
senior
Opciones
h [host [:puerto]] Nombre de host de un nodo gestionado en el que el ID de usuario y la contrasea deben ser autenticadas por Tivoli Management Framework. Especifique esta opcin con el formato host:puerto si se utiliza un puerto distinto del puerto 94. c consola1:consola2:... Lista de consolas que se desea exportar, separadas por caracteres de dos puntos.
Captulo 1. Comandos
137
e grupo_eventos1:grupo_eventos2:... Lista de grupos de eventos que se desea exportar, separados por caracteres de dos puntos. f nombre_archivo Ruta y nombre del archivo que contendr las definiciones exportadas. Si el archivo no existe, se crear. La ruta ya debe existir. O operador1:operador2:... Lista de operadores que se desea exportar, separados por caracteres de dos puntos. p contrasea Contrasea del inicio de sesin especificado en el argumento u. Esta opcin es obligatoria si utiliza la opcin u para especificar un usuario. u usuario Inicio de sesin del administrador de Tivoli. Si no especifica esta opcin, se utiliza el ID del usuario que tenga una sesin iniciada en este momento. Nota: si est trabajando en un sistema AIX y ha iniciado la sesin como root, debe utilizar las subopciones h, u y p para especificar explcitamente el nombre del host, el ID de usuario y la contrasea para evitar que se visualice la ventana de inicio de sesin. Esto no es necesario si inicia la sesin en un sistema AIX con otro ID de usuario.
Ejemplos
1. El ejemplo siguiente lleva a cabo la exportacin como el usuario root en el servidor de eventos mica desde un sistema que ejecuta el sistema operativo Windows. Se muestran los operadores, las consolas y los grupos de eventos que se van a exportar y los recursos 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 exportacin como el usuario root en el servidor de eventos mica desde un sistema que ejecuta el sistema operativo Windows. En este caso, todos los operadores, las consolas y los grupos de eventos se exportan a export_file.
wtecexport.cmd -h mica -u root -p tivoli \ -f export_file
Vase tambin
wtecimport
138
wtecimport
Importa definiciones de consola de eventos de un archivo de exportacin a una regin de Tivoli.
Sintaxis
wtecimport h host [:puerto] [u usuario] [p contrasea] [O operador1:operador2:...] [c consola1:consola2:...] [e grupo_eventos1:grupo_eventos2:...] [f nombre_archivo] [x e | r | c] En los sistemas Windows, al comando wtecimport se le llama utilizando wtecimport.cmd. Las opciones son las mismas.
Descripcin
Las definiciones de grupos de eventos, consolas y operadores pueden exportarse a un archivo con el comando wtecexport y despus importarse a otra regin de Tivoli mediante una consola de eventos. Todos los administradores tienen la misma vista de configuracin de los objetos de una regin. La exportacin y la importacin de definiciones de consola ofrecen las ventajas siguientes: v Este mtodo permite crear de forma eficaz un conjunto base de consolas de eventos en una regin de Tivoli de modo que puedan importarse las consolas de eventos a otra regin para realizar tareas de configuracin o implementacin adicionales. v Las definiciones de consola de una regin de Tivoli se pueden emplear como un punto de control nico para la configuracin de consolas en un entorno de varias regiones. v Este mtodo permite crear de forma eficaz copias de seguridad de consolas. Esta tarea tambin 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 nmero de grupos de eventos sin importar los operadores. Si no se especifica como mnimo una de las opciones O, c y e, se importarn todas las definiciones de consola. Observe que wtecimport importa consolas, grupos de eventos y operadores para todos los usuarios. Al importar consolas, los operadores o grupos de eventos asignados a las consolas ya deben existir, o deben tambin importarse a la vez. Slo pueden importarse como operadores los administradores de Tivoli definidos en la regin de Tivoli receptora. No es posible crear un administrador de Tivoli nuevo en una regin importando un operador que no est definido en la regin receptora.
Autorizacin
senior
Opciones
c consola1:consola2;... Lista de consolas que se desea importar, separadas por caracteres de dos puntos.
Captulo 1. Comandos
139
e grupo_eventos1:grupo_eventos2:... Lista de grupos de eventos que se desea importar, separados por caracteres de dos puntos. f nombre_archivo Ruta y nombre del archivo que contiene las definiciones exportadas. -h [host [:puerto]] Nombre de host de un nodo gestionado en el que el ID de usuario y la contrasea deben ser autenticadas por Tivoli Management Framework. Especifique esta opcin con el formato host:puerto si se utiliza un puerto distinto del puerto 94. O operador1:operador2:... Lista de operadores que se desea importar, separados por caracteres de dos puntos. p contrasea Contrasea del inicio de sesin especificado en el argumento u. Esta opcin es obligatoria si utiliza la opcin u para especificar un usuario. u usuario Inicio de sesin del administrador de Tivoli. Si no especifica esta opcin, se utiliza el ID del usuario que tenga una sesin iniciada en este momento. x e | r | c Modo de resolucin de los nombres de objeto conflictivos. Utilice x e para emplear el objeto existente (consola, grupo de eventos u operador), x r para sustituir el objeto existente por el nuevo o x c para cambiar el nombre del objeto agregando un nmero al nuevo objeto. Los indicadores son sensibles a las maysculas y minsculas. El espacio entre el argumento y el indicador es opcional. Nota: si est trabajando en un sistema AIX y ha iniciado la sesin como root, debe utilizar las subopciones h, u y p para especificar explcitamente el nombre del host, el ID de usuario y la contrasea para evitar que se visualice la ventana de inicio de sesin. Esto no es necesario si inicia la sesin en un sistema AIX con otro ID de usuario.
Ejemplos
1. El ejemplo siguiente lleva a cabo la importacin como el usuario root en el servidor de eventos mica. Se indican los operadores, las consolas y los grupos de eventos que se van a importar y los valores exportados se incluyen en un archivo denominado export_file. Los operadores, las consolas y los grupos de eventos existentes se sustituirn en caso de que se produzca un conflicto de nombres.
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
140
2. El ejemplo siguiente importa todas las consolas, los grupos de eventos y los operadores incluidos en export_file. Una vez ms, la importacin se lleva a cabo como el usuario root en el servidor de eventos mica. Los operadores, las consolas y los grupos de eventos existentes se sustituirn en caso de que se produzca un conflicto de nombres.
wtecimport.cmd -h mica -u root -p tivoli -f export_file -x r
Vase tambin
wtecexport
Captulo 1. Comandos
141
wtouchac
Actualiza la hora de modificacin de un registro de perfil de configuracin de adaptador para forzar la redistribucin.
Sintaxis
wtouchac clave... perfil
Descripcin
El comando wtouchac actualiza la indicacin de la hora en uno o varios registros de un perfil de configuracin de adaptador. La actualizacin fuerza la distribucin de los registros la prxima vez que se solicite una distribucin desde la GUI del Recurso de configuracin del adaptador o mediante el comando wdist cuando no se especifique la opcin de copia exacta. Como en las configuraciones de adaptadores intervienen otros archivos que no estn directamente controlados por el mecanismo de perfiles en Tivoli Enterprise, el hecho de que un registro deba redistribuirse debido a que un archivo auxiliar ha cambiado no es evidente para la aplicacin. Por lo tanto, se utiliza el comando wtouchac cuando ha cambiado un archivo auxiliar pero no el registro.
Autorizacin
admin
Opciones
clave... Claves de uno o varios registros. Cada registro se lee y se vuelve a escribir. Separe las diversas claves con un espacio. Puede ver el valor de clave en la parte superior derecha del panel de entrada del perfil de configuracin del adaptador o mediante el comando wlsac. perfil Perfil de configuracin de adaptador que se ver afectado. Si el nombre contiene espacios, escriba todo el nombre entre comillas.
Ejemplos
El ejemplo siguiente actualiza la indicacin de la hora de la entrada de perfil de configuracin de adaptador almacenada en la clave 1 del perfil ACP_Profile:
wtouchac 1 @ACP:ACP_Profile
El ejemplo siguiente actualiza la indicacin de la hora de la entrada de perfil de configuracin de adaptador almacenada en la clave 1 del perfil ACP Profile (que contiene un espacio en el nombre):
wtouchac 1 @"ACP:ACP Profile"
Vase tambin
wdistrib (en la publicacin IBM Tivoli Management Framework Reference Manual), waddac
142
Captulo 2. Tareas
En este captulo se describen las tareas predefinidas incluidas en la biblioteca de tareas del producto Tivoli Enterprise Console. El nombre real de esta biblioteca de tareas es T/EC Tasks; este nombre se muestra en los dilogos de tareas y se utiliza cuando se especifica la biblioteca de tareas desde una lnea de comandos. Existen tres tipos de tareas de Tivoli Enterprise Console: Tareas de consola Estas tareas estn configuradas y se ejecutan inmediatamente desde el visor de eventos. Si una tarea de consola requiere algn valor para algn atributo de evento, seleccione el evento en la cola de trabajo del visor de eventos para asociar el evento con la tarea. Tareas automticas Estas tareas se configuran por adelantado y se ejecutan automticamente cuando en la consola en la que se muestra el evento se recibe un evento determinado con las clases y atributos de evento especificados. Las tareas automticas se configuran con el men desplegable Tareas automticas del visor de eventos. Tareas de base de reglas Estas tareas se ejecutan cuando forman parte de una accin correspondiente a una regla que se ha activado. Para ejecutar las tareas de base de reglas se utilizan los predicados del lenguaje de reglas exec_task y exec_task_local. Las tareas de base de reglas tambin se conocen como respuestas automticas. Para obtener informacin acerca de la ejecucin de tareas incluidas en las reglas, consulte la publicacin Tivoli Enterprise Console Rule Builders Guide. Una tarea es un script que normalmente llama a otros comandos de Tivoli. Los valores de las variables se pasan a una tarea en el momento de la ejecucin. Los valores de las variable pueden proceder de las opciones y argumentos que especifique o de los atributos de evento disponibles para la tarea. En el caso de las tareas de consola que necesitan tener disponibles los atributos de un evento, debe asociar el evento con la tarea seleccionando el evento en la consola de eventos. En este captulo se describen las opciones y los argumentos que puede especificar para las tareas. Los atributos de evento disponibles para las tareas se describen en el Captulo 3, Variables de entorno disponibles para las tareas, en la pgina 171. Los procedimientos para configurar tareas desde una consola de eventos se describen en la ayuda en lnea de la consola actual. En el dilogo Tareas automticas puede definir o modificar las propiedades siguientes: v Nombre v Descripcin v Cuando un evento coincide con v Ejecutar tareas Cuando una tarea automtica finaliza, enva informacin en la que se indica si la tarea ha sido correcta o si ha fallado, as como el resultado de la tarea. El icono de finalizacin de tarea se visualiza en la primera columna del visor de eventos
143
cuando una tarea automtica finaliza. Puede hacer clic en el icono de la columna para ver los detalles acerca del resultado de la tarea automtica. Estos detalles no permanecen tras el reinicio de la consola. El resultado de las tareas automticas se puede grabar en un archivo de texto, que se configura en el dilogo Propiedades de consola de cada consola. Para obtener informacin detallada acerca de la ejecucin de la funcin de tarea automtica desde la consola de eventos, consulte las entradas de Tarea automtica proporcionadas en la ayuda en lnea. Al ejecutar una tarea de base de reglas, la informacin que indica si la tarea ha sido correcta o incorrecta y su resultado slo se enva si el estado de observacin tiene el valor YES. De lo contrario, en la consola no se muestra informacin alguna sobre la tarea. Si el estado de observacin es YES, el icono de finalizacin de tarea se visualiza en la primera columna del visor de eventos cuando la tarea finaliza. Puede hacer clic en el icono de esta columna para ver los detalles acerca del resultado de la tarea de base de reglas. Estos detalles s permanecen tras el reinicio de la consola. Puede configurar y ejecutar todas las tareas mediante los dilogos de la consola de eventos. Puede configurar y ejecutar la mayora de las tareas desde la lnea de comandos. Para obtener informacin acerca del acceso a los dilogos relacionados con las tareas de Tivoli Enterprise Console, consulte la publicacin Tivoli Enterprise Console Rule Builders Guide. El comando wruntask de Tivoli Management Framework se utiliza para configurar y ejecutar las tareas de consola desde la lnea de comandos, y se muestra en todos los ejemplos de este captulo. Las tareas tambin pueden ejecutarse mediante una accin en una regla de Tivoli Enterprise Console. Nota: en este captulo, el trmino configurar significa especificar los parmetros de entrada y las opciones de ejecucin para las tareas de Tivoli Enterprise Console y, en el caso de una tarea automtica, definir las restricciones de evento para la coincidencia de campos de eventos para activar la accin de la tarea y definir el nombre de la tarea que se ejecutar si se cumplen las restricciones de evento.
Nombres y scripts de tareas

En la tabla siguiente: v Se listan las tareas con sus nombres de tarea y sus nombres descriptivos. Los nombres de tarea se utilizan en la lnea de comandos para identificar las tareas. Puede ver los nombres de tarea y los nombres descriptivos en el dilogo de tareas de T/EC del escritorio de Tivoli marcando y quitando la marca del cuadro de seleccin Mostrar por identificadores para ver los nombres de tareas en el visor de eventos. v Se listan los nombres de archivo de los scripts de tarea. Estos scripts se encuentran en el directorio $BINDIR/../generic_unix/TAS/TASK_LIBRARY/bin/tmr_number. Puede modificarlos si es necesario. v Se indica si puede ejecutar la tarea en la lnea de comandos. Determinadas tareas necesitan tener disponibles los atributos de un evento. No puede ejecutar en la lnea de comandos una tarea que necesite tener disponibles los atributos de un evento.
144
Nombre de tarea Change_Severity Clean_Database
Nombre descriptivo Cambiar la gravedad de un evento Borrar el contenido de la base de datos de Tivoli Enterprise Console Borrar eventos cerrados Borrar registro de recepcin Cerrar evento
Nombre de archivo T_EC_Tasks_C_zonctxba T_EC_Tasks_C_hmmeleka
Lnea de comandos No S
Clear_Closed_Events Clear_Reception_Log Close_Event Dump_Event_Repository Event_Query Find_Similar_Events Forward_Event Log_Event_To_File Popup_Message Send_Email Send_Event Start_Maintenance
T_EC_Tasks_C_onyloafa T_EC_Tasks_C_rgetpzda T_EC_Tasks_C_ylzejuna
S S No S S No No No S No S S
Volcar repositorio de eventos T_EC_Tasks_D_ckqiqpka Consultar repositorio de eventos Buscar evento coincidente Reenviar evento a servidor Tivoli Enterprise Console Registrar evento en archivo Mostrar mensaje emergente en el escritorio Enviar informacin de eventos Enviar evento a servidor Tivoli Enterprise Console Informar al servidor de eventos sobre los intervalos de mantenimiento Saltar a Netscape con URL T_EC_Tasks_E_wkxovwka T_EC_Tasks_F_lozglmea T_EC_Tasks_F_dpstmska T_EC_Tasks_L_jfugucca T_EC_Tasks_P_rsoomfna T_EC_Tasks_S_rsnlpxda T_EC_Tasks_S_lwqpwqla T_EC_Tasks_S_jxixoxea
Wake_Up_Netscape
T_EC_Tasks_W_mnnqzlga
Salida de las tareas

Cuando una tarea finaliza, enva informacin en la que se indica si la tarea ha sido correcta o si ha fallado, as como el resultado de la tarea (por ejemplo, el resultado de una consulta a la base de datos de eventos). Para las tareas que se ejecutan desde el visor de eventos, se visualiza un dilogo de salida de la tarea que contiene esta informacin. Para las tareas que se ejecutan en la lnea de comandos, se graba el mismo nivel de informacin en stdout y stderr. En el caso de las tareas automticas, el resultado se puede mostrar con el evento relacionado que ha activado la tarea. La tarea tambin se puede configurar de modo que guarde el resultado en un archivo de registro. En el caso de las tareas de base de reglas, el resultado se puede mostrar en la consola, y tambin se almacena en la base de datos.
Captulo 2. Tareas
145
Change_Severity
Cambia la gravedad de un evento. La gravedad se cambia en el visor de eventos, en la cach de eventos y en el repositorio de eventos. Esta tarea presupone que el comando wsetemsg est disponible en el host en el que se ejecuta la tarea. El comando wsetemsg siempre est disponible en el host del servidor de eventos. Adems, el servidor de eventos debe estar en ejecucin para que esta tarea se ejecute correctamente.
Autorizacin
super, senior, admin, user
Opciones de configuracin del dilogo

Gravedad Nueva gravedad del evento. Los valores vlidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) o Desconocido (UNKNOWN).
Sinopsis del comando

Esta tarea no se puede ejecutar desde la lnea de comandos.
146
Clean_Database
Suprime los eventos antiguos de la base de datos de eventos. Los eventos se suprimen del registro de recepcin segn el valor del campo Duracin de la informacin del registro de recepcin de eventos en el dilogo Parmetros de servidor de eventos del servidor de eventos. Los eventos cerrados del repositorio de eventos que sean anteriores al valor indicado en el campo Duracin de eventos cerrados en la memoria cach del dilogo Parmetros de servidor de eventos se suprimen. Esta tarea presupone que el comando wtdbclear est disponible en el host en el que se ejecuta la tarea. El comando wtdbclear siempre est disponible en el host del servidor de eventos. Si se produce un problema mientras el comando wtdbclear se est ejecutando, se emite un mensaje explicativo y el script finaliza inmediatamente con un cdigo de retorno. La base de datos de eventos debe estar disponible. No es necesario que el servidor de eventos est en ejecucin. Nota: despus de ejecutar esta tarea, los eventos antiguos suprimidos del repositorio de eventos no se eliminan de una consola de eventos hasta que se cierre y se vuelva a abrir. Los eventos antiguos en la cach de eventos no se eliminan hasta que el servidor de eventos se detiene y se vuelve a iniciar, o bien hasta que los eventos antiguos alcanzan su valor de tiempo de espera.
Autorizacin
RIM_update, RIM_view, super, senior, admin, user

No hay opciones para esta tarea. Los parmetros se obtienen de los campos mencionados en la descripcin de la tarea.

wruntask t Clean_Database l "T/EC Tasks" h nodo
Argumentos del comando

t Clean_Database Tarea que se ejecutar. l "T/EC Tasks" Biblioteca de tareas. h nodo Nodo gestionado en el que se ejecutar la tarea.
Ejemplo del comando

wruntask -t Clean_Database -l "T/EC Tasks" \ -h orange
Captulo 2. Tareas
147
Clear_Closed_Events
Suprime los eventos cerrados del repositorio de eventos, utilizando la antigedad proporcionada por el usuario. Esta tarea presupone que el comando wtdbclear est disponible en el host en el que se ejecuta la tarea. El comando wtdbclear siempre est disponible en el host del servidor de eventos. La base de datos de eventos debe estar disponible. No es necesario que el servidor de eventos est en ejecucin.
Autorizacin

Segundos Antigedad, en segundos, tras la cual los eventos se suprimen. Por ejemplo, el valor 60 especifica que se suprimirn los eventos cerrados de ms de 60 segundos de antigedad.

wruntask t Clear_Closed_Events l "T/EC Tasks" h nodo a segundos

a segundos h nodo l "T/EC Tasks" Biblioteca de tareas. t Clear_Closed_Events Tarea que se ejecutar. Antigedad inicial, en segundos, de los eventos que se suprimirn. Nodo gestionado en el que se ejecutar la tarea.
Ejemplo del comando

wruntask -t Clear_Closed_Events -l "T/EC Tasks" \ -h orange -a 6000
148
Clear_Reception_Log
Suprime los eventos del registro de recepcin recibidos hace ms de 30 segundos. Esta tarea presupone que el comando wtdbclear est disponible en el host en el que se ejecuta la tarea. El comando wtdbclear siempre est disponible en el host del servidor de eventos. La base de datos de eventos debe estar disponible. No es necesario que el servidor de eventos est en ejecucin.
Autorizacin

No hay opciones para esta tarea.

wruntask t Clear_Reception_Log l "T/EC Tasks" h nodo

h nodo l "T/EC Tasks" Biblioteca de tareas. t Clear_Reception_Log Tarea que se ejecutar. Nodo gestionado en el que se ejecutar la tarea.
Ejemplo del comando

wruntask -t Clear_Reception_Log -l "T/EC Tasks" \ -h orange
Captulo 2. Tareas
149
Close_Event
Cambia el estado de un evento seleccionado a Cerrado (CLOSED). El estado se cambia en la consola de eventos, en la cach de eventos y en el repositorio de eventos. Esta tarea presupone que el comando wsetemsg est disponible en el host en el que se ejecuta la tarea. El comando wsetemsg siempre est disponible en el host del servidor de eventos. Adems, el servidor de eventos debe estar en ejecucin para que esta tarea se ejecute correctamente.
Autorizacin

No hay opciones para esta tarea.

150
Dump_Event_Repository
Muestra los detalles de los eventos del repositorio de eventos en el dilogo de salida de la tarea. Esta tarea presupone que el comando wtdumper est disponible en el host en el que se ejecuta la tarea. El comando wtdumper siempre est disponible en el host del servidor de eventos. La base de datos de eventos debe estar disponible. No es necesario que el servidor de eventos est en ejecucin.
Autorizacin
RIM_view, super, senior, admin, user

Orden ascendente o descendente? Orden en que se listarn los eventos en la salida. Las opciones posibles son: ASC Lista en primer lugar la entrada ms antigua del repositorio de eventos.
DESC Lista en primer lugar la entrada ms reciente del repositorio de eventos. Nmero de eventos Nmero mximo de eventos que se mostrarn en la salida. Si el nmero de eventos del repositorio de eventos supera el valor especificado, se omitirn las entradas a partir del final de la salida. Por ejemplo, si la salida se visualiza en orden ascendente, las entradas ms recientes de la base de datos no se mostrarn.

wruntask t Dump_Event_Repository l "T/EC Tasks" h nodo a orden_clasificacin a nmero_eventos

a nmero_eventos Nmero mximo de eventos que se mostrarn en la salida. Si el nmero de eventos de la base de datos supera el valor especificado, se omitirn las entradas a partir del final de la salida. Por ejemplo, si la salida se visualiza en orden ascendente, las entradas ms recientes de la base de datos no se mostrarn. a orden_clasificacin Orden en que se listarn los eventos en la salida. Los valores vlidos son: ASC Lista en primer lugar la entrada ms antigua del repositorio de eventos.
DESC Lista en primer lugar la entrada ms reciente del repositorio de eventos. h nodo Nodo gestionado en el que se ejecutar la tarea.
Captulo 2. Tareas
151
l "T/EC Tasks" Biblioteca de tareas. t Dump_Event_Repository Tarea que se ejecutar.
Ejemplo del comando

wruntask -t Dump_Event_Repository -l "T/EC Tasks" \ -h orange -a ASC -a 10
152
Event_Query
Realiza una consulta en el repositorio de eventos. El resultado se muestra en el dilogo de salida de la tarea. Esta tarea presupone que el comando wtdumper est disponible en el host en el que se ejecuta la tarea. El comando wtdumper siempre est disponible en el host del servidor de eventos. La base de datos de eventos debe estar disponible. No es necesario que el servidor de eventos est en ejecucin.
Autorizacin

Para las opciones de tipo de coincidencia siguientes (Emparejar clase a Emparejar mensaje), las selecciones que realice indicarn qu atributos y valores se utilizarn para los criterios de seleccin de la consulta. Con todas las opciones puede especificar texto de forma manual, incluido el carcter comodn asterisco (*), para especificar todos los valores de un atributo. Si especifica manualmente varios valores para una opcin, seprelos con comas. Algunas de las opciones tambin disponen de un pulsador para mostrar una lista desplegable en la que se pueden seleccionar uno o varios valores. Emparejar clase Clases de eventos. Emparejar estado Estado de los eventos. Los nombres de estados vlidos son: Abierto (OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado (CLOSED). Emparejar gravedad Niveles de gravedad de los eventos. Los valores vlidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Emparejar nombre de host Nombres de los sistemas en los que se han producido los eventos. Emparejar fuente Fuentes de los eventos (por ejemplo, LOGFILE es el nombre de fuente para el adaptador del archivo de registro de UNIX). Las fuentes las definen los tipos de adaptador. Emparejar subfuente Especificacin ms detallada de las fuentes. Emparejar origen Direcciones de protocolo o nombres de host de los sistemas fuente. Emparejar suborigen Especificacin ms detallada de los orgenes. Emparejar mensaje Una o varias cadenas de texto de mensaje de los eventos. Si especifica ms de un mensaje, especifique el valor completo de la opcin Emparejar mensaje con algn tipo de comillas (por
Captulo 2. Tareas
153
ejemplo, comillas simples) y especifique los mensajes con otro tipo de comillas distintas (por ejemplo, comillas simples) separados por comas. Por ejemplo: "texto msj1,texto msj2". Para especificar todos los mensajes, utilice el carcter comodn *. Fecha y hora de inicio Especifica la consulta de los eventos recibidos desde el momento indicado hasta el momento actual. Para especificar un punto inicial, utilice el formato siguiente: mesddhh:mm:ssaaaa. Por ejemplo, Ene 01 00:01:01 2000. Para consultar todos los eventos, especifique el carcter comodn *. Orden de clasificacin Orden en que se listarn los resultados de la consulta en la salida. Los valores vlidos son: ASC Lista en primer lugar el evento ms antiguo.
DESC Lista en primer lugar el evento ms reciente. Mostrar valores para atributos Especifica qu atributos de eventos base se mostrarn en la salida. Haga clic en Atributos para obtener una lista desplegable de los atributos de eventos base y realizar una seleccin. Todos los atributos de eventos no base se visualizan siempre. Si no selecciona ningn atributo, en la salida se mostrarn todos (base y no base).

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 {"'msj'[,'msj'...]" | "*"} a {"punto_inicial" | "*"} a orden_clasificacin a {"atributo[,atributo...]" | "*"]

a "clase..." Uno o varios nombres de clase de evento. Si se especifica ms de una clase por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todas las clases de evento, utilice el carcter comodn *. Para obtener informacin adicional acerca de los nombres de clases de evento, consulte la publicacin Tivoli Enterprise Console Adapters Guide o los archivos BAROC de los adaptadores que generan los eventos. Uno o varios nombres de estado de evento. Si se especifica ms de un estado por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los nombres de estado de evento, utilice el carcter comodn *. Los nombres de estados vlidos son: Abierto (OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado (CLOSED).
a "estado..."
154
a "gravedad..." Uno o varios nombres de gravedad de evento. Si se especifica ms de una gravedad por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los nombres de gravedad de evento, utilice el carcter comodn *. Los nombres de gravedad vlidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). a "nombre_host..." Uno o varios nombres de los sistemas en los que se han producido los eventos. Si se especifica ms de un host por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los nombres de host, utilice el carcter comodn *. a "fuente..." Una o varias fuentes de los eventos (por ejemplo, LOGFILE es el nombre de fuente para el adaptador del archivo de registro de UNIX). Las fuentes las definen los tipos de adaptador. Si se especifica ms de una fuente por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todas las fuentes, utilice el carcter comodn *. Una o varias subfuentes de los eventos. Una subfuente es una especificacin ms detallada de una fuente. Si se especifica ms de una subfuente por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todas las subfuentes, utilice el carcter comodn *. a "origen..." Una o varias direcciones de protocolo o nombres de host de los sistemas fuente. Si se especifica ms de un origen por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los orgenes, utilice el carcter comodn *. Uno o varios suborgenes de los eventos. Un suborigen es una especificacin ms detallada de un origen. Si se especifica ms de un suborigen por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los suborgenes, utilice el carcter comodn *. a "'msj...'" Una o varias cadenas de texto de mensaje de los eventos. Especifique cada mensaje con un tipo de comillas distintas de las utilizadas para especificar el valor completo del argumento a; es decir, si el valor del argumento se especifica entre comillas dobles (como se muestra en la sinopsis), utilice comillas simples para los mensajes. Por ejemplo, -a "texto msj1,texto msj2". Para especificar todos los mensajes, utilice el carcter comodn *.
a "subfuente..."
a "suborigen..."
a "punto_inicial" Especifica la consulta de los eventos recibidos desde el momento indicado hasta el momento actual. Para especificar un punto inicial, utilice el formato siguiente: mesddhh:mm:ssaaaa. Por ejemplo, Ene 01 00:01:01 2000. Para consultar todos los eventos, utilice el carcter comodn *. a "orden_clasificacin" Orden en que se listarn los resultados de la consulta en la salida. Los valores vlidos son:
Captulo 2. Tareas
155
ASC
Lista en primer lugar el evento ms antiguo.
DESC Lista en primer lugar el evento ms reciente. h nodo a "atributo..." Nodo gestionado en el que se ejecutar la tarea. Especifica uno o varios atributos de eventos base que se mostrarn en la salida. Todos los atributos de eventos no base se visualizan siempre. Si se especifica ms de un atributo por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los atributos, utilice el carcter comodn *. Biblioteca de tareas. t Event_Query Tarea que se ejecutar.
l "T/EC Tasks"
Ejemplo del comando

wruntask -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"
156
Find_Similar_Events
Realiza una consulta en el repositorio de eventos utilizando un evento para comparar atributos. El resultado se muestra en el dilogo de salida de la tarea. Debe seleccionar el evento en el visor de eventos antes de configurar esta tarea. Esta tarea presupone que el comando wtdumper est disponible en el host en el que se ejecuta la tarea. El comando wtdumper siempre est disponible en el host del servidor de eventos. La base de datos de eventos debe estar disponible. Adems, el servidor de eventos debe estar en ejecucin para que esta tarea se ejecute correctamente.
Autorizacin

Para las opciones de tipo de coincidencia siguientes (Emparejar clase a Emparejar mensaje), al marcar el botn de seleccin S se especifica el uso del atributo del evento seleccionado para las comparaciones con los mismo atributos de eventos en la base de datos. Si se marca el botn de seleccin No, se indica que no se utilizar el atributo del evento especificado para las comparaciones. Emparejar clase Clase del evento. Emparejar estado Estado del evento. Los nombres de estados vlidos son: Abierto (OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado (CLOSED). Emparejar gravedad Gravedad del evento. Los valores vlidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Emparejar nombre de host Nombre del sistema en el que se produjo el evento. Emparejar fuente Fuente del evento. Emparejar subfuente Especificacin ms detallada de la fuente. Emparejar origen Direccin de protocolo o nombre de host del sistema fuente. Emparejar suborigen Especificacin ms detallada del origen. Emparejar mensaje Texto del mensaje del evento. Fecha y hora de inicio Especifica la consulta de los eventos recibidos desde el momento indicado hasta el momento actual. Para especificar un punto inicial, utilice el formato siguiente: mesddhh:mm:ssaaaa. Por ejemplo, Ene 01 00:01:01 2000. Para consultar todos los eventos, especifique un asterisco (*).
Captulo 2. Tareas
157
Orden de clasificacin Orden en que se listarn los resultados de la consulta en la salida. Los valores vlidos son: Ascendente Lista en primer lugar el evento ms antiguo. Descendente Lista en primer lugar el evento ms reciente. Mostrar valores para atributos Especifica qu atributos de eventos base se mostrarn en la salida. Haga clic en Atributos para obtener una lista desplegable de los atributos de eventos base y realizar una seleccin. Todos los atributos de eventos no base se visualizan siempre. Si no selecciona ningn atributo, en la salida se mostrarn todos.

158
Forward_Event
Reenva un evento a otro servidor de eventos registrado en la regin de gestin de Tivoli actual. Esta tarea presupone que el comando wpostemsg est disponible en el host en el que se ejecuta la tarea. El comando wpostemsg siempre est disponible en el host del servidor de eventos.
Autorizacin

Nombre del servidor de eventos Servidor de eventos que recibe el evento reenviado. Puede escribir un nombre o bien puede seleccionar el nombre en una lista desplegable de servidores de eventos conocidos haciendo clic en Elegir. El servidor de eventos local se denomina EventServer. Para indicar un servidor de eventos remoto, especifique EventServer#tmr, siendo tmr el nombre de la regin de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orange-region.

Captulo 2. Tareas
159
Log_Event_To_File
Graba en un archivo los detalles acerca de un evento.
Autorizacin
super, senior, admin

Nombre de archivo de registro Escriba la ruta y el nombre del archivo en el que se grabar la informacin sobre el evento. Puede escribir una ruta y un nombre de archivo o bien puede hacer clic en Nombre de archivo de registro para mostrar un dilogo para buscar un archivo.

160
Popup_Message
Muestra un mensaje en el escritorio de Tivoli de un operador. Esta tarea presupone que el comando wsendresp est disponible en el host en el que se ejecuta la tarea. El comando wsendresp siempre est disponible en el host del servidor de eventos. Adems, el visor de eventos que recibe el mensaje debe estar en ejecucin para que esta tarea se ejecute correctamente.
Autorizacin

Nombre de operador Nombre del operador que recibe el mensaje. Puede escribir este valor o hacer clic en Operador para ver una lista desplegable de operadores conocidos. Nombre de archivo Ruta y nombre del archivo que contendr el texto del mensaje que se visualizar. Puede escribir la ruta y el nombre de archivo manualmente. Nodo gestionado Nodo gestionado en el que se ejecutar la tarea.

wruntask t Popup_Message l "T/EC Tasks" h nodo a administrador a ruta

a administrador Nombre de la consola de eventos del administrador de Tivoli que recibe el mensaje. a ruta Ruta y nombre del archivo que contendr el texto del mensaje que se visualizar. Si el archivo est en un host remoto, para especificarlo utilice el formato nombre_host:ruta; por ejemplo, red:/tmp/msg.txt. Nodo gestionado en el que se ejecutar la tarea. Biblioteca de tareas. t Popup_Message Tarea que se ejecutar.
h nodo l "T/EC Tasks"
Ejemplo del comando

wruntask -t Popup_Message -l "T/EC Tasks" \ -h orange -a Root_orange-region \ -a /tmp/msg.txt
Captulo 2. Tareas
161
Send_Email
Enva en un mensaje de correo electrnico los detalles acerca de un evento. Se puede ejecutar desde el visor de eventos o desde una regla. Esta tarea presupone que el comando sendmail est disponible en los hosts UNIX y Linux, y que el programa $BINDIR/bin/smtp_client.exe est disponible en los hosts Windows NT. Para poder ejecutar esta tarea, debe definirse un servidor de correo SMTP con el comando wmailhost. Para obtener ms informacin acerca del comando wmailhost, consulte la publicacin Tivoli Management Framework Reference Manual.
Autorizacin

Nombre del administrador Nombre de la persona que recibe el mensaje. El nombre se muestra en el campo Para: del mensaje de correo electrnico. Direccin de correo electrnico del administrador ID de correo electrnico de la persona que recibe el mensaje.

162
Send_Event
Crea un nuevo evento y lo enva al servidor de eventos especificado de la regin de Tivoli actual. Esta tarea presupone que el comando wpostemsg est disponible en el host en el que se ejecuta la tarea. El comando wpostemsg siempre est disponible en el host del servidor de eventos y en los puntos finales que tengan instalado un adaptador de eventos.
Autorizacin

Las nicas opciones que requieren valores son Nombre de clase y Fuente. Las dems son opcionales. Aunque las deje en blanco, el proceso del servidor de eventos asigna valores predeterminados. Nombre del servidor de eventos Servidor de eventos que recibe el evento. Puede escribir un nombre o bien puede seleccionar el nombre en una lista desplegable de servidores de eventos conocidos haciendo clic en Elegir. El servidor de eventos local se denomina EventServer. Para indicar un servidor de eventos remoto, especifique EventServer#tmr, siendo tmr el nombre de la regin de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orangeregion. Si no se especifica ningn valor para esta opcin, se utiliza el valor predeterminado EventServer. mensaje Texto del mensaje del evento.
nombre de host Nombre del sistema en el que se produjo el evento. origen gravedad Direccin de protocolo o nombre de host del sistema fuente. Gravedad del evento. Los niveles de gravedad vlidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Especificacin ms detallada del origen. Especificacin ms detallada de la fuente.
suborigen subfuente
Nombre de clase Clase del evento. Esta opcin requiere un valor. Para obtener informacin adicional acerca de los nombres de clase de evento, consulte la publicacin IBM Tivoli Enterprise Console Adapters Guide o el archivo BAROC de un adaptador determinado. Fuente Fuente del evento (por ejemplo, LOGFILE es el nombre de fuente para el adaptador del archivo de registro de UNIX). La fuente la definen los tipos de adaptador. Esta opcin requiere un valor.

Los nicos argumentos que requieren un valor son a clase_evento y a fuente. La especificacin de valores para los dems argumentos es opcional. Es decir, no es necesario especificar valores para esos argumentos, pero s debe especificar el
Captulo 2. Tareas
163
indicador de los mismos con un contenedor vaco; por ejemplo, a "". Opcionalmente, puede sustituir las comillas simples por comillas dobles como se muestra. wruntask t Send_Event l "T/EC Tasks" h nodo a {servidor_eventos | ""} a {msj | ""} a {nombre_host | ""} a {origen | ""} a {gravedad | ""} a {suborigen | ""} a {subfuente | ""} a clase_evento a fuente

a servidor_eventos Servidor de eventos que recibe el evento. El servidor de eventos local se denomina EventServer. Para indicar un servidor de eventos remoto, especifique EventServer#tmr, siendo tmr el nombre de la regin de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orange-region. Si no se especifica ningn servidor de eventos pare argumento, se utiliza el valor predeterminado EventServer. amsj anombre_host aorigen agravedad Texto del mensaje del evento. Si el mensaje contiene espacios en blanco, especifquelo entre comillas. Nombre del sistema en el que se produjo el evento. Direccin de protocolo o nombre de host del sistema fuente. Nivel de gravedad del evento. Los niveles de gravedad vlidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Suborigen del evento. Un suborigen es una especificacin ms detallada de un origen. Subfuente del evento. Una subfuente es una especificacin ms detallada de una fuente. Nombre de ka clase de evento. Este argumento requiere un valor. Para obtener informacin adicional acerca de los nombres de clase de evento, consulte la publicacin IBM Tivoli Enterprise Console Adapters Guide o el archivo BAROC de un adaptador determinado. Fuente del evento (por ejemplo, LOGFILE es el nombre de fuente para el adaptador del archivo de registro de UNIX). Las fuentes las definen los tipos de adaptador. Este argumento requiere un valor. Nodo gestionado en el que se ejecutar la tarea. Biblioteca de tareas. t Send_Event Tarea que se ejecutar.
asuborigen asubfuente aclase
afuente
h nodo l "T/EC Tasks"
164
Ejemplo del comando

wruntask -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
Captulo 2. Tareas
165
Start_Maintenance
Informa al servidor de eventos de todos los intervalos de mantenimiento en curso o planificados para ms adelante correspondientes a un host o a todos los hosts. La salida de esta tarea es la misma que la salida del comando wstartmaint.sh. Esta tarea presupone que el comando wpostemsg est disponible en el host en el que se ejecuta la tarea. El comando wpostemsg siempre est disponible en el host del servidor de eventos y en los puntos finales que tengan instalado un adaptador de eventos.
Autorizacin

Las nicas opciones que requieren valores son Nombre de host y Duracin del mantenimiento. Las dems son opcionales. Si las deja en blanco, el proceso del servidor de eventos asigna valores predeterminados. Nombre del servidor de eventos Servidor de eventos que recibe el evento. Puede escribir un nombre o bien puede seleccionar el nombre en una lista desplegable de servidores de eventos conocidos haciendo clic en Elegir. El servidor de eventos local se denomina EventServer. Para indicar un servidor de eventos remoto, especifique EventServer#tmr, siendo tmr el nombre de la regin de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orange-region. Si no se especifica ningn valor para esta opcin, se utiliza el valor predeterminado EventServer. nombre de host Nombre totalmente calificado del sistema que est o estar en modo de mantenimiento. El valor "*" indica que todos los hosts gestionados de la red entrarn en modalidad de mantenimiento y, por consiguiente, todos los eventos de estos hosts se descartarn o se cerrarn. Esta opcin requiere un valor. Informacin del propietario del mantenimiento Toda la informacin de contacto correspondiente a la persona que ha iniciado el modo de mantenimiento en el host, como la direccin de correo electrnico o el nmero de telfono. Duracin del mantenimiento (minutos) Tiempo que durar el mantenimiento en minutos. El valor predeterminado es 60 minutos. Esta opcin requiere un valor. Hora de inicio del mantenimiento (aaaa mm dd hh mm ss) Hora a la que se iniciar el mantenimiento del host. Si no se especifica un valor, el valor predeterminado es la hora actual del sistema. En el caso de un intervalo de mantenimiento planificado para ms adelante, la hora debe especificarse en el formato AAAA MM DD HH MIN SS, siendo AAAA los cuatro dgitos del ao, MM el mes (1 a 12), DD el da (1 a 31), HH la hora (00 a 23), MIN los minutos (00 a 59) y SS los segundos (00 a 59).

wruntask t Start_Maintenance l "T/EC Tasks" h nodo a {servidor_eventos | ""}
166
a a a a
nombre_host {info_propietario | ""} duracin {hora_inicio | ""}
Los nicos argumentos que requieren un valor son a nombre_host y a duracin. La especificacin de valores para los dems argumentos es opcional. Es decir, no es necesario especificar valores para esos argumentos, pero s debe especificar el indicador de los mismos con un contenedor vaco; por ejemplo: -a "" Nota: opcionalmente, puede sustituir las comillas simples por comillas dobles. Si va a especificar la hora en la que se iniciar el mantenimiento, especifique los valores entre comillas dobles; por ejemplo, -a "2003 10 10 10 10 10"

a servidor_eventos Servidor de eventos que recibe el evento. El servidor de eventos local se denomina EventServer. Para indicar un servidor de eventos remoto, especifique EventServer#tmr, siendo tmr el nombre de la regin de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orangeregion. Si no se especifica ningn valor para esta opcin, se utiliza el valor predeterminado EventServer. a nombre_host Nombre totalmente calificado del sistema que est o estar en modo de mantenimiento. El valor "*" indica que todos los hosts gestionados de la red entrarn en modalidad de mantenimiento y, por consiguiente, todos los eventos de estos hosts se descartarn o se cerrarn. a info_propietario Toda la informacin de contacto correspondiente a la persona que ha iniciado el modo de mantenimiento en el host, como la direccin de correo electrnico o el nmero de telfono. a duracin Tiempo que durar el mantenimiento en minutos. El valor predeterminado es 60 minutos. a hora_inicio Hora a la que se iniciar el mantenimiento del host. Si no se especifica un valor, el valor predeterminado es la hora actual del sistema. En el caso de un intervalo de mantenimiento planificado para ms adelante, la hora debe especificarse en el formato AAAA MM DD HH MIN SS, siendo AAAA los cuatro dgitos del ao, MM el mes (1 a 12), DD el da (1 a 31), HH la hora (00 a 23), MIN los minutos (00 a 59) y SS los segundos (00 a 59). h nodo Nodo gestionado en el que se ejecutar la tarea. l "T/EC Tasks" Biblioteca de tareas. t Start_Maintenance Tarea que se ejecutar.
Captulo 2. Tareas
167
Ejemplo del comando

wruntask -t Start_Maintenance -l "T/EC Tasks" -h orange -a EventServer \ -a myhost.mynet.com -a "my_info" -a 30 -a "2003 10 10 10 15 59"
168
Wake_Up_Netscape
Muestra una pgina web en una ventana nueva del navegador Netscape. Esta tarea presupone que ya hay un proceso de navegador Netscape en ejecucin en el host en el que se ejecuta la tarea.
Autorizacin

URL a visualizar URL (localizador uniforme de recursos) de la pgina web que se visualiza. Ruta de Netscape Ruta predeterminada del directorio en el que se ha instalado Netscape en el host en el que se ejecuta la tarea. El valor predeterminado es /usr/local/bin. Nota: en Windows NT, la variable de entorno PATH debe incluir el directorio en el que Netscape se ha instalado. En UNIX, si Netscape no se ha instalado en el directorio /usr/local/bin, la variable PATH debe incluir el directorio en el que Netscape se ha instalado.

wruntask t Wake_Up_Netscape l "T/EC Tasks" h nodo a url Nota: si el host est configurado como punto final y como nodo gestionado, y desea que esta tarea se ejecute en el entorno de nodo gestionado, debe utilizar la sintaxis @ManagedNode. Para obtener ms informacin, consulte la publicacin Tivoli Management Framework Reference Manual.

a url h nodo URL de la pgina web que se visualiza. Nodo gestionado en el que se ejecutar la tarea.
l T/EC Tasks Biblioteca de tareas. t Wake_Up_Netscape Tarea que se ejecutar.
Ejemplo del comando

wruntask -t Wake_Up_Netscape -l "T/EC Tasks" \ -h orange -a http://www.tivoli.com
Captulo 2. Tareas
169
170
Captulo 3. Variables de entorno disponibles para las tareas

En este captulo se describen las variables de entorno disponibles para los programas de Tivoli Enterprise Console y las tareas que se ejecutan con eventos. Puede especificar restricciones en los valores de los atributos para las tareas que se ejecutan con eventos.
Descripciones de las variables

En la tabla siguiente se describen las variables de entorno disponibles para los programas, las tareas de consola y las tareas automticas que se ejecutan con un evento. Est organizada como se indica a continuacin: Nombre Descripcin Nombre de la variable de entorno. Breve descripcin de la variable de entorno.
Disponible para Una X en cualquiera de las cuatro subcolumnas existentes bajo esta columna significa que la variable de entorno est disponible para las tareas de consola, los programas de consola, las tareas de base de reglas o los programas de base de reglas. Las variables de entorno que representan los atributos de eventos figuran despus de las variables de entorno generales, en el apartado de la tabla titulado Atributos de evento. Ambas secciones de la tabla estn ordenadas alfabticamente.
Disponible para Programas de base de reglas Tareas de base de reglas X X
Nombre CHILD_OF_OSERV
Descripcin Indica al proceso hijo que es hijo del proceso oserv y permite al proceso hijo tomar las dos rutas siguientes: v No necesita volver a efectuar una autenticacin con el proceso oserv porque ste cre credenciales cuando cre el proceso hijo. v No necesita iniciar una nueva conexin con el proceso oserv porque ste cre un par de sockets o un par de pipes para comunicarse con el proceso hijo cuando cre dicho proceso hijo.
CONSOLE_NAME DISPLAY ENDPOINT
Nombre de la consola de eventos desde la que se ha llamado a la tarea. Variable de UNIX que controla la visualizacin del servidor X. Nodo en el que se ejecuta la tarea.
X X X
Programas de consola
Tareas de consola
171
Disponible para Programas de base de reglas X X X X X X X X X X X X X X X X X X X Tareas de base de reglas X X X X X X X X X X X X X X X X X X
Nombre ENDPOINT_OID EVENT_CLASS INTERP LANG LD_LIBRARY_PATH LIBPATH NLSPATH PATH SHLIB_PATH SLOTS TEC_ADMIN
Descripcin Identificador del objeto que indica donde se ejecuta la tarea. Clase de evento pasado al predicado exec_task. Tipo de arquitectura del sistema en el que el nodo est instalado. Identificador del entorno local. Ruta de las bibliotecas compartidas en los intrpretes solaris2 y sunos4. Ruta de las bibliotecas compartidas en un sistema AIX. Ruta del directorio utilizado por las aplicaciones para determinar el idioma. Ruta para la bsqueda de archivos. Ruta de las bibliotecas compartidas en OpenView. Atributos del evento asociado con la tarea. Nombre del administrador de Tivoli Enterprise Console definido en el entorno Tivoli. Directorio en el que est instalado el producto Tivoli Enterprise Console. Indica si se ha activado el parmetro de configuracin tec_exectask_dbcs. Si TEC_EXECTASK_DBCS tiene el valor TRUE, significa que tec_exectask_dbcs tiene el valor true en el archivo .tec_config y que los parmetros de ranura se han convertido al conjunto de cdigos local antes de ejecutar la tarea. Si no se establece TEC_EXECTASK_DBCS, tec_exectask_dbcs tampoco se establece (o se establece con el valor false) en el archivo .tec_config y los parmetros de ranura no se convierten al conjunto de cdigos local antes de ejecutar la tarea. Ubicacin de la base de reglas cargada dentro del directorio $DBDIR. Puerto que el proceso tec_server utiliza para las comunicaciones. Nmero de segundos para la inicializacin del servidor de eventos.
TEC_BIN_DIR TEC_EXECTASK_DBCS
TEC_KB_DIR TEC_MASTER_PORT TEC_MASTER_START_ TIMEOUT
172
Programas de consola
Tareas de consola
Disponible para Programas de base de reglas X X X X X X X X X X X X X X X X X Tareas de base de reglas X X X X X X X X X X X X X X X X X X X X
Nombre TEC_RECV_BUFSIZE
Descripcin Nmero mximo de eventos que se colocan en el bfer de memoria en el servidor de eventos. Indica que se registrar la recepcin de eventos en el servidor de eventos. Frecuencia, en segundos, con la que los eventos cuyo tiempo ha pasado se borran de la cach de reglas. Tiempo, en segundos, que los eventos cerrados permanecen en la cach de reglas. Tiempo, en segundos, que los eventos no cerrados permanecen en la cach de reglas. Nmero mximo de eventos almacenados en la cach de eventos. Indica si el proceso de las reglas genera informacin de seguimiento. Archivo que contiene la informacin de seguimiento de las reglas Directorio de los archivos pertenecientes a la internacionalizacin de Tivoli. Huso horario. Nombre del nodo tal como se le conoce en el entorno Tivoli. Atributos de evento
TEC_RECV_LOG TEC_RULE_CACHE_ CLEAN_FREQ TEC_RULE_CACHE_ FULL_HISTORY TEC_RULE_CACHE_ NON_CLOSED_HISTORY TEC_RULE_CACHE_ SIZE TEC_RULE_TRACE TEC_RULE_TRACE_ FILE TISDIR TZ WLOCALHOST
acl
Lista de las funciones de grupo de eventos que permiten a un operador modificar el evento. Host en el que se ejecuta el adaptador. Operador que confirm o cerr el evento. El atributo cause_date_reception se utiliza para enlazar un evento de efecto con el evento de causa. Este valor se establece con el valor del atributo date_reception del evento de causa. Se utiliza para enlazar un evento de efecto con un evento de causa y contiene el valor del atributo event_handle del evento de causa. Nombre de clase de evento. Nombre de clase de evento.
adapter_host administrator cause_date_reception
X X X
cause_event_handle
class class_name
X X
Programas de consola X X X X X X
Tareas de consola
173
Disponible para Programas de base de reglas X X X X X X X X Tareas de base de reglas X X X X X X X X X X X X
Nombre credibility
Descripcin Indica cmo se envi el evento desde el adaptador. El valor es 1 si se envi un evento a travs de un canal de comunicaciones proporcionado por los servicios de Tivoli Management Framework o un adaptador TME. El valor es 0 si se envi un evento desde un adaptador no TME. Fecha y hora en la que se gener el evento. Fecha y hora en la que se gener el evento. Indicacin de la hora que indica la hora a la que el servidor de eventos recibi el evento. Es un nmero entero que indica los segundos transcurridos desde el estndar epoch, que corresponde al 1 de enero de 1970. Este valor tambin se utiliza como componente para identificar un evento de forma exclusiva. Un evento se identifica de forma exclusiva mediante la combinacin de los valores de los atributos date_reception, event_handle y server_handle. Para los eventos cerrados, antigedad (en segundos) del evento desde que el servidor de eventos lo recibi hasta que se cerr. Para los eventos no cerrados, este valor es 0. Identificador de evento que se compone de los valores de los atributos event_handle, server_handle y date_reception. Nmero utilizado para hacer referencia al evento. Este nmero lo asigna el servidor de eventos. Nmero utilizado para hacer referencia al evento. Este nmero lo asigna el servidor de eventos. Nombre del sistema en el que se produjo el evento. Momento en el que se modific el evento por ltima vez. Texto de resumen del evento. Para el soporte de los mensajes de eventos internacionalizados en el futuro; actualmente no est implementado.
date date_event date_reception
duration
ev_key
event_handle
event_hndl
hostname last_modified_time msg msg_catalog
X X X X
174
Programas de consola X X X X X X X X
Tareas de consola
Disponible para Programas de base de reglas X X X X X X X X Tareas de base de reglas X X X X X X X X X X
Nombre msg_index num_actions
Descripcin ID de mensaje utilizado para obtener el mensaje internacionalizado. Nmero de acciones (tareas o programas) que el servidor de eventos est controlando para este evento. Nmero de puerto utilizado por el proceso oserv. Direccin de protocolo o nombre de host del sistema fuente. Contador para realizar un seguimiento del nmero de veces que se recibe un tipo de evento duplicado. Nmero que identifica el servidor de eventos que ha recibido este evento. Un evento se identifica de forma exclusiva mediante la combinacin de los valores de los atributos date_reception, event_handle y server_handle. Nmero que identifica el servidor de eventos que ha recibido este evento. Un evento se identifica de forma exclusiva mediante la combinacin de los valores de los atributos date_reception, event_handle y server_handle. Almacena informacin que describe los motores de reglas que ha pasado un evento. Gravedad del evento. La base de datos almacena la gravedad en forma de nmero. Esta asignacin se define en el archivo de base de reglas root.baroc y se establece para los niveles de gravedad predeterminadas del servidor de eventos como se indica a continuacin: 10 UNKNOWN (Desconocido) 20 HARMLESS (Inocuo) 30 WARNING (Aviso) 40 MINOR (Leve) 50 CRITICAL (Grave) 60 FATAL (Muy grave)
X X
o_dispatch origin repeat_count
X X X
server_handle
server_hndl
server_path
severity
Programas de consola X X X X X X
Tareas de consola
175
Disponible para Programas de base de reglas X X X X Tareas de base de reglas X X X X
Nombre source
Descripcin Fuente del evento (por ejemplo, el adaptador OpenView). La fuente la definen los tipos de adaptador. Estado del evento. Especificacin ms detallada del origen. Este atributo es opcional. Especificacin ms detallada de la fuente. Este atributo es opcional.
status sub_origin sub_source
X X X
Ejemplos
En este apartado se muestran ejemplos de vuelcos de variables de entorno para una tarea automtica emitida desde una regla de Tivoli Enterprise Console y una tarea de consola ejecutada desde la consola de eventos. Puede haber saltos de lnea en los valores de las variables debido a las limitaciones de espacio de la pgina.
Vuelco de variables de entorno al ejecutar una tarea desde una regla

El ejemplo siguiente muestra un vuelco de las variables de entorno cuando se ejecuta una tarea 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_Error INTERP=solaris2 LANG=C LD_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/ucblib NLSPATH=/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.cat PATH=/data/TMP3.6/bin/solaris2/bin:/bin:/usr/bin SLOTS=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_path TEC_BIN_DIR=/data/TMP3.6/bin/solaris2/TME/TEC TEC_KB_DIR=tec/rb_dir TEC_MASTER_PORT=50561 TEC_MASTER_START_TIMEOUT=300 TEC_RECV_BUFSIZE=500 TEC_RECV_LOG=YES TEC_RULE_CACHE_CLEAN_FREQ=3600 TEC_RULE_CACHE_FULL_HISTORY=86400 TEC_RULE_CACHE_NON_CLOSED_HISTORY=15552000 TEC_RULE_CACHE_SIZE=1000 TEC_RULE_TRACE=YES
176
Programas de consola X X X X
Tareas de consola
TEC_RULE_TRACE_FILE=/tmp/rules.trace TISDIR=/data/TMP3.6/bin/solaris2/../generic TZ=US/Central WLOCALHOST=xerius acl=[admin] adapter_host= administrator= cause_date_reception=0 cause_event_handle=0 class_name=TEC_Error credibility=1 date=Aug 8 13:26:57 2000 date_reception=965759217 duration=0 event_handle=1 hostname=xerius msg=task msg_catalog= msg_index=0 num_actions=2 o_dispatch=94 origin=146.84.39.78 repeat_count=0 server_handle=1 server_path=[] severity=MINOR source=EVENT status=OPEN sub_origin= sub_source=
Vuelco de variables de entorno al ejecutar un programa desde la consola de eventos

El ejemplo siguiente muestra un vuelco de las variables de entorno cuando se ejecuta una tarea de consola desde la consola de eventos.
EVENT_CLASS=TEC_Error INTERP=solaris2 LANG=C LD_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/ucblib NLSPATH=/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.cat PATH=/data/TMP3.6/bin/solaris2/bin:/bin:/usr/bin SLOTS=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_path TEC_BIN_DIR=/data/TMP3.6/bin/solaris2/TME/TEC TEC_KB_DIR=tec/rb_dir TEC_MASTER_PORT=50561 TEC_MASTER_START_TIMEOUT=300 TEC_RECV_BUFSIZE=500 TEC_RECV_LOG=YES TEC_RULE_CACHE_CLEAN_FREQ=3600 TEC_RULE_CACHE_FULL_HISTORY=86400 TEC_RULE_CACHE_NON_CLOSED_HISTORY=15552000 TEC_RULE_CACHE_SIZE=1000 TEC_RULE_TRACE=YES TEC_RULE_TRACE_FILE=/tmp/rules.trace TISDIR=/data/TMP3.6/bin/solaris2/../generic TZ=US/Central WLOCALHOST=xerius
177
acl=[admin] adapter_host= administrator= cause_date_reception=0 cause_event_handle=0 class_name=TEC_Error credibility=1 date=Aug 8 13:26:57 2000 date_reception=965759217 duration=0 event_handle=1 hostname=xerius msg=task msg_catalog= msg_index=0 num_actions=2 o_dispatch=94 origin=146.84.39.78 repeat_count=0 server_handle=1 server_path=[] severity=MINOR source=EVENT status=OPEN sub_origin= sub_source=
178
Apndice. Parmetros de configuracin

A continuacin se facilitan los parmetros que se pueden establecer en el archivo .tec_config. Este archivo se encuentra en el directorio $BINDIR/TME/TEC. Los parmetros tambin se pueden establecer en las reglas mediante el predicado get_config_param. Nota: los parmetros tec_recv_agent_port, tec_disp_rule_port y tec_recv_rule_port indican qu nmeros de puerto se utilizan para enviar eventos sin utilizar los servicios de comunicaciones de Tivoli Management Framework. Los nmeros de puerto pueden definirse con un valor superior a 5000 para evitar que se produzcan conflictos con los puertos asignados automticamente.
Parmetro tec_recv_agent_port Uso Especifica el puerto que el proceso tec_reception utiliza para la comunicacin entre procesos. Este parmetro es obligatorio en los sistemas UNIX. Especifica el puerto que el proceso tec_dispatch utiliza para la comunicacin entre procesos. Especifica el puerto que el proceso tec_rule utiliza para la comunicacin entre procesos. Especifica el tiempo de espera, en segundos, para el proceso tec_reception cuando se leen eventos de un socket. El valor predeterminado es 5. Si el proceso tec_reception se detiene durante los segundos especificados en tec_recv_timeout al leer un evento, finaliza la conexin y contina recibiendo eventos para no provocar retrasos en otros agentes. Especifica el directorio en el que los archivos temporales se crean y se manipulan. Estos archivos temporales se utilizan cuando las reglas graban informacin en un directorio temporal. Especifica el nmero de eventos almacenados en la cach de eventos del motor de reglas. Especifica el tiempo mximo, en segundos, que un evento abierto puede estar en la cach de eventos del motor de reglas. Especifica el tiempo mximo, en segundos, que un evento cerrado puede estar en la cach de eventos del motor de reglas. Especifica la frecuencia con la que se vaciar la cach de eventos del motor de reglas.
tec_disp_rule_port
tec_recv_rule_port tec_recv_timeout
tec_tmpfile_dir
tec_rule_cache_size
tec_rule_cache_full_history
tec_rule_cache_non_closed_history
tec_rule_cache_clean_freq
179
Parmetro tec_rule_trace
Uso Activa o desactiva el seguimiento en las reglas de compilacin. Si tiene el valor YES, tambin debe establecerse el parmetro tec_rule_trace_file. Especifica el nombre del archivo en el que se graba la informacin de seguimiento. Debe establecerse si tec_rule_trace tiene el valor YES. Especifica el host en el que se ejecuta el motor de reglas. Especifica el identificador numrico del servidor. Especifica el nombre de archivo de la cach de eventos. Se utiliza para colocar en la cach los eventos de entrada que se reciben a una velocidad superior a la que se procesan. Especifica cmo se pasan al motor de tareas los parmetros de ranura de tipo cadena. Si se le asigna el valor TRUE, los parmetros de ranura se convierten al cdigo local antes de que se ejecute la tarea. Si se le asigna el valor FALSE, los parmetros se pasan como UTF8. Indica si todos los eventos de entrada estarn en formato UTF8.
tec_rule_trace_file
tec_rule_host tec_server_handle event_cache_file
tec_exectask_dbcs
always_expect_utf8
180
Avisos
Esta informacin se ha desarrollado para productos y servicios ofrecidos en Estados Unidos. Es posible que IBM no ofrezca en otros pases los productos, los servicios o las funciones que se describen en este documento. Pngase en contacto con el representante de IBM para obtener informacin sobre los productos y servicios disponibles actualmente en su zona. Las referencias a un producto, programa o servicio de IBM no pretenden afirmar ni implicar que slo pueda utilizarse dicho producto, programa o servicio de IBM. En su lugar, se puede utilizar cualquier producto, programa o servicio funcionalmente equivalente que no infrinja los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de un producto, programa o servicio que no es de IBM. IBM puede tener patentes o solicitudes de patentes pendientes que afecten los temas tratados en este documento. El suministro de este documento no da licencia alguna para estas patentes. Puede enviar consultas sobre licencias, por escrito, a: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 EE.UU. Si desea hacer consultas sobre informacin de doble byte (DBCS), pngase en contacto con el departamento de propiedad intelectual de IBM de su pas o enve las consultas, por escrito, a: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106 Japn El prrafo siguiente no se aplica al Reino Unido ni a ningn otro pas donde las disposiciones en l expuestas sean incompatibles con la legislacin local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIN TAL CUAL SIN GARANTAS DE NINGN TIPO, YA SEAN EXPLCITAS O IMPLCITAS, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTAS IMPLCITAS DE NO VULNERACIN, COMERCIABILIDAD O ADECUACIN A UNA FINALIDAD DETERMINADA. Algunas legislaciones no contemplan la declaracin de limitacin de responsabilidad, ni implcita ni explcita, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaracin no se aplique en su caso. Esta informacin puede contener imprecisiones tcnicas o errores tipogrficos. Peridicamente se efectan cambios en la informacin aqu contenida; dichos cambios se incorporarn en nuevas ediciones de la publicacin. IBM puede efectuar mejoras o cambios en los productos o programas descritos en esta publicacin en cualquier momento y sin previo aviso.
181
Cualquier referencia realizada en esta informacin a sitios web que no son de IBM se proporciona nicamente para su comodidad y de ningn modo representa una recomendacin de dichos sitios web. Los materiales de estos sitios web no forman parte de los materiales de este producto de IBM y la utilizacin de los mismos ser por cuenta y riesgo del usuario. IBM puede utilizar o distribuir la informacin que le proporcione del modo que considere apropiado sin incurrir en ninguna obligacin con el remitente. Los titulares de licencias de este programa que deseen informacin sobre el mismo con el fin de permitir: (i) el intercambio de informacin entre programas creados independientemente y otros programas (incluido ste) y (ii) la utilizacin mutua de la informacin intercambiada, deben ponerse en contacto con: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 EE.UU. Esta informacin puede estar disponible de acuerdo con los trminos y condiciones adecuados que, en algunos casos, pueden suponer el pago de una cuota. IBM proporciona el programa bajo licencia que se describe en este documento y todo el material bajo licencia de que dispone segn los trminos que se especifican en los acuerdos IBM Customer Agreement, IBM International Program License Agreement o cualquier acuerdo equivalente acordado entre las partes. Los datos de rendimiento incluidos aqu se determinaron en un entorno controlado. Por lo tanto, los resultados que se obtengan en otros entornos operativos pueden variar significativamente. Algunas mediciones podran haberse realizado en sistemas de fase de desarrollo y no existe ninguna garanta de que tales mediciones vayan a ser las mismas en sistemas de disponibilidad general. Adems, es posible que alguna medicin se haya estimado mediante extrapolacin. Los resultados reales pueden variar. Los usuarios de este documento deben verificar los datos aplicables a su entorno especfico. La informacin relativa a productos que no son IBM se ha obtenido de los suministradores de dichos productos, de sus anuncios publicados o de cualquier otra fuente disponible pblicamente. IBM no ha probado estos productos y no puede confirmar la veracidad del rendimiento, la compatibilidad u otras afirmaciones relacionadas con productos que no son IBM. Las preguntas sobre las posibilidades de los productos que no son IBM deben dirigirse a sus suministradores. Todas las declaraciones relativas a la direccin o la intencin futura de IBM estn sujetas a cambios o anulacin sin previo aviso y representan nicamente metas y objetivos. Esta informacin contiene ejemplos de datos e informes utilizados en operaciones comerciales cotidianas. Para ilustrarlas lo mejor posible, los ejemplos incluyen nombres de personas, empresas, marcas y productos. Todos estos nombres son ficticios y cualquier parecido con los nombres y las direcciones utilizados por empresas reales es pura coincidencia. LICENCIA DE COPYRIGHT:
182
Esta informacin contiene programas de aplicacin de ejemplo en lenguaje fuente, que ilustran las tcnicas de programacin en varias plataformas operativas. Es posible copiar, modificar y distribuir estos programas de ejemplo de la forma que desee sin abonar pago alguno a IBM, con el fin de desarrollar, utilizar, comercializar o distribuir programas de aplicaciones de acuerdo con la interfaz de programacin de aplicaciones de la plataforma operativa para la que se han realizado los programas de ejemplo. Estos programas no se han probado exhaustivamente bajo todas las condiciones. Por lo tanto, IBM no puede garantizar ni dar por supuesta la fiabilidad, servicio o funcin de los mismos. Es posible copiar, modificar y distribuir estos programas de ejemplo de la forma que desee sin abonar pago alguno a IBM, con el fin de desarrollar utilizar, comercializar o distribuir programas de aplicaciones de acuerdo con las interfaces de programacin de aplicaciones de IBM. Si consulta esta informacin con algn programa de software, puede que las fotografas y las ilustraciones en color no aparezcan.
Marcas registradas
IBM, el logotipo de IBM, Tivoli, el logotipo de Tivoli, AIX, DB2, Informix, NetView, OS/2, Tivoli Enterprise, Tivoli Enterprise Console, TME y WebSphere son marcas registradas de International Business Machines Corporation o de Tivoli Systems Inc. en Estados Unidos o en otros pases. Microsoft, Windows y Windows NT son marcas registradas de Microsoft Corporation en Estados Unidos o en otros pases. Java y todas las marcas registradas basadas en Java y sus logotipos son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos o en otros pases.
UNIX es una marca registrada de The Open Group en Estados Unidos y en otros pases. Otros nombres de compaas, productos y servicios son marcas registradas o de servicio de terceros.
Avisos
183
184
ndice A
acl, variable de entorno 173 actualizar bases de reglas anteriores a la versin 3.7 92 reglas del generador de reglas 16 actualizar, hora de modificacin de registro de perfil de configuracin de adaptador 142 adaptador comandos, resumen 6 identificadores para varios adaptadores en el mismo sistema 20, 97, 102 instalar informacin de validacin para 108 instalar variables de entorno para 105 mostrar informacin de validacin instalada 56 adapter_host, variable de entorno 173 administrator, variable de entorno 173 agregar filtros de grupos de eventos 25 registro de configuracin de adaptador para perfil de configuracin de adaptador 17 registro de configuracin de adaptador para un valor predeterminado de tipo de adaptador 99 archivo BAROC, importar a una base de reglas 81 archivo de clases, suprimir 79 archivo de definiciones de clases de eventos, comprobar la validez 22 archivo rule_builder.pro 16 asignados, listar grupos de eventos 30 asignar grupo de eventos 27 grupos de eventos, desasignar 32 operadores a una consola 28 atributo restablecer fuente de eventos 117
C
cach de eventos, especificar el nmero de eventos 115 cadena, lmite de tamao ix cargar, base de reglas en el servidor de eventos 84 cause_date_reception, variable de entorno 173 cause_event_handle, variable de entorno 173 clase de evento archivo de definiciones, comprobar la validez 7 especificaciones, importar a una base de reglas 81 listar 84 class, variable de entorno 173 class_name, variable de entorno 173 Clean_Database, tarea 145, 147 Clear_Closed_Events, tarea 145, 148 Clear_Reception_Log, tarea 145, 149 Close_Event, tarea 145, 150 comandos chkclass 5, 7 postemsg 4, 8 postzmsg 4, 10 sintaxis ix tec_console 4, 12 TECAgent 4, 14 upgrade_gui.sh 5, 16 waddac 6, 17 wconsole 4, 23 wcrtdefcfg 4, 37 wcrtebizgroups 4, 38 wcrtmtgroups 4, 40 wcrtnvgroups 4, 41 wcrtsrc 4, 42 wcrtteccfg 4, 43 wchkclass 5, 22 wdbconfig.sh 5, 44 wdbmaint.sh 5, 45 wdelac 6, 47 wdelsrc 4, 48 wlsac 6, 49 wlsaddflt 6, 52 wlsadenv 6, 54 wlsadgui 6, 55 wlsadval 6, 56 wlsaeenv 6, 58 wlsemsg 4, 59 wlsesvrcfg 5, 61 wlssrc 4, 63 wmigcon 4, 64 wpostemsg (versin de nodo gestionado) 4, 68 wpostemsg (versin de punto final) 4, 66 wpostzmsg (versin de nodo gestionado) 5, 72 wpostzmsg (versin de punto final) 4, 70 wrb 5, 74 wrb_default_rb 5, 91 wrbupgrade 5, 92 wruntask 144 wsendresp 4, 93 wsetac 6, 94 wsetaddflt 6, 99 wsetadenv 6, 105 wsetadgui 6, 106 wsetadval 6, 108
B
base de datos comandos, resumen 5 estadsticas, actualizar 45 reorganizar 45 scripts de configuracin, ejecutar 44 servidor, comprobar disponibilidad 131 base de datos de eventos borrar eventos de 125, 127 base de reglas actualizar versiones anteriores a la 3.7 92 cargar en el servidor de eventos 84 comandos, resumen 5 condiciones de estado coherente 74 copiar 76 crear, en el servidor de eventos 77 establecer propiedades 85 gestionar 74 importar a 75 listar cargada 84 listar definida 84 suprimir, del servidor de eventos 79 borrar, eventos de la base de datos de eventos
125, 127
185
comandos (continuacin) wsetaeenv 6, 110 wsetemsg 4, 113 wsetesvrcfg 5, 115 wsetsrc 4, 117 wsighup 6, 118 wstartesvr 5, 119 wstartmaint.sh 5, 120 wstatesvr 5, 121 wstopesvr 5, 122 wstopmaint.sh 5, 123 wstoptecgw 6, 124 wtdbclear 5, 125 wtdbclear.pl 5, 127 wtdbspace 5, 129 wtdbstat 5, 131 wtdumper 6, 132 wtdumprl 6, 134 wtdumptr 6, 136 wtecexport 4, 137 wtecimport 4, 139 wtouchac 6, 142 compilar, reglas 76 componente de ruta absoluta 3 directorio actual 3 directorio padre 3 relativa 3 componente de ruta del directorio padre 3 comprobar archivo de definiciones de clases de eventos 22 disponibilidad del servidor de base de datos 131 validez del archivo de definiciones de clases de eventos configurar (definicin en el contexto de las tareas) 144 conjunto de reglas importar a un destino de base de reglas 83 importar a un paquete de reglas 82 importar a una base de reglas 81 listar 85 suprimir de un paquete de reglas 80 suprimir de una base de reglas 80 consola, resumen de comandos 4 consola de eventos asignados, listar grupos de eventos 30 asignar grupo de eventos 27 asignar operadores 28 cambiar nombre 31 copiar 28 crear 28 crear grupo de eventos 29 desasignar grupos de eventos 32 desasignar operadores 32 filtro de grupo de eventos, cambiar nombre 31 filtros, grupo de eventos, agregar 25 filtros, grupo de eventos, suprimir 30 gestionar 23 grupo de eventos, cambiar nombre 31 grupos de eventos, listar 30 iniciar 12 mostrar definidas 30 suprimir 29 suprimir grupo de eventos 29 CONSOLE_NAME, variable de entorno 171 convenios sintaxis de comandos ix tipogrficos viii
copiar base de reglas 76 consola de eventos 28 crear base de reglas en el servidor de eventos 77 consola de eventos 28 destino de base de reglas 78 fuente en el servidor de eventos 42 grupo de eventos 29 grupos de eventos para e-business.rls 38 grupos de eventos para maintenance_mode.rls grupos de eventos para netview.rls 41 paquete de reglas 78 credibility, variable de entorno 174
40
CH
Change_Severity, tarea 145, 146 CHILD_OF_OSERV, variable de entorno chkclass, comando 5, 7 171
D
date, variable de entorno 174 date_event, variable de entorno 174 date_reception, variable de entorno 174 desasignar grupo de eventos 32 operadores de una consola 32 destino de base de reglas crear 78 listar 85 suprimir 80 detener gateway 124 servidor de eventos 122 directorios, notacin ix DISPLAY, variable de entorno 171 Dump_Event_Repository, tarea 145, 151 duration, variable de entorno 174
E
eliminar registro de configuracin de adaptador de un perfil de configuracin de adaptador 47 en lnea, acceder a publicaciones vi ENDPOINT, variable de entorno 171 ENDPOINT_OID, variable de entorno 172 enlace con herramientas de configuracin ampliadas, mostrar 55 enlace instalado con herramientas de configuracin ampliadas, mostrar 55 enlazar, interfaz de Recurso de configuracin del adaptador con una herramienta de configuracin 106 entorno Tivoli, configuracin 1 enviar un evento al servidor de eventos 8, 66, 68 establecimiento parmetros de configuracin para el servidor de eventos 115 periodo de conservacin en registro de recepcin 115 propiedades de base de reglas 85 ev_key, variable de entorno 174 EVENT_CLASS, variable de entorno 172 event_handle, variable de entorno 174 event_hndl, variable de entorno 174
186
Event_Query, tarea 145, 153 evento borrar de base de datos de eventos 125, 127 en base de datos del servidor, listar 59 enviar al servidor de eventos 8, 66, 68 generar informe sobre 132 generar informes de eventos recibidos por servidor de eventos 134 mensajes, resumen de comandos 4 modificar evento 113 nivel de gravedad 9, 10, 15, 67, 69, 71, 72 nmero, especificar para cach de eventos 115 restablecer atributos de fuentes de eventos 117
F
filtros, grupo de eventos agregar 25 cambiar nombres 31 suprimir 30 filtros de grupos de eventos agregar 25 cambiar nombres 31 suprimir 30 Find_Similar_Events, tarea 145, 157 Forward_Event, tarea 145, 159 fuente comandos, resumen 4 crear, en el servidor de eventos 42 en servidor de eventos, listar 63 suprimir de una lista de servidores de eventos
importar (continuacin) conjunto de reglas a una base de reglas 81 especificaciones de clase de evento a una base de reglas 81 paquete de reglas a un destino de base de reglas 83 informacin de validacin instalar para un tipo de adaptador 108 tipo de adaptador, mostrar 56 informes eventos recibidos por servidor de eventos 134 tareas completadas 136 iniciar, servidor de eventos 119 iniciar consola de eventos 12 instalar enlace de interfaz de Recurso de configuracin del adaptador con herramientas de configuracin 106 informacin de validacin para un tipo de adaptador variables de entorno para un adaptador 105 internacionalizacin mensajes y postzmsg 8, 10 INTERP, variable de entorno 172
108
L
LANG, variable de entorno 172 last_modified_time, variable de entorno 174 LD_LIBRARY_PATH, variable de entorno 172 LIBPATH, variable de entorno 172 libros vase publicaciones vi lnea de comandos sintaxis ix tareas ejecutables 145 listar base de reglas, cargada 84 base de reglas, definida en el servidor de eventos clases de eventos 84 conjuntos de reglas 85 consolas de eventos definidas 30 destinos de bases de reglas 85 eventos en base de datos 59 eventos recibidos 59 fuentes en el servidor de eventos 63 grupo de eventos 30 grupos de eventos asignados 30 paquetes de reglas 85 parmetros de configuracin para un servidor de eventos 61 Log_Event_To_File, tarea 145, 160
48
G
gateway, detener 124 generar informe de eventos 132 informe sobre tareas completadas 136 grupo de eventos agregar para e-business.rls 38 agregar para maintenance_mode.rls 40 agregar para netview.rls 41 asignados, listar 30 cambiar nombres 31 listar 30 grupos de noticias vii
84
H
herramientas de configuracin enlazar con interfaz de Recurso de configuracin del adaptador 106 mostrar enlace instalado con 55 hora de modificacin, actualizar en un registro de perfil de configuracin de adaptador 142 hostname, variable de entorno 174
M
manuales vase publicaciones vi mensaje, visualizar en el escritorio del administrador 93 mensajes de eventos, resumen de comandos 4 modificar evento 113 registro de configuracin de adaptador para perfil de configuracin de adaptador 94 registro de configuracin de adaptador para un valor predeterminado de tipo de adaptador 99 variables de entorno en puntos finales de perfil de configuracin de adaptador 110
I
identificadores para varios adaptadores en el mismo sistema 20, 97, 102 importar archivo BAROC a una base de reglas 81 conjunto de reglas a un destino de base de reglas 83 conjunto de reglas a un paquete de reglas 82
ndice
187
mostrar informacin de validacin instalada para el tipo de adaptador 56 registros de configuracin de adaptador para perfil de configuracin de adaptador 49 variables de entorno de Recurso de integracin de eventos especficas del adaptador 54 Vase tambin listar 49 msg, variable de entorno 174 msg_catalog, variable de entorno 174 msg_index, variable de entorno 175
postzmsg, comando 4, 10 publicaciones en lnea, acceder vi pedidos vii punto final modificar variables de entorno en 110 mostrar variables de entorno para un perfil de configuracin de adaptador 58
R
Recurso de configuracin del adaptador comandos, resumen 6 interfaz, enlazar con herramientas de configuracin 106 referencia a objeto absoluta 2 registrados, nombres 2 registro de configuracin de adaptador agregar, para un perfil de configuracin de adaptador 17 agregar, para un valor predeterminado de tipo de adaptador 99 modificar, para un perfil de configuracin de adaptador 94 modificar, para un valor predeterminado de tipo de adaptador 99 mostrar, en un perfil de configuracin de adaptador 49 suprimir de un perfil de configuracin de adaptador 47 registro de nombres, descripcin 2 registro de recepcin, especificar periodo de conservacin de eventos 115 regla compilar 27, 28, 29, 30, 31, 32, 76 reglas del generador de reglas, actualizar 16 repeat_count, variable de entorno 175 restablecer atributos de fuentes de eventos 117 resmenes de comandos comandos de adaptador 6 comandos de base de datos 5 comandos de base de reglas 5 comandos de consola 4 comandos de fuentes 4 comandos de mensajes de eventos 4 comandos de servidor de eventos 5 comandos del Recurso de configuracin del adaptador 6 ruta absoluta 3 ruta relativa 3 rutas, notacin ix rutas de objeto 2, 3
N
nivel de gravedad, eventos 9, 10, 15, 67, 69, 71, 72 NLSPATH, variable de entorno 172 nombre registrado, descripcin 2 notacin rutas ix tipogrfica ix variables de entorno ix num_actions, variable de entorno 175
O
o_dispatch, variable de entorno 175 objeto referencia 2 referencia desde comando 2 rutas 2, 3 operadores asignar a una consola 28 desasignar de una consola 32 origin, variable de entorno 175
P
paquete de reglas crear 78 importar a un destino de base de reglas 83 listar 85 suprimir 80 paquetes de soporte de idiomas y postzmsg 8, 10 parmetros de configuracin establecer para el servidor de eventos 115 listar para un servidor de eventos 61 PATH, variable de entorno 172 pedidos de publicaciones vii perfil de configuracin de adaptador actualizar hora de modificacin de registro de perfil de configuracin de adaptador 142 agregar un registro de configuracin de adaptador para 17 agregar un valor predeterminado de tipo de adaptador para 99 eliminar registro de configuracin de adaptador de 47 modificar un registro de configuracin de adaptador para 94 modificar un valor predeterminado de tipo de adaptador para 99 modificar variables de entorno en puntos finales de perfil de configuracin de adaptador 110 mostrar registros de configuracin de adaptador de 49 mostrar variables de entorno para puntos finales 58 Popup_Message, tarea 145, 161 postemsg, comando 4, 8
S
Salida de la tarea, dilogo 145 Send_Email, tarea 145, 162 Send_Event, tarea 145, 163 server_handle, variable de entorno 175 server_hndl, variable de entorno 175 server_path, variable de entorno 175 servicio de soporte de software, ponerse en contacto vii servidor de eventos 59 comandos, resumen 5 detener 122 enviar un evento a 8, 66, 68 establecer parmetros de configuracin para 115 generar informe sobre tareas completadas por 136 generar informes de eventos recibidos por 134 iniciar 119
188
servidor de eventos (continuacin) lista, suprimir una fuente de 48 listar fuentes en 63 listar parmetros de configuracin para 61 visualizar estado de 121 severity, variable de entorno 175 SHLIB_PATH, variable de entorno 172 sintaxis de comandos ix SLOTS, variable de entorno 172 soporte al cliente vase soporte de software vii source, variable de entorno 176 Start_Maintenance, tarea 145, 166 status, variable de entorno 176 sub_origin, variable de entorno 176 sub_source, variable de entorno 176 suprimir archivo de clases 79 base de reglas del servidor de eventos 79 conjunto de reglas de un paquete de reglas 80 conjunto de reglas de una base de reglas 80 consola de eventos 29 destino de base de reglas 80 filtros de grupos de eventos 30 fuente de una lista de servidores de eventos 48 grupo de eventos 29 paquete de reglas 80
TEC_RULE_TRACE, variable de entorno 173 TEC_RULE_TRACE_FILE, variable de entorno TECAgent, comando 4, 14 tipogrficos, convenios viii TISDIR, variable de entorno 173 Tivoli Software Information Center vi TZ, variable de entorno 173
173
U
upgrade_gui.sh, comando 5, 16
V
variable de atributos de evento 173 variable de entorno acl 173 adapter_host 173 administrator 173 atributos de evento 173 cause_date_reception 173 cause_event_handle 173 class 173 class_name 173 CONSOLE_NAME 171 credibility 174 CHILD_OF_OSERV 171 date 174 date_event 174 date_reception 174 descripciones 171 DISPLAY 171 disponibilidad para tareas que se ejecutan con eventos 171 duration 174 ejemplos programa desde consola Java 177 tarea desde consola Java 176 en puntos finales de perfil de configuracin de adaptador, modificar 110 ENDPOINT 171 ENDPOINT_OID 172 ev_key 174 EVENT_CLASS 172 event_handle 174 event_hndl 174 hostname 174 instalar para un adaptador 105 INTERP 172 LANG 172 last_modified_time 174 LD_LIBRARY_PATH 172 LIBPATH 172 mostrar Recurso de integracin de eventos especficas del adaptador 54 msg 174 msg_catalog 174 msg_index 175 NLSPATH 172 num_actions 175 o_dispatch 175 origin 175 para un punto final de perfil de configuracin de adaptador, mostrar 58 PATH 172 repeat_count 175 ndice
T
tarea Clean_Database 145, 147 Clear_Closed_Events 145, 148 Clear_Reception_Log 145, 149 Close_Event 145, 150 Change_Severity 145, 146 Dump_Event_Repository 145, 151 Event_Query 145, 153 Find_Similar_Events 145, 157 Forward_Event 145, 159 informacin general 143 Log_Event_To_File 145, 160 nombres de archivo de script 145 nombres descriptivos 145 Popup_Message 145, 161 salida 145 Send_Email 145, 162 Send_Event 145, 163 Start_Maintenance 145, 166 Wake_Up_Netscape 145, 169 tareas completadas, generar informe sobre 136 tareas de T/EC, dilogo 144 TEC_ADMIN, variable de entorno 172 TEC_BIN_DIR, variable de entorno 172 tec_console, comando 4, 12 TEC_EXECTASK_DBCS, variable de entorno 172 TEC_KB_DIR, variable de entorno 172 TEC_MASTER_PORT, variable de entorno 172 TEC_MASTER_START_TIMEOUT, variable de entorno 172 TEC_RECV_BUFSIZE, variable de entorno 173 TEC_RECV_LOG, variable de entorno 173 TEC_RULE_CACHE_CLEAN_FREQ, variable de entorno 173 TEC_RULE_CACHE_FULL_HISTORY, variable de entorno 173 TEC_RULE_CACHE_NON_CLOSED_HISTORY, variable de entorno 173 TEC_RULE_CACHE_SIZE, variable de entorno 173
189
variable de entorno (continuacin) server_handle 175 server_hndl 175 server_path 175 severity 175 SHLIB_PATH 172 SLOTS 172 source 176 status 176 sub_origin 176 sub_source 176 TEC_ADMIN 172 TEC_BIN_DIR 172 TEC_EXECTASK_DBCS 172 TEC_KB_DIR 172 TEC_MASTER_PORT 172 TEC_MASTER_START_TIMEOUT 172 TEC_RECV_BUFSIZE 173 TEC_RECV_LOG 173 TEC_RULE_CACHE_CLEAN_FREQ 173 TEC_RULE_CACHE_FULL_HISTORY 173 TEC_RULE_CACHE_NON_CLOSED_HISTORY TEC_RULE_CACHE_SIZE 173 TEC_RULE_TRACE 173 TEC_RULE_TRACE_FILE 173 TISDIR 173 TZ 173 WLOCALHOST 173 variables, notacin para ix variables de entorno, notacin ix visor de eventos 160 visualizar estado del servidor de eventos 121 mensaje en el escritorio del administrador 93
173
wrb_default_rb, comando 5, 91 wrbupgrade, comando 5, 92 wruntask, comando 144 wsendresp, comando 4, 93 wsetac, comando 6, 94 wsetaddflt, comando 6, 99 wsetadenv, comando 6, 105 wsetadgui, comando 6, 106 wsetadval, comando 6, 108 wsetaeenv, comando 6, 110 wsetemsg, comando 4, 113 wsetesvrcfg, comando 5, 115 wsetsrc, comando 4, 117 wsighup, comando 6, 118 wstartesvr, comando 5, 119 wstartmaint.sh, comando 5, 120 wstatesvr, comando 5, 121 wstopesvr, comando 5, 122 wstopmaint.sh, comando 5, 123 wstoptecgw, comando 6, 124 wtdbclear, comando 5, 125 wtdbclear.pl, comando 5, 127 wtdbspace, comando 5, 129 wtdbstat, comando 5, 131 wtdumper, comando 6, 132 wtdumprl, comando 6, 134 wtdumptr, comando 6, 136 wtecexport, comando 4, 137 wtecimport, comando 4, 139 wtouchac, comando 6, 142
W
waddac, comando 6, 17 Wake_Up_Netscape, tarea 145, 169 wconsole, comando 4, 23 wcrtdefcfg, comando 4, 37 wcrtebizgroups, comando 4, 38 wcrtmtgroups, comando 4, 40 wcrtnvgroups, comando 4, 41 wcrtsrc, comando 4, 42 wcrtteccfg, comando 4, 43 wchkclass, comando 5, 22 wdbconfig.sh, comando 5, 44 wdbmaint.sh, comando 5, 45 wdelac, comando 6, 47 wdelsrc, comando 4, 48 WLOCALHOST, variable de entorno 173 wlsac, comando 6, 49 wlsaddflt, comando 6, 52 wlsadenv, comando 6, 54 wlsadgui, comando 6, 55 wlsadval, comando 6, 56 wlsaeenv, comando 6, 58 wlsemsg, comando 4, 59 wlsesvrcfg, comando 5, 61 wlssrc, comando 4, 63 wmigcon, comando 4, 64 wpostemsg, comando (versin de nodo gestionado) 4, 68 wpostemsg, comando (versin de punto final) 4, 66 wpostzmsg, comando (versin de nodo gestionado) 5, 72 wpostzmsg, comando (versin de punto final) 4, 70 wrb, comando 5, 74
190
Printed in Denmark by IBM Danmark A/S
SC10-3980-00

Manual de Consulta de Comandos de Tivoli

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Manual de Consulta de Comandos de Tivoli

Загружено:

Авторское право:

Доступные форматы

IBM Tivoli Enterprise Console

Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console

Manual de consulta de comandos y tareas

Captulo 2. Tareas . . . . . . . . . 143

Send_Email . . . Send_Event . . . Start_Maintenance . Wake_Up_Netscape

162 163 166 169

Vuelco de variables de entorno al ejecutar un programa desde la consola de eventos . . .

Captulo 3. Variables de entorno disponibles para las tareas . . . . . 171

Apndice. Parmetros de configuracin . . . . . . . . . . . 179 Avisos . . . . . . . . . . . . . . 181

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

Acerca de este libro

A quin va dirigida esta publicacin

Biblioteca de IBM Tivoli Enterprise Console

Copyright IBM Corp. 2002

Cmo acceder a las publicaciones en lnea

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

Cmo ponerse en contacto con el servicio de soporte de software

Participacin en grupos de noticias

Acerca de este libro

Convenios utilizados en esta gua

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

Rutas y variables que dependen del sistema operativo

Sintaxis de la lnea de comandos

Acerca de este libro

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

Establecimiento del entorno Tivoli

Si utiliza el shell C, ejecute el comando siguiente:

Utilizacin de los comandos de Tivoli

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

donde Administrator es el recurso y jerry es la instancia.

Comandos de Tivoli Enterprise Console

wsendresp wsetemsg wtecexport wtecimport

Comandos de mensajes de eventos

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

Comando wpostzmsg (versin de nodo gestionado)

Comandos de servidor de eventos

Comandos de base de reglas

wrb wrb_default_rb wrbupgrade

Comandos de base de datos

Comando wtdumper wtdumprl wtdumptr

Comandos del Recurso de configuracin del adaptador

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

El cambio entra en vigor de inmediato.

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

Usuario de la consola Administrador Operador

Funciones de regin de gestin de Tivoli RIM_view, RIM_update, senior

Vistas de la consola Vistas de configuracin, resumen y prioridad y visor de eventos

RIM_view, RIM_update, user Vistas de resumen y prioridad y visor de eventos

f archivo_configuracin Especifica el nombre del archivo de configuracin. Consulte la publicacin

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

IBM Tivoli Enterprise Console: Manual de consulta de comandos y tareas

crtconsole crteg crtoperator delconsole deleg delegflt deloperator

Funciones de regin RIM_view, RIM_update, user

RIM_view, RIM_update, user RIM_view, RIM_update, user

lseg lsoperator setconsole

RIM_view, RIM_update, user RIM_view, RIM_update, user

Desasigna operadores de una RIM_view, RIM_update, definicin de consola de senior eventos.