errpt, errpd
PURPOSE
Processes a report of logged errors.
SYNOPSIS
errpt [ [ flags [options] ] [ file ] ]
DESCRIPTION
The errpt command reads a specified error file or files,
processes the data, and writes a report of that data to
standard output. These error files should be named
file.0 or file.1, but do not include the .0 or .1 exten-
sion when you specify the file name argument. errpt adds
the extension. If you do not specify a file name, errpt
uses the file listed in /etc/rasconf, adding the .0 and
.1 extensions (these are usually /usr/adm/ras/errfile.0
and /usr/adm/ras/errfile.1). The default report is a
summary of all errors posted in the named file, as well
as system information events, such as time changes,
system starts, and so on.
The errpt command pipes error entries through the program
/usr/lib/errpd, which adds probable cause information to
certain entries. If no probable cause information is
added, errpt logs records exactly as it receives them.
FLAGS
-a Produces a detailed report. This contains
specific error information for every event
that errpt formats.
-d list Limits the report to certain types of error
records as defined by list. The list items
can either be separated by commas or
enclosed in double quotation marks and sep-
arated by commas or blanks. See "Error
Identifiers" for the valid list values.
-e date Includes all records posted earlier than
date, where date has the form MMddhhmmyy
(month, day, hour, minute and year).
-n node Includes only entries in the error report
from the specified nodename.
-s date Includes all records posted later than
date, where date has the form MMddhhmmyy.
-v vmid Includes only entries in the error report
from the system name specified with vmid.
ERROR IDENTIFIERS
In the following error identifiers, 0 acts as a wildcard
character, such that, for example, H00 gives you all
hardware errors (H11 to HFF), and H10 gives you all
errors from H11 to H1F, and so on.
1. Class
H00 = Hardware (01)
S00 = Software (02)
I00 = IPL/Shutdown (03)
G00 = General System Condition (04)
U00 = User Defined, Non-Hardware
2. Class/Subclass
H10 = Hardware/Processor and Memory Management
Card Machine Check
H11 = Hardware/Main Processor
H12 = Hardware/Main Memory
H20 = Hardware/Fixed Disk Drive and Adapter
H30 = Hardware/Diskette Drive and Adapter
H40 = Hardware/Tape and Adapter
H50 = Hardware/Display Station
H51 = Hardware/5080 Display Adapter
H52 = Hardware/APA16 Display Adapter
H60 = Hardware/Display Station Adapter
H70 = Hardware/Keyboard/Mouse
H80 = Hardware/Communication Adapters
H81 = Hardware/RS232 Multi-port
H84 = Hardware/Serial or Serial/Parallel
H85 = Hardware/IBM PC Network Adapter
H86 = Hardware/RS422 Multi-port
H87 = Hardware/Native Serial I/O
H8E = Hardware/SSLA
H90 = Hardware/Parallel Printer and Adapter
H91 = Hardware/Parallel or Serial/Parallel
H92 = Hardware/Parallel or PC Monochrome
HA0 = Hardware/Printers
HF0
.
HFF = User Defined Hardware
S10 = Software/Processor and Memory Management
Card Program Check
S20 = Software/Abend
S21 = Software/Abend dump taken
S22 = Software/Abend No dump taken
S30 = Software/Program Error AIX
S33 = Software/Program Error AIX Kernel
S40 = Software/Program Error AIX Device Driver
S42 = Software/5080 Display Device Driver
S50 = Software/Program Error AIX Device Driver
S60 = Software/Program Error VRM Base
S61 = Software/Program Error VRM Attach Device
S70 = Software/Program Base VRM Component
S72 = Software/Program Base VRM Component -
Virtual Terminal
S74 = Software/5080 Display VRM Device Driver
S75 = Software/5080 Peripherals VRM Device Driver
Manager
S80 = Software/Program Error Application
S80 = Software/Program Error Application - Error
Log Analysis
S80 = Software/Program Error Application - Inter-
active Workstation
S90 = Software/Program Error Application
SA0 = Software/Program Error Application
SB0 = Software/Program Error Application
SC0 = Software/Program Error Application
SD0 = Software/Program Error Application
SE0 = Software/Program Error Application
SF0 = Software/Program Error Application
I10 = IPL/Shutdown/Manual IPL
I20 = IPL/Shutdown/Soft IPL
I30 = IPL/Shutdown/Auto IPL
I40 = IPL/Shutdown/Shutdown
I50 = IPL/Shutdown/Maintenance Shutdown
G10 = General System Condition/Degraded Config
G20 = General System Condition/Set Date/ Time
G40 = General System Condition/Error Reporting
G50 = General System Condition/LPOST
G41 = General System Condition/Cause Codes
G42 = General System Condition/Device Information
G43 = General System Condition/Counters
G51 = General System Condition/Memory Test LPOST
U10
.
UFF = User Defined, Non-Hardware
errpd
The error log analysis program, /usr/lib/errpd, analyzes
the error log data. /usr/lib/errpd processes error data
to determine if the error is a hardware error and if the
error is a temporary or permanent error.
The analysis does the following:
o Generates a number that corresponds to a service
request number.
o Analyzes the data and generates the ALERT number.
o Makes the description message ID number. The
description consists of the following:
- Error Analysis determines, from the error data
passed, the nature of the operation at the time
of the failure. This becomes part of the error
description.
- Error Analysis determines what failed and what
the error indication is. This becomes part of
the error description and is used to create the
ALERT number.
- Field Replacement Unit (FRU) Analysis determines
the Service Request Code. This becomes part of
the error description.
FILES
/usr/adm/ras/errfile? Error file.
RELATED INFORMATION
The following command: "errdemon."
The errfile file in AIX Operating System Technical Refer-
ence.
AIX Operating System Programming Tools and Interfaces.