DEFINE ALERTTRIGGER (Define an alert trigger)

Use this command to trigger an alert whenever a server issues a specific error message. You can define a message number to be an alert trigger, assign it to a category, or specify administrators who can be notified of the alert by email.

Privilege class

To issue this command, you must have system privilege.

Syntax


                        .-,-----------------.   
                        V                   |   
>>-DEfine ALERTTrigger----+--message_number-+------------------->

   .-CATegory--=--SErver----------.   
>--+------------------------------+----------------------------->
   '-CATegory--=--+-APplication-+-'   
                  +-INventory---+     
                  +-CLient------+     
                  +-DEvice------+     
                  +-SErver------+     
                  +-STorage-----+     
                  +-SYstem------+     
                  '-VMclient----'     

>--+--------------------------+--------------------------------><
   |           .-,----------. |   
   |           V            | |   
   '-ADmin--=----admin_name-+-'

Parameters

message_number (Required)

Specifies the message number that you want to associate with the alert trigger. Specify multiple message numbers, which are separated by commas, and no intervening spaces. Message numbers are a maximum of eight characters in length.

CATegory

Specifies the category type for the alert, which is determined by the message types. The default value is SERVER.

Note: Changing the category of an alert trigger does not change the category of existing alerts on the server. New alerts are categorized with the new category.

Specify one of the following values:

APplication: Alert is classified as application category. For example, you can specify this category for messages that are associated with application (TDP) clients.
INventory: Alert is classified as inventory category. For example, you can specify this category for messages that are associated with the database, active log file, or archive log file.
CLient: Alert is classified as client category. For example, you can specify this category for messages that are associated with general client activities.
DEvice: Alert is classified as device category. For example, you can specify this category for messages that are associated with device classes, libraries, drives, or paths.
SErver: Alert is classified as general server category. For example, you can specify this category for messages that are associated with general server activities or events.
STorage: Alert is classified as storage category. For example, you can specify this category for messages that are associated with storage pools.
SYstems: Alert is classified under system clients category. For example, you can specify this category for messages that are associated with system backup and archive or hierarchical storage management (HSM) backup-archive clients.
VMclient: Alert is classified under VMclient category. For example, you can specify this category for messages that are associated with virtual machine clients.

ADmin

This optional parameter specifies the name of the administrator who receives email notification of this alert. The alert trigger is defined successfully even if no administrator names are specified.

Assign two message numbers to an alert

Issue the following command to specify that you want two message numbers to trigger an alert:

define alerttrigger ANR1067E,ANR1073E

Assign a message number to an alert and email two administrators

Issue the following command to specify the message numbers that you want to trigger an alert and have them sent by email to two administrators:

define alerttrigger ANR1067E,ANR1073E ADmin=BILL,DJADMIN

Related commands

Table 1. Commands related to DEFINE ALERTTRIGGER
Command	Description
DELETE ALERTTRIGGER (Remove a message from an alert trigger)	Removes a message number that can trigger an alert.
QUERY ALERTSTATUS (Query the status of an alert)	Displays information about alerts that have been issued on the server.
QUERY ALERTTRIGGER (Query the list of defined alert triggers)	Displays message numbers that trigger an alert.
QUERY MONITORSETTINGS (Query the configuration settings for monitoring alerts and server status)	Displays information about monitoring alerts and server status settings.
UPDATE ALERTTRIGGER (Update a defined alert trigger)	Updates the attributes of one or more alert triggers.
UPDATE ALERTSTATUS (Update the status of an alert)	Updates the status of a reported alert.