errpt Command

Purpose

Generates a report of logged errors.

Syntax

To Process a Report from the Error Log

errpt [ -@ wpar_name ] [  -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 System Management Interface Tool (SMIT) smit errpt fast path to run this command.

Flags

-@wpar_name
Selects the error entries for the specified WPAR name.
-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 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.
-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 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.)
-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.)

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.
To run the errpt command, you must have the following additional authorizations, if errpt restriction is enabled in the errdemon command:
aix.ras.error.errpt
Required to run the errpt command.
Note: By default, the root and system group users are privileged users.

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
  9. To display a detailed report of all errors and group duplicate errors, enter: 
    errpt -aD
  10. To display a detailed report of all errors logged for the error labels DISK_ERR1 and DISK_ERR2 during the month of August, enter: 
    errpt -a -J DISK_ERR1,DISK_ERR2 -s 0801000004 -e 0831235904"

Files

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