alertentries command

This command manages the recipients of alerts generated by the primary management module.

Table 1. alertentries command
Function What it does Command Valid targets
Display alert properties for all recipients Displays alert properties for all management-module alert recipients. Returned values for each alert recipient are:
  • recipient name
  • notification method (Email over LAN/Systems Director comp./SNMP over LAN)
  • type of alerts received (Receives critical alerts only/Receives all alerts/Disabled)
alertentries
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Display alert properties for alert recipients Displays alert properties for the specified management-module alert recipient profile. Returned values are:
  • -status alert_recipient_status (on/off)
  • -n alert_recipient_name
  • -f alert_type (critical/none)
  • -t notification_method (email/director/snmp)
  • -e email_address (used for email notifications)
  • -i static_IP_addr/hostname (used for IBM Systems Director notifications)
alertentries -recip_number

where recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.

                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Delete alert recipient Delete the specified alert recipient. alertentries -recip_number -del

where recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list. It is possible to delete an empty alert recipient.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Create alert recipient Create the specified alert recipient.

All fields must be specified when creating an alert recipient.

alertentries -recip_number -n recip_name -status alert_status -f filter_type -t notification_method -e email_addr -i ip_addr/hostname

where:

  • recip_number is a number from 1 to 12 that corresponds to an unused recipient number in the "Display alert properties for all recipients" list.
  • recip_name is a alphanumeric string up to 31 characters in length containing any character, including spaces, except for angle brackets ( < and > ). If the string includes spaces it must be enclosed in double-quotes.
  • alert_status is on or off for receipt of alerts.
  • filter_type filters the alert types received: critical (receive critical alerts only) or none (receive all alerts).
  • notification_method is email, director (IBM Systems Director) or snmp.
    • For email, you must specify an email address (-e argument).
    • For director you must specify an IP address (-i argument).
    • If snmp is selected, the -e and -i arguments are not needed.
  • email_addr is a valid email address string up to 63 characters in length.
(continued on next page)
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Create alert recipient

(continued)

 
  • ip_addr/hostname is a valid static IP address or an alphanumeric hostname string for the recipient that is up to 49 characters in length that can include periods ( . ), hyphens ( - ), and underscores ( _ ).
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
 
Set alert recipient name Sets a name for the specified alert recipient. alertentries -recip_number -n recip_name

where:

  • recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.
  • recip_name is a alphanumeric string up to 31 characters in length that can include any character, including spaces, except for angle brackets ( < and > ). If the name includes spaces, it must be enclosed in double-quotes.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set alert recipient status Sets status for the specified alert recipient. The status determines if a recipient will receive alarm notifications. alertentries -recip_number -status alert_status

where:

  • recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.
  • alert_status is on or off.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set alert types received Filters the types of alert that are received by the specified alert recipient. alertentries -recip_number -f filter_type

where:

  • recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.
  • alert_type filters the alert types received: critical (receive critical alerts only) or none (receive all alerts).
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set alert notification method Sets the alert notification method for the specified alert recipient. alertentries -recip_number -t notification_method

where:

  • recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.
  • notification_method is
    • email
    • director (IBM Systems Director)
    • snmp
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set alert recipient email address Sets the email address for the specified alert recipient. This email address is used to send alerts to the recipient via email.

The email address can be set only if the alert notification method (-t option) is set to email. The -t and -e options can be combined within the same command.

alertentries -recip_number -e email_addr

where:

  • recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.
  • email_addr is a valid email address string up to 63 characters in length.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Set alert recipient IP address or hostname Sets the IP address or hostname used to send alert notifications to the specified alert recipient using IBM Systems Director.

The IP address or hostname used to send alert notifications can be set only if the alert notification method (-t option) is set to director (IBM Systems Director). The -t and -i options can be combined within the same command.

alertentries -recip_number -i ip_addr/hostname

where:

  • recip_number is a number from 1 to 12 that corresponds to the recipient number assigned in the "Display alert properties for all recipients" list.
  • ip_addr/hostname is a valid static IP address or an alphanumeric hostname string up to 49 characters in length that can include periods ( . ), hyphens ( - ), and underscores ( _ ).
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Generate test alert Generates a test alert to verify correct alert response.
Notes:
  • The alertentries -test command option must be used alone.
  • If autoftp is enabled, sending a test alert will cause the system to send out service data as well.
alertentries -test
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis log management
  • Chassis administration
  • Chassis configuration
  • Blade administration
  • Blade configuration
  • Blade remote presence
  • I/O module administration
  • I/O module configuration
See Commands and user authority for additional information.
                           -T system:mm[x]
                        

where x is the primary management-module bay number.

Example: To view the configuration for alert recipient 1, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  alertentries -1
               
To configure alert recipient 2 to receive only critical alert notifications by email, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  alertentries -2 -n test2 -status on -f critical -t email -e test2@us.ibm.com
               
To configure alert recipient 3 to receive all alert notifications through IBM Systems Director, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  alertentries -3 -n test3 -status on -f none -t director -i 192.168.70.140
               
To configure alert recipient 4 to receive all alert notifications through SNMP, while management module 1 is set as the persistent command environment, at the system:mm[1]> prompt, type
                  alertentries -4 -n test4 -status on -f none -t snmp
               

The following example shows the information that is returned from these commands:

               system:mm[1]> alertentries -1
-status on
-n test1
-f critical
-t email
-e test1@us.ibm.com
system:mm[1]> alertentries -2 -n test2 -status on -f critical -t email
-e test2@us.ibm.com
OK
system:mm[1]> alertentries -3 -n test3 -status on -f none -t director
-i 192.168.70.140
OK
system:mm[1]> alertentries -4 -n test4 -status on -f none -t snmp
OK
system:mm[1]>