Sun Microsystems Logo
Products and Services
 
Support and Training
 
 

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W  X  Y  Z  
 
System Administrationtestemail(1m)


NAME

 testemail - Test the event-reporting features, which include event message logging and email notification of events.

SYNOPSIS

 testemail -c event_class_list -d domain_ID [-i resource_indictment_list]
 testemail -h

DESCRIPTION

 

testemail(1M) enables you to generate test events and verify that they are logged in the SMS platform message log file and reported by email to designated recipients. This command also enables you to verify any changes made to the email control file (event_email.cf), which identifies the recipients of the event email.

You specify the test events to be generated, the domain affected by the events, and optionally a list of components that are associated (indicted) with each event listed.

OPTIONS

 

The following options are supported:

-c event_class_list
A list of one or more fault event classes to be generated and reported by the test email, for example: fault.test.email

Use a comma to separate each event class listed. The valid fault classes are described in the file /etc/opt/SUNWSMS/SMS/config/SF15000.dict .

-d domain_id
Specifies the one-character ID of the domain affected by the specified event classes. Valid domain_ids are A-R and must be specified as upper-case characters.
-h
Help. Displays usage descriptions. Note – Use alone. Any option specified in addition to -h is ignored.
-i indictment_ resource_list
A list of one or more components that map to each event class specified. Use a comma to separate each component in the list. The components listed correspond to each fault event specified. However, for test purposes the components specified do not actually have to be faulty.

Valid component values are:

  • board (a system_board, io_board, expander_board, or centerplane_support_board)
  • system_board/port
  • io_board/port
  • system_board/port/physical bank/dimm
  • system_board/port/physical bank/dimm/logical_dimm
  • system_board/port/ecache
  • io_board/port/iobus
  • centerplane
  • centerplane support
  • bus (address bus, data bus, or response bus)
  • expander_board/cdcdimm0
  • expander_board/bus
  • system_controller
  • system_controller_peripheral
  • fan _tray
  • power_supply

where
system_board
SB(0...17) for Sun Fire 15K systems

SB(0...8) for Sun Fire 12K systems

io_board
IO(0...17) for Sun Fire 15K systems

IO(0...8) for Sun Fire 12K systems

expander_board
EX(0...17) for Sun Fire 15K systems

EX(0...8) for Sun Fire 12K systems

port or processors for system_boards
P(0...3)
physical bank
B(0|1)
dimm
D(0...3)
logical dimm
L(0|1)
io_bus
I(0|1)
ecache
E(0|1)
centerplane
CP(0|1)
centerplane support
CS(0|1)
bus
ABUS|DBUS|RBUS(0|1)
system_controller
SC(0|1)
system_controller_peripheral
SCPER(0|1)
fan tray
FT(0...7)
power supply
PS(0...5)

EXTENDED DESCRIPTION

 

Test Results

 

The results of the email test includes the following:

  • Event messages in the platform messages log that reflect the test fault with event code, with a text string that indicates the test should be ignored
  • Email that notifies designated recipients of the events generated

Group Privileges Required

 

You must have platform administrator or platform service privileges to run this command.

Refer to Chapter 2, "SMS Security Options and Administrative Privileges" in the System Management Services (SMS) 1.4 Administrator Guide for more information.

EXAMPLES

 Example 1. Generating Test Fault Events for Expander and I/O Boards
 
 
sc0:sms-user:> testemail -c fault.board.ex.l1l2, fault.board.io.l1l2 -dD -i EX7,IO8

EXIT STATUS

 

The following exit values are returned:

0
Successful completion.
>0
An error occurred.

FILES

 

The following files are used by this command:

/etc/opt/SUNWSMS/SMS/config/event_email.cf
Controls email notifications

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

Attribute TypesAttribute Values
AvailabilitySUNWSMSop

SEE ALSO

 

erd(1m)


SMS 1.4Go To TopLast Changed 19 September 2003