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 (E-Mail over LAN/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 e-mail notifications) -i static_IP_addr/hostname (used for IBM 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. Command use restricted (see Commands and user authority).	`-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 `e-mail`, `director` (IBM Director) or `snmp`. For `e-mail`, you must specify an e-mail 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 e-mail 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 ( _ ). Command use restricted (see Commands and user authority).
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. Command use restricted (see Commands and user authority).	`-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. Command use restricted (see Commands and user authority).	`-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). Command use restricted (see Commands and user authority).	`-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 Director) `snmp` Command use restricted (see Commands and user authority).	`-T system:mm[x]` where x is the primary management-module bay number.
Set alert recipient e-mail address	Sets the e-mail address for the specified alert recipient. This e-mail address is used to send alerts to the recipient via e-mail. The e-mail 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 e-mail address string up to 63 characters in length. Command use restricted (see Commands and user authority).	`-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 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 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 ( _ ). Command use restricted (see Commands and user authority).	`-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 e-mail, 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 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]>