alertentries command

This command manages the recipients of alerts generated by the primary CMM.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or alertentries command errors for a list of error messages that are specific to the alertentries command.

Table 1. alertentries command.
The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function	What it does	Command	Target (see paths in Command targets)
Display alert properties for all recipients	Displays alert properties for all CMM 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`	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Display alert properties for alert recipients	Displays alert properties for the specified CMM 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)	`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.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM 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 account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM 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 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` or `snmp` . For `email` , you must specify an email address (-e argument). If `snmp` is selected, the -e argument is not needed. email_addr is a valid email address string up to 63 characters in length. (continued on next page) This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
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 account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM 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 account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM 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 account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM 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` `snmp` This command can only be run by users who have one or more of the following command authorities: Supervisor Chassis account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM 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 account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.
Generate test alert	Generates a test alert to verify correct alert response. Note 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 account management Chassis log management Chassis administration Chassis configuration See Commands and user authority for additional information. In some cases, your system configuration might also allow the command to be run by users who have one or more of the following command authorities: Chassis log management Chassis administration Blade administration Blade configuration Blade remote presence I/O module administration I/O module configuration See Commands and user authority for additional information.	Primary CMM: mm[p] mm[P] mm[x] where x is the primary CMM bay number.

Example: To view the configuration for alert recipient 1, while the primary CMM in bay 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 the primary CMM in bay 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@lenovo.com

To configure alert recipient 4 to receive all alert notifications through SNMP, while the primary CMM in bay 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@lenovo.com
system:mm[1]> alertentries -2 -n test2 -status on -f critical -t email
-e test2@us.lenovo.com
OK
system:mm[1]> alertentries -4 -n test4 -status on -f none -t snmp
OK
system:mm[1]>

Give documentation feedback