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]>