IBM Tivoli Storage Manager, Version 7.1

ENABLE EVENTS (Enable server or client events for logging)

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, Tivoli® Storage Manager issues an error message. However, any valid receivers, events, or names that you specified are still enabled.

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

Administrative commands are returned to the command issuer and are only logged as numbered events. These numbered events are not logged to the system console, but are logged to other receivers, including administrative command-line sessions running in console mode.

Privilege class

To issue this command, you must have system privilege.

Syntax


>>-ENable--EVents----------------------------------------------->

   .-,-------------------------------------------.   
   V                                             |   
>----+-ALL-------------------------------------+-+-------------->
     +-CONSOLE---------------------------------+     
     +-ACTLOG----------------------------------+     
     +-EVENTSERVER-----------------------------+     
     +-FILE------------------------------------+     
     +-FILETEXT--------------------------------+     
     |                                     (1) |     
     +-Windows operating systemsNTEVENTLOG-----+     
     |      (2)                                |     
     +-SNMP------------------------------------+     
     +-TIVOLI----------------------------------+     
     '-USEREXIT--------------------------------'     

   .-,--------------.                                       
   V                |                                       
>----+-event_name-+-+--+--------------------------------+------><
     +-ALL--------+    |              .-,---------.     |   
     +-INFO-------+    |              V           |     |   
     +-WARNING----+    +-NODEname--=----node_name-+-----+   
     +-ERROR------+    |                .-,-----------. |   
     '-SEVERE-----'    |                V             | |   
                       '-SERVername--=----server_name-+-'

Notes:

NTEVENTLOG is available only on Windows.
SNMP is available only on AIX, HP-UX, Linux, Solaris, and Windows.

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.
NTEVENTLOG: The Windows application log as a receiver.
SNMP: The simple network management protocol (SNMP) as a receiver.
TIVOLI: The Tivoli Enterprise Console® (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 Storage Manager application client	Prefix	Range
Data Protection for Microsoft Exchange Server	ACN	3500–3649
Data Protection for Lotus® Domino®	ACD	5200–5299
Data Protection for Oracle	ANS	500–599
Data Protection for Informix®	ANS	600–699
Data Protection for Microsoft SQL Server	ACO	3000–3999

Restriction: The application client must have enhanced Tivoli Event Console support enabled in order to route these messages to the Tivoli Event Console.

Tip:

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.

Example: Enable specific categories of events

Enable all ERROR and SEVERE client events to the USEREXIT receiver for the node BONZO.

enable events userexit error,severe nodename=bonzo

Related commands

Table 1. 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.

Feedback