Administrator's Reference

QUERY EVENTRULES (Query Rules for Server or Client Events)

Use this command to display the history of events that are enabled or disabled by a specified receiver for the server or for a client node.

Privilege Class

Any administrator can issue this command.

Syntax

                        .-*---------------------.
>>-Query--EVENTRUles----+-----------------------+--------------->
                        |  .-,----------------. |
                        |  V                  | |
                        '----+-CONSOLE-----+--+-'
                             +-ACTLOG------+
                             +-EVENTSERVER-+
                             +-FILE--------+
                             +-FILETEXT----+
                             +-NTEVENTLOG--+
                             +-SNMP--------+
                             +-TIVOLI------+
                             '-USEREXIT----'
 
>-----+-----------------------------+--------------------------><
      +-NODEname--=--node_name------+
      '-SERVername--=--server_name--'
 

Parameters

receivers
Specifies the name of one or more receivers for enabled events. This parameter is optional.

You can use a wildcard character to specify all receivers.

Valid values are:

CONSOLE
Specifies the standard 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.

NTEVENTLOG
Specifies the Windows NT application log as a receiver.

SNMP
Specifies the simple network management protocol (SNMP) 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.

NODEname
Specifies a node name to be queried. You can use a wildcard character to specify a name. You can specify NODENAME or SERVERNAME. If neither parameter is specified, the query is for event rules for the server running this command.

SERver
Specifies a server name to be queried. You can use a wildcard character to specify a name. You can specify NODENAME or SERVERNAME. If neither parameter is specified, the query is for event rules for the server running this command.

Examples

Task 1

Display the history of client events enabled or disabled for the server console and activity log receivers.

Command:
query eventrules console,actlog nodename=*

Output:
+--------------------------------------------------------------------------------+
|Date/Time            Client Event Rules                                         |
|-------------------- ----------------------------------------------------       |
|05/29/97 13:39:58    ENABLE EVENTS CONSOLE ANE4001 NODENAMES=JEE                |
|05/30/97 13:46:25    DISABLE EVENTS ACTLOG ANE4962 NODENAMES=JEE                |
|05/30/97 13:46:25    DISABLE EVENTS ACTLOG ANE4963 NODENAMES=JEE                |
|05/30/97 13:46:25    DISABLE EVENTS ACTLOG ANE4965 NODENAMES=JEE                |
|05/30/97 13:46:25    DISABLE EVENTS ACTLOG ANE4966 NODENAMES=JEE                |
|05/30/97 13:46:25    DISABLE EVENTS ACTLOG ANE4967 NODENAMES=JEE                |
|05/30/97 13:46:25    DISABLE EVENTS ACTLOG ANE4968 NODENAMES=JEE                |
|05/30/97 14:24:20    ENABLE EVENTS CONSOLE ANE4015 NODENAMES=RON                |
|05/30/97 14:24:50    ENABLE EVENTS CONSOLE ANE4026 NODENAMES=DONNA              |
|05/30/97 14:25:59    ENABLE EVENTS CONSOLE ANE4015 NODENAMES=DONNA              |
+--------------------------------------------------------------------------------+

Task 2

Display the history of server events enabled or disabled for all receivers.

Command:
query eventrules

Output:
+--------------------------------------------------------------------------------+
|Date/Time            Server Event Rules                                         |
|-------------------- ----------------------------------------------------       |
|05/22/97 14:35:13    ENABLE EVENTS CONSOLE ANR2578                              |
|05/30/97 14:29:31    ENABLE EVENTS CONSOLE ANR0272                              |
|05/30/97 14:31:46    ENABLE EVENTS USEREXIT ANR0130                             |
|05/30/97 14:31:54    ENABLE EVENTS USEREXIT ANR0131                             |
|05/30/97 14:50:28    ENABLE EVENTS USEREXIT ANR0266                             |
+--------------------------------------------------------------------------------+

Related Commands

Table 168. Commands Related to QUERY ENABLED

Command Description
BEGIN EVENTLOGGING Starts event logging to a specified receiver.
DISABLE EVENTS Disables specific events for receivers.
ENABLE EVENTS Enables specific events for receivers.
END EVENTLOGGING Ends event logging to a specified receiver.
QUERY ENABLED Displays enabled or disabled events for a specific receiver.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]