Manual de consulta de comandos de Tivoli

IBM Tivoli Enterprise Console

Manual de consulta de comandos y tareasV ersin 3.9

SC10-3980-00

IBM Tivoli Enterprise Console

Manual de consulta de comandos y tareasV 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.

ContenidoAcerca de este libro . . . . . . . . . vA 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. . . . . . . . . 1Establecimiento 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 . . . . . . . . . 143Nombres 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 . . . . . 171Descripciones 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 . . . . . . . . . . . . . . 181Marcas registradas. . . . . . . . . . . . 183

ndice . . . . . . . . . . . . . . . 185

iv

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

Acerca de este libroEl 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 publicacinEsta 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

PublicacionesEn 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 ConsoleEn 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

Copyright IBM Corp. 2002

v

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 relacionadasEl 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 lneaEl 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 publicacionesPuede 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 softwareSi 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 noticiasLos 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.

Acerca de este libro

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 guaEn 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 tipogrficosEn 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 operativoEn 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 comandosEste 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

Acerca de este libro

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.

x


Captulo 1. ComandosEn 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 TivoliCuando 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 TivoliLos 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. Copyright IBM Corp. 2002

1

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 objetosCuando 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 registradosCada 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

2


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 objetoLas 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 ConsoleEn los apartados siguientes se describen brevemente los comandos de Tivoli Enterprise Console por componente.

Captulo 1. Comandos

3

Comandos de consolaComando 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 fuentesComando 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 eventosComando 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.

4


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 eventosComando 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 reglasComando 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 datosComando 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

5

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 adaptadorComando 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 adaptadorComando 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.

6


chkclassComprueba si un archivo de definiciones de clases de eventos es vlido cotejndolo con un directorio de base de reglas.

Sintaxischkclass [k dir_base_reglas] archivo_clases

DescripcinEl 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.

AutorizacinNinguna.

Opcionesarchivo_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.

EjemplosEl 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 tambinwchkclass

Captulo 1. Comandos

7

postemsgEnva un evento al servidor de eventos mediante comunicaciones no de Tivoli.

Sintaxispostemsg S servidor | f archivo_configuracin [m mensaje] [r gravedad] [atributo=valor...] clase fuente

DescripcinEl 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.

AutorizacinNinguna.

Opcionesatributo=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.

8


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.

EjemplosEl 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 tambinpostzmsg, 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

9

postzmsgEnva un evento al servidor de eventos mediante comunicaciones no de Tivoli.

Sintaxispostzmsg S servidor | f archivo_configuracin [m mensaje] [r gravedad] [atributo=valor...] clase fuente

DescripcinEl 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).

AutorizacinNinguna.

Opcionesatributo=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. 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.

EjemplosEl 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 tambinpostemsg, 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_consoleInicia la consola de eventos de Tivoli Enterprise Console.

Sintaxistec_console [u ID_usuario] [p contrasea] [h nombre_host[:puerto]] [e grupo_eventos] [nowindow] [&]

DescripcinEl 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.

AutorizacinPara 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.

EjemplosEl 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

TECAgentEnva un evento al servidor de eventos mediante comunicaciones Tivoli o no de Tivoli.

Sintaxisjava com.tivoli.tec.event_delivery.TECAgent SENDER f archivo_configuracin [m mensaje] [r gravedad] [atributo=valor...] clase fuente

DescripcinEl 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.

Autorizacinuser

Opcionesatributo=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.

EjemplosEl 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 tambinpostemsg, 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.shActualiza 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.

Sintaxisupgrade_gui.sh dir_base_reglas

DescripcinSi 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.

AutorizacinNinguna.

Opcionesdir_base_reglas Directorio que contiene la base de reglas que contiene las reglas del generador de reglas que se desea actualizar.

EjemplosEl 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


waddacAgrega un registro de configuracin de adaptador para un perfil de configuracin de adaptador.

Sintaxiswaddac detalles_adaptador tipo perfil

DescripcinEl 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.

Autorizacinadmin

Opcionesdetalles_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 distribuidosCaptulo 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


EjemplosEl 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 tambinwdelac, wlsac, wsetac, wsetaddflt

Captulo 1. Comandos

21

wchkclassComprueba si un archivo de definiciones de clases de eventos es vlido cotejndolo con un directorio de base de reglas.

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

DescripcinEl 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.

Autorizacinuser

Opcioneshost: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.

EjemplosEl 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 tambinchkclass

22


wconsoleGestiona las consolas de eventos.

Sintaxiswconsole [opcin [subopcin]]

DescripcinUtilice 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.

Autorizacinsenior (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.

Notasv 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.

OpcionesCada 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 retornoEl 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.

EjemplosEn 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 cop

Manual de consulta de comandos de Tivoli

Documents

Transcript of Manual de consulta de comandos de Tivoli