chemail

Use the chemail command to set or modify contact information for email event notifications. At least one of the parameters must be specified to modify settings.

Syntax

Read syntax diagramSkip visual syntax diagram chemail -replyreply_email_address-contactcontact_name-primaryprimary_telephone_number-alternatealternate_telephone_number-locationlocation-contact2contact_name2-primary2primary_telephone_number2-alternate2alternate_telephone_number2-nocontact2-organizationorganization-addressaddress-citycity-statestate-zipzip-countrycountry-fromemail_address-nofrom

Parameters

-reply reply_email_address
(Optional) Specifies the email address to which a reply is sent.
-contact contact_name
(Optional) Specifies the name of the person to receive the email.
-primary primary_telephone_number
(Optional) Specifies the primary contact telephone number.
Note: For machine types 2071 and 2072 (in the United States and Canada), the value entered must be exactly ten decimal digits. For machines types 2071 and 2072 (in other countries) the value entered can be five to nineteen decimal digits. Otherwise, there can be up to nineteen characters.
-alternate alternate_telephone_number
(Optional) Specifies the alternate contact telephone number that is used when you cannot reach the primary contact on the primary phone.
-location location
(Optional) Specifies the physical location of the system that is reporting the error. The location value must not contain punctuation or any other characters that are not alphanumeric or spaces.
-contact2 contact_name2
(Optional) Specifies the name of the second contact person to receive the email.

For machine types 2071 and 2072 the maximum number of characters is 30. For other machine types the maximum number of characters is 72.

-primary2 primary_telephone_number2
(Optional) Specifies the primary contact telephone number for the second contact person.
Note: For machine types 2071 and 2072 (in the United States and Canada), the value entered must be exactly ten decimal digits. For machines types 2071 and 2072 (in other countries) the value entered can be five to nineteen decimal digits. Otherwise, there can be up to nineteen characters.
-alternate2 alternate_telephone_number2
(Optional) Specifies the alternate contact telephone number for the second contact person.
-nocontact2
(Optional) Removes all the contact details for the second contact person.
-organization organization
(Optional) Specifies the user's organization as it should appear in Call Home emails.
-address address
(Optional) Specifies the first line of the user's address as it should appear in Call Home email.
-city city
(Optional) Specifies the user's city as it should appear in Call Home email.
-state state
(Optional) Specifies the user's state as it should appear in Call Home email. This is a two-character value such as NY for New York.
-zip zip
(Optional) Specifies the user's zip code or postal code as it should appear in Call Home email.
-country country
(Optional) Specifies the country in which the machine resides as it should appear in Call Home email. This is a two-character value such as US for United States.

For machine types 2071 and 2072 this value cannot be US or CA if the value for primary or primary2 telephone number is not blank or exactly 10 digits.

-from email_address
(Optional) Specifies the email address that is set in the from: field of the email that is sent by the system.
-nofrom
(Optional) Removes the email address that is set in the from: field of the email that is sent by the system.

Description

This command sets or modifies contact information that is used by the email event notification facility.

Note: If you are starting the email event notification facility, the reply, contact, primary, and location parameters are required. If you are modifying contact information used by the email event notification facility, at least one of the parameters must be specified.
Remember: When considering e-mail addresses:
  • Alphanumeric characters and additionally underscore (_), at symbol (@), and dot (.) characters are permitted.
  • There must be exactly one @ character in the string, and the @ characters must not start or end the string.
  • A plus (+) character is permitted before the @ character.
The email notification system cannot be started unless the following fields are set (in addition to the existing four: reply, contact, primary, location):
  • Organization
  • Address
  • City
  • State
  • Zip
  • Country
The state field has a default value of XX, which is for systems that are not in the USA, Canada, Puerto Rico, the Virgin Islands, or Guam.
Remember: The user must enter values for these fields in order to enable the email notification system.

These fields do not have to be set to start the email notification system, but if the new fields are set they are included in the email event notifications.

An invocation example

chemail -reply jane.doe@ibm.com
 -contact 'Jane Doe'
 -primary 01234 567890
 -location 'Server Room'
 -organization IBM
 -address '1 Orchard Rd'
 -city 'New York'
 -zip 10504
 -country US

The resulting output:

No feedback.