Commands Reference, Volume 2

errpt Command

Purpose

Generates a report of logged errors.

Syntax

To Process a Report from the Error Log

errpt [ -a ] [ -A ] [ -c ] [ -d ErrorClassList ] [ -D ] [ -e EndDate ] [ -g ] [ -i File ] [ -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 ] [ -P ] [ -R ResourceTypeList ] [ -S ResourceClassList ] [ -T ErrorTypeList ] [ -y File ] [ -z File ]

To Process a Report from the Error Record Template Repository

errpt [ -a ] [ -A ] [ -I File ] [ -t ] [ -d ErrorClassList ] [ -j ErrorID [ ,ErrorID ] ] | [ -k ErrorID [ ,ErrorID ] ] [ -J ErrorLabel [ ,ErrorLabel ] ] |
[ -K ErrorLabel [ ,ErrorLabel ] ] [ -F FlagList ] [ -P ] [ -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. When error log analysis is performed, however, diagnostics may add diagnostic information back into the error log. Such information is shown following the detailed data of the corresponding error log entry.

You can use the Devices application in Web-based System Manager (wsm) to change device characteristics. You could also use the System Management Interface Tool (SMIT) smit errpt fast path to run this command.

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.
-A	Displays a shortened version of the detailed report produced by the -a flag. The -A flag is not valid with the -a, -g, or -t flags. The items reported are the label, date and time, type, resource name, description, and detail data. The example output of this flag is in the following format: LABEL: STOK_RCVRY_EXIT Date/Time: Tue Dec 14 15:25:33 Type: TEMP Resource Name: tok0 Description PROBLEM RESOLVED Detail Data FILE NAME line: 273 file: stok_wdt.c SENSE DATA 0000 0000 0000 0000 0000 0000 DEVICE ADDRESS 0004 AC62 25F1
-c	Formats and displays each of the error 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 variable: H (hardware), S (software), 0 (errlogger command messages), and U (undetermined). The error records in the ErrorClassList variable can be separated by a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character.
-D	Consolidates duplicate errors. The detailed error report, obtained with the -a flag, reports the number, and first and last times of the duplicates. See Error Logging Overview in AIX 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs. Note: The -D flag is not valid with the -c, -g, -l, -t, and -P flags.
-e EndDate	Specifies all records posted prior to and including 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
-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 a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character. 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.
-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 a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character. When combined with the -t flag, entries are processed from the error-template repository. (Otherwise entries are processed from the error-log repository.)
-I File	Uses the diagnostic log file specified by File. If this flag is not specified, the default pathname, /var/adm/ras/diag_log, is used
-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 ErrorID[,ErrorID]	Excludes the error-log entries specified by the ErrorID variable. The ErrorID variables can be separated by a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character. 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).
-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 a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character.
-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.
-N ResourceNameList	Generates a report of resource names specified by the ResourceNameList variable. The ResourceNameList variable is a list of names of resources that have detected errors. For software errors, the ResourceNameList variable lists the names of resources that have detected errors. For hardware errors, it lists names of devices or system components. It does not indicate that the component is faulty or needs replacement. Instead, it is used to determine the appropriate diagnostic modules to be used to analyze the error. The names of the ResourceNameList variable can be separated by a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character.
-P	Shows only errors which are duplicates of the previous error. The -P flag applies only to duplicate errors generated by the error log device driver. These errors are duplicates that occurred within the approximate time interval specified by the errlg_duptime error logging attribute controlled by the errdemon daemon -t flag. The -P flag is invalid with the -D flag.
-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 items in the ResourceTypeList variable can be each separated by a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character.
-s StartDate	Specifies all records posted on and after the StartDate variable, where the StartDate variable has the format mmddhhmmyy (month, day, hour, minute, and year).
-S ResourceClassList	Generates a report of resource classes specified by the ResourceClassList variable. For hardware errors, the ResourceClassList variable is a device class. The resource classes must be each separated by a , (comma), or enclosed in " " (double quotation marks) and separated by a , (comma), or a space character.
-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.
-T ErrorTypeList	Limits the error report to error types specified by the valid ErrorTypeList variables: INFO, PEND, PERF, PERM, TEMP, and UNKN. The error types can be each separated by a , (comma), or enclosed in " " (double quotation marks) and separated by a , or a space character.
-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.)

Examples

To display a complete summary report, enter:
```
errpt
```

To display a complete detailed report, enter:
errpt -a

To display a detailed report of all errors logged for the error identifier E19E094F, enter:
errpt -a -j E19E094F

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.

To list error-record templates for which logging is turned off for any error-log entries, enter:
errpt -t -F log=0

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

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

To display a detailed report of all errors logged for the error label ERRLOG_ON, enter:
errpt -a -J ERRLOG_ON
To display a detailed report of all errors and group duplicate errors, enter:
```
errpt -aD
```

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 5L Version 5.2 General Programming Concepts: Writing and Debugging Programs

Examples of Detailed Error Reports, Example of a Summary Error Report in AIX 5L Version 5.2 General Programming Concepts.

For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.2 Web-based System Manager Administration Guide.