errpt

errpt Command



Purpose

Generates a report of logged errors.

Syntax



To Process a Report from the Error Log

errpt [ -a ] [ -c ] [ -d ErrorClassList ] [ -e EndDate ] 
[ -g ] [ -i File ] [ -j ErrorID [ ,ErrorID ] ] | [ -k ErrorID
[ ,ErrorID ] ] [ -J ErrorLabel [ ,ErrorLabel ] ] | [ -K ErrorLabel
[ ,ErrorLabel ] ] [ -l SequenceNumber ] [ -m Machine ] [ -n
Node ] [ -s StartDate ] [ -F FlagList ] [ -N ResourceNameList
] [ -R ResourceTypeList ] [ -S ResourceClassList ] [ -T ErrorTypeList
] [ -y File ] [ -z File ]

To Process a Report from the Error Record Template Repository

errpt [-a ] [ -t ] [ -d ErrorClassList ] [ -j ErrorID [ ,ErrorID
] ] | [ -k ErrorID [ ,ErrorID ] ] [ -J ErrorLabel [ ,ErrorLabel
] ] | [ -K ErrorLabel [ ,ErrorLabel ] ] [ -F FlagList ] 
[ -T ErrorTypeList ] [ -y File ] [ -z File ]

Description

The errpt command generates an error report from entries in an error
log. It includes flags for selecting errors that match specific criteria.
By using the default condition, you can display error log entries
in the reverse order they occurred and were recorded. By using the
- c (concurrent) flag, you can display errors as they occur. If the
-i flag is not used with the errpt command, the error log file processed
by errpt is the one specified in the error log configuration database.
(To view the information in the error log configuration database,
use the errdemon command.)

The default summary report contains one line of data for each error.
You can use flags to generate reports with different formats.

Note:	The errpt command does not perform error log analysis; for analysis,
use the diag command.

You can use the System Management Interface Tool (SMIT) fast path
to run the errpt command. To use the SMIT fast path, enter:

smit errpt

Flags

-a	Displays information about errors in the error log file in detailed
format. If used in conjunction with the - t flag, all the information
from the template file is displayed.

-c	Formats and displays each of the rror entries concurrently, that
is, at the time they are logged. The existing entries in the log file
are displayed in the order in which they were logged. 

-d ErrorClassList	Limits the error report to certain types of error
records specified by the valid ErrorClassList variables: H (hardware),
S (software), 0 (errlogger command messages), and U (undetermined).
The ErrorClassList variable can be separated by , (commas), or enclosed
in "" (double quotation marks) and separated by , (commas) or space
characters.

-e EndDate	Specifies all records posted before the EndDate variable,
where the EndDate variable has the form mmddhhmmyy (month, day, hour,
minute, and year).

-g	Displays the ASCII representation of unformatted error-log entries.
The output of this flag is in the following format:

el_sequence	Error-log stamp number

el_label	Error label

el_timestamp	Error-log entry time stamp

el_crcid	Unique cyclic-redundancy-check (CRC) error identifier

el_machineid	Machine ID variable

el_nodeid	Node ID variable

el_class	Error class

el_type	Error type

el_resource	Resource name

el_rclass	Resource class

el_rtype	Resource type

el_vpd_ibm	IBM vital product data (VPD)

el_vpd_user	User VPD

el_in	Location code of a device

el_connwhere	Hardware-connection ID (location on a specific device,
such as slot number)

et_label	Error label

et_class	Error class

et_type	Error type

et_desc	Error description

et_probcauses	Probable causes

et_usercauses	User causes

et_useraction	User actions

et_instcauses	Installation causes

et_instaction	Installation actions

et_failcauses	Failure causes

et_failaction	Failure actions

et_detail_length	Detail-data field length

et_detail_descid	Detail-data identifiers

et_detail_encode	Description of detail-data input format

et_logflg	Log flag

et_alertflg	Alertable error flag

et_reportflg	Error report flag

el_detail_length	Detail-data input length

el_detail_data	Detail-data input

-i File	Uses the error log file specified by the File variable. If
this flag is not specified, the value from the error log configuration
database is used.

-j ErrorID[,ErrorID]	Includes only the error-log entries specified
by the ErrorID (error identifier) variable. The ErrorID variables
can be separated by , (commas), or enclosed in "" (double quotation
marks) and separated by , (commas) or space characters. When combined
with the -t flag, entries are processed from the error-template repository.
(Otherwise entries are processed from the error-log repository.)

-k ErrorID[,ErrorID]	Excludes the error-log entries specified by
the ErrorID variable. The ErrorID variables can be separated by ,
(commas), or enclosed in "" (double quotation marks) and separated
by , (commas) or space characters. When combined with the -t flag,
entries are processed from the error-template repository. (Otherwise
entries are processed from the error-log repository.)

-l SequenceNumber	Selects a unique error-log entry specified by the
SequenceNumber variable. This flag is used by methods in the error-notification
object class. The SequenceNumber variable can be separated by , (commas),
or enclosed in "" (double quotation marks) and separated by , (commas)
or space characters.

-m Machine	Includes error-log entries for the specified Machine variable.
The uname -m command returns the Machine variable value.

-n Node	Includes error-log entries for the specified Node variable.
The uname -n command returns the Node variable value.

-s StartDate	Specifies all records posted after the StartDate variable,
where the StartDate variable has the form mmddhhmmyy (month, day,
hour, minute, and year).

-t	Processes the error-record template repository instead of the error
log. The -t flag can be used to view error-record templates in report
form.

-y File	Uses the error record template file specified by the File
variable. When combined with the -t flag, entries are processed from
the specified error template repository. (Otherwise, entries are processed
from the error log repository, using the specified error template
repository.)

-z File	Uses the error logging message catalog specified by the File
variable. When combined with the -t flag, entries are processed from
the error template repository. (Otherwise, entries are processed from
the error log repository.)

-F FlagList	Selects error-record templates according to the value
of the Alert, Log, or Report field of the template. The FlagList variable
can be separated by , (commas), or enclosed in "" (double quotation
marks) and separated by , (commas) or space characters. The -F flag
is used with the -t flag only.

Valid values of the FlagList variable include:

alert=0	Selects error-record templates with the Alert field set to
False.

alert=1	Selects error-record templates with the Alert field set to
True.

log=0	Selects error-record templates with the Log field set to False.

log=1	Selects error-record templates with the Log field set to True.

report=0	Selects error-record templates with the Report field set
to False.

report=1	Selects error-record templates with the Report field set
to True.

-J ErrorLabel	Includes the error log entries specified by the ErrorLabel
variable. The ErrorLabel variable values can be separated by commas
or enclosed in double-quotation marks and separated by commas or blanks.
When combined with the -t flag, entries are processed from the error
template repository. (Otherwise, entries are processed from the error
log repository.)

-K ErrorLabel	Excludes the error log entries specified by the ErrorLabel
variable. The ErrorLabel variable values can be separated by commas
or enclosed in double-quotation marks and separated by commas or blanks.
When combined with the -t flag, entries are processed from the error
template repository. (Otherwise, entries are processed from the error
log repository). 

-N ResourceNameList	Generates a report of resource names specified
by the ResourceNameList variable. For hardware errors, the ResourceNameList
variable is a device name; for software errors it is the name of the
failing executable. The ResourceNameList variable can be separated
by , (commas), or enclosed in "" (double quotation marks) and separated
by , (commas) or space characters.

-R ResourceTypeList	Generates a report of resource types specified
by the ResourceTypeList variable; for hardware errors the ResourceTypeList
variable is a device type; for software errors it is the LPP value.
The ResourceTypeList variable can be separated by , (commas), or enclosed
in "" (double quotation marks) and separated by , (commas) or space
characters.

-S ResourceClassList	Generates a report of resource classes specified
by the ResourceClassList variable. For hardware errors, the ResourceClassList
variable is a device class. The ResourceClassList variable can be
separated by , (commas), or enclosed in "" (double quotation marks)
and separated by , (commas) or space characters.

-T ErrorTypeList	Limits the error report to error types specified
by the valid ErrorTypeList variables: INFO, PEND, PERF, PERM, TEMP,
and UNKN. The ErrorTypeList variable can be separated by , (commas),
or enclosed in "" (double quotation marks) and separated by , (commas)
or space characters.

Examples

1.	To display a complete summary report, enter:

errpt

2.	To display a complete detailed report, enter: 

errpt -a

3.	To display a detailed report of all errors logged for the error
identifier E19E094F, enter:

errpt -a -j E19E094F

4.	To display a detailed report of all errors logged in the past 24
hours, enter:

errpt -a -s mmddhhmmyy

where the mmddhhmmyy string equals the current month, day, hour, minute,
and year, minus 24 hours.

5.	To list error-record templates for which logging is turned off
for any error-log entries, enter:

errpt -t -F log=0

6.	To view all entries from the alternate error-log file /var/adm/ras/errlog.alternate,
enter:

errpt -i /var/adm/ras/errlog.alternate

7.	To view all hardware entries from the alternate error-log file
/var/adm/ras/errlog.alternate, enter:

errpt -i /var/adm/ras/errlog.alternate -d H

8.	To display a detailed report of all errors logged for the error
label ERRLOG_ON, enter:

errpt -a -J ERRLOG_ON

Files

/etc/objrepos/SWservAt	Contains the software service aids attributes
object class; that is, the error log configuration database.

Related Information

The diag command, errclear command, errinstall command, errupdate
command, uname command.

The errsave kernel service.

The errlog subroutine.

Error Logging Overview in AIX Version 4 Problem Solving Guide and
Reference.

Examples of Detailed Error Reports, Example of a Summary Error Report
in AIX Version 4 Problem Solving Guide and Reference.