[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
Commands Reference, Volume 2

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 Web-based System Manager Devices application (wsm devices fast path) to run this command. 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.
-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 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
-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 on and 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. The ResourceNameList variable is a list of names of resources that have detected errors. For software errors, these are the names of resources that have detected errors. For hardware errors, these are 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 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.3 Problem Solving Guide and Reference.

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

Setting up and running Web-based System Manager in AIX Version 4.3 System Management Guide: Operating System and Devices.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]