IBM RS/6000 SP, Problem Determination Manual

Page: 201 / 316

This soft copy for use by IBM employees only.
TRUE Matches alertable errors.
FALSE Matches non-alertable errors.
en_resource Identifies the name of the failing resource. For the
hardware error class, a valid resource name is the device
name.
en_rtype Identifies the type of the failing resource. For the
hardware error class, a valid resource type is the device
type a resource is known by in the devices object.
en_rclass Identifies the class of the failing resource. For the
hardware error class, a valid resource class is the device
class. The resource error class is
not applicable for the
software error class.
en_method Specifies a shell script or command string to be run when
an error matching the selection criteria of this error
notification object is logged. The notification uses the
sh
-c
command to execute the notify method. The following
key words are automatically expanded by the error
notification daemon as arguments to the notify method:
$1 The sequence number from the error log entry
$2 The error ID from the error log entry
$3 The error class from the error log entry
$4 The error type from the error log entry
$5 The alert flags from the error log entry
$6 The resource name from the error log entry
$7 The resource type from the error log entry
$8 The resource class from the error log entry
$9 The error label from the error log entry
Use the en_persistenceflg to avoid erroneous signaling. Those notification
objects containing methods which send a signal to another process should
especially
not persist across system restart. This is because the receiving
process and its process ID do not persist across system restarts. The creator of
the error notification object is responsible for removing the error notification
object at the appropriate time. In the event that the process terminates and fails
to remove the error notification object, the en_persistenceflg descriptor ensures
that obsolete error notification objects are removed when the system restarts.
6.3.3 Adding an Error Notification Object
The following example shows how to mail the error report to
root@controlworkstation when a switch adapter fails the online diagnostics.
Adding the
dsh -a
command to the ODM commands will perform the action on
all nodes of the RS/6000 SP.
1. Set up the directories for the error notification objects and methods:
mkdir /<define_path>/errnotify/objects
mkdir /<define_path>/errnotify/methods
2. Create the error notification method script.
Create the script that will be run when the error occurs. For example:
Chapter 6. E r r o r Logging
181