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)
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Create alert recipient

(continued)

  
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.
  
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@us.ibm.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@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 -4 -n test4 -status on -f none -t snmp
OK
system:mm[1]>
Parent topic: Command reference