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

 chemail    [  -reply  reply_email_address  ]   [  -contact  contact_name  ]   [  -primary  primary_telephone_number  ]   [  -alternate  alternate_telephone_number  ]   [  -location  location  ]   [  -contact2  contact_name2  ]   [  -primary2  primary_telephone_number2  ]   [  -alternate2  alternate_telephone_number2  ]   [  -nocontact2  ]   [  -organization  organization  ]   [  -address  address  ]   [  -city  city  ]   [  -state  state  ]   [  -zip  zip  ]   [  -country  country  ]

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.

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

-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.
-organizationorganization
(Optional) Specifies the user's organization as it should appear in Call Home emails.
-addressaddress
(Optional) Specifies the first line of the user's address as it should appear in Call Home email.
-citycity
(Optional) Specifies the user's city as it should appear in Call Home email.
-statestate
(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.
-zipzip
(Optional) Specifies the user's zip code or postal code as it should appear in Call Home email.
-countrycountry
(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.

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 ddrogba@uk.uefa.com
        -contact 'Didier Drogba'
        -primary 01962817668
        -location 'C block'
        -organization UEFA
        -address '1 Chelsea Blvd'
        -city Fulham
        -zip 0U812
        -machine_country GB

The resulting output:

No feedback

An invocation example

chemail -primary 0441234567 -location 'room 256 floor 1'

The resulting output:

No feedback

An invocation example

chemail -country US -primary 8458765309

The resulting output:

No feedback