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-------+       |   
                      |   |            (1) |       |   
                      |   +-NTEVENTLOG-----+       |   
                      |   |        (2)     |       |   
                      |   +-SYSLOG---------+       |   
                      |   +-TIVOLI---------+       |   
                      |   '-USEREXIT-------'       |   
                      +-NODEname--=--node_name-----+   
                      '-SERVername--=--server_name-'

Notes:

This parameter is only available for the Windows operating system.
This parameter is only available for the Linux operating system.

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 IBM Spectrum Protect™ 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 application log as a receiver.
SYSLOG: Specifies the Linux system log as a receiver.
TIVOLI: Specifies the Tivoli Management Environment (TME) as a receiver.
USEREXIT: Specifies a user-written routine to which IBM Spectrum Protect 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.

Example: Display the history of client events for the server console

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

query eventrules console,actlog nodename=*

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

Example: Display the history of client events for all receivers

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

query eventrules

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

Field descriptions

Date/Time: Specifies the date and time when the event was enabled or disabled.
Client Event Rules: Specifies client events that were enabled or disabled for the specified receivers.
Server Event Rules: Specifies server events that were enabled or disabled for the specified receivers.

Related commands

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