of 204

Manual de consulta de comandos de Tivoli

Published on December 2016 | Categories: Documents | Downloads: 20 | Comments: 0
302 views

Command guide Tivoli

Comments

Content

IBM Tivoli Enterprise Console

Manual de consulta de comandos y tareas
V ersión 3.9

SC10-3980-00

IBM Tivoli Enterprise Console

Manual de consulta de comandos y tareas
V ersión 3.9

SC10-3980-00

Nota Antes de utilizar esta información y el producto al que da soporte, lea la información del apartado “Avisos” en la página 181.

Primera edición (agosto 2003) Este manual es la traducción del original en inglés IBM Tivoli Enterprise Console Command and Task Reference, SC32-1232-00. Esta edición se aplica a la versión 3, release 9, de IBM Tivoli Enterprise Console (número 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 quién va dirigida esta publicación . . . . . . v Publicaciones . . . . . . . . . . . . . . v Biblioteca de IBM Tivoli Enterprise Console . . . v Publicaciones relacionadas . . . . . . . . vi Cómo acceder a las publicaciones en línea . . . vi Pedidos de publicaciones . . . . . . . . . vii Cómo ponerse en contacto con el servicio de soporte de software . . . . . . . . . . . vii Participación en grupos de noticias . . . . . . vii Convenios utilizados en esta guía . . . . . . viii Convenios tipográficos . . . . . . . . . viii Rutas y variables que dependen del sistema operativo . . . . . . . . . . . . . . ix Sintaxis de la línea de comandos . . . . . . ix wlsadval . . . . . . . . . . . wlsaeenv . . . . . . . . . . . wlsemsg . . . . . . . . . . . wlsesvrcfg . . . . . . . . . . . wlssrc . . . . . . . . . . . . wmigcon . . . . . . . . . . . wpostemsg (versión de punto final) . . wpostemsg (versión de nodo gestionado) wpostzmsg (versión de punto final) . . wpostzmsg (versión 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

Capítulo 1. Comandos. . . . . . . . . 1
Establecimiento del entorno Tivoli . . . . . Utilización 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 configuración 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

Capítulo 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

Capítulo 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

Apéndice. Parámetros de configuración . . . . . . . . . . . 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 aplicación de gestión de eventos basado en reglas que integra la gestión del sistema, la red, las bases de datos y las aplicaciones para garantizar una disponibilidad óptima de los servicios de TI de una organización. En la publicación 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 quién va dirigida esta publicación
Esta publicación está dirigida a los administradores de Tivoli Enterprise Console que desean utilizar la interfaz de línea 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. También se describe cómo acceder a las publicaciones de Tivoli en línea y cómo 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 información acerca de los adaptadores soportados, incluida la información para instalar y configurar estos adaptadores. v IBM Tivoli Enterprise Console Manual de consulta de comandos y tareas, SC10-3980. Proporciona información detallada acerca de los comandos de Tivoli Enterprise Console, las tareas predefinidas incluidas en la biblioteca de tareas y las variables de entorno que están disponibles para las tareas que se ejecutan contra un evento. v IBM Tivoli Enterprise Console Guía de instalación, SC10-3979 Describe la instalación, actualización y desinstalación del producto Tivoli Enterprise Console. v IBM Tivoli Enterprise Console Release Notes, SC32-1238 Proporciona información específica del release que no está disponible hasta el momento de lanzar el producto al mercado. v IBM Tivoli Enterprise Console Rule Developer’s Guide, SC32-1234 Describe cómo desarrollar reglas e integrarlas para la correlación de eventos y la gestión automatizada de eventos. v IBM Tivoli Enterprise Console Rule Set Reference, SC32-1282

© Copyright IBM Corp. 2002

v

Proporciona información de consulta acerca de los conjuntos de reglas Tivoli Enterprise Console. v IBM Tivoli Enterprise Console Guía del usuario, SC10-3981 Proporciona información general sobre el producto Tivoli Enterprise Console y describe cómo configurar y utilizar Tivoli Enterprise Console para gestionar los eventos. v IBM Tivoli Enterprise Console Warehouse Enablement Pack: Implementation Guide, SC32-1236 Describe cómo instalar y configurar el paquete de activación del almacén para el producto Tivoli Enterprise Console; también describe las estructuras y el flujo de datos utilizados por el paquete del almacén. v Tivoli Event Integration Facility Reference, SC32-1241 Describe cómo desarrollar sus propios adaptadores de eventos adaptados a su entorno de red y a las necesidades específicas de su empresa. En este manual también se describe cómo filtrar los eventos en la fuente.

Publicaciones relacionadas
El glosario de software de Tivoli contiene las definiciones de muchos de los términos técnicos relacionados con el software de Tivoli. El glosario de software de Tivoli está disponible en el sitio web siguiente (únicamente en inglés): 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.

Cómo acceder a las publicaciones en línea
El CD de documentación 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 documentación. IBM publica en el sitio web de Tivoli Software Information Center las publicaciones de este y de otros productos Tivoli en cuanto están 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 dirección web siguiente: http://www.ibm.com/software/tivoli/library/ Desplácese hacia abajo por la página 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 tamaño de papel que no sea carta (letter), marque el cuadro de selección Ajustar a página de la ventana Imprimir de Adobe Acrobat. Para abrir esta ventana, haga clic en Archivo → Imprimir. La opción Ajustar a página garantiza que se imprimirá todo el contenido de las páginas de tamaño carta en el papel que utilice.

vi

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

Pedidos de publicaciones
Puede solicitar muchas de las publicaciones de Tivoli en línea en el sitio web siguiente: http://www.elink.ibmlink.ibm.com/public/applications/publications/ cgibin/pbi.cgi También puede solicitarlas por teléfono llamando a uno de los siguientes números: v En los Estados Unidos: 800-879-2755 v En Canadá: 800-426-4968 En los demás países, consulte el sitio web siguiente para ver una lista de los números de teléfono correspondientes: http://www.ibm.com/software/tivoli/order-lit/

Cómo ponerse en contacto con el servicio de soporte de software
Si tiene algún problema con algún 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 publicación IBM Software Support Guide en este sitio web: http://techsupport.services.ibm.com/guides/handbook.html En esta guía se proporciona información que permite ponerse en contacto con el servicio de soporte de software de IBM en función de la gravedad del problema y también se proporciona la información siguiente: v Registro y condiciones exigidas. v Números de teléfono y direcciones de correo electrónico dependiendo del país en que se encuentre. v Información de la que debe disponer antes de ponerse en contacto con el servicio de soporte de software de IBM.

Participación en grupos de noticias
Los grupos de usuarios proporcionan a los profesionales del software un foro en el que intercambiar ideas, conocimientos técnicos y experiencia acerca de un producto. Se encuentran en Internet y están disponibles mediante programas de lector de noticias estándar. Estos grupos están destinados principalmente para la comunicación 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 pestaña Programas.

Acerca de este libro

vii

4. En la lista Grupos de noticias, haga clic en la fecha hacia abajo y después 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 dirección del grupo de noticias de un producto en el campo Dirección 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 Categoría, haga clic en Correo/Grupos de noticias para visualizar la configuración de Correo/Grupos de noticias. 4. Marque el cuadro de selección Utilizar Netscape Mail como aplicación de correo predeterminada. 5. Haga clic en Aceptar. 6. Cierre el navegador Netscape Navigator y ábralo de nuevo. 7. Corte y pegue la dirección del grupo de noticias de un producto en el campo Dirección 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 guía
En esta guía se utilizan convenios para los términos y acciones especiales, para las rutas y los comandos que dependen del sistema operativo, y para la sintaxis de los comandos.

Convenios tipográficos
En esta guía se utilizan los siguientes convenios tipográficos: Negrita v Comandos en minúscula o en una combinación de minúsculas y mayúsculas que de no destacarse serían difíciles de distinguir del resto de texto v Controles de la interfaz (cuadros de selección, pulsadores, botones de selección, botones cíclicos, campos, carpetas, iconos, cuadros de lista, elementos de los cuadros de lista, listas de varias columnas, contenedores, opciones de menú, nombres de menús, pestañas, hojas de propiedades), etiquetas (como Sugerencia: y Consideraciones sobre el sistema operativo:) v Palabras clave y parámetros dentro del texto Cursiva v Palabras definidas en el texto v Para dar énfasis a palabras (palabras como tales)

viii

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

v Términos nuevos en el texto (excepto en las listas de definiciones) v Variables y valores que debe proporcionar el usuario Monoespaciado v Ejemplos y código de ejemplo v Nombres de archivos, palabras clave de programación y otros elementos difíciles 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 guía se utiliza el convenio de UNIX para especificar las variables de entorno y para la notación de directorios. Si utiliza la línea 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 línea de comandos
Este documento utiliza los caracteres especiales siguientes para definir la sintaxis de los comandos: [] ... | Identifica un argumento opcional. Los argumentos que no están delimitados por corchetes son obligatorios. Indica que puede especificar varios valores para el argumento anterior. Indica información que se excluye mutuamente. Puede emplear o bien 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 número de caracteres máximo 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 demás 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

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

Capítulo 1. Comandos
En este capítulo se describe cómo establecer un entorno Tivoli para utilizar comandos de Tivoli y se proporciona información detallada acerca de cada comando de Tivoli Enterprise Console.

Establecimiento del entorno Tivoli
Cuando se instala Tivoli Management Framework, se crean dos archivos de configuración que puede utilizar para establecer fácilmente las rutas de búsqueda y las variables de entorno correctas. Estos archivos están disponibles en cualquier cliente o en el servidor de la región de gestión de Tivoli. Siga estos pasos para configurar el entorno del sistema UNIX para ejecutar los comandos de Tivoli Enterprise: 1. Inicie la sesión en un cliente Tivoli Enterprise o en el servidor Tivoli Enterprise en el que el administrador de Tivoli Enterprise tenga un alias con la función ″super″ para la región de gestión de Tivoli. Consulte la publicación Tivoli Management Framework Guía del usuario para obtener información detallada sobre la creación de administradores de Tivoli Enterprise con funciones de autorización para la región. 2. Hay disponibles dos scripts de inicialización y configuración 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 línea de comandos. Ahora ya tiene un entorno preparado para llevar a cabo operaciones de Tivoli.

Utilización de los comandos de Tivoli
Los comandos de Tivoli sirven para llevar a cabo operaciones del sistema desde una línea de comandos en lugar de utilizar el escritorio de Tivoli. A menudo resulta útil o más apropiado llamar una operación de la aplicación de gestión de Tivoli desde la línea de comandos que desde el escritorio; por ejemplo: v Si no tiene acceso a una pantalla gráfica, como sucede cuando se inicia la sesión a través de una línea telefónica 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 ratón sino llamar un comando desde un shell.
© Copyright IBM Corp. 2002

1

v Si una operación 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 mayoría de los comandos también se han desarrollado con la sintaxis w+verbo+objeto, que coincide con la descripción que se daría de la acción. 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 programación. En su lugar, se utiliza un nombre que sea fácil de emplear. Este nombre de uso sencillo se obtiene a partir de un nombre dado al objeto por el usuario de la aplicación (por ejemplo, cuando se crea una región de política). Se pueden emplear dos formatos de nombres distintos con los comandos de la interfaz de línea de comandos, tal como se indica a continuación: v Nombres registrados v Rutas de objeto Los programas de línea de comandos de Tivoli admiten ambos métodos de denominación. En ocasiones le resultará más cómodo utilizar un formato que el otro.

Nombres registrados
Cada región 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 región 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 efectúan automáticamente. Consulte la publicación IBM Tivoli Management Framework Planning for Deployment Guide para ver una lista completa de los tipos de recursos y la información de intercambio. El uso del registro de nombres facilita el intercambio de recursos entre varias regiones de Tivoli. Consulte la publicación IBM Tivoli Management Framework Planning for Deployment Guide para ver una descripción 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

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

Consulte en la publicación IBM Tivoli Management Framework Reference Manual una descripción detallada y la sintaxis del comando wlookup. Otros comandos que utilizan nombres registrados son wls y wmv. Por ejemplo, para obtener una lista de los objetos del escritorio del administrador Jerry, especifique 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 carácter de barra inclinada (/). Una ruta relativa puede empezar por cualquier otro carácter que no sea una barra inclinada (/), como por ejemplo los componentes de rutas especiales correspondientes al directorio actual (.) y al directorio padre (..). A continuación 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 explícita opcional.

nombre Es la instancia concreta en la que desea efectuar alguna operación. Utilice el especificador tipo opcional si debe especificar un recurso concreto que tiene el mismo nombre que otro recurso de otro tipo. Por ejemplo, imagine que la región de política Engineering tiene un gestor de perfiles denominado Servers y una subregión de política llamada Servers. Para especificar el gestor de perfiles con un nombre de ruta de objeto, podría 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.

Capítulo 1. Comandos

3

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 configuración 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 están 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 configuración 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. Efectúa la migración de las consolas, los grupos de eventos, los filtros de grupo de eventos y los operadores de la versión 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 región 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 (versión de punto final) wpostemsg (versión de nodo gestionado) wpostzmsg (versión de punto final) Finalidad Envía un evento al servidor de eventos. Este comando no requiere los servicios de Tivoli Management Framework. Envía un evento al servidor de eventos mediante comunicaciones no de Tivoli. Envía un evento al servidor de eventos mediante comunicaciones Tivoli o no de Tivoli. Envía un evento al servidor de eventos. Este comando requiere los servicios de Tivoli Management Framework. Envía un evento al servidor de eventos. Este comando requiere los servicios de Tivoli Management Framework. Envía 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

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

Comando wpostzmsg (versión de nodo gestionado)

Finalidad Envía 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 parámetros de configuración de un servidor de eventos en ejecución. Establece los parámetros de configuración 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 válido cotejándolo 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 versión 3.6.2 y anteriores del generador de reglas a la sintaxis soportada por el compilador de reglas proporcionado en esta versión del producto Tivoli Enterprise Console. Comprueba si un archivo de definiciones de clases de eventos es válido cotejándolo 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 versión 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 configuración de la base de datos generados. Actualiza las estadísticas de distribución 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 estadísticas de la base de datos. Visualiza el estado del servidor de base de datos.
Capítulo 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 recepción. Genera un informe de las tareas completadas.

Comandos del Recurso de configuración del adaptador
Comando waddac wdelac wlsac wlsaddflt wlsadenv wlsadgui wlsadval wlsaeenv wsetac wsetaddflt wsetadenv wsetadgui wsetadval wsetaeenv wstoptecgw wtouchac Finalidad Agrega un registro de configuración de adaptador para un perfil de configuración de adaptador. Elimina un registro de configuración de adaptador de un perfil de configuración de adaptador. Muestra los registros de configuración de adaptador de un perfil de configuración de adaptador. Muestra los registros de configuración de adaptador de un perfil de configuración de adaptador. Muestra una lista instalada de las variables de entorno de EIF (Recurso de integración de eventos) específicas del adaptador. Muestra un enlace instalado con las herramientas de configuración ampliadas específicas del adaptador. Muestra la información de validación instalada para un tipo de adaptador. Muestra las variables de entorno disponibles en un punto final de perfil de configuración de adaptador. Modifica un registro de configuración de adaptador existente en un perfil de configuración de adaptador. Agrega o establece un registro de configuración de adaptador para un valor predeterminado de tipo de adaptador. Instala una lista de variables de entorno de EIF (Recurso de integración de eventos) reconocidas para un tipo de adaptador. Instala un enlace de la GUI del Recurso de configuración del adaptador con una herramienta de configuración específica del tipo. Instala información de validación para un tipo de adaptador. Modifica las variables de entorno almacenadas en los puntos finales del perfil de configuración de adaptador. Detiene el gateway de Tivoli Enterprise Console. Actualiza la hora de modificación de un registro de perfil de configuración de adaptador para forzar la redistribución.

Comandos de adaptador
Comando wsighup Finalidad Vuelve a cargar los archivos de configuración y formato para el adaptador del registro de eventos de Windows y el adaptador de registro de eventos de Windows NT.

6

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

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

Sintaxis
chkclass [–k dir_base_reglas] archivo_clases

Descripción
El comando chkclass comprueba que un archivo de definiciones de clases de eventos sea válido para el directorio de base de reglas especificado por el argumento dir_base_reglas. El argumento dir_base_reglas que se utiliza con la opción –k sólo es opcional si no se ha establecido la variable de entorno $TEC_KB_DIR (que no se establece automáticamente). 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.

Autorización
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 cotejándolo con el directorio de base de reglas especificado por la variable de entorno $TEC_KB_DIR:
chkclass /install/bin/hpux/TME/TEC/classfile1

Véase también
wchkclass

Capítulo 1. Comandos

7

postemsg
Envía un evento al servidor de eventos mediante comunicaciones no de Tivoli.

Sintaxis
postemsg –S servidor | –f archivo_configuración [–m mensaje] [–r gravedad] [atributo=valor...] clase fuente

Descripción
El comando postemsg envía 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 (versión de nodo gestionado) o wpostzmsg (versión 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 configuración que esté siendo utilizado por otro programa (como por ejemplo un adaptador). Puesto que este comando no tiene acceso a los catálogos de mensajes de los paquetes de soporte de idiomas, postemsg muestra los mensajes de error en inglés únicamente.

Autorización
Ninguna.

Opciones
atributo=valor Asigna un valor a cualquier atributo válido. 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 algún 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 algún espacio en blanco en el nombre de la fuente, especifíquelo entre comillas dobles.

fuente

–f archivo_configuración Especifica el nombre del archivo de configuración del adaptador. Debe especificar el argumento –S o el argumento –f. Consulte la publicación IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –m mensaje Especifica el texto del evento, entre comillas dobles.

8

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

–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 dirección IP del servidor. Utilice esta opción ú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 envía 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 sesión su". Su_Failure LOGFILE

Véase también
postzmsg, TECAgent, wpostemsg (versión de punto final), wpostemsg (versión de nodo gestionado), wpostzmsg (versión de punto final), wpostzmsg (versión de nodo gestionado), wsetemsg

Capítulo 1. Comandos

9

postzmsg
Envía un evento al servidor de eventos mediante comunicaciones no de Tivoli.

Sintaxis
postzmsg –S servidor | –f archivo_configuración [–m mensaje] [–r gravedad] [atributo=valor...] clase fuente

Descripción
El comando postzmsg envía 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 catálogos de mensajes de los paquetes de soporte de idiomas, postzmsg muestra los mensajes de error en inglés únicamente. Notas: 1. Si Tivoli Management Framework está instalado en el sistema, puede utilizar los comandos wpostzmsg (versión de punto final) o wpostzmsg (versión 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 configuración que esté siendo utilizado por otro programa (como por ejemplo un adaptador).

Autorización
Ninguna.

Opciones
atributo=valor Asigna un valor a cualquier atributo válido. 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 algún 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 algún espacio en blanco en el nombre de la fuente, especifíquelo entre comillas dobles.

fuente

–f archivo_configuración Especifica el nombre del archivo de configuración. Debe especificar el argumento –S o el argumento –f. Consulte la publicación IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –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 dirección IP del servidor. Utilice esta

10

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

opción ú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 envía 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 sesión su". Su_Failure LOGFILE

Véase también
postemsg, TECAgent, wpostemsg (versión de punto final), wpostemsg (versión de nodo gestionado), wpostzmsg (versión de punto final), wpostzmsg (versión de nodo gestionado), wsetemsg

Capítulo 1. Comandos

11

tec_console
Inicia la consola de eventos de Tivoli Enterprise Console.

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

Descripción
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 sesión. 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 extensión del nombre de archivo .cmd; por ejemplo:
tec_console.cmd &

El proceso del servidor de la interfaz de usuario (UI) actúa de interfaz con la consola de eventos para obtener eventos del repositorio de eventos y empaquetar las solicitudes de actualización de base de datos y pasarlas al proceso de asignación 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 opción de inicio de sesión 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 opción, ejecute el siguiente comando:
odadmin set_allow_rconnect TRUE

El cambio entra en vigor de inmediato.

Autorización
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 región de gestión de Tivoli que se muestran en la tabla siguiente. También se muestran las vistas de Tivoli Enterprise Console disponibles para los dos tipos de usuarios. Consulte la publicación Tivoli Enterprise Console Guía del usuario para obtener información adicional acerca de las funciones necesarias para los usuarios de Tivoli Enterprise Console.

12

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

Usuario de la consola Administrador Operador

Funciones de región de gestión de Tivoli RIM_view, RIM_update, senior

Vistas de la consola Vistas de configuración, 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 opción, debe indicar los nombres de grupo de eventos formados por varias palabras de forma diferente en función de si utiliza el sistema operativo UNIX o Windows. En todos los sistemas operativos, el nombre de grupo de eventos es sensible a las mayúsculas y minúsculas. 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 contraseña deben ser autenticadas por Tivoli Management Framework. Especifique esta opción con el formato nombre_host:puerto si se utiliza un puerto distinto del puerto 94. –nowindow Suprime la ventana de DOS (sólo para sistemas Windows). –p contraseña Contraseña del ID de inicio de sesión del administrador de Tivoli. –u ID_usuario ID de inicio de sesión 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 sesión y la contraseña.
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 sesión y la contraseña.
tec_console.cmd -e NT &

Capítulo 1. Comandos

13

TECAgent
Envía un evento al servidor de eventos mediante comunicaciones Tivoli o no de Tivoli.

Sintaxis
java com.tivoli.tec.event_delivery.TECAgent SENDER –f archivo_configuración [–m mensaje] [–r gravedad] [atributo=valor...] clase fuente

Descripción
El comando TECAgent envía 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 función de la configuración. Nota: puesto que las aplicaciones no pueden compartir los archivos de la caché, para este comando no debe utilizar un archivo de configuración 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 configuración, 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 correlación basada en estados.

Autorización
user

Opciones
atributo=valor... Asigna un valor a cualquier atributo válido. 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 algún 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 algún espacio en blanco en el nombre de la fuente, especifíquelo entre comillas dobles.

fuente

–f archivo_configuración Especifica el nombre del archivo de configuración. Consulte la publicación

14

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

IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –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 envía 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 sesión su". Su_Failure LOGFILE

Véase también
postemsg, postzmsg, wpostemsg (versión de punto final), wpostemsg (versión de nodo gestionado), wpostzmsg (versión de punto final), wpostzmsg (versión de nodo gestionado), wsetemsg

Capítulo 1. Comandos

15

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

Sintaxis
upgrade_gui.sh dir_base_reglas

Descripción
Si tiene reglas generadas por la versión 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 versión del producto Tivoli Enterprise Console. Las reglas convertidas utilizan las funciones implementadas por la nueva versión del compilador y son más fáciles 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: efectúe 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 vacío.

Autorización
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

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

waddac
Agrega un registro de configuración de adaptador para un perfil de configuración de adaptador.

Sintaxis
waddac detalles_adaptador tipo perfil

Descripción
El comando waddac agrega un registro para configurar un adaptador de eventos de Tivoli Enterprise Console a un perfil de configuración de adaptador existente. Cuando se distribuye a los nodos gestionados de abono, el nuevo registro hace que entre en vigor la configuración del adaptador que reflejan los argumentos detalles_adaptador proporcionados, en combinación con los valores predeterminados específicos del tipo que haya instalados. Cada tipo de adaptador de cada perfil de configuración de adaptador puede estar soportado por políticas predeterminadas para proporcionar valores iniciales para componentes de la configuración no suministrados por una llamada de waddac. Del mismo modo, puede haber políticas de validación para garantizar que una configuración determinada sea válida según las necesidades de la implementación del adaptador de eventos, las particularidades de la instalación y las consideraciones de seguridad. El comando waddac escribe el valor de clave del nuevo registro de configuración de adaptador en la salida estándar. El valor de clave se puede emplear más 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 configuración del adaptador o mediante el comando wlsac.

Autorización
admin

Opciones
detalles_adaptador Proporciona la información de configuración específica del adaptador como, por ejemplo, las rutas de distribución, los ID de usuario y los filtros del adaptador empleados para los parámetros de distribución 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 específicos a los que se da soporte varían según el punto final, pero entre los que se admiten actualmente se encuentran los siguientes: action_fail Controla el manejo de anomalías de las peticiones de distribución anteriores (!comando) y posteriores (!!comando). Para obtener más información acerca de estas peticiones, consulte la opción –D. Los valores son:
Capítulo 1. Comandos

17

abort

Detener la distribución.

ignore Pasar por alto todas las anomalías. report Informar de las anomalías pero seguir con la actividad de distribución (comportamiento predeterminado). expand Controla si, al distribuir el perfil, el código 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 expansión, yes a fin de habilitarla para todos los atributos (comportamiento predeterminado), o una lista de nombres de atributo separados por comas para efectuar una expansión selectiva únicamente en los valores de esos atributos. rm_on_del Indica al código del punto final si debe eliminar los archivos de configuración y archivos distribuidos cuando se distribuye el registro tras eliminarse. El valor puede ser yes (para forzar la eliminación, que es el comportamiento predeterminado), no (para inhabilitar la eliminación y, por consiguiente, conservar los archivos en su ubicación tras la supresión del registro) o conf (para eliminar únicamente el archivo de configuración del adaptador principal). run_actions Controla si se realizan las peticiones de distribución anteriores (!comando) y posteriores (!!comando). Para obtener más información acerca de estas peticiones, consulte la opción –D. El valor puede ser yes o no, siendo yes el valor predeterminado. El código del punto final admite (salvo que la política de validación 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 configuración de adaptador. El texto de comentario se escribirá en el archivo de configuración cuando se cree la próxima 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 carácter de barra inclinada, el nombre de archivo real se formará agregando destino al directorio de destino según la especificación de una opción –d (o de los valores predeterminados de la política). En lugar del formato destino=fuente para una petición de distribución, la cadena puede tener el formato !comando o !!comando. El comando proporcionado, que puede ser cualquier sentencia válida para el intérprete de línea de comandos dependiente del sistema operativo presente en los nodos de abono (normalmente, /bin/sh, aunque en los sistemas operativos

18

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

distintos de UNIX puede ser diferente), se ejecuta antes (!) o después (!!) de la información de configuración 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 configuración del adaptador. –e nombre=valor Define una variable de entorno que se colocará en el archivo de configuración del adaptador. Pueden proporcionarse tantos argumentos –e como se desee para crear un número de variables de entorno arbitrario. Algunas variables de entorno, que las bibliotecas del adaptador de eventos reconocen directamente, controlan el funcionamiento básico del adaptador. Otras variables pueden ser utilizadas en un nivel superior por adaptadores específicos. –f filtro Define un filtro de eventos que se colocará en el archivo de configuración 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 intérprete de línea 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 configuración 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 intérprete de línea 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 cachés 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
Capítulo 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 numérico. –i on|off[,nombre_id] Especifica si se debe asignar al adaptador un identificador exclusivo y el identificador que se utilizará. Utilice esta opción 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 distribución del perfil. Si especifica –i off con nombre_id, el registro de configuración contendrá el ID pero el adaptador no tendrá un ID tras la distribución del perfil. Puede cambiar el registro de configuración mediante el comando wsetac. –m modo_prefiltro Define el modo prefiltro que se colocará en el archivo de configuración de los adaptadores Windows y NetWare. Los valores válidos son IN, in, OUT y out. El valor predeterminado es OUT. Si utiliza IN o in, también deberá proporcionar el parámetro –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 colocarán en el archivo de configuración de los adaptadores Windows y NetWare. Debe especificar como mínimo la especificación 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 configuración 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 opción –d.Tenga en cuenta que la política 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 numérico. perfil tipo Perfil de configuración de adaptador al que se agregará el nuevo registro de configuración del adaptador. Proporciona el tipo de adaptador del nuevo adaptador. El tipo de adaptador normalmente se utiliza para regir el funcionamiento de las políticas predeterminadas y de validación. Si se proporcionan tipos de adaptador desconocidos para waddac, las políticas de validación del perfil de configuración de adaptador de destino pueden rechazar el nuevo registro. Para ver los tipos disponibles, utilice el comando wlsaddflt.

20

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

Ejemplos
El ejemplo siguiente agrega una entrada de perfil de configuración 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"

Véase también
wdelac, wlsac, wsetac, wsetaddflt

Capítulo 1. Comandos

21

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

Sintaxis
wchkclass [–S servidor] [–a archivo_clases | –b archivo_clases] [[host:]ruta] ... base_reglas

Descripción
El comando wchkclass comprueba que un archivo de definiciones de clases de eventos sea válido 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.

Autorización
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 comprobación 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 comprobación 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 región de Tivoli.

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

Véase también
chkclass

22

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

wconsole
Gestiona las consolas de eventos.

Sintaxis
wconsole [opción [subopción]]

Descripción
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 opción del comando wconsole especifica su función principal. Las subopciones posteriores sólo son válidas en el contexto de la primera opción.

Autorización
senior (función de región sólo para el comando, sin opciones) En la tabla siguiente se muestran las funciones de región para opciones específicas del comando wconsole, junto con breves descripciones de las opciones.
Opción –addegflt –assigneg Descripción Agrega un nuevo filtro a un grupo de eventos. Asigna un grupo de eventos a una definición de consola de eventos. Asigna operadores a una definición de consola de eventos. Funciones de región 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 autorización de una consola de eventos en otra definición de consola. Crea una nueva definición de RIM_view, RIM_update, consola de eventos. senior Crea un nuevo grupo de eventos. Crea un nuevo operador de consola. Suprime una definición 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

Capítulo 1. Comandos

23

Opción –lsassigneg

Descripción Lista los grupos de eventos asignados a una definición de consola de eventos. Lista las definiciones de consola de eventos. Lista las consolas que están en ejecución en este momento. Lista los grupos de eventos. Lista la definición de operador.

Funciones de región 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, descripción de una definición senior de consola de eventos. Cambia el nombre y la descripción de un grupo de eventos. Cambia el nombre y la descripción de un filtro de grupo de eventos. Desasigna uno o varios grupos de eventos de una definición 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, definición de consola de senior eventos.

Notas
v Si emite el comando wconsole desde un shell bash en un sistema Windows, incluya la extensión del nombre de archivo .cmd; por ejemplo:
wconsole.cmd -delconsole -h mfoster -u Administrator \ -p chief10 -n “Personnel Systems”

v Antes de ejecutar el comando wconsole en un nodo gestionado, compruebe que el entorno Tivoli esté inicializado. v Apague las consolas de eventos en ejecución cuyas propiedades deban modificarse. Una vez realizados los cambios, reinicie las consolas para que los cambios entren en vigor.

Opciones
Cada opción del comando wconsole contiene las subopciones –h, –u y –p opcionales para especificar el nombre de host, el ID de usuario y la contraseña, respectivamente, a fin de iniciar la sesión en el host del nodo gestionado en el que Tivoli Management Framework debe autenticar el ID de usuario y la contraseña. 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 sesión; de lo contrario, si lo ejecuta en un host en un entorno no Tivoli, se muestra la ventana de inicio de sesión.

24

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

Nota: si ejecuta el comando wconsole en un nodo gestionado con el sistema operativo AIX y ha iniciado la sesión como root, debe utilizar las subopciones –h, –u y –p para especificar explícitamente el nombre del host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión 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 sólo se muestran en la tabla siguiente.
Subopción común –h host[:puerto] Definición Nombre del host del nodo gestionado en el que el ID de usuario y la contraseña deben ser autenticadas por Tivoli Management Framework. Especifique el número de puerto si el puerto empleado por el host no es el 94. ID de inicio de sesión del administrador de Tivoli. Contraseña asociada al ID de inicio de sesión del administrador de Tivoli.

–u usuario –p contraseña

Notas: 1. Los argumentos que contengan espacios deberán 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 numéricos no pueden delimitarse con ningún tipo de comilla. 4. Los valores enumerados deben especificarse por sus nombres de enumeración, no sus valores numéricos. Los valores enumerados deben delimitarse mediante comillas simples. –addegflt [–h host[:puerto]] [–u usuario] [–p contraseña] –E grupo_eventos –n nombre [–D descripción] [–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 cláusula 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 selección para que se incluyan eventos en un grupo de eventos. Un grupo de eventos puede no tener ningún filtro o tener alguno. Un evento se incluye en un grupo de eventos si satisface como mínimo los criterios de un filtro. Si no hay ningún filtro configurado para un grupo de eventos, todos los eventos se incluirán en el grupo de eventos. Cada filtro de un grupo de eventos puede constar de cero o más restricciones para los atributos de los eventos recibidos y sentencias SQL de formato libre. Una restricción 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 válida para una cláusula WHERE.

Capítulo 1. Comandos

25

Notas: 1. El comando wconsole no efectuará ninguna comprobación 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 comodín en casi todas las bases de datos:
Carácter comodín % _ [] Significado Cualquier cadena de cero o más caracteres. Cualquier carácter único. Cualquier carácter único dentro del rango especificado. Por ejemplo, [a-f] o [abcedf] Cualquier carácter único que no se encuentre dentro del rango especificado. Por ejemplo, [^a - f] o [^abcdef]

[^]

3. La sintaxis de la cláusula WHERE debe cumplir los requisitos del RDBMS empleado para la base de datos de eventos. –D descripción Descripción 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 automáticamente. Vincule varias restricciones con el operador AND. Cada una de las restricciones debe delimitarse mediante paréntesis. El argumento de restricciones completo debe escribirse entre comillas dobles; por ejemplo:
-s "(severity IN (‘CRITICAL’,’FATAL’))AND \ (source=’NT’)"

Los operadores válidos para una restricción son =, <>, <, <=, >, >=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, BETWEEN y NOT BETWEEN. La tabla siguiente muestra diversos atributos de eventos establecidos en indicaciones de la hora y el formato que debe emplearse al especificar valores para estos atributos con la subopción –s. Los valores de indicación de la hora deben delimitarse mediante comillas simples. Los valores de indicación de la hora con formato especificados en una restricción se convierten de forma interna en los tipos de datos correspondientes que requiere la base de datos de eventos.

26

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

Atributos que contienen valores de indicación 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 especificación de una restricción de filtro funciona como el diálogo Editor de restricciones de la consola de eventos. Puede especificar los mismos atributos de eventos, operadores y valores de atributos en el Editor de restricciones que con la subopción –s de la opción –addegflt. 2. Para especificar varias restricciones, utilice el operador AND. No utilice la subopción –s más de una vez en un solo comando wconsole. –S SQL_formato_libre Sentencias SQL válidas para una cláusula 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 automáticamente. Escriba el argumento SQL_formato_libre completo entre comillas. Puede emplear caracteres comodín de SQL siempre que el RDBMS empleado para la base de datos de eventos los admita. Notas: 1. El comando wconsole no efectuará ninguna comprobación 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 subopción –S más de una vez en un solo comando wconsole. –assigneg [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola –E grupo_eventos [–r rol:...] Asigna un grupo de eventos a una definición de consola de eventos. Si lo desea, también puede asignar los roles del grupo de eventos. Los 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 asignarán al grupo de eventos. Separe cada rol con un carácter de dos puntos (:). El valor predeterminado es admin. Los valores válidos son super, senior, admin y user. Si desea obtener

Capítulo 1. Comandos

27

más información sobre las funciones de Tivoli Enterprise Console, consulte la publicación IBM Tivoli Enterprise Console Guía del usuario. –assignop [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola –O operador:... Asigna operadores a una definición de consola de eventos. –C consola Nombre de la consola a la que se asignarán los operadores. –O operador:... Lista de operadores que se asignarán a la consola. Separe cada operador con un carácter 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 opción de creación de un operador en la consola de eventos o mediante el comando wconsole –crtoperator. Si un operador todavía 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 opción –lsconsole para obtener información sobre cómo 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 contraseña] –n nombre –C consola Copia los grupos de eventos, los filtros de grupos de eventos y las asignaciones de funciones de autorización de una consola de eventos en otra definición 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 están 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 contraseña] [–C consola] [–n nombre] [–D descripción] [–O operador:...] Crea una nueva definición de consola de eventos. –C consola Nombre de la consola fuente de la que se copiarán los grupos de eventos y sus funciones de autorización, así como los filtros de grupos de eventos, en la nueva definición de consola. –D descripción Descripción de texto de la nueva consola. El valor predeterminado es Nueva descripción. –n nombre Nombre de la nueva consola. El valor predeterminado es Nuevo. –O operador:... Lista de operadores que se asignarán a la nueva consola. Separe cada operador con un carácter 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

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

la opción de creación de un operador de la consola de eventos o mediante el comando wconsole –crtoperator. Si un operador todavía 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 opción –lsconsole para obtener información sobre cómo obtener una lista de todas las consolas definidas en ese momento y los operadores asignados a las mismas. –crtoperator [–h host[:puerto]] [–u usuario] [–contraseña] –O operador:... [-C consola] Crea un nuevo operador de consola. –O operador:... Lista de operadores que se crearán. Separe cada operador con un carácter 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 todavía 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 opción –lsconsole para obtener información sobre cómo 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 asignarán los nuevos operadores creados. –crteg [–h host[:puerto]] [–u usuario] [–p contraseña] –n nombre [–D descripción] [–E grupo_eventos] Crea un nuevo grupo de eventos. –D descripción Descripción 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. También se copian los filtros del grupo de eventos fuente. –n nombre Nombre del nuevo grupo de eventos. –delconsole [–h host[:puerto]] [–u usuario] [–p contraseña] –n nombre Suprime una definición de consola de eventos. Si hay instancias de la consola que están en ejecución cuando se emite esta opción, la definición no se eliminará hasta que no haya ninguna instancia en ejecución. –n nombre Nombre de la definición de consola que se va a suprimir. –deleg [–h host[:puerto]] [–u usuario] [–p contraseña] –e grupo_eventos:... Suprime uno o varios grupos de eventos, incluidos los filtros. Si alguno de los grupos de eventos especificados con esta opción 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 carácter de dos puntos (:).

Capítulo 1. Comandos

29

–delegflt [–h host[:puerto]] [–u usuario] [–p contraseña] –E grupo_eventos {–a | –n nombre} Suprime uno o varios filtros de un grupo de eventos. –a Suprime todos los filtros del grupo de eventos.

–E grupo_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 contraseña] –O operador:... Suprime un operador de consola existente. –O operador:... Lista de operadores que se suprimirán. Separe cada operador con un carácter de dos puntos (:). Las consolas asignadas primero se desasignan. Consulte la opción –lsconsole para obtener información sobre cómo 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 contraseña] –C consola Lista los grupos de eventos asignados a una definición de consola de eventos. –C consola Nombre de la consola que se desea listar. –lsconsole [–h host[:puerto]] [–u usuario] [–p contraseña] [–a] [–c consola:...] Lista las definiciones de consola de eventos. Esta opción no muestra los clientes de la consola que están instalados. –a Lista la descripción de la consola, los grupos de eventos asignados y sus funciones de autorización, así como los operadores asignados para cada definición de consola. Si no se especifica esta opción, sólo se muestran los nombres de consola.

–c consola:... Nombres de las definiciones de consola específicas que se desea listar. Separe cada nombre de consola con un carácter de dos puntos (:). Si no se especifica esta subopción, se listarán todas las definiciones de consola. -lsconsoleup [–h host[:puerto]] [–u usuario] [–p contraseña] Muestra una lista de las consolas que están en ejecución en este momento para el servidor de la interfaz de usuario en la región de Tivoli en la que el usuario que ejecuta el comando wconsole -lsconsoleup tiene iniciada una sesión. –lseg [–h host[:puerto]] [–u usuario] [–p contraseña] [–a] [–e grupo_eventos:...] Lista los grupos de eventos. –a Lista la descripción y los filtros de cada grupo de eventos. Si no se especifica esta subopción, sólo se muestran los nombres de los grupos de eventos.

–e grupo_eventos:... Nombres de los grupos de eventos específicos que se desea listar.

30

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

Separe cada nombre de grupo de eventos con un carácter de dos puntos (:). Si no se especifica esta subopción, se listarán todos los grupos de eventos. –lsoperator [–h host[:puerto]] [–u usuario] [–p contraseña] [–a] –[O operador:...] Lista las definiciones de operadores de consola. –a Lista la definición de consola asignada. Si no se especifica esta opción, sólo se muestran los nombres de operador.

–O operador:... Nombres de los operadores de consola específicos que se desea listar. Separe cada operador con un carácter de dos puntos (:). Si no se especifica esta subopción, se listarán todos los operadores de consola. –setconsole [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola [–n nombre] [–D descripción] Cambia el nombre y la descripción de una definición de consola de eventos. –C consola Nombre de la consola que se desea cambiar. –D descripción Nueva descripción 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 contraseña] [–n nombre] [–D descripción] –E grupo_eventos Cambia el nombre y la descripción de un grupo de eventos. Los cambios se replican en los grupos de eventos asignados. –D descripción Nueva descripción 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 contraseña] [–n nombre] [–D descripción] –E grupo_eventos –F filtro Cambia el nombre y la descripción de un filtro de grupo de eventos. –D descripción Nueva descripción 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.

Capítulo 1. Comandos

31

–unassigneg [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola –e grupo_eventos:... Desasigna uno o varios grupos de eventos de una definición de consola 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 carácter de dos puntos (:). –unassignop [–h host[:puerto]] [–u usuario] [–p contraseña] –C consola –O operador:... Desasigna operadores de una definición de consola de eventos. –C consola Nombre de la consola de la que se desasignarán los operadores. –O operador:... Lista de operadores que se desasignarán de la consola. Separe cada operador con un carácter de dos puntos (:). Consulte la opción –lsconsole para obtener información sobre cómo 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 estándar). 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 condición 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 carácter de barra inclinada invertida (\) situado al final de una línea indica que el texto que aparece en la línea siguiente se ha separado debido a las limitaciones de espacio de la página. El ejemplo se debe interpretar como si estuviera en una sola línea. –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

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

restricción: 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 restricción es específico de un RDBMS Microsoft SQL Server. El carácter de barra inclinada invertida antepuesto al operador es un carácter de escape para que el shell UNIX interprete correctamente el signo de exclamación.
wconsole -addegflt -E Subnet \ -n "Router Ports" -s "(class=’Link_Down’) \ AND (adapter_host IS NOT NULL)" \ -S "(repeat_count \!< 10)"

–assigneg - Ejemplos El ejemplo siguiente asigna el grupo de eventos Subnet con 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.

Capítulo 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 definición de consola denominada Personnel Systems y especifica su descripción. No se asigna ningún 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 definición de consola denominada Personnel Systems, especifica su descripción y asigna el operador denominado mf_viewer a la consola. No se asigna ningún 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 definición de consola denominada Personnel Systems, especifica su descripción, 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 opción –C corresponde a una operación 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 definición 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

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

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

La salida que visualiza este comando es:
Administrator New Test1 Test2

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

La salida que visualiza este comando es:
Administrator Description: Console for \ Administrator User Event Group: DM (User, Admin, \ Senior, Super) Event Group: UNIX_Logfile (User, \ Admin, Senior, Super) Event Group: NT (User, Admin, \ Senior, Super) New Description: New description Event Group: newEG2 (User, Admin) Event Group: newEG1 (User, Admin)

-lsconsoleup - Ejemplo A continuación se muestra un ejemplo de la salida de la opción –lsconsoleup con los valores predeterminados:
Actualmente existen 3 consolas TEC activas. Console Administrator/Operator _________________________________________ Root_jbr01-region Admin1 test1 TestAdmin DB2 DB2Admin

Capítulo 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 descripción:
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

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

wcrtdefcfg
Crea una configuración predeterminada en la consola de eventos.

Sintaxis
wcrtdefcfg operador [host[:puerto] usuario contraseña]

Descripción
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.

Autorización
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 opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. contraseña Especifica la contraseña del administrador. Esta opción es obligatoria si especifica un usuario.

Ejemplos
El ejemplo siguiente crea una configuración predeterminada para el operador Root_adasilva-region en el host calculus; el nombre y la contraseña del administrador son root y mi_contraseña:
wcrtdefcfg Root_adasilva-region calculus root mi_contraseña

Véase también
wconsole

Capítulo 1. Comandos

37

wcrtebizgroups
Crea los grupos de eventos necesarios para emplear el conjunto de reglas e-business.rls.

Sintaxis
wcrtebizgroups [host[:puerto] usuario contraseña]

Descripción
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 supervisión 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 asociación 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 demás eventos de e-business relacionados con los servicios de DB2, WebSphere Application Server y WebSphere MQ supervisados.

Autorización
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 opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. contraseña Especifica la contraseña del administrador. Esta opción es obligatoria si especifica un usuario. Nota: si está trabajando en un sistema AIX y ha iniciado la sesión como root, debe especificar explícitamente el nombre de host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión en un sistema AIX con otro ID de usuario.

38

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

Ejemplos
El ejemplo siguiente crea los grupos de eventos en un sistema denominado phizer:
wcrtebizgroups phizer.dev.tivoli.com jford mi_contraseña

Véase también
wconsole

Capítulo 1. Comandos

39

wcrtmtgroups
Crea los grupos de eventos necesarios para emplear el conjunto de reglas maintenance_mode.rls.

Sintaxis
wcrtmtgroups [host[:puerto] usuario contraseña]

Descripción
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.

Autorización
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 opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. contraseña Especifica la contraseña del administrador. Esta opción es obligatoria si especifica un usuario. Nota: si está trabajando en un sistema AIX y ha iniciado la sesión como root, debe especificar explícitamente el nombre de host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión en un sistema AIX con otro ID de usuario.

Ejemplos
El ejemplo siguiente crea los grupos de eventos en un sistema denominado phizer:
wcrtmtgroups phizer.dev.tivoli.com jford mi_contraseña

Véase también
wconsole

40

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

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

Sintaxis
wcrtnvgroups [host[:puerto] usuario contraseña]

Descripción
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 están 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.

Autorización
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 opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. contraseña Especifica la contraseña del administrador. Esta opción es obligatoria si especifica un usuario. Nota: si está trabajando en un sistema AIX y ha iniciado la sesión como root, debe especificar explícitamente el nombre de host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión en un sistema AIX con otro ID de usuario.

Ejemplos
El ejemplo siguiente crea los grupos de eventos en un sistema denominado phizer:
wcrtnvgroups phizer.dev.tivoli.com jford mi_contraseña

Véase también
wconsole

Capítulo 1. Comandos

41

wcrtsrc
Crea una fuente en el servidor de eventos.

Sintaxis
wcrtsrc [–S servidor] [–l etiqueta] fuente

Descripción
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 envían información de eventos a la consola de eventos por medio de los adaptadores de eventos. El adaptador de eventos define el nombre de una fuente.

Autorización
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 región de Tivoli.

Ejemplos
El ejemplo siguiente agrega la fuente LOGFILE a la región de Tivoli local y da a la fuente la etiqueta Logfile:
wcrtsrc –l "Logfile" LOGFILE

Véase también
wdelsrc, wlssrc, wsetsrc

42

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

wcrtteccfg
Crea una configuración predeterminada de Tivoli Enterprise Console.

Sintaxis
wcrtteccfg host[:puerto] usuario contraseña [operador]

Descripción
El comando wcrtteccfg crea una configuración predeterminada de Tivoli Enterprise Console. Utilice este comando si los datos de la configuración predeterminada de Tivoli Enterprise Console no se crean debido a una anomalía durante la instalación del servidor UI. Este comando también se puede ejecutar en cualquier momento si por cualquier motivo se pierden los datos de configuración. Nota: debido a una limitación de los sistemas AIX, los administradores deben ejecutar este comando para crear los datos iniciales.

Autorización
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. contraseña Especifica la contraseña del administrador. operador Especifica el operador que se asignará a la consola predeterminada. Este parámetro es opcional.

Ejemplos
El ejemplo siguiente crea una configuración predeterminada de Tivoli Enterprise Console para el operador Root_adasilva-region en el host calculus; el nombre y la contraseña del administrador son root y mi_contraseña:
wcrtteccfg calculus root mi_contraseña Root_adasilva-region

Capítulo 1. Comandos

43

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

Sintaxis
wdbconfig.sh [rm | rm_tbl | cr | cr_tbl | upg | upg_362]

Descripción
El script wdbconfig.sh ejecuta los scripts de configuración de la base de datos generados durante la instalación 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 instalación de la base de datos de eventos generados. El usuario debe haber iniciado la sesión 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 sesión correspondiente para el administrador de Tivoli. Para la base de datos Informix, el script wdbconfig.sh sólo se puede ejecutar en el sistema en el que está instalado el servidor de la base de datos.

Autorización
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 instalación de la base de datos. Si tiene una base de datos existente, ésta debe eliminarse antes de realizar una nueva instalación. 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 versión 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 versión 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

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

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

Sintaxis
wdbmaint.sh [reorg | stats] [nombre_objeto_rim db2server | db2client]

Descripción
El comando wdbmaint.sh mejora el rendimiento en tiempo de ejecución de la base de datos actualizando las estadísticas de la base de datos o reorganizando la base de datos. Al actualizar las estadísticas de la base de datos para reflejar la cantidad actual de datos y los valores de distribución 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 actualización de las estadísticas también actualiza la información acerca de las páginas libres en una tabla. Esto permite que la base de datos reutilice las páginas de tabla que contienen filas suprimidas. Las estadísticas de la base de datos deben actualizarse regularmente para evitar que se produzcan errores de espacio de tabla lleno; siempre deben actualizarse después 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 fragmentación. Tras ejecutarse el programa de utilidad de reorganización, las estadísticas se actualizan automáticamente. Al reorganizar la base de datos DB2 también 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 ampliación asignada por una tabla de un espacio de tablas sólo 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 después de ejecutar el comando wtdbclear. Nota: la reorganización de las bases de datos debe llevarse a cabo mientras el servidor de eventos está desconectado. Las estadísticas se pueden actualizar mientras el servidor de eventos está en ejecución. Se recomienda ejecutar estos programas de utilidad con frecuencia. En concreto, los programas de utilidad deben ejecutarse después 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 opción reorg, este comando debe ejecutarse desde el host RIM. Para todas las demás bases de datos, este comando se ejecuta desde el servidor de eventos. Para la base de datos DB2, debe iniciar la sesión como usuario RIM de Tivoli Enterprise Console DB2 y el comando debe ejecutarse desde el procesador de línea 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.

Capítulo 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.

Autorización
user

Opciones
reorg stats Permite reorganizar los índices y las tablas de la base de datos. Permite actualizar las estadísticas internas de distribución 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 conexión empleada por RIM. Este parámetro sólo se utiliza con las conexiones DB2 a RIM. El cliente DB2 solicita la contraseña 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 conexión empleada por RIM. Este parámetro sólo 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

Véase también
wtdbclear, wtdbspace

46

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

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

Sintaxis
wdelac clave... perfil

Descripción
El comando wdelac suprime los registros seleccionados por las claves proporcionadas del perfil de configuración de adaptador especificado. La próxima vez que se distribuya el perfil, se eliminarán los archivos de configuración antiguos o que no se basan en el valor del indicador de comportamiento rm_on_del.

Autorización
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 configuración del adaptador o mediante el comando wlsac. perfil Nombre del perfil de configuración 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"

Véase también
waddac, wlsac, wsetac, wsetaddflt

Capítulo 1. Comandos

47

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

Sintaxis
wdelsrc [–S servidor] fuente...

Descripción
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.

Autorización
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 región de Tivoli.

Ejemplos
El ejemplo siguiente suprime la fuente SNMP de la región de Tivoli local:
wdelsrc SNMP

Véase también
wcrtnvgroups, wlssrc, wsetsrc

48

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

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

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

Descripción
El comando wlsac escribe en la salida estándar uno o varios registros de un perfil de configuración de adaptador. Es posible proporcionar una o varias claves de registro para elegir registros individuales. Si no se especifica ninguna clave, se imprimirán 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 configuración del adaptador al efectuar la distribución). Se puede especificar otro formato con la opción –f. Con la opción –l, cada registro se imprime como una auténtica configuración de adaptador con el mismo formato empleado cuando se crean los archivos de configuración al efectuar la distribución.

Autorización
admin

Opciones
clave... Clave de los registros que se desea imprimir. Si se omite la clave, se imprimirán todos los registros. Separe las diversas claves con un espacio. Puede ver el valor de clave en la parte superior derecha del panel de entrada del perfil de configuración de adaptador o mediante este comando. perfil Nombre del perfil de configuración 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 catálogos de mensajes, es decir, un valor de índice y una solicitud de formato. Los valores siguientes están 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 distribución de archivo

Capítulo 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 distribución ID de grupo para las acciones de distribución 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 más sencillo para esos valores es del tipo ’$I{%1$s}{\n}’, que imprime cada cadena de la secuencia en una línea 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 publicación Tivoli ADE Application Services Manual, Volume 1, para obtener completa información sobre los formatos de los mensajes y los catálogos de mensajes. –l Muestra todos los registros seleccionados como configuraciones de adaptador completas.

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

El ejemplo siguiente muestra la salida del ejemplo anterior:
0 tecad_nt C:\TEMP/tecad_nt.conf Record comment tecad_nt Configuration! Env Var Defs BEGIN [email protected] 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

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

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!

Véase también
waddac, wdelac, wsetac, wsetaddflt

Capítulo 1. Comandos

51

wlsaddflt
Muestra información predeterminada global sobre los tipos de adaptador definidos.

Sintaxis
wlsaddflt [ –l | –f formato] [tipo... ]

Descripción
El comando wlsaddflt recupera información predeterminada global para uno o varios tipos de adaptador. Si no se especifica ningún tipo, wlsaddflt imprime información 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 configuración del adaptador al efectuar la distribución). Se puede especificar otro formato con la opción –f. Con la opción –l, cada registro se imprime como una auténtica configuración de adaptador con el mismo formato empleado cuando se crean los archivos de configuración al efectuar la distribución.

Autorización
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 catálogos de mensajes, es decir, un valor de índice y una solicitud de formato. Los valores siguientes están 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 distribución de archivo Secuencia de indicadores de comportamiento de punto final ID de usuario para las acciones de distribución ID de grupo para las acciones de distribución

52

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

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 más sencillo para esos valores es del tipo ’$I{%1$s}{\n}’, que imprime cada cadena de la secuencia en una línea 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 publicación Tivoli ADE Application Services Manual, Volume 1, para obtener completa información sobre los formatos de los mensajes y los catálogos de mensajes. –l Muestra todos los registros seleccionados como configuraciones de adaptador completas.

Ejemplos
El ejemplo siguiente muestra el registro de configuración para el tipo tecad_hpov:
# wlsaddflt -l tecad_hpov :::: record tecad_hpov :::: # Sun 06 Aug 2000 07:05:49 PM CDT # # tecad_hpov Configuration # [email protected] EventMaxSize=4096 WellBehavedDaemon=TRUE BufEvtPath=$TIVOLIHOME/tec/${AC_TYPE}.cache

Véase también
waddac, wdelac

Capítulo 1. Comandos

53

wlsadenv
Muestra una lista instalada de las variables de entorno de EIF (Recurso de integración de eventos) específicas del adaptador.

Sintaxis
wlsadenv tipo

Descripción
El comando wlsadenv escribe en la salida estándar la lista de variables de entorno del Recurso de integración de eventos reconocidas por el tipo de adaptador especificado, separadas por líneas nuevas. El Recurso de configuración del adaptador utiliza el tipo __generic__ para la lista de variables reconocidas por la propia biblioteca del Recurso de integración de eventos.

Autorización
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 integración de eventos para el tipo de adaptador tecad_logfile:
wlsadenv tecad_logfile

Este ejemplo devuelve la siguiente información:
UnmatchLog LogSources

Véase también
waddac, wsetadenv, wlsadgui, wlsadval

54

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

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

Sintaxis
wlsadgui tipo

Descripción
El comando wlsadgui escribe en la salida estándar el nombre de clase, el nombre de instancia y la etiqueta de botón instalada con wsetadgui para el tipo de adaptador especificado. Si un adaptador tiene herramientas de configuración ampliadas especiales destinadas al uso con las herramientas de configuración gráficas del archivo de configuración del adaptador, debe establecerse un enlace al instalar el adaptador.

Autorización
admin

Opciones
tipo Tipo de adaptador. Para ver los tipos disponibles, utilice el comando wlsaddflt.

Ejemplos
El ejemplo siguiente muestra las herramientas de configuración ampliadas para el tipo tecad_logfile:
# wlsadgui tecad_logfile @LogfileConfiguration:LogfileConfiguration Logfile Format Editor...

Véase también
wlsac, wlsadenv, wsetadgui, wlsadval

Capítulo 1. Comandos

55

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

Sintaxis
wlsadval atributo tipo

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

Autorización
admin

Opciones
atributo Nombre del atributo de perfil cuya información de validación debe imprimirse. La lista siguiente muestra los atributos de un perfil de configuración de adaptador típico: ACPbhv Secuencia de variables de comportamiento del perfil, separadas por líneas nuevas. ACPcomment Campo de comentarios. ACPdist Secuencia de peticiones de distribución, separadas por líneas nuevas. ACPev Secuencia de variables de entorno, separadas por líneas nuevas. ACPflt Secuencia de definiciones de filtro, separadas por líneas nuevas. ACPgid ID de grupo para las acciones de punto final. ACPtargdir Directorio de instalación de configuración. ACPtarget Nombre de archivo de configuración principal de destino. ACPtype Tipo de registro. Normalmente este atributo no necesita validación. 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

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

Ejemplos
El ejemplo siguiente muestra la información de validación 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

Véase también
wlsac, wlsadenv, wsetadgui

Capítulo 1. Comandos

57

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

Sintaxis
wlsaeenv [–a] punto_final

Descripción
El comando wlsaeenv imprime en la salida estándar la lista de variables de entorno y sus valores para un punto final determinado. Cada una de las variables se imprime en una línea con el formato nombre=valor. Este formato se puede emplear con wsetaeenv cuando ese comando se ejecuta con la opción –i. Por consiguiente, es posible emplear wlsaeenv y wsetaeenv en combinación para copiar el entorno de un punto final en otro.

Autorización
admin

Opciones
punto_final Nombre del objeto de punto final que se modificará. Se puede hacer referencia al objeto de punto final con la notación @Classname:etiqueta estándar; de lo contrario, se supone que es una referencia a un objeto de nodo gestionado. –a Solicita que se impriman las cuatro variables automáticas específicas del punto final (ACPEP_NAME, ACPEP_CLASS, ACPEP_NODE y ACPEP_OID) junto con todas las establecidas con wsetaeenv. La variable ACPEP_NODE sólo 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 ningún 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 información:
[email protected]:xerius ACPEP_OID=1170507881.2.508+#TMF_Endpoint::Endpoint# ACPEP_CLASS=Endpoint

Véase también
waddac, wdelac, wdistrib (en la publicación IBM Tivoli Management Framework Reference Manual), wsetaeenv

58

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

wlsemsg
Lista los eventos recibidos.

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

Descripción
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 devolverán todos los eventos. Si desea especificar varios valores para un indicador, utilice el indicador varias veces, salvo que se indique lo contrario para la opción. Cuando utilice las opciones, sólo se devolverán los eventos que cumplan la especificación de todas las opciones. Utilice la opción –k para especificar claves de clasificación para los eventos devueltos.

Autorización
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. Sólo se indicarán los eventos que pasen los filtros del grupo de eventos. –k clave Especifica los campos por los que se efectuará la clasificación. 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 concatenación 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 ubicación también puede configurar gravedades adicionales. –t estado Especifica un estado Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE) o Confirmado (ACK).

Capítulo 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"

Véase también
“wtdumper” en la página 132, “wtdumprl” en la página 134, wpostemsg (versión de punto final), wsetemsg

60

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

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

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

Descripción
El comando wlsesvrcfg lista los parámetros de configuración de un servidor de eventos en ejecución. El servidor de la región de Tivoli local es el servidor predeterminado salvo que se especifique otro servidor. Si no se especifica ninguna opción, se visualizarán todos los parámetros.

Autorización
user

Opciones
–b –c –e –k –m –n Visualiza el número máximo de mensajes de eventos colocados en el búfer de recepción. Visualiza el número de eventos que pueden almacenarse en la caché de eventos. Visualiza el número de segundos que se conservan los eventos recibidos en el registro de recepción. Visualiza el número de segundos que deben conservarse los eventos cerrados en la caché de eventos. Visualiza el número de segundos que deben concederse al servidor de eventos para inicializarse. Visualiza el número 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 región de Tivoli. –t Visualiza si el seguimiento de reglas está habilitado y el nombre de ruta del archivo de seguimiento.

Capítulo 1. Comandos

61

Ejemplos
El ejemplo siguiente lista información correspondiente al servidor de eventos instalado en la región de Tivoli denominada gray-region:
# wlsesvrcfg -S @EventServer#gray-region -t

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

Véase también
wsetesvrcfg

62

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

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

Sintaxis
wlssrc [–S servidor] [–l] [fuente...]

Descripción
El comando wlssrc lista las fuentes que están configuradas en este momento en el servidor de eventos. Si no se especifica ninguna fuente, se listarán todas. Puede emplear opciones para ver la etiqueta para cada fuente. LA etiqueta representa la fuente en las consolas de eventos de los administradores.

Autorización
user

Opciones
fuente... Especifica una fuente para obtener una lista de la misma o una expresión regular Perl. Si no se especifica ninguno, se listarán 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 región de Tivoli.

Ejemplos
El ejemplo siguiente lista toda la información acerca de todas las fuentes del servidor de eventos local:
wlssrc –bl

Véase también
wcrtsrc, wdelsrc, wsetsrc

Capítulo 1. Comandos

63

wmigcon
Efectúa la migración de las consolas, los grupos de eventos, los filtros de grupo de eventos y los operadores de la versión 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 contraseña] [–x e | r | c]

Descripción
El comando wmigcon lleva a cabo una migración automática de las consolas, los grupos de eventos y los operadores de una instalación de la versión 3.6 de Tivoli Enterprise Console existente al formato adecuado para la consola de eventos de la versión 3.7, 3.8 y 3.9. Este comando normalmente se utiliza sólo una vez, durante la configuración inicial del producto Tivoli Enterprise Console, versión 3.7, 3.8 o 3.9. La tabla siguiente indica cómo 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 precisión 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 versión 3.6 de Tivoli Enterprise Console realiza el filtrado basándose 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 demás atributos. El comando wmigcon crea un nuevo filtro que

64

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

coincide exactamente con una sola fuente. Es decir, no hay ningún carácter comodín (%) en el filtro de la versión 3.9 de Tivoli Enterprise Console. Por lo tanto, si la fuente (source) y una subfuente (sub_source) de un filtro de la versión 3.6 de Tivoli Enterprise Console son las siguientes:
source: “LOG” sub_source: “LOGFILE”

el filtro de la versión 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 comodín, lo que le permite coincidir con cualquier cadena que contenga la subcadena LOGFILE, pero el atributo source sólo coincide con las cadenas que son exactamente LOG.

Autorización
super, senior

Opciones
–h host[:puerto] Nombre del nodo gestionado que contiene la consola de eventos de Tivoli Enterprise Console versión 3.6. Especifique esta opción con el formato host:puerto si se utiliza un puerto distinto del puerto 94. –p contraseña Contraseña del inicio de sesión especificado en el argumento –u usuario. Esta opción es obligatoria si utiliza la opción –u para especificar un usuario. –u usuario Inicio de sesión empleado como administrador de Tivoli. Si no especifica esta opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. –x e | r | c Modo de resolución 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 número al nuevo objeto.Los indicadores son sensibles a las mayúsculas y minúsculas. El espacio entre la opción y el indicador es opcional. Nota: si está trabajando en un sistema AIX y ha iniciado la sesión como root, debe utilizar las subopciones –h, –u y –p para especificar explícitamente el nombre del host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión en un sistema AIX con otro ID de usuario.

Ejemplos
El ejemplo siguiente lleva a cabo la migración 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

Capítulo 1. Comandos

65

wpostemsg (versión de punto final)
Envía 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_configuración] [–m mensaje] [–r gravedad ] [ atributo=valor... ] clase fuente

Descripción
El comando wpostemsg envía 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 configuración que esté siendo utilizado por otro programa (como por ejemplo un adaptador). Este comando requiere la instalación 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 instalación 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 versión de punto final del comando. Los ejemplos siguientes ilustran cómo 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 Asegúrese de que la sentencia PATH no incluya ambas versiones del comando.

Autorización
user

Opciones
atributo=valor... Asigna un valor a cualquier atributo válido. 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 algún espacio en blanco en el nombre de la clase, especifique el nombre de la clase entre comillas dobles.

66

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

fuente

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

–f archivo_configuración Especifica el nombre del archivo de configuración. Consulte la publicación IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –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 envíen 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 región de Tivoli. Si no especifica la opción –S o –f, el evento se envía 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 dirección 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 envía 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

Véase también
postemsg, postzmsg, TECAgent, wpostemsg (versión de nodo gestionado), wpostzmsg (versión de punto final), wpostzmsg (versión de nodo gestionado), wsetemsg

Capítulo 1. Comandos

67

wpostemsg (versión de nodo gestionado)
Envía un al servidor de eventos mediante comunicaciones de nodo gestionado Tivoli.

Sintaxis
wpostemsg [–S servidor | –f archivo_configuración] [–m mensaje] [–r gravedad] [atributo=valor...] clase fuente

Descripción
El comando wpostemsg envía 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 configuración que esté siendo utilizado por otro programa (como por ejemplo un adaptador). Este comando requiere la instalación de Tivoli Management Framework en el sistema en el que se ejecuta este comando. Este comando se encuentra en el directorio $BINDIR/bin. La versión 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 instalación.

Autorización
user

Opciones
atributo=valor... Asigna un valor a cualquier atributo válido. 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 algún 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 algún espacio en blanco en el nombre de la fuente, especifíquelo entre comillas dobles.

fuente

–f archivo_configuración Especifica el nombre del archivo de configuración del adaptador. Consulte la publicación IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –m mensaje Texto del evento, entre comillas dobles.

68

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

–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 región de Tivoli. Si no se especifica la opción –S ni –f, el evento se envía al servidor de eventos con nombre local.

Ejemplos
El siguiente ejemplo envía 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

Véase también
postemsg, postzmsg, TECAgent, wpostemsg (versión de punto final), wpostzmsg (versión de punto final), wpostzmsg (versión de nodo gestionado), wsetemsg

Capítulo 1. Comandos

69

wpostzmsg (versión de punto final)
Envía 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_configuración] [–m mensaje] [–rgravedad] [atributo=valor...] clase fuente

Descripción
El comando wpostzmsg envía un evento a un servidor de eventos mediante comunicaciones de punto final Tivoli a un gateway Tivoli Enterprise Console. Este comando requiere la instalación 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 configuración 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 instalación 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 versión de punto final del comando. Los ejemplos siguientes ilustran cómo 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 Asegúrese de que la sentencia PATH no incluya ambas versiones del comando.

Autorización
user

Opciones
atributo=valor Asigna un valor a cualquier atributo válido. 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 algún 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 algún espacio en blanco en el nombre de la fuente, especifíquelo entre comillas dobles.

fuente

–f archivo_configuración Especifica el nombre del archivo de configuración. Para realizar el envío

70

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

directamente al servidor de eventos, especifique el transporte SOCKET en el archivo de configuración. Consulte la publicación IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –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 envíen 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 región de Tivoli. Si no especifica la opción –S o –f, el evento se envía 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 dirección 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 envía 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 sesión su." Su_Failure LOGFILE

Véase también
postemsg, postzmsg, TECAgent, wpostemsg (versión de punto final), wpostemsg (versión de nodo gestionado), wpostzmsg (versión de nodo gestionado), wsetemsg

Capítulo 1. Comandos

71

wpostzmsg (versión de nodo gestionado)
Envía un evento al servidor de eventos mediante comunicaciones de nodo gestionado Tivoli o mediante comunicaciones no de Tivoli.

Sintaxis
wpostzmsg [–S servidor | –f archivo_configuración] [–m mensaje] [–rgravedad] [atributo=valor...] clase fuente

Descripción
El comando wpostzmsg envía un evento a un servidor de eventos mediante comunicaciones de nodo gestionado Tivoli o mediante comunicaciones no de Tivoli. Este comando requiere la instalación 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 configuración que esté siendo utilizado por otro programa (como por ejemplo un adaptador). La versión 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 instalación.

Autorización
user

Opciones
atributo=valor Asigna un valor a cualquier atributo válido. 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 algún 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 algún espacio en blanco en el nombre de la fuente, especifíquelo entre comillas dobles.

fuente

–f archivo_configuración Especifica el nombre del archivo de configuración. Consulte la publicación IBM Tivoli Enterprise Console Event Integration Facility Reference para obtener más información acerca de los archivos de configuración. –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

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

local. Para indicar un servidor remoto, especifique @EventServertmr, siendo tmr el nombre de una región de Tivoli. Si no se especifica la opción –S ni –f, el evento se envía al servidor de eventos con nombre local.

Ejemplos
El ejemplo siguiente para los entornos UNIX envía 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 sesión su." Su_Failure LOGFILE

Véase también
postemsg, postzmsg, TECAgent, wpostemsg (versión de punto final), wpostemsg (versión de nodo gestionado), wpostzmsg (versión de punto final), wsetemsg

Capítulo 1. Comandos

73

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

Sintaxis
wrb [opción [subopción]]

Descripción
Utilice el comando wrb para gestionar las bases de reglas. Puede llevar a cabo tareas tales como crear, ver información, manipular, suprimir, compilar, cargar y activar bases de reglas con este comando. La primera opción de este comando especifica su función principal. Las subopciones posteriores sólo son válidas 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 demás archivos del directorio de base de reglas. Este acceso no se otorga agregando un usuario al inicio de sesión 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 definición 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 definición de atributo de clase de evento se han definido en el archivo BAROC. v Las clases padre a las que hace referencia una clase hija (relación ISA) se han definido en el archivo BAROC. v Los valores de atributo y faceta son del tipo correcto y están dentro del rango. v No se ha definido ninguna enumeración ni clase de evento más de una vez. v No se ha definido más de una vez ningún atributo de una clase de evento. v Los filtros de eventos y los filtros de atributos hacen referencia a las clases de eventos y a los atributos de clases de eventos que se han definido en un 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

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

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 extensión de archivo .baroc) o archivos de conjunto de reglas (con la extensión de archivo .rls) a una base de reglas, es preciso especificar el nombre del archivo (con la extensión). Una vez que estos objetos se hayan importado a una base de reglas, deberá utilizar el nombre lógico (es decir, sin la extensión) en las opciones 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 versión más reciente del objeto. Cada opción de comando siguiente especifica si es necesario especificar el nombre del archivo o el nombre del objeto. Nota: para obtener información sobre los convenios de denominación de todos los objetos de reglas (bases de reglas, conjuntos de reglas, paquetes de reglas, etc.), consulte la publicación IBM Tivoli Enterprise Console Rule Developer’s Guide.

Autorización
user (función de región para el comando wrb) En la tabla siguiente se listan las funciones de región para las opciones del comando wrb.
Opción 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 Autorización user senior senior user senior user senior user user user senior senior user senior user user user user senior senior

Capítulo 1. Comandos

75

Opción de comando –imprprule –imptdp –imptgtdata –imptgtrule –loadrb –lscurrb –lsrb –lsrbclass –lsrbpack –lsrbrule –lsrbtarget –setrb

Autorización 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 función de lenguaje de regla o BAROC que ha quedado obsoleta. –profile Habilita los perfiles para la base de reglas en la compilación. Para habilitar o suprimir los perfiles en el nivel del conjunto de reglas o la regla de una base de reglas, consulte la información sobre directivas de perfiles de la publicación IBM Tivoli Enterprise Console Rule Developer’s Guide. –trace Habilita el seguimiento para la base de reglas en la compilación. Para habilitar o suprimir el seguimiento en el nivel del conjunto de reglas o la regla de una base de reglas, consulte la información sobre directivas del compilador de reglas trace de la publicación IBM Tivoli Enterprise Console Rule Developer’s 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

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

fuente debe encontrarse en un estado coherente para que se pueda copiar. Puede eludir la comprobación 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 opción –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 también se copian en la base de reglas de destino. destino Nombre de la base de reglas en la que se copiará la información. fuente Nombre de la base de reglas de la que se copiará la información.

–classes Copia clases de eventos. –delete Suprime todos los archivos existentes de la base de reglas de destino antes de escribir información 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 acción 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 región 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 comprobación de coherencia con el argumento –force. Automáticamente 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 sólo es posible cargar y activar una a la vez. base_reglas Nombre de la base de reglas que se desea crear. –force Fuerza la creación 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.
Capítulo 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 colección 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 importarán 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 línea 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 distribuirán 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 automáticamente 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 importarán. 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 línea 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 ejecución y el conjunto de reglas dependency.rls debe estar cargado y activo; para obtener más información acerca del conjunto de reglas dependency.rls, consulte la publicación Tivoli Enterprise Console Rule Set Reference. Nota: esta opción utiliza el programa de utilidad wpostemsg para enviar al servidor de eventos la información de dependencias como

78

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

eventos. Puede definir la configuración del programa de utilidad wpostemsg al que llama la opción deldp creando un archivo de configuración denominado $BINDIR/bin/wrb_eif.conf. Si este archivo de configuración tiene la acumulación de eventos desactivada (BufferEvents=NO), en el caso de que el servidor de eventos no esté en ejecución el comando wrb –deldp fallará y devolverá un error. Sin embargo, si se utiliza la configuración de wpostemsg predeterminada, los eventos se acumulan en el búfer y, aunque no se envían 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 eliminarán de la base de conocimientos. Para obtener información acerca de este archivo y de la definición de relaciones de dependencia para el conjunto de reglas de e-business, consulte la publicación 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 opción, se suprime el archivo BAROC especificado de la base de reglas. Copie el archivo BAROC en una ubicación 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.

Capítulo 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 opción 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 ubicación 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

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

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 codificación ] [–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, agregándolo 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 codificación Especifica la codificación de caracteres del archivo de clases. Si no se especifica esta opción, los archivos de clases que se importen a una base de reglas se abrirán con la codificación UTF-8. Para obtener más información acerca de las codificaciones internacionales, consulte el apartado “Notas” en la página 86. –force Importa el archivo de clases aunque con ello pueda producirse una incoherencia de base de reglas. –imprbrule archivo_reglas [–encoding codificación ] [–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 comprobación de coherencia con el argumento –force.
Capítulo 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 extensión de archivo .rls). –encoding codificación Especifica la codificación de caracteres del archivo de clases. Si no se especifica esta opción, los archivos de clases que se importen a una base de reglas se abrirán con la codificación UTF-8. Para obtener más información acerca de las codificaciones internacionales, consulte el apartado “Notas” en la página 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 opción 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 ejecución y el conjunto de reglas dependency.rls debe estar cargado y activo; para obtener más información acerca del conjunto de reglas dependency.rls, consulte la publicación Tivoli Enterprise Console Rule Set Reference. Nota: esta opción utiliza el programa de utilidad wpostemsg para enviar al servidor de eventos la información de dependencias como eventos. Puede definir la configuración del programa de utilidad wpostemsg al que llama la opción imptdp creando un archivo de configuración denominado $BINDIR/bin/wrb_eif.conf. Si este archivo de configuración tiene la acumulación de eventos

82

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

desactivada (BufferEvents=NO), en el caso de que el servidor de eventos no esté en ejecución el comando wrb –imptdp fallará y devolverá un error. Sin embargo, si se utiliza la configuración de wpostemsg predeterminada, los eventos se acumulan en el búfer y, aunque no se envían 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 agregarán a la base de conocimientos como hechos de dependencias. Para obtener información acerca de este archivo y de la definición de relaciones de dependencia para el conjunto de reglas de e-business, consulte la publicación 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 configuración de Recurso de integración 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 opción 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.
Capítulo 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 válidos. La base de reglas cargada sustituye a todas las especificaciones de clase de evento y reglas definidas actualmente en el servidor. Sólo 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 después 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 están definidas en este momento en el servidor de eventos. Puede haber muchas bases de reglas definidas en el servidor de eventos, aunque sólo 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 extensión de archivo es .baroc), archivos de reglas (cuya extensión de archivo es .rls), archivos de paquetes de reglas (cuya extensión 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 expresión regular Perl. La acción 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 acción predeterminada es que sólo 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 expresión regular Perl. Este argumento restringe la lista de clases que se muestra. La acción 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

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

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 específico o una expresión regular Perl. Si no especifica este argumento, se visualizarán 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 específico o una expresión regular Perl. Si no especifica este argumento, se visualizarán 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 específico o una expresión regular Perl. Si no especifica este argumento, se visualizarán 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 comprobación de coherencia con el argumento –force. base_reglas Nombre de la base de reglas que se desea modificar.

Capítulo 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 (página de códigos 932) para el texto en japonés, 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 codificación distinta de la predeterminada en el sistema local, especifique la opción –encoding junto con el nombre de la codificación de caracteres de archivo en el comando wrb –imprbclass o wrb –imprbrule. Puede especificar cualquiera de las codificaciones de caracteres siguientes: ASCII Código estándar americano para el intercambio de información (American Standard Code for Information Interchange) Cp1252 Windows Latino-1 ISO8859_1 ISO 8859, alfabeto latino número 1 UTF-16BE Formato de transformación de Unicode de 16 bits, orden de bytes big-endian UTF-16LE Formato de transformación de Unicode de 16 bits, orden de bytes little-endian UTF-8 Formato de transformación de Unicode de 8 bits UTF-16 Formato de transformación 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á (bilingüe, francés), Países Bajos, Portugal, Brasil, Australia Cp273 IBM Austria, Alemania Cp277 IBM Dinamarca, Noruega Cp278 IBM Finlandia, Suecia Cp280 IBM Italia Cp284 IBM Catalán/España, español de Latinoamérica Cp285 IBM Reino Unido, Irlanda Cp297 IBM Francia Cp420 IBM Árabe Cp424 IBM Hebreo Cp437 MS-DOS EE.UU., Australia, Nueva Zelanda, Sudáfrica Cp500 EBCDIC 500V1 Cp737 PC Griego Cp775 PC Báltico Cp838 IBM Tailandia SBCS ampliado Cp850 MS-DOS Latino-1 Cp852 MS-DOS Latino-2 Cp855 IBM Cirílico Cp856 IBM Hebreo

86

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

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 carácter del euro MS-DOS Portugués MS-DOS islandés PC Hebreo MS-DOS Francés de Canadá PC Árabe MS-DOS Nórdico MS-DOS Ruso MS-DOS Pakistán IBM Griego moderno IBM multilingüe Latino 2 IBM Islandia IBM Tailandia IBM Griego IBM Pakistán (Urdu) IBM Letonia, Lituania (AIX, DOS) IBM Estonia (AIX, DOS) Japonés 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 Japonés Latino Kanji combinado con 4370 UDC, superconjunto de 5035 IBM OS/2 Japonés, superconjunto de Cp932 Variante de Cp942 IBM OS/2 Japonés, superconjunto de Cp932 y Shift-JIS Variante de Cp943 OS/2 Chino (Taiwán), superconjunto de Cp938 PC Coreano Variante de Cp949 PC Chino (Hong Kong, Taiwán) AIX Chino (Taiwán) AIX Coreano IBM AIX Pakistán (Urdu) IBM Multilingüe cirílico: Bulgaria, Bosnia, Hercegovina, Macedonia IBM Latino-5, Turquía IBM Árabe — Windows IBM Irán (Farsi)/Persa IBM Irán (Farsi)/Persa (PC) IBM Letonia, Lituania IBM Estonia IBM Ucrania IBM AIX Ucrania Variante de Cp037 con el carácter del euro Variante de Cp273 con el carácter del euro Variante de Cp277 con el carácter del euro Variante de Cp278 con el carácter del euro Variante de Cp280 con el carácter del euro Variante de Cp284 con el carácter del euro
Capítulo 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 carácter del euro Variante de Cp297 con el carácter del euro Variante de Cp500 con el carácter del euro Variante de Cp871 con el carácter del euro Windows Europeo Oriental Windows Cirílico Windows Griego Windows Turco Windows Hebreo Windows Árabe Windows Báltico Windows Vietnamita IBM OS/2, DOS República Popular de China (RPC) IBM AIX República Popular de China (RPC) IBM-eucJP — Japonés (superconjunto de 5050) GB2312, codificación EUC, chino simplificado JIS X 0201, 0208, 0212, codificación EUC, japonés JIS X 0201, 0208, codificación EUC, japonés KS C 5601, codificación EUC, coreano CNS11643 (plano 1–3), codificación EUC, chino tradicional GBK, chino simplificado ISO 2022 CN, chino (únicamente conversión a Unicode) JIS X 0201, 0208 en formato ISO 2022, japonés ISO 2022 KR, coreano ISO 8859–2, alfabeto latino número 2 ISO 8859–3, alfabeto latino número 3 ISO 8859–4, alfabeto latino número 4 ISO 8859–5, alfabeto latino/cirílico ISO 8859–6, alfabeto latino/arábigo ISO 8859–7, alfabeto latino/griego ISO 8850–8, alfabeto latino/hebreo ISO 8859–9, alfabeto latino número 5 ISO 8859–13, alfabeto latino número 7 ISO 8859–15, alfabeto latino número 9 JIS X 0201, japonés JIS X 0208, japonés JIS X 0212, japonés Detecta Shift-JIS, EUC-JP, ISO 2022 JP y los convierte (únicamente conversión a Unicode) Johab, coreano KOI8–R, ruso Windows Tailandés Windows Japonés Windows Chino simplificado Windows Coreano Windows Chino tradicional Macintosh Arábe Macintosh Latino-2 Macintosh Croata Macintosh Cirílico Macintosh Dingbat Macintosh Griego Macintosh Hebreo Macintosh Islandia

88

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

MacRoman MacRomania MacSymbol MacThai MacTurkish MacUkraine SJIS TIS620

Macintosh Romano Macintosh Rumanía Macintosh Symbol Macintosh Tailandés Macintosh Turco Macintosh Ucrania Shift-JIS, japonés TIS620, Tailandés

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 información 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 continuación:
wrb -delrbrule all_instances MyRuleSet

Capítulo 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

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

wrb_default_rb
Desactiva los conjuntos de reglas activos en la base de reglas predeterminadas.

Sintaxis
wrb_default_rb –inactivate conjuntos_reglas

Descripción
El comando wrb_default_rb desactiva todos los conjuntos de reglas de la base de reglas predeterminada que están activados de forma predeterminada, es decir, los conjuntos de reglas maintenance_mode, netview, ebusiness, heartbeat y cleanup. Nota: el conjunto de reglas de dependencia también está activo de forma predeterminada, pero su actividad está vinculada al conjunto de reglas de e-business y sólo 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.

Autorización
Ninguna.

Opciones
rulesets Especifica los nombres de los conjuntos de reglas que se van a desactivar. Para desactivar más 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

Capítulo 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 versión 3.7 y posteriores. Nota: este comando está situado en el directorio $BINDIR/TME/TEC y no en la ubicación estándar ($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 demás archivos del directorio de base de reglas.

Sintaxis
wrbupgrade [ –f –p ruta_de_base_reglas |–n nombre_base_reglas]

Descripción
Sólo 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 versión 3.7. No es preciso que ejecute este comando para emplear el comando wrb.

Autorización
user

Opciones
–f Especifica que el comando wrbupgrade debe ejecutarse aunque la base de reglas especificada ya se haya actualizado. Esta opción sólo es válida con la opción -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

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

wsendresp
Visualiza un mensaje en el escritorio del operador.

Sintaxis
wsendresp operador [host:]ruta_archivo

Descripción
Envía el contenido del archivo especificado en una ventana emergente a la consola especificada. Una regla también 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 acción 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 ejecución.

Autorización
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

Capítulo 1. Comandos

93

wsetac
Modifica un registro de configuración de adaptador para un perfil de configuración de adaptador.

Sintaxis
wsetac detalles_adaptador clave perfil

Descripción
El comando wsetac permite modificar un registro existente de un perfil de configuración de adaptador. Cada tipo de adaptador de cada perfil de configuración de adaptador puede estar soportado por políticas predeterminadas para proporcionar valores iniciales para componentes de la configuración no suministrados por una llamada de waddac. Del mismo modo, podría haber políticas de validación para garantizar que una configuración determinada sea válida según las necesidades de la implementación del adaptador de eventos, las particularidades de la instalación local y las consideraciones de seguridad. El comando wsetac escribe el valor de clave del nuevo registro de configuración de adaptador en la salida estándar. El valor de clave se puede emplear más adelante para modificar o eliminar el registro.

Autorización
admin

Opciones
detalles_adaptador Proporciona la información de configuración específica del adaptador como, por ejemplo, las rutas de distribución, los ID de usuario y los filtros del adaptador empleados para los parámetros de distribución del adaptador. –a Indica que los valores proporcionados en la línea de comandos para los atributos de “lista” (entorno, filtros, acciones de distribución 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 según 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 distribución, se eliminan las diversas copias efectuadas para el mismo nombre de ruta. En el caso de los filtros, las entradas duplicadas se eliminan.

94

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

–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 específicos a los que se da soporte varían según el punto final, pero entre los que se admiten actualmente se encuentran los siguientes: action_fail Controla el manejo de anomalías de las peticiones de distribución de !comando y !!comando. Los valores son: ignore Pasar por alto todas las anomalías. report Informar de las anomalías pero seguir con la actividad de distribución (comportamiento predeterminado). abort expand Controla si, al distribuir el perfil, el código 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 expansión, yes a fin de habilitarla para todos los atributos (comportamiento predeterminado), o una lista de nombres de atributo separados por comas para efectuar una expansión selectiva únicamente en los valores de esos atributos. rm_on_del Indica al código del punto final si debe eliminar los archivos de configuración y archivos distribuidos cuando se distribuye el registro tras eliminarse. El valor puede ser yes (para forzar la eliminación, que es el comportamiento predeterminado), no (para inhabilitar la eliminación y, por consiguiente, conservar los archivos en su ubicación tras la supresión del registro) o conf (para eliminar únicamente el archivo de configuración del adaptador principal). run_actions Controla si se llevan a cabo peticiones de distribución de !comando y !!comando. El valor puede ser yes o no, siendo yes el valor predeterminado. El código del punto final admite (salvo que la política de validación 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 configuración de adaptador. El texto de comentario se escribirá en el archivo de configuración cuando se cree la próxima 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
Capítulo 1. Comandos

Detener la distribución.

95

destino no empieza por un carácter de barra inclinada, el nombre de archivo real se formará agregando destino al directorio de destino según la especificación de una opción –d (o de los valores predeterminados de la política). En lugar del formato destino=fuente para una petición de distribución, la cadena puede tener el formato !comando o !!comando. El comando proporcionado, que puede ser cualquier sentencia válida para el intérprete de línea 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 después (!!) de la información de configuración 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 configuración del adaptador. –e nombre=valor Define una variable de entorno que se colocará en el archivo de configuración del adaptador. Pueden proporcionarse tantos argumentos –e como se desee para crear un número de variables de entorno arbitrario. Algunas variables de entorno, que las bibliotecas del adaptador de eventos reconocen directamente, controlan el funcionamiento básico del adaptador. Otras variables pueden ser utilizadas en un nivel superior por adaptadores específicos. –f filtro Define un filtro de eventos que se colocará en el archivo de configuración 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 intérprete de línea 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 configuración 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 intérprete de línea de comandos tenga en cuenta los caracteres de

96

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

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 cachés 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 numérico. –i on|off[,nombre_id] Especifica si se debe asignar al adaptador un identificador exclusivo y el identificador que se utilizará. Utilice esta opción 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 configuración contendrá el ID pero el adaptador no tendrá un ID tras la distribución del perfil. –m modo_prefiltro Define el modo prefiltro que se colocará en el archivo de configuración de los adaptadores Windows y NetWare. Los valores válidos son IN, in, OUT y out. El valor predeterminado es OUT. Si utiliza IN o in, también deberá proporcionar el parámetro –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

–p prefiltro Define los prefiltros que se colocarán en el archivo de configuración de los adaptadores Windows y NetWare. Debe especificar como mínimo la especificación de registro y, si lo desea, las especificaciones EventId, EventType y Source. En el ejemplo siguiente se muestra un comando que utiliza este argumento:
wsetac -a -p ’Log=Security’ 1 ACPprofile

–t destino Nombre del archivo de configuración 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 opción –d. Tenga en cuenta que la política 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 numérico. clave Proporciona la clave del registro de configuración del adaptador existente

Capítulo 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 configuración del adaptador o mediante el comando wlsac. perfil Perfil de configuración de adaptador al que se agregará el nuevo registro de configuración 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 configuración de adaptador denominado quasar:
wsetac -e ServerLocation=quasar 0 @ACP:quasar

Véase también
waddac, wdelac, wlsac, wsetaddflt

98

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

wsetaddflt
Agrega o establece un registro de configuración de adaptador para un perfil de configuración de adaptador o valor predeterminado de tipo de adaptador.

Sintaxis
wsetaddflt detalles_adaptador tipo

Descripción
El comando wsetaddflt también crea o modifica un registro de perfil de configuración 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 más adelante con el comando wlsaddflt de los scripts de política a fin de obtener la información predeterminada básica para un tipo de adaptador. Posteriormente, los scripts de política pueden aplicar filtros o modificaciones. Cada perfil de configuración de adaptador contiene la siguiente información de configuración para uno o varios adaptadores de eventos: v Ubicación de los archivos de configuración v Definiciones de variables de entorno de adaptador, con información tal como la ubicación del servidor de eventos v Definiciones de filtros de eventos v Peticiones de distribución de archivos adicionales Cada tipo de adaptador de cada perfil de configuración de adaptador puede estar soportado por políticas predeterminadas para proporcionar valores iniciales para componentes de la configuración no suministrados por una llamada de waddac. Del mismo modo, podría haber políticas de validación para garantizar que una configuración determinada sea válida según las necesidades de la implementación del adaptador de eventos, las particularidades de la instalación local y las consideraciones de seguridad.

Autorización
senior

Opciones
detalles_adaptador Proporciona la información de configuración específica del adaptador como, por ejemplo, las rutas de distribución, los ID de usuario y los filtros del adaptador empleados para los parámetros de distribución del adaptador. –a Indica que los valores proporcionados en la línea de comandos para los atributos de “lista” (entorno, filtros, acciones de distribución 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 según
Capítulo 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 distribución, se eliminan las diversas copias efectuadas para el mismo nombre de ruta. En el caso de los filtros, las entradas duplicadas se eliminan. (La opción –a es válida 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 específicos a los que se da soporte varían según el punto final, pero entre los que se admiten actualmente se encuentran los siguientes: action_fail Controla el manejo de anomalías de las peticiones de distribución de !comando y !!comando. Los valores reconocidos son: ignore Pasar por alto todas las anomalías. report Informar de las anomalías pero seguir con la actividad de distribución (comportamiento predeterminado). abort expand Controla si, al distribuir el perfil, el código 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 expansión, yes a fin de habilitarla para todos los atributos (comportamiento predeterminado), o una lista de nombres de atributo separados por comas para efectuar una expansión selectiva únicamente en los valores de esos atributos. rm_on_del Indica al código del punto final si debe eliminar los archivos de configuración y archivos distribuidos cuando se distribuye el registro tras eliminarse. El valor puede ser yes (para forzar la eliminación, que es el comportamiento predeterminado), no (para inhabilitar la eliminación y, por consiguiente, conservar los archivos en su ubicación tras la supresión del registro) o conf (para eliminar únicamente el archivo de configuración del adaptador principal). run_actions Controla si se llevan a cabo peticiones de distribución de !comando y !!comando. El valor puede ser yes o no, siendo yes el valor predeterminado. Detener la distribución.

100

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

El código del punto final admite (salvo que la política de validación 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 configuración de adaptador. El texto de comentario se escribirá en el archivo de configuración cuando se cree la próxima 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 carácter de barra inclinada, el nombre de archivo real se formará agregando destino al directorio de destino según la especificación de una opción –d (o de los valores predeterminados de la política). En lugar del formato destino=fuente para una petición de distribución, la cadena puede tener el formato !comando o !!comando. El comando proporcionado, que puede ser cualquier sentencia válida para el intérprete de línea 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 después (!!) de la información de configuración 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 configuración del adaptador. –e nombre=valor Define una variable de entorno que se colocará en el archivo de configuración del adaptador. Pueden proporcionarse tantos argumentos –e como se desee para crear un número de variables de entorno arbitrario. Algunas variables de entorno, que las bibliotecas del adaptador de eventos reconocen directamente, controlan el funcionamiento básico del adaptador. Otras variables pueden ser utilizadas en un nivel superior por adaptadores específicos. –f filtro Define un filtro de eventos que se colocará en el archivo de configuración 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 intérprete de línea 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:.)

Capítulo 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 configuración 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 intérprete de línea 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 cachés 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 numérico. –i on|off[,nombre_id] Especifica si se debe asignar al adaptador un identificador exclusivo y el identificador que se utilizará. Utilice esta opción 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 configuración contendrá el ID pero el adaptador no tendrá un ID tras la distribución del perfil. –m modo_prefiltro Define el modo prefiltro que se colocará en el archivo de configuración de los adaptadores Windows y NetWare. Los valores válidos son IN, in, OUT y out. El valor predeterminado es OUT. Si utiliza IN o in, también deberá proporcionar el parámetro –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

–p prefiltro Define los prefiltros que se colocarán en el archivo de configuración de los adaptadores Windows y NetWare. Debe especificar como mínimo la especificación de registro y, si lo desea, las especificaciones EventId, EventType y Source. En el ejemplo siguiente se muestra un comando que utiliza este argumento:
wsetaddflt -a -p ’Log=Security’ 1 ACPprofile

–t destino Nombre del archivo de configuración del adaptador principal, denominado habitualmente archivo CONF. El nombre de archivo

102

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

completo de este archivo se forma agregando destino al valor proporcionado para dir con una opción –d. Tenga en cuenta que la política 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 numérico. 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 políticas predeterminadas y de validación. Si se proporcionan tipos de adaptador desconocidos para waddac, las políticas de validación del perfil de configuración 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 "[email protected]" \ -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__

Capítulo 1. Comandos

103

Nota: se recomienda no suprimir la definición predeterminada del perfil de configuración de adaptador __generic__, ya que es la definición base para todos los tipos de adaptador.

Véase también
waddac, wdelac, wlsac, wsetac

104

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

wsetadenv
Instala una lista de variables de entorno de Recurso de integración de eventos reconocidas para un tipo de adaptador.

Sintaxis
wsetadenv [–a] nombre_variable... tipo

Descripción
El comando wsetadenv proporciona al Recurso de configuración del adaptador una lista de las variables de entorno de Recurso de integración de eventos que el adaptador reconoce pero que no forman parte del conjunto común de variables que emplea directamente el Recurso de integración de eventos. Los nombres de variables registrados con wsetadenv pasan a estar disponibles para los usuarios de la interfaz gráfica de usuario del Recurso de configuración del adaptador al configurar las listas de variables de entorno. Los scripts de validación de perfiles también pueden emplear la lista. El propio Recurso de configuración del adaptador instala la lista de variables del Recurso de integración de eventos básicas con el tipo __generic__. Esta lista no debe modificarse.

Autorización
senior

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

nombre_variable... Cero o más variables reconocidas por el tipo de adaptador especificado. No es ningún error instalar alguna de las variables del Recurso de integración de eventos estándar 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

Véase también
wlsadenv, waddac, wsetadgui, wsetadval

Capítulo 1. Comandos

105

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

Sintaxis
wsetadgui class nombre catálogo texto clave tipo

Descripción
El comando wsetadgui proporciona al Recurso de configuración del adaptador el nombre de un objeto que ofrece una interfaz estándar para llevar a cabo una configuración gráfica específica del tipo ampliada. Asimismo, el comando proporciona una etiqueta que se utilizará en el botón de “inicio” de la GUI del Recurso de configuración del adaptador en el que el usuario puede hacer clic para iniciar las herramientas de configuración ampliada. Como los adaptadores de eventos de Tivoli Enterprise Console pueden variar enormemente de tipo y ámbito, el propio Recurso de configuración del adaptador no intenta proporcionar herramientas de configuración para otros detalles más allá del subconjunto común de configuración del Recurso de integración de eventos. Sin embargo, como las herramientas de configuración gráficas pueden resultar adecuadas para una amplia gama de tipos de adaptadores, la interfaz gráfica del Recurso de configuración del adaptador puede ampliarse de forma eficaz creando una herramienta de configuración para un adaptador específico y después conectándola al Recurso de configuración del adaptador con wsetadgui. Una herramienta de configuración específica del tipo debe implementarse como un método en un objeto de Tivoli Enterprise. El método 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 configuración del adaptador llama al método acf_extension tras la solicitud del usuario y pasa al método el registro de perfil según la configuración actual junto con la clave de registro y el nombre de perfil. El entorno del servidor de la interfaz de usuario también se pasa para que las herramientas de configuración sepan dónde visualizar los diálogos. La herramienta de configuración ampliada puede efectuar las modificaciones necesarias en el registro y devolver una nueva versión del registro cuando haya terminado. Por lo general, las variables de entorno y las peticiones de distribución son los atributos del registro modificado de forma más habitual, pero puede modificarse cualquier elemento.

Autorización
senior

106

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

Opciones
catálogo Nombre del catálogo de mensajes que contiene el mensaje que se utilizará como etiqueta del botón de “inicio” en la GUI del Recurso de configuración del adaptador. clase clave Nombre de la clase de Tivoli Enterprise de la que es miembro el objeto de configuración. Clave del catálogo de mensajes para la etiqueta del botón de “inicio”.

nombre Nombre del objeto de configuración (el objeto que da soporte al método acf_extension para el tipo de adaptador). texto tipo Texto predeterminado de la etiqueta del botón de “inicio”, que se emplea si no se encuentra el catálogo. Tipo de adaptador. Si todavía no se ha instalado ninguna información de entorno ni otra información de tipo, wsetadenv registra automáticamente 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

Véase también
wlsadgui, waddac, wsetadenv, wsetadval

Capítulo 1. Comandos

107

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

Sintaxis
wsetadval archivo atributo tipo

Descripción
El comando wsetadval informa al Recurso de configuración del adaptador de que el archivo especificado contiene información de validación que debe emplearse al validar el valor del atributo indicado en los registros de perfil de configuración de adaptador. Por lo general, la información de validación consiste en la totalidad o parte de un script de algún tipo. Los scripts de política de validación instalados en los perfiles de configuración de adaptador posteriormente pueden extraer y utilizar la información de validación instalada. El formato más sencillo de un script de validación de perfil de configuración de adaptador es el siguiente:
#!/bin/sh wlsadval "$1" "$2" | sh –s "$3"

Con este esquema el contenido del registro de validación se utiliza directamente como script de validación real. El método de política 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 página 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 política almacenados en los objetos de perfil repartidos por la instalación puedan seguir siendo genéricos. Tal como se distribuyen, las políticas de validación del Recurso de configuración del adaptador esperan que la información de validación de adaptador instalada corresponda a scripts de shell.

Autorización
senior

Opciones
atributo Nombre del atributo al que se aplica la información de validación. Los atributos de un perfil de configuración de adaptador suelen ser los siguientes: ACPbhv Secuencia de variables de comportamiento del perfil, separadas por líneas nuevas. ACPcomment Campo de comentarios.

108

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

ACPdist Secuencia de peticiones de distribución, separadas por líneas nuevas. ACPev Secuencia de variables de entorno, separadas por líneas nuevas. ACPflt Secuencia de definiciones de filtro, separadas por líneas nuevas. ACPgid ID de grupo para las acciones de punto final. ACPtargdir Directorio de instalación de configuración. ACPtarget Nombre de archivo de configuración principal de destino. ACPtype Tipo de registro; normalmente no necesita validación. 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 información de validación. Si archivo es un solo guión, wlsadval lee la información de validación de la entrada estándar. tipo Tipo de adaptador para el que debe instalarse la información de validación. Para ver los tipos disponibles, utilice el comando wlsaddflt.

Ejemplos
El ejemplo siguiente agrega la información de validación 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

Véase también
wlsadval, waddac, wsetadenv, wsetadgui

Capítulo 1. Comandos

109

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

Sintaxis
wsetaeenv [–a] [–d nombre...] nombre=valor... punto_final wsetaeenv [–a] [–d nombre...] –i archivo punto_final

Descripción
Nota: utilice este comando únicamente en los nodos gestionados; no lo emplee en un punto final. El comando wsetaeenv permite establecer o modificar la lista de las variables de entorno de configuración de adaptador almacenadas en un objeto de punto final de perfil. Los valores nuevos se emplearán en la siguiente distribución de perfil de configuración de adaptador que se realice al punto_final especificado. Los perfiles de configuración de adaptador utilizan la información 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 distribución, 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 expansión se efectúa con el control del indicador de comportamiento expand; consulte la página del comando waddac. Además de las variables de entorno establecidas con el control del usuario mediante wsetaeenv, el código de punto final de configuración de adaptador crea automáticamente algunas variables. Estas variables describen el objeto de punto final, el perfil de configuración de adaptador que contiene el registro donde se hace una referencia y el propio registro. Estas variables de entorno automáticas están disponibles para el uso exactamente del mismo modo que las variables controladas por el usuario. Entre la lista de variables de entorno automáticas se encuentran las siguientes: ACPEP_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 configuración de adaptador que contiene el registro donde se hace una referencia a la variable.

110

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

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 coincidiría 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 automáticas 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.

Autorización
senior

Opciones
punto_final Nombre del objeto de punto final que se modificará. Se puede hacer referencia al objeto de punto final con la notación @Classname:etiqueta estándar. Si no se emplea la notación estándar, 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 excepción de los duplicados, que se evitan). Sin –a, la lista de variables proporcionada en la línea 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 opción –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 línea de
Capítulo 1. Comandos

111

comandos. Las definiciones de variables deben figurar en el archivo, una en cada línea. Si archivo es un solo guión, la lista se lee de la entrada estándar 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

Véase también
waddac, wdelac, wdistrib (en la publicación IBM Tivoli Management Framework Reference Manual), wlsaeenv

112

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

wsetemsg
Modifica un evento.

Sintaxis
wsetemsg [–t estado [–f] [–r gravedad] [atributo=valor...] consola ID_evento

Descripción
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 número de ID de evento; asimismo, debe estar asignado como operador de esa consola. Utilice el comando wlsemsg para ver una lista de los números de ID de evento.

Autorización
La función de autorización necesaria depende de los indicadores empleados. La tabla siguiente indica las funciones necesarias:
Opción de comando –f –r –t Autorización 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 válido. 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). También fuerza el cambio del estado de Confirmado (ACK) a Abierto (OPEN). Si no especifica la opción –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).
Capítulo 1. Comandos

113

Ejemplos
El ejemplo siguiente confirma el evento 11782052457 para la consola de eventos Network Events:
wsetemsg –t ACK "Network Events" 11782052457

Véase también
wlsemsg, wpostemsg (versión de punto final), wpostzmsg (versión de punto final)

114

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

wsetesvrcfg
Establece los parámetros de configuración para el servidor de eventos. Debe detener y reiniciar el servidor de eventos para que estos parámetros entren en vigor.

Sintaxis
wsetesvrcfg [–S servidor] [–b eventos] [–c eventos] [–e [segundos] ] [–k segundos] [–m segundos] [–n segundos] [–r [segundos] ] [–t [archivo] ]

Descripción
El comando wsetesvrcfg establece los parámetros de configuración para el servidor de eventos. Se modifica el servidor de la región de Tivoli local salvo que se especifique otro servidor. Debe especificar al menos una opción; de lo contrario, el comando devolverá un error. El servidor puede conservar un número de registros (tales como eventos y modificaciones de eventos). Los registros tienen una limitación de tiempo; al final del periodo especificado, el registro se suprime y se inicia otro nuevo. No pretenden sustituir a los registros del sistema. Utilícelos para realizar pruebas y diagnósticos a corto plazo.

Autorización
senior

Opciones
–b eventos Especifica el número máximo de eventos que se guardarán en el búfer de recepción mientras el motor de reglas procese otros eventos. El valor predeterminado es 500 eventos. –c eventos Establece la caché de eventos en el número de eventos especificado por eventos. El valor predeterminado es 1000 eventos. Debe ser un valor suficientemente alto para manejar un número máximo de eventos pendientes. Si la caché es demasiado pequeña, el servidor fuerza la eliminación de los eventos más antiguos de la caché. –e segundos Especifica el número de segundos que deben conservarse los eventos registrados en el registro de recepción. Si no se especifica un número de segundos, la función de registro se desactiva. El valor predeterminado es 86400 segundos (1 día). Este valor no se aplica automáticamente, 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 antigüedad indicada por el número de segundos especificado. El valor predeterminado es 86400 segundos (1 día).

Capítulo 1. Comandos

115

–m segundos Especifica el número de segundos que se conceden al servidor de eventos para inicializarse. El valor predeterminado es 300 segundos. –n segundos Especifica el número de segundos que deben conservarse los eventos que no se han cerrado. El valor predeterminado es 15552000 segundos (180 días). –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 región 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 tamaño de la caché del servidor de eventos en 1536 eventos para el servidor de la región AcmeTMR:
wsetesvrcfg –c 1536 –S @EventServer#AcmeTMR

Véase también
wlsesvrcfg

116

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

wsetsrc
Restablece los atributos de las fuentes de eventos.

Sintaxis
wsetsrc [–S servidor] [–l etiqueta] [–n nombre] fuente

Descripción
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 mínimo uno de los argumentos opcionales (–1, –n o –S).

Autorización
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 según se ha especificado en el archivo de configuración 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 región de Tivoli.

Ejemplos
El ejemplo siguiente establece la etiqueta de la fuente LOGFILE en syslog:
wsetsrc -l syslog LOGFILE

Véase también
wcrtsrc, wdelsrc, wlssrc

Capítulo 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 configuración y de formato.

Sintaxis
wsighup adaptador pid

Descripción
El comando wsighup hace que el adaptador del registro de eventos de Windows o de Windows NT vuelva a cargar los archivos de configuración y formato. Utilice este comando si ha realizado modificaciones en el archivo de configuración o de formato y desea empezar a utilizar la configuración 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 configuración y formato.

Autorización
Ninguna.

Opciones
adaptador Nombre del servicio del adaptador pid ID de proceso del adaptador

Ejemplos
El ejemplo siguiente vuelve a cargar los archivos de configuración y de formato correspondientes al adaptador tecwinadapter_myid con el ID de proceso 712:
wsighup tecwinadapter_myid 712

118

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

wstartesvr
Inicia el servidor de eventos.

Sintaxis
wstartesvr [–S servidor]

Descripción
De forma predeterminada, el comando wstartesvr inicia el servidor de eventos de la región de Tivoli local. El servidor de eventos lee los archivos de configuración y la base de datos de eventos, y carga la base de reglas. La caché de eventos se carga con eventos en función de los parámetros de tiempo y tamaño del búfer y los eventos en cola y en espera (si había eventos en esos estados la última vez que se apagó el servidor) se cargan en el búfer de recepción. A continuación, el servidor de eventos se establece como disponible para la comunicación 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 ejecución, 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 automáticamente cuando se reinicia el servidor.

Autorización
senior

Opciones
–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 región de Tivoli.

Ejemplos
El ejemplo siguiente inicia el servidor de eventos local:
wstartesvr

Véase también
wstopesvr

Capítulo 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 duración "info_propietario" [hora_inicio]

Descripción
El comando wstartmaint.sh informa al servidor de eventos de que un recurso de red ha entrado en modo de mantenimiento mediante el envío 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.

Autorización
Ninguna.

Opciones
nombre_host Especifica el nombre totalmente calificado del host que ha entrado en modo de mantenimiento. duración Especifica el tiempo, en minutos, que el host permanecerá en modo de mantenimiento. "info_propietario" Especifica la información 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 estarán en modo de mantenimiento durante 1 minuto:
wstartmaint.sh "*" 1 "my.email.com"

Véase también
wstopmaint.sh

120

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

wstatesvr
Visualiza el estado de un servidor de eventos.

Sintaxis
wstatesvr [–S servidor]

Descripción
El comando wstatesvr visualiza el estado del servidor de eventos.

Autorización
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 región de Tivoli.

Ejemplos
El ejemplo siguiente visualiza el estado del servidor de eventos local:
wstatesvr

Véase también
wstartesvr, wstopesvr

Capítulo 1. Comandos

121

wstopesvr
Detiene el servidor de eventos.

Sintaxis
wstopesvr [–S servidor]

Descripción
El comando wstopesvr detiene el servidor de eventos de la región de Tivoli local. Si un servidor de eventos se detiene, las consolas que estaban conectadas al mismo se vuelven a conectar automáticamente cuando se reinicia el servidor.

Autorización
senior

Opciones
–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 región de Tivoli.

Ejemplos
El ejemplo siguiente detiene el servidor de eventos local:
wstopesvr

Véase también
wstartesvr

122

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

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]

Descripción
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 finalización planificada o bien de que se va a cancelar un intervalo de mantenimiento planificado para más adelante para un recurso de red.

Autorización
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

Véase también
wstartmaint.sh

Capítulo 1. Comandos

123

wstoptecgw
Detiene el gateway de Tivoli Enterprise Console.

Sintaxis
wstoptecgw

Descripción
El comando wstoptecgw detiene un gateway de Tivoli Enterprise Console que da servicio a puntos finales. El gateway de Tivoli Enterprise Console se reinicia automáticamente 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 configuración del adaptador en el nodo gestionado para que actúe como gateway de Tivoli Enterprise Console. 2. Cree un punto final en ese nodo gestionado. 3. Cree una entrada de perfil de configuración de adaptador para el archivo de configuración tec_gateway. 4. Distribuya el perfil de configuración 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 también se distribuye al distribuir el perfil de configuración de adaptador tec_gateway_sce.

Autorización
user

124

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

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]

Descripción
El comando wtdbclear suprime eventos del registro de recepción, el repositorio de eventos o ambos. Las tablas de las que suprima las filas dependerán de las opciones especificadas. El comando wtdbclear debe ejecutarse desde el servidor de eventos.

Autorización
senior

Opciones
–a registros Se efectúa una confirmación tras suprimirse x número de registros. –c nombre_clase Borra los eventos con el nombre de clase especificado. Nota: no puede emplear esta opción al borrar el registro de recepción con la opción –l. –e Suprime eventos del repositorio de eventos, del repositorio de tareas y de la tabla de atributos de eventos ampliados. Debe emplear la opción –t para especificar la antigüedad de los eventos que se deben suprimir. Fuerza la supresión de los eventos en cola y en espera del registro de recepción. Nota: no utilice nunca esta opción mientras está en ejecución el servidor de Tivoli Enterprise Console. –l Suprime eventos del registro de recepción. Debe emplear la opción –t para especificar la antigüedad de los eventos que se deben suprimir. Nota: no puede emplear las opciones –c, –r o –s al borrar el registro de recepción con esta opción. –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 ejecución de wtdbclear. –r gravedad Borra los eventos con la gravedad especificada. Los valores predeterminados válidos son Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN).

–f

Capítulo 1. Comandos

125

Nota: no puede emplear esta opción al borrar el registro de recepción con la opción –l. –s estado Borra los eventos con el estado especificado. Los valores predeterminados válidos son Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE) o Confirmado (ACK). Nota: no puede emplear esta opción al borrar el registro de recepción con la opción –l. –t segundos Suprime los eventos que tienen una antigüedad superior al número de segundos especificado. Esta opción es obligatoria. –w Fuerza la supresión de eventos que todavía no han sido procesados por el proceso ETL (extracción, transformación y carga) del almacén de datos. Si el paquete de activación del almacén de Tivoli Enterprise Console está instalado, el proceso ETL del almacén procesa periódicamente los eventos del repositorio. Si emite el comando wtdbclear y especifica un intervalo de tiempo que incluya los eventos que el proceso ETL del almacén aún no ha procesado, el comando wtdbclear devuelve un mensaje de aviso. Utilice la opción –w para forzar la supresión de estos eventos.

Notas
Si se especifica más de una de las opciones –c, –s y –r, el resultado es un OR lógico.

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 más 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

Véase también
wdbmaint.sh, wtdumper, wtdumprl, wtdumptr

126

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

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]

Descripción
El comando wtdbclear.pl suprime eventos del registro de recepción, el repositorio de eventos o ambos. Las tablas de las que suprima las filas dependerán de la opción 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 máximo. 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 borrarán los eventos recibidos antes de las 9:00. Los últimos 30 minutos de eventos permanecerán en la base de datos. Al ejecutar wtdbclear.pl en el servidor de Tivoli Enterprise Console se borraría por completo la base de datos. Nota: este comando ha quedado obsoleto con la versión 3.8 de 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.

Autorización
senior

Opciones
–a registros Se efectúa una confirmación tras suprimirse el número de registros especificado. –c nombre_clase Borra los eventos con el nombre de clase especificado. Nota: no puede emplear esta opción al borrar registros de recepción con la opción –l. –D Activa el seguimiento. Cuando se utiliza esta opción, la acción predeterminada es que la actividad de seguimiento se escriba en la salida estándar (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

–e

Capítulo 1. Comandos

127

tabla de atributos de eventos ampliados. Debe emplear la opción –t para especificar la antigüedad de los eventos que se deben suprimir. –f Fuerza la supresión de los eventos en cola y en espera del registro de recepción. Nota: no utilice esta opción mientras está en ejecución el servidor de Tivoli Enterprise Console. –l Suprime eventos del registro de recepción. Nota: no puede emplear las opciones –c, –r o –s al borrar el registro de recepción con esta opción. –R Nombre de objeto RIM. El valor predeterminado es tec.

–r gravedad Borra los eventos con la gravedad especificada. Los valores predeterminados válidos son Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Nota: no puede emplear esta opción al borrar registros de recepción con la opción –l. –s estado Borra los eventos con el estado especificado. Los valores predeterminados válidos son Abierto (OPEN), Cerrado (CLOSED), Respondido (RESPONSE) o Confirmado (ACK). Nota: no puede emplear esta opción al borrar registros de recepción con la opción –l. –t segundos Suprime los eventos que tienen una antigüedad superior al número de segundos especificado. Esta opción es obligatoria. –w Fuerza la supresión de eventos que todavía no han sido procesados por el proceso ETL (extracción, transformación y carga) del almacén de datos. Si el paquete de activación del almacén de Tivoli Enterprise Console está instalado, el proceso ETL del almacén procesa periódicamente 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 almacén aún no ha procesado, el script wtdbclear.pl devuelve un mensaje de aviso. Utilice la opción –w para forzar la supresión de estos eventos.

Ejemplos
El ejemplo siguiente suprime todos los eventos con una antigüedad superior a 60 segundos de los repositorios de eventos y tareas y del registro de recepción, activa el seguimiento y coloca la salida en el archivo /tmp/output:
wtdbclear.pl -elt 60 -D > /tmp/output

Véase también
wdbmaint.sh, wtdbclear, wtdumper, wtdumprl, wtdumptr

128

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

wtdbspace
Proporciona estadísticas 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 ]

Descripción
El comando wtdbspace proporciona estadísticas 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 línea 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 estén disponibles mediante un montaje NFS. El comando wrimsql no es necesario cuando se ejecuta el comando wtdbspace para una base de datos DB2.

Autorización
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 lógico
Capítulo 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 ningún nombre, se informa sobre todos los nombres de dispositivo de la base de datos. Este comando admite el uso del carácter de asterisco como carácter 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 ningún nombre, se informará sobre todos los dispositivos temporales con nombre de la base de datos. Este comando admite el uso del carácter de asterisco como carácter 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 parámetro no se puede emplear con el parámetro –d.

Ejemplos
El ejemplo siguiente muestra el espacio empleado para un objeto RIM denominado mssql_tec y muestra la información 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

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

wtdbstat
Comprueba la disponibilidad del servidor de base de datos que utiliza el servidor de Tivoli Enterprise Console.

Sintaxis
wtdbstat [–q]

Descripción
El comando wtdbstat visualiza la disponibilidad del servidor de base de datos. Este comando tarda más en ejecutarse cuando el servidor de base de datos está inactivo.

Autorización
senior

Opciones
–q Especifica que no se imprimirá ninguna salida (el comando wtdbstat se ejecuta de forma silenciosa). El código de retorno indica el estado. El código de retorno 0 indica que el servidor está en ejecución. Cualquier otro código de retorno indica un error.

Ejemplos
El ejemplo siguiente visualiza la disponibilidad del servidor de base de datos:
wtdbstat

Véase también
wstatesvr

Capítulo 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_finalización] [–o ASC | DESC] [–m número] [–d] [–w cláusula_where]

Descripción
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 acción predeterminada es que los eventos figuren en el orden en que se han producido. Sin embargo, el evento más 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 visualizarán 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 visualizaría toda la base de datos.

Autorización
senior

Opciones
–d Lista información de formato detallada en el informe de eventos. –e hora_finalización Lista los eventos acontecidos antes de la fecha y la hora especificadas. El parámetro hora_finalización 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 finalización. –f archivo Escribe la salida en el archivo especificado. –m número Especifica el número máximo de eventos que se registrará en el informe. Si el número 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 más recientes de la base de datos no se incluirán en el informe. –o ASC | DESC Establece el orden en que se listarán los eventos. Los valores posibles son: ASC Lista en primer lugar el registro de evento más antiguo. Éste es el valor predeterminado.

DESC Lista en primer lugar el registro de evento más reciente.

132

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

–t hora_inicio Lista los eventos acontecidos después de la fecha y la hora especificadas. El parámetro hora_inicio debe indicar una fecha con el formato “mes dd hh:mm:ss aaaa”. –w cláusula_where Especifica una cláusula WHERE de SQL parcial para la consulta de la base de datos de eventos. Esta cláusula parcial se agrega a la cláusula WHERE generada internamiento con el operador AND. Nota: esta opción 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 cláusula WHERE de SQL parcial para la consulta de la base de datos de eventos:
wtdumper -w "msg = ’Se ha producido un error de impresión’"

Véase también
wtdbclear, wtdumprl, wtdumptr

Capítulo 1. Comandos

133

wtdumprl
Genera un informe de los eventos recibidos del registro de recepción.

Sintaxis
wtdumprl [–f archivo] [–t hora_inicio] [–e hora_finalización] [–o ASC | DESC] [–m número]

Descripción
El comando wtdumprl genera un informe de los eventos recibidos por el servidor de eventos. El registro de recepción mantiene una lista de estos eventos en la base de datos. La acción predeterminada es que los eventos figuren en el orden en que se han producido. Sin embargo, el evento más 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 visualizarán 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 visualizaría toda la base de datos.

Autorización
senior, RIM_view

Opciones
–e hora_finalización Lista los eventos recibidos antes de la fecha y la hora especificadas. El parámetro hora_finalización 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 finalización. –f archivo Escribe la salida en el archivo especificado. –m número Especifica el número máximo de eventos que se registrará en el informe. Si el número 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 más recientes de la base de datos no se incluirán en el informe. –o ASC | DESC Establece el orden en que se listarán los eventos. Los valores posibles son: ASC Lista en primer lugar la entrada más antigua del registro. Éste es el valor predeterminado.

DESC Lista en primer lugar la entrada más reciente del registro.

134

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

–t hora_inicio Lista los eventos recibidos después de la fecha y la hora especificadas. El parámetro 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"

Véase también
wtdbclear, wtdumper, wtdumptr

Capítulo 1. Comandos

135

wtdumptr
Genera un informe de las tareas en ejecución o completadas.

Sintaxis
wtdumptr [–f archivo] [–t hora_inicio] [–e hora_finalización] [–o ASC | DESC] [–m número]

Descripción
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 acción predeterminada es que las tareas completadas figuren en el orden en que se han producido. Sin embargo, la tarea más reciente puede constar en primer lugar utilizando el indicador –o.

Autorización
senior, RIM_view

Opciones
–e hora_finalización Lista las tareas completadas antes de la fecha y la hora especificadas. El parámetro hora_finalización 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 finalización. –f archivo Escribe la salida en el archivo especificado. –m número Especifica el número máximo de eventos que se registrará en el informe. Si el número 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 más recientes de la base de datos no se incluirán en el informe. –o ASC | DESC Establece el orden en que se listarán los eventos. Los valores posibles son: ASC Lista en primer lugar el registro de evento más antiguo. Éste es el valor predeterminado.

DESC Lista en primer lugar el registro de evento más reciente. –t hora_inicio Lista las tareas completadas después de la fecha y la hora especificadas. El parámetro 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"

Véase también
wtdbclear, wtdumper, wtdumprl

136

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

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

Sintaxis
wtecexport –h [host [:puerto]] [–u usuario] [–p contraseña] [–O operador1:operador2:...] [–c consola1:consola2:...] [–e grupo_eventos1:grupo_eventos2:...] [–f nombre_archivo] En los sistemas Windows, al comando wtecexport se le llama utilizando wtecexport.cmd. Las opciones son las mismas.

Descripción
Las definiciones de grupos de eventos, consolas y operadores pueden exportarse a un archivo y después importarse a otra región de Tivoli mediante el comando wtecimport. Todos los administradores tienen la misma vista de configuración de los objetos de una región. La exportación y la importación de definiciones de consola ofrecen las ventajas siguientes: v Este método permite crear de forma eficaz un conjunto base de consolas de eventos en una región de Tivoli de modo que puedan importarse las consolas de eventos a otras regiones para realizar tareas de configuración o implementación adicionales. v Las definiciones de consola de una región de Tivoli se pueden emplear como un punto de control único para la configuración de consolas en un entorno de varias regiones. v Este método permite crear de forma eficaz copias de seguridad de consolas. Esta tarea también 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 número de grupos de eventos sin exportar los operadores. Si no se especifica como mínimo una de las opciones –O, –c y –e, se exportarán todas las definiciones de consola. Observe que wtecexport exporta consolas, grupos de eventos y operadores para todos los usuarios.

Autorización
senior

Opciones
—h [host [:puerto]] Nombre de host de un nodo gestionado en el que el ID de usuario y la contraseña deben ser autenticadas por Tivoli Management Framework. Especifique esta opción 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.

Capítulo 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 contraseña Contraseña del inicio de sesión especificado en el argumento –u. Esta opción es obligatoria si utiliza la opción –u para especificar un usuario. —u usuario Inicio de sesión del administrador de Tivoli. Si no especifica esta opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. Nota: si está trabajando en un sistema AIX y ha iniciado la sesión como root, debe utilizar las subopciones –h, –u y –p para especificar explícitamente el nombre del host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión en un sistema AIX con otro ID de usuario.

Ejemplos
1. El ejemplo siguiente lleva a cabo la exportación 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 exportación 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

Véase también
wtecimport

138

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

wtecimport
Importa definiciones de consola de eventos de un archivo de exportación a una región de Tivoli.

Sintaxis
wtecimport –h host [:puerto] [–u usuario] [–p contraseña] [–O operador1:operador2:...] [–c consola1:consola2:...] [–e grupo_eventos1:grupo_eventos2:...] [–f nombre_archivo] [–x e | r | c] En los sistemas Windows, al comando wtecimport se le llama utilizando wtecimport.cmd. Las opciones son las mismas.

Descripción
Las definiciones de grupos de eventos, consolas y operadores pueden exportarse a un archivo con el comando wtecexport y después importarse a otra región de Tivoli mediante una consola de eventos. Todos los administradores tienen la misma vista de configuración de los objetos de una región. La exportación y la importación de definiciones de consola ofrecen las ventajas siguientes: v Este método permite crear de forma eficaz un conjunto base de consolas de eventos en una región de Tivoli de modo que puedan importarse las consolas de eventos a otra región para realizar tareas de configuración o implementación adicionales. v Las definiciones de consola de una región de Tivoli se pueden emplear como un punto de control único para la configuración de consolas en un entorno de varias regiones. v Este método permite crear de forma eficaz copias de seguridad de consolas. Esta tarea también se puede efectuar desde la consola de eventos. Las opciones –O, –c y –e se pueden emplear por separado o de forma combinada. Por ejemplo, puede importar una o varias consolas y cualquier número de grupos de eventos sin importar los operadores. Si no se especifica como mínimo una de las opciones –O, –c y –e, se importarán 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 también importarse a la vez. Sólo pueden importarse como operadores los administradores de Tivoli definidos en la región de Tivoli receptora. No es posible crear un administrador de Tivoli nuevo en una región importando un operador que no esté definido en la región receptora.

Autorización
senior

Opciones
–c consola1:consola2;... Lista de consolas que se desea importar, separadas por caracteres de dos puntos.

Capítulo 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 contraseña deben ser autenticadas por Tivoli Management Framework. Especifique esta opción 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 contraseña Contraseña del inicio de sesión especificado en el argumento –u. Esta opción es obligatoria si utiliza la opción –u para especificar un usuario. –u usuario Inicio de sesión del administrador de Tivoli. Si no especifica esta opción, se utiliza el ID del usuario que tenga una sesión iniciada en este momento. –x e | r | c Modo de resolución 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 número al nuevo objeto. Los indicadores son sensibles a las mayúsculas y minúsculas. El espacio entre el argumento y el indicador es opcional. Nota: si está trabajando en un sistema AIX y ha iniciado la sesión como root, debe utilizar las subopciones –h, –u y –p para especificar explícitamente el nombre del host, el ID de usuario y la contraseña para evitar que se visualice la ventana de inicio de sesión. Esto no es necesario si inicia la sesión en un sistema AIX con otro ID de usuario.

Ejemplos
1. El ejemplo siguiente lleva a cabo la importación como el usuario root en el servidor de eventos mica. Se indican los operadores, las consolas y los 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 sustituirán 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

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

2. El ejemplo siguiente importa todas las consolas, los grupos de eventos y los operadores incluidos en export_file. Una vez más, la importación 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 sustituirán en caso de que se produzca un conflicto de nombres.
wtecimport.cmd -h mica -u root -p tivoli -f export_file -x r

Véase también
wtecexport

Capítulo 1. Comandos

141

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

Sintaxis
wtouchac clave... perfil

Descripción
El comando wtouchac actualiza la indicación de la hora en uno o varios registros de un perfil de configuración de adaptador. La actualización fuerza la distribución de los registros la próxima vez que se solicite una distribución desde la GUI del Recurso de configuración del adaptador o mediante el comando wdist cuando no se especifique la opción de copia exacta. Como en las configuraciones de adaptadores intervienen otros archivos que no están directamente controlados por el mecanismo de perfiles en Tivoli Enterprise, el hecho de que un registro deba redistribuirse debido a que un archivo auxiliar ha cambiado no es evidente para la aplicación. Por lo tanto, se utiliza el comando wtouchac cuando ha cambiado un archivo auxiliar pero no el registro.

Autorización
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 configuración del adaptador o mediante el comando wlsac. perfil Perfil de configuración de adaptador que se verá afectado. Si el nombre contiene espacios, escriba todo el nombre entre comillas.

Ejemplos
El ejemplo siguiente actualiza la indicación de la hora de la entrada de perfil de configuración de adaptador almacenada en la clave 1 del perfil ACP_Profile:
wtouchac 1 @ACP:ACP_Profile

El ejemplo siguiente actualiza la indicación de la hora de la entrada de perfil de configuración de adaptador almacenada en la clave 1 del perfil ACP Profile (que contiene un espacio en el nombre):
wtouchac 1 @"ACP:ACP Profile"

Véase también
wdistrib (en la publicación IBM Tivoli Management Framework Reference Manual), waddac

142

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

Capítulo 2. Tareas
En este capítulo 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 diálogos de tareas y se utiliza cuando se especifica la biblioteca de tareas desde una línea de comandos. Existen tres tipos de tareas de Tivoli Enterprise Console: Tareas de consola Estas tareas están configuradas y se ejecutan inmediatamente desde el visor de eventos. Si una tarea de consola requiere algún valor para algún atributo de evento, seleccione el evento en la cola de trabajo del visor de eventos para asociar el evento con la tarea. Tareas automáticas Estas tareas se configuran por adelantado y se ejecutan automáticamente 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 automáticas se configuran con el menú desplegable Tareas automáticas del visor de eventos. Tareas de base de reglas Estas tareas se ejecutan cuando forman parte de una acción 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 también se conocen como respuestas automáticas. Para obtener información acerca de la ejecución de tareas incluidas en las reglas, consulte la publicación Tivoli Enterprise Console Rule Builder’s 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 ejecución. 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 capítulo 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 Capítulo 3, “Variables de entorno disponibles para las tareas”, en la página 171. Los procedimientos para configurar tareas desde una consola de eventos se describen en la ayuda en línea de la consola actual. En el diálogo Tareas automáticas puede definir o modificar las propiedades siguientes: v Nombre v Descripción v Cuando un evento coincide con v Ejecutar tareas Cuando una tarea automática finaliza, envía información 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 finalización de tarea se visualiza en la primera columna del visor de eventos
© Copyright IBM Corp. 2002

143

cuando una tarea automática finaliza. Puede hacer clic en el icono de la columna para ver los detalles acerca del resultado de la tarea automática. Estos detalles no permanecen tras el reinicio de la consola. El resultado de las tareas automáticas se puede grabar en un archivo de texto, que se configura en el diálogo Propiedades de consola de cada consola. Para obtener información detallada acerca de la ejecución de la función de tarea automática desde la consola de eventos, consulte las entradas de Tarea automática proporcionadas en la ayuda en línea. Al ejecutar una tarea de base de reglas, la información que indica si la tarea ha sido correcta o incorrecta y su resultado sólo se envía si el estado de observación tiene el valor YES. De lo contrario, en la consola no se muestra información alguna sobre la tarea. Si el estado de observación es YES, el icono de finalización 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 diálogos de la consola de eventos. Puede configurar y ejecutar la mayoría de las tareas desde la línea de comandos. Para obtener información acerca del acceso a los diálogos relacionados con las tareas de Tivoli Enterprise Console, consulte la publicación Tivoli Enterprise Console Rule Builder’s Guide. El comando wruntask de Tivoli Management Framework se utiliza para configurar y ejecutar las tareas de consola desde la línea de comandos, y se muestra en todos los ejemplos de este capítulo. Las tareas también pueden ejecutarse mediante una acción en una regla de Tivoli Enterprise Console. Nota: en este capítulo, el término configurar significa especificar los parámetros de entrada y las opciones de ejecución para las tareas de Tivoli Enterprise Console y, en el caso de una tarea automática, definir las restricciones de evento para la coincidencia de campos de eventos para activar la acción 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 línea de comandos para identificar las tareas. Puede ver los nombres de tarea y los nombres descriptivos en el diálogo de tareas de T/EC del escritorio de Tivoli marcando y quitando la marca del cuadro de selección 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 línea de comandos. Determinadas tareas necesitan tener disponibles los atributos de un evento. No puede ejecutar en la línea de comandos una tarea que necesite tener disponibles los atributos de un evento.

144

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

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 recepción Cerrar evento

Nombre de archivo T_EC_Tasks_C_zonctxba T_EC_Tasks_C_hmmeleka

Línea 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 información 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, envía información 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 diálogo de salida de la tarea que contiene esta información. Para las tareas que se ejecutan en la línea de comandos, se graba el mismo nivel de información en stdout y stderr. En el caso de las tareas automáticas, el resultado se puede mostrar con el evento relacionado que ha activado la tarea. La tarea también 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 también se almacena en la base de datos.

Capítulo 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. Además, el servidor de eventos debe estar en ejecución para que esta tarea se ejecute correctamente.

Autorización
super, senior, admin, user

Opciones de configuración del diálogo
Gravedad Nueva gravedad del evento. Los valores válidos 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 línea de comandos.

146

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

Clean_Database
Suprime los eventos antiguos de la base de datos de eventos. Los eventos se suprimen del registro de recepción según el valor del campo Duración de la información del registro de recepción de eventos en el diálogo Parámetros de servidor de eventos del servidor de eventos. Los eventos cerrados del repositorio de eventos que sean anteriores al valor indicado en el campo Duración de eventos cerrados en la memoria caché del diálogo Parámetros 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 código de retorno. La base de datos de eventos debe estar disponible. No es necesario que el servidor de eventos esté en ejecución. Nota: después 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.

Autorización
RIM_update, RIM_view, super, senior, admin, user

Opciones de configuración del diálogo
No hay opciones para esta tarea. Los parámetros se obtienen de los campos mencionados en la descripción de la tarea.

Sinopsis del comando
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

Capítulo 2. Tareas

147

Clear_Closed_Events
Suprime los eventos cerrados del repositorio de eventos, utilizando la antigüedad 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 ejecución.

Autorización
RIM_update, RIM_view, super, senior, admin, user

Opciones de configuración del diálogo
Segundos Antigüedad, en segundos, tras la cual los eventos se suprimen. Por ejemplo, el valor 60 especifica que se suprimirán los eventos cerrados de más de 60 segundos de antigüedad.

Sinopsis del comando
wruntask –t Clear_Closed_Events –l "T/EC Tasks" –h nodo –a segundos

Argumentos del comando
–a segundos –h nodo –l "T/EC Tasks" Biblioteca de tareas. –t Clear_Closed_Events Tarea que se ejecutará. Antigüedad inicial, en segundos, de los eventos que se suprimirán. 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

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

Clear_Reception_Log
Suprime los eventos del registro de recepción recibidos hace más 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 ejecución.

Autorización
RIM_update, RIM_view, super, senior, admin, user

Opciones de configuración del diálogo
No hay opciones para esta tarea.

Sinopsis del comando
wruntask –t Clear_Reception_Log –l "T/EC Tasks" –h nodo

Argumentos del comando
–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

Capítulo 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. Además, el servidor de eventos debe estar en ejecución para que esta tarea se ejecute correctamente.

Autorización
super, senior, admin, user

Opciones de configuración del diálogo
No hay opciones para esta tarea.

Sinopsis del comando
Esta tarea no se puede ejecutar desde la línea de comandos.

150

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

Dump_Event_Repository
Muestra los detalles de los eventos del repositorio de eventos en el diálogo 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 ejecución.

Autorización
RIM_view, super, senior, admin, user

Opciones de configuración del diálogo
¿Orden ascendente o descendente? Orden en que se listarán los eventos en la salida. Las opciones posibles son: ASC Lista en primer lugar la entrada más antigua del repositorio de eventos.

DESC Lista en primer lugar la entrada más reciente del repositorio de eventos. Número de eventos Número máximo de eventos que se mostrarán en la salida. Si el número de eventos del repositorio de eventos supera el valor especificado, se omitirán las entradas a partir del final de la salida. Por ejemplo, si la salida se visualiza en orden ascendente, las entradas más recientes de la base de datos no se mostrarán.

Sinopsis del comando
wruntask –t Dump_Event_Repository –l "T/EC Tasks" –h nodo –a orden_clasificación –a número_eventos

Argumentos del comando
–a número_eventos Número máximo de eventos que se mostrarán en la salida. Si el número de eventos de la base de datos supera el valor especificado, se omitirán las entradas a partir del final de la salida. Por ejemplo, si la salida se visualiza en orden ascendente, las entradas más recientes de la base de datos no se mostrarán. –a orden_clasificación Orden en que se listarán los eventos en la salida. Los valores válidos son: ASC Lista en primer lugar la entrada más antigua del repositorio de eventos.

DESC Lista en primer lugar la entrada más reciente del repositorio de eventos. –h nodo Nodo gestionado en el que se ejecutará la tarea.
Capítulo 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

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

Event_Query
Realiza una consulta en el repositorio de eventos. El resultado se muestra en el diálogo 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 ejecución.

Autorización
RIM_view, super, senior, admin, user

Opciones de configuración del diálogo
Para las opciones de tipo de coincidencia siguientes (Emparejar clase a Emparejar mensaje), las selecciones que realice indicarán qué atributos y valores se utilizarán para los criterios de selección de la consulta. Con todas las opciones puede especificar texto de forma manual, incluido el carácter comodín asterisco (*), para especificar todos los valores de un atributo. Si especifica manualmente varios valores para una opción, sepárelos con comas. Algunas de las opciones también 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 válidos son: Abierto (OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado (CLOSED). Emparejar gravedad Niveles de gravedad de los eventos. Los valores válidos 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 Especificación más detallada de las fuentes. Emparejar origen Direcciones de protocolo o nombres de host de los sistemas fuente. Emparejar suborigen Especificación más detallada de los orígenes. Emparejar mensaje Una o varias cadenas de texto de mensaje de los eventos. Si especifica más de un mensaje, especifique el valor completo de la opción Emparejar mensaje con algún tipo de comillas (por
Capítulo 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 carácter comodín *. 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 carácter comodín *. Orden de clasificación Orden en que se listarán los resultados de la consulta en la salida. Los valores válidos son: ASC Lista en primer lugar el evento más antiguo.

DESC Lista en primer lugar el evento más reciente. Mostrar valores para atributos Especifica qué atributos de eventos base se mostrarán en la salida. Haga clic en Atributos para obtener una lista desplegable de los atributos de eventos base y realizar una selección. Todos los atributos de eventos no base se visualizan siempre. Si no selecciona ningún atributo, en la salida se mostrarán todos (base y no base).

Sinopsis del comando
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_clasificación –a {"atributo[,atributo...]" | "*"]

Argumentos del comando
–a "clase..." Uno o varios nombres de clase de evento. Si se especifica más 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 carácter comodín *. Para obtener información adicional acerca de los nombres de clases de evento, consulte la publicación 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 más 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 carácter comodín *. Los nombres de estados válidos son: Abierto (OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado (CLOSED).

–a "estado..."

154

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

–a "gravedad..." Uno o varios nombres de gravedad de evento. Si se especifica más 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 carácter comodín *. Los nombres de gravedad válidos 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 más 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 carácter comodín *. –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 más 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 carácter comodín *. Una o varias subfuentes de los eventos. Una subfuente es una especificación más detallada de una fuente. Si se especifica más 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 carácter comodín *. –a "origen..." Una o varias direcciones de protocolo o nombres de host de los sistemas fuente. Si se especifica más de un origen por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los orígenes, utilice el carácter comodín *. Uno o varios suborígenes de los eventos. Un suborigen es una especificación más detallada de un origen. Si se especifica más de un suborigen por nombre, separe los nombres con comas y no deje espacios en blanco entre ellos. Para especificar todos los suborígenes, utilice el carácter comodín *. –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 carácter comodín *.

–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 carácter comodín *. –a "orden_clasificación" Orden en que se listarán los resultados de la consulta en la salida. Los valores válidos son:

Capítulo 2. Tareas

155

ASC

Lista en primer lugar el evento más antiguo.

DESC Lista en primer lugar el evento más reciente. –h nodo –a "atributo..." Nodo gestionado en el que se ejecutará la tarea. Especifica uno o varios atributos de eventos base que se mostrarán en la salida. Todos los atributos de eventos no base se visualizan siempre. Si se especifica más 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 carácter comodín *. 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

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

Find_Similar_Events
Realiza una consulta en el repositorio de eventos utilizando un evento para comparar atributos. El resultado se muestra en el diálogo de salida de la tarea. Debe seleccionar el evento en el visor de eventos antes de configurar esta tarea. Esta tarea 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. Además, el servidor de eventos debe estar en ejecución para que esta tarea se ejecute correctamente.

Autorización
RIM_view, super, senior, admin, user

Opciones de configuración del diálogo
Para las opciones de tipo de coincidencia siguientes (Emparejar clase a Emparejar mensaje), al marcar el botón de selección 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 botón de selección 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 válidos son: Abierto (OPEN), Confirmado (ACK), Respondido (RESPONSE) y Cerrado (CLOSED). Emparejar gravedad Gravedad del evento. Los valores válidos 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 Especificación más detallada de la fuente. Emparejar origen Dirección de protocolo o nombre de host del sistema fuente. Emparejar suborigen Especificación más 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 (*).
Capítulo 2. Tareas

157

Orden de clasificación Orden en que se listarán los resultados de la consulta en la salida. Los valores válidos son: Ascendente Lista en primer lugar el evento más antiguo. Descendente Lista en primer lugar el evento más reciente. Mostrar valores para atributos Especifica qué atributos de eventos base se mostrarán en la salida. Haga clic en Atributos para obtener una lista desplegable de los atributos de eventos base y realizar una selección. Todos los atributos de eventos no base se visualizan siempre. Si no selecciona ningún atributo, en la salida se mostrarán todos.

Sinopsis del comando
Esta tarea no se puede ejecutar desde la línea de comandos.

158

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

Forward_Event
Reenvía un evento a otro servidor de eventos registrado en la región de gestión 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.

Autorización
super, senior, admin, user

Opciones de configuración del diálogo
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 región de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orange-region.

Sinopsis del comando
Esta tarea no se puede ejecutar desde la línea de comandos.

Capítulo 2. Tareas

159

Log_Event_To_File
Graba en un archivo los detalles acerca de un evento.

Autorización
super, senior, admin

Opciones de configuración del diálogo
Nombre de archivo de registro Escriba la ruta y el nombre del archivo en el que se grabará la información 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 diálogo para buscar un archivo.

Sinopsis del comando
Esta tarea no se puede ejecutar desde la línea de comandos.

160

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

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. Además, el visor de eventos que recibe el mensaje debe estar en ejecución para que esta tarea se ejecute correctamente.

Autorización
super, senior, admin

Opciones de configuración del diálogo
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.

Sinopsis del comando
wruntask –t Popup_Message –l "T/EC Tasks" –h nodo –a administrador –a ruta

Argumentos del comando
–a administrador Nombre de la consola de eventos del administrador de Tivoli 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

Capítulo 2. Tareas

161

Send_Email
Envía en un mensaje de correo electrónico 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 más información acerca del comando wmailhost, consulte la publicación Tivoli Management Framework Reference Manual.

Autorización
super, senior, admin, user

Opciones de configuración del diálogo
Nombre del administrador Nombre de la persona que recibe el mensaje. El nombre se muestra en el campo Para: del mensaje de correo electrónico. Dirección de correo electrónico del administrador ID de correo electrónico de la persona que recibe el mensaje.

Sinopsis del comando
Esta tarea no se puede ejecutar desde la línea de comandos.

162

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

Send_Event
Crea un nuevo evento y lo envía al servidor de eventos especificado de la región 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.

Autorización
super, senior, admin, user

Opciones de configuración del diálogo
Las únicas opciones que requieren valores son Nombre de clase y Fuente. Las demás 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 región de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orangeregion. Si no se especifica ningún valor para esta opción, 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 Dirección de protocolo o nombre de host del sistema fuente. Gravedad del evento. Los niveles de gravedad válidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Especificación más detallada del origen. Especificación más detallada de la fuente.

suborigen subfuente

Nombre de clase Clase del evento. Esta opción requiere un valor. Para obtener información adicional acerca de los nombres de clase de evento, consulte la publicación 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 opción requiere un valor.

Sinopsis del comando
Los únicos argumentos que requieren un valor son –a clase_evento y –a fuente. La especificación de valores para los demás argumentos es opcional. Es decir, no es necesario especificar valores para esos argumentos, pero sí debe especificar el

Capítulo 2. Tareas

163

indicador de los mismos con un contenedor vacío; 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

Argumentos del comando
–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 región de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orange-region. Si no se especifica ningún 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, especifíquelo entre comillas. Nombre del sistema en el que se produjo el evento. Dirección de protocolo o nombre de host del sistema fuente. Nivel de gravedad del evento. Los niveles de gravedad válidos son: Muy grave (FATAL), Grave (CRITICAL), Leve (MINOR), Aviso (WARNING), Inocuo (HARMLESS) y Desconocido (UNKNOWN). Suborigen del evento. Un suborigen es una especificación más detallada de un origen. Subfuente del evento. Una subfuente es una especificación más detallada de una fuente. Nombre de ka clase de evento. Este argumento requiere un valor. Para obtener información adicional acerca de los nombres de clase de evento, consulte la publicación 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

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

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

Capítulo 2. Tareas

165

Start_Maintenance
Informa al servidor de eventos de todos los intervalos de mantenimiento en curso o planificados para más 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.

Autorización
super, senior, admin, user

Opciones de configuración del diálogo
Las únicas opciones que requieren valores son Nombre de host y Duración del mantenimiento. Las demás 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 región de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orange-region. Si no se especifica ningún valor para esta opción, 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 entrarán en modalidad de mantenimiento y, por consiguiente, todos los eventos de estos hosts se descartarán o se cerrarán. Esta opción requiere un valor. Información del propietario del mantenimiento Toda la información de contacto correspondiente a la persona que ha iniciado el modo de mantenimiento en el host, como la dirección de correo electrónico o el número de teléfono. Duración del mantenimiento (minutos) Tiempo que durará el mantenimiento en minutos. El valor predeterminado es 60 minutos. Esta opción 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 más adelante, la hora debe especificarse en el formato AAAA MM DD HH MIN SS, siendo AAAA los cuatro dígitos del año, MM el mes (1 a 12), DD el día (1 a 31), HH la hora (00 a 23), MIN los minutos (00 a 59) y SS los segundos (00 a 59).

Sinopsis del comando
wruntask –t Start_Maintenance –l "T/EC Tasks" –h nodo –a {servidor_eventos | ""}

166

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

–a –a –a –a

nombre_host {info_propietario | ""} duración {hora_inicio | ""}

Los únicos argumentos que requieren un valor son –a nombre_host y –a duración. La especificación de valores para los demás 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 vacío; 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"

Argumentos del comando
–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 región de Tivoli en la que se encuentra el servidor de eventos remoto; por ejemplo, EventServer#orangeregion. Si no se especifica ningún valor para esta opción, 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 entrarán en modalidad de mantenimiento y, por consiguiente, todos los eventos de estos hosts se descartarán o se cerrarán. –a info_propietario Toda la información de contacto correspondiente a la persona que ha iniciado el modo de mantenimiento en el host, como la dirección de correo electrónico o el número de teléfono. –a duración 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 más adelante, la hora debe especificarse en el formato AAAA MM DD HH MIN SS, siendo AAAA los cuatro dígitos del año, MM el mes (1 a 12), DD el día (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á.

Capítulo 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

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

Wake_Up_Netscape
Muestra una página web en una ventana nueva del navegador Netscape. Esta tarea presupone que ya hay un proceso de navegador Netscape en ejecución en el host en el que se ejecuta la tarea.

Autorización
super, senior, admin

Opciones de configuración del diálogo
URL a visualizar URL (localizador uniforme de recursos) de la página 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.

Sinopsis del comando
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 más información, consulte la publicación Tivoli Management Framework Reference Manual.

Argumentos del comando
–a url –h nodo URL de la página 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

Capítulo 2. Tareas

169

170

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

Capítulo 3. Variables de entorno disponibles para las tareas
En este capítulo 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 automáticas que se ejecutan con un evento. Está organizada como se indica a continuación: Nombre Descripción Nombre de la variable de entorno. Breve descripción 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 después de las variables de entorno generales, en el apartado de la tabla titulado Atributos de evento. Ambas secciones de la tabla están ordenadas alfabéticamente.
Disponible para Programas de base de reglas Tareas de base de reglas X X

Nombre CHILD_OF_OSERV

Descripción 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 autenticación con el proceso oserv porque éste creó credenciales cuando creó el proceso hijo. v No necesita iniciar una nueva conexión 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.

X

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 visualización del servidor X. Nodo en el que se ejecuta la tarea.

X X X

Programas de consola

Tareas de consola

© Copyright IBM Corp. 2002

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

Descripción 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 intérpretes 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 búsqueda 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 parámetro de configuración 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 parámetros de ranura se han convertido al conjunto de códigos 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 parámetros de ranura no se convierten al conjunto de códigos local antes de ejecutar la tarea. Ubicación de la base de reglas cargada dentro del directorio $DBDIR. Puerto que el proceso tec_server utiliza para las comunicaciones. Número de segundos para la inicialización del servidor de eventos.

X

TEC_BIN_DIR TEC_EXECTASK_DBCS

X

TEC_KB_DIR TEC_MASTER_PORT TEC_MASTER_START_ TIMEOUT

172

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

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

Descripción Número máximo de eventos que se colocan en el búfer de memoria en el servidor de eventos. Indica que se registrará la recepción 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. Número máximo de eventos almacenados en la caché de eventos. Indica si el proceso de las reglas genera información de seguimiento. Archivo que contiene la información de seguimiento de las reglas Directorio de los archivos pertenecientes a la internacionalización 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.

X

adapter_host administrator cause_date_reception

X X X

cause_event_handle

X

class class_name

X X

Programas de consola X X X X X X

Tareas de consola

Capítulo 3. Variables de entorno disponibles para las tareas

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

Descripción Indica cómo se envió el evento desde el adaptador. El valor es 1 si se envió un evento a través 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. Indicación de la hora que indica la hora a la que el servidor de eventos recibió el evento. Es un número entero que indica los segundos transcurridos desde el estándar epoch, que corresponde al 1 de enero de 1970. Este valor también se utiliza como componente para identificar un evento de forma exclusiva. Un evento se identifica de forma exclusiva mediante la combinación de los valores de los atributos date_reception, event_handle y server_handle. Para los eventos cerrados, antigüedad (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. Número utilizado para hacer referencia al evento. Este número lo asigna el servidor de eventos. Número utilizado para hacer referencia al evento. Este número 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.

X

date date_event date_reception

duration

X

ev_key

X

event_handle

X

event_hndl

X

hostname last_modified_time msg msg_catalog

X X X X

174

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

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

Descripción ID de mensaje utilizado para obtener el mensaje internacionalizado. Número de acciones (tareas o programas) que el servidor de eventos está controlando para este evento. Número de puerto utilizado por el proceso oserv. Dirección de protocolo o nombre de host del sistema fuente. Contador para realizar un seguimiento del número de veces que se recibe un tipo de evento duplicado. Número que identifica el servidor de eventos que ha recibido este evento. Un evento se identifica de forma exclusiva mediante la combinación de los valores de los atributos date_reception, event_handle y server_handle. Número que identifica el servidor de eventos que ha recibido este evento. Un evento se identifica de forma exclusiva mediante la combinación de los valores de los atributos date_reception, event_handle y server_handle. Almacena información que describe los motores de reglas que ha pasado un evento. Gravedad del evento. La base de datos almacena la gravedad en forma de número. Esta asignación 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 continuación: 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

X

server_hndl

X

server_path

X

severity

X

Programas de consola X X X X X X

Tareas de consola

Capítulo 3. Variables de entorno disponibles para las tareas

175

Disponible para Programas de base de reglas X X X X Tareas de base de reglas X X X X

Nombre source

Descripción Fuente del evento (por ejemplo, el adaptador OpenView). La fuente la definen los tipos de adaptador. Estado del evento. Especificación más detallada del origen. Este atributo es opcional. Especificación más detallada de la fuente. Este atributo es opcional.

X

status sub_origin sub_source

X X X

Ejemplos
En este apartado se muestran ejemplos de vuelcos de variables de entorno para una tarea automática emitida desde una regla de Tivoli Enterprise Console y una tarea de consola ejecutada desde la consola de eventos. Puede haber saltos de línea en los valores de las variables debido a las limitaciones de espacio de la página.

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

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

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
Capítulo 3. Variables de entorno disponibles para las tareas

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

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

Apéndice. Parámetros de configuración
A continuación se facilitan los parámetros que se pueden establecer en el archivo .tec_config. Este archivo se encuentra en el directorio $BINDIR/TME/TEC. Los parámetros también se pueden establecer en las reglas mediante el predicado get_config_param. Nota: los parámetros tec_recv_agent_port, tec_disp_rule_port y tec_recv_rule_port indican qué números de puerto se utilizan para enviar eventos sin utilizar los servicios de comunicaciones de Tivoli Management Framework. Los números de puerto pueden definirse con un valor superior a 5000 para evitar que se produzcan conflictos con los puertos asignados automáticamente.
Parámetro tec_recv_agent_port Uso Especifica el puerto que el proceso tec_reception utiliza para la comunicación entre procesos. Este parámetro es obligatorio en los sistemas UNIX. Especifica el puerto que el proceso tec_dispatch utiliza para la comunicación entre procesos. Especifica el puerto que el proceso tec_rule utiliza para la comunicación 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 conexión y continúa 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 información en un directorio temporal. Especifica el número de eventos almacenados en la caché de eventos del motor de reglas. Especifica el tiempo máximo, en segundos, que un evento abierto puede estar en la caché de eventos del motor de reglas. Especifica el tiempo máximo, 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

© Copyright IBM Corp. 2002

179

Parámetro tec_rule_trace

Uso Activa o desactiva el seguimiento en las reglas de compilación. Si tiene el valor YES, también debe establecerse el parámetro tec_rule_trace_file. Especifica el nombre del archivo en el que se graba la información 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 numérico 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 cómo se pasan al motor de tareas los parámetros de ranura de tipo cadena. Si se le asigna el valor TRUE, los parámetros de ranura se convierten al código local antes de que se ejecute la tarea. Si se le asigna el valor FALSE, los parámetros se pasan como UTF8. Indica si todos los eventos de entrada estarán en formato UTF8.

tec_rule_trace_file

tec_rule_host tec_server_handle event_cache_file

tec_exectask_dbcs

always_expect_utf8

180

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

Avisos
Esta información se ha desarrollado para productos y servicios ofrecidos en Estados Unidos. Es posible que IBM no ofrezca en otros países los productos, los servicios o las funciones que se describen en este documento. Póngase en contacto con el representante de IBM para obtener información 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 sólo 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 información de doble byte (DBCS), póngase en contacto con el departamento de propiedad intelectual de IBM de su país o envíe las consultas, por escrito, a: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106 Japón El párrafo siguiente no se aplica al Reino Unido ni a ningún otro país donde las disposiciones en él expuestas sean incompatibles con la legislación local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN ″TAL CUAL″ SIN GARANTÍAS DE NINGÚN TIPO, YA SEAN EXPLÍCITAS O IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍAS IMPLÍCITAS DE NO VULNERACIÓN, COMERCIABILIDAD O ADECUACIÓN A UNA FINALIDAD DETERMINADA. Algunas legislaciones no contemplan la declaración de limitación de responsabilidad, ni implícita ni explícita, en determinadas transacciones, por lo que cabe la posibilidad de que esta declaración no se aplique en su caso. Esta información puede contener imprecisiones técnicas o errores tipográficos. Periódicamente se efectúan cambios en la información aquí contenida; dichos cambios se incorporarán en nuevas ediciones de la publicación. IBM puede efectuar mejoras o cambios en los productos o programas descritos en esta publicación en cualquier momento y sin previo aviso.

© Copyright IBM Corp. 2002

181

Cualquier referencia realizada en esta información a sitios web que no son de IBM se proporciona únicamente para su comodidad y de ningún modo representa una recomendación de dichos sitios web. Los materiales de estos sitios web no forman parte de los materiales de este producto de IBM y la utilización de los mismos será por cuenta y riesgo del usuario. IBM puede utilizar o distribuir la información que le proporcione del modo que considere apropiado sin incurrir en ninguna obligación con el remitente. Los titulares de licencias de este programa que deseen información sobre el mismo con el fin de permitir: (i) el intercambio de información entre programas creados independientemente y otros programas (incluido éste) y (ii) la utilización mutua de la información intercambiada, deben ponerse en contacto con: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 EE.UU. Esta información puede estar disponible de acuerdo con los términos 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 según los términos 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 podrían haberse realizado en sistemas de fase de desarrollo y no existe ninguna garantía de que tales mediciones vayan a ser las mismas en sistemas de disponibilidad general. Además, es posible que alguna medición se haya estimado mediante extrapolación. Los resultados reales pueden variar. Los usuarios de este documento deben verificar los datos aplicables a su entorno específico. La información 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 públicamente. 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 dirección o la intención futura de IBM están sujetas a cambios o anulación sin previo aviso y representan únicamente metas y objetivos. Esta información 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

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

Esta información contiene programas de aplicación de ejemplo en lenguaje fuente, que ilustran las técnicas de programación 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 programación 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 función 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 programación de aplicaciones de IBM. Si consulta esta información con algún programa de software, puede que las fotografías 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 países. Microsoft, Windows y Windows NT son marcas registradas de Microsoft Corporation en Estados Unidos o en otros países. 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 países.

UNIX es una marca registrada de The Open Group en Estados Unidos y en otros países. Otros nombres de compañías, productos y servicios son marcas registradas o de servicio de terceros.

Avisos

183

184

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

Índice A
acl, variable de entorno 173 actualizar bases de reglas anteriores a la versión 3.7 92 reglas del generador de reglas 16 actualizar, hora de modificación de registro de perfil de configuración de adaptador 142 adaptador comandos, resumen 6 identificadores para varios adaptadores en el mismo sistema 20, 97, 102 instalar información de validación para 108 instalar variables de entorno para 105 mostrar información de validación instalada 56 adapter_host, variable de entorno 173 administrator, variable de entorno 173 agregar filtros de grupos de eventos 25 registro de configuración de adaptador para perfil de configuración de adaptador 17 registro de configuración 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 número de eventos 115 cadena, límite de tamaño 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 (versión de nodo gestionado) 4, 68 wpostemsg (versión de punto final) 4, 66 wpostzmsg (versión de nodo gestionado) 5, 72 wpostzmsg (versión 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 estadísticas, actualizar 45 reorganizar 45 scripts de configuración, 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

© Copyright IBM Corp. 2002

185

comandos (continuación) 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 (definición 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 tipográficos 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, notación ix DISPLAY, variable de entorno 171 Dump_Event_Repository, tarea 145, 151 duration, variable de entorno 174

7

E
eliminar registro de configuración de adaptador de un perfil de configuración de adaptador 47 en línea, acceder a publicaciones vi ENDPOINT, variable de entorno 171 ENDPOINT_OID, variable de entorno 172 enlace con herramientas de configuración ampliadas, mostrar 55 enlace instalado con herramientas de configuración ampliadas, mostrar 55 enlazar, interfaz de Recurso de configuración del adaptador con una herramienta de configuración 106 entorno Tivoli, configuración 1 enviar un evento al servidor de eventos 8, 66, 68 establecimiento parámetros de configuración para el servidor de eventos 115 periodo de conservación en registro de recepción 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

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

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 número, 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 (continuación) 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 información de validación 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 configuración del adaptador con herramientas de configuración 106 información de validación para un tipo de adaptador variables de entorno para un adaptador 105 internacionalización 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 véase publicaciones vi línea 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 parámetros de configuración 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 configuración enlazar con interfaz de Recurso de configuración del adaptador 106 mostrar enlace instalado con 55 hora de modificación, actualizar en un registro de perfil de configuración de adaptador 142 hostname, variable de entorno 174

M
manuales véase publicaciones vi mensaje, visualizar en el escritorio del administrador 93 mensajes de eventos, resumen de comandos 4 modificar evento 113 registro de configuración de adaptador para perfil de configuración de adaptador 94 registro de configuración de adaptador para un valor predeterminado de tipo de adaptador 99 variables de entorno en puntos finales de perfil de configuración 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 información de validación instalada para el tipo de adaptador 56 registros de configuración de adaptador para perfil de configuración de adaptador 49 variables de entorno de Recurso de integración de eventos específicas del adaptador 54 Véase también 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 línea, acceder vi pedidos vii punto final modificar variables de entorno en 110 mostrar variables de entorno para un perfil de configuración de adaptador 58

R
Recurso de configuración del adaptador comandos, resumen 6 interfaz, enlazar con herramientas de configuración 106 referencia a objeto absoluta 2 registrados, nombres 2 registro de configuración de adaptador agregar, para un perfil de configuración de adaptador 17 agregar, para un valor predeterminado de tipo de adaptador 99 modificar, para un perfil de configuración de adaptador 94 modificar, para un valor predeterminado de tipo de adaptador 99 mostrar, en un perfil de configuración de adaptador 49 suprimir de un perfil de configuración de adaptador 47 registro de nombres, descripción 2 registro de recepción, especificar periodo de conservación 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 resúmenes 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 configuración del adaptador 6 ruta absoluta 3 ruta relativa 3 rutas, notación 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, descripción 2 notación rutas ix tipográfica 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 parámetros de configuración 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 configuración de adaptador actualizar hora de modificación de registro de perfil de configuración de adaptador 142 agregar un registro de configuración de adaptador para 17 agregar un valor predeterminado de tipo de adaptador para 99 eliminar registro de configuración de adaptador de 47 modificar un registro de configuración de adaptador para 94 modificar un valor predeterminado de tipo de adaptador para 99 modificar variables de entorno en puntos finales de perfil de configuración de adaptador 110 mostrar registros de configuración 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, diálogo 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 parámetros de configuración para 115 generar informe sobre tareas completadas por 136 generar informes de eventos recibidos por 134 iniciar 119

188

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

servidor de eventos (continuación) lista, suprimir una fuente de 48 listar fuentes en 63 listar parámetros de configuración 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 véase 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 tipográficos, 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 configuración 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 integración de eventos específicas 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 configuración 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 información 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, diálogo 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 (continuación) 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, notación para ix variables de entorno, notación 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 (versión de nodo gestionado) 4, 68 wpostemsg, comando (versión de punto final) 4, 66 wpostzmsg, comando (versión de nodo gestionado) 5, 72 wpostzmsg, comando (versión de punto final) 4, 70 wrb, comando 5, 74

190

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

Printed in Denmark by IBM Danmark A/S

SC10-3980-00

Sponsor Documents

Or use your account on DocShare.tips

Hide

Forgot your password?

Or register your new account on DocShare.tips

Hide

Lost your password? Please enter your email address. You will receive a link to create a new password.

Back to log-in

Close