Administrator's Reference
Use this command to enable one or more server or client events for logging
to one or more receivers (destinations).
If you enter any invalid events, receivers, node or server names, TSM
issues an error message. However, TSM enables any valid events,
receivers, node or server names that were specified.
Note: | Certain events, such as some messages issued during server start-up and
shutdown, automatically go to the console but 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-----'
+-NETVIEW-----+
+-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
- Specifies all receivers.
- CONSOLE
- Specifies the standard server console as a receiver.
- ACTLOG
- Specifies the TSM activity log as a receiver.
- EVENTSERVER
- Specifies the event server as a receiver.
- FILE
- Specifies a user file as a receiver. Each logged event is a record in the file and a person cannot read
each logged event easily.
- FILETEXT
- Specifies a user file as a receiver. Each logged event is a
fixed-size, readable line.
- NETVIEW
- Specifies the NetView for MVS network observation tool as a
receiver.
- TIVOLI
- Specifies the Tivoli Management Environment (TME) as a receiver.
- USEREXIT
- Specifies a user-written routine to which TSM writes information as a
receiver.
- events
- Specifies the type of events to be enabled. You can specify
multiple events by separating them with commas and no intervening
spaces. This is a required parameter. Valid values are ALL, a
message name or a severity category.
- ALL
- Specifies that all events are enabled.
- eventname
- Specifies a four-digit message number preceded by ANR for a
server event or ANE for a client event. To enable client
events, you must specify the NODENAMES parameter. To enable server
events, you must specify the SERVERNAMES parameter.Valid ranges are
from ANR0001 to ANR9999 and from ANE4000 to ANE4999.
- 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 104. 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 ]