Tivoli Header
Administrator's Reference
Use this command to enable the processing of one or more events. If
you specify a receiver that is not supported on any platform, or if you
specify an invalid event or name, TSM issues an error message. However,
any valid receivers, events, or names that you specified are still
enabled.
- Note:
- Certain events, such as some messages issued during server start-up and
shutdown, automatically go to the console. They do not go to other
receivers even if they are enabled.
Privilege Class
To issue this command, you must have system privilege.
Syntax
.-,---------------. .-,--------------.
V | V |
>>-ENable--EVents----+-ALL---------+-+----+-event_name-+-+------>
+-CONSOLE-----+ +-ALL--------+
+-ACTLOG------+ +-INFO-------+
+-EVENTSERVER-+ +-WARNING----+
+-FILE--------+ +-ERROR------+
+-FILETEXT----+ '-SEVERE-----'
+-SNMP--------+
+-TIVOLI------+
'-USEREXIT----'
>--+--------------------------------+--------------------------><
| .-,---------. |
| V | |
+-NODEname--=----node_name-+-----+
| .-,-----------. |
| V | |
'-SERVername--=----server_name-+-'
Parameters
- receivers (Required)
- Specifies one or more receivers for which to log enabled events.
You can specify multiple receivers by separating them with commas and no
intervening spaces. Valid values are:
- ALL
- All receivers.
- CONSOLE
- The standard server console as a receiver.
- ACTLOG
- The server activity log as a receiver.
- EVENTSERVER
- The event server as a receiver.
- FILE
- A user file as a receiver. Each logged event is a record in the
file. The records are not easily readable by people.
- FILETEXT
- A user file as a receiver. Each logged event is a fixed-size,
readable line.
- SNMP
- The simple network management protocol (SNMP) as a receiver.
- TIVOLI
- The Tivoli Enterprise Console(R) (TEC) as a receiver.
- USEREXIT
- A user-written program as a receiver. The server writes information
to the program.
- events (Required)
- Specifies the type of events to be enabled. You can specify
multiple events by separating them with commas and no intervening
spaces. Possible values are:
- ALL
- All events.
- event_name
- A four-digit message number preceded by ANR for a server event
or ANE for a client event. Valid ranges are from ANR0001 to
ANR9999 and from ANE4000 to ANE4999. Specify the NODENAME parameter if
client events are to be enabled for matching nodes. Specify the
SERVERNAME parameter if server events are to be enabled for matching
servers.
For the TIVOLI event receiver, you can specify the following additional
ranges for the Tivoli Storage Manager application clients:
Tivoli Data Protection Application Client
| Prefix
| Range
|
TDP for Exchange
| ACN
| 3500-3649
|
TDP for Domino(TM)
| ACD
| 5200-5299
|
TDP for Oracle
| ANS
| 500-599
|
TDP for Informix
| ANS
| 600-699
|
TDP for SQL
| ACO
| 3000-3999
|
Notes:
- The application client must have enhanced T/EC support enabled in order to
route the above messages to the Tivoli Event Console.
- Specifying the ALL option enables these messages. However, the
INFO, WARNING, ERROR, and SEVERE options have no effect on the
messages.
- Because of the number of messages, you should not enable all messages from
a node to be logged to the Tivoli Event Console.
- severity categories
- If the event list contains a severity category, all events of that
severity are enabled for the specified nodes. The message types
are:
- INFO
- Information messages (type of I) are enabled.
- WARNING
- Warning messages (type of W) are enabled.
- ERROR
- Error messages (type of E) are enabled.
- SEVERE
- Severe error messages (type of S) are enabled.
- NODEname
- Specifies one or more client nodes for which events are enabled.
You can use a wildcard character to specify all client nodes. You can
specify NODENAME or SERVERNAME. If neither parameter is specified,
events are enabled for the server running this command.
- SERVername
- Specifies one or more servers for which events are to be enabled.
You can use a wildcard character to specify all servers other than the server
from which this command is issued. You can specify SERVERNAME or
NODENAME. If neither parameter is specified, the events are enabled for
the server running this command.
Examples
Task
Enable all ERROR and SEVERE client events to the USEREXIT receiver for the
node BONZO.
- Command:
- enable events userexit error,severe nodename=bonzo
Related Commands
Table 128. Commands Related to ENABLE EVENTS
Command
| Description
|
BEGIN EVENTLOGGING
| Starts event logging to a specified receiver.
|
DISABLE EVENTS
| Disables specific events for receivers.
|
END EVENTLOGGING
| Ends event logging to a specified receiver.
|
QUERY ENABLED
| Displays enabled or disabled events for a specific receiver.
|
QUERY EVENTRULES
| Displays information about rules for server and client events.
|
QUERY STATUS
| Displays the settings of server parameters, such as those selected by the
SET commands.
|
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]