IBM RS/6000 SP, Problem Determination Manual

Page: 181 / 316

This soft copy for use by IBM employees only.
recommended actions. Collectively, the templates
comprise the Error Record Template Repository.
6.1.2 Error Logging Commands
errclear Deletes entries from the error log. This command can
erase the entire error log. Removes entries with
specified error ID numbers, classes, or types.
errdead Extracts errors in the /dev/error buffer captured in the
system dump. The system dump will contain error
records if errdemon was not active prior to the dump.
errdemon Reads error records from /dev/error and writes error
log entries to the system error log. The errdemon
also performs error notification as specified in the
notification objects in the ODM. The daemon is
started automatically during system initialization.
errinstall Can be used to add or replace messages in the error
message catalog. Provided for use by software
installation procedures. The system creates a backup
f i l e c a l l e d < f i l e > . u n d o . The .undo file allows you to
cancel the changes you made by issuing the
errinstall
command.
errlogger Writes an operator message entry to the error log.
errmsg Implements error logging in applications. The
errmsg
command will list, add or delete messages stored in
the error message catalog. With this command you
can add text to the
Error Description, Probable Cause,
User Cause, Failure Cause, Recommended Action
, and
Detailed Data message sets.
errpt Generates an error report from entries in the system
error log. The report can be formatted to give a single
line for each entry, or as a detailed listing.
errstop Stops errdemon, which is initiated during system
initialization. Running the
errstop
command also
disables some diagnostic and recovery functions of
the system.
errupdate Adds or deletes templates in the Error Record
Template Repository. Modifies the Alert log and
Report attributes of an error template. Provided for
use by software installation procedures.
6.1.3 Error Log Files
/dev/error Provides standard device driver interfaces
required by the error log component.
/dev/errorctl Provides non-standard device-driver
interfaces for controlling the error logging
system.
/usr/include/sys/err_rec.h Contains structures defined as arguments to
the errsave kernel services and the errlog
subroutine.
Chapter 6. E r r o r Logging
161