Generates a report of logged errors.
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 ]
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.
Item | Description |
---|---|
-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:
|
-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® Version 7.1 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:
|
|
|
-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:
|
-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.) |
errpt
errpt -a
errpt -i /var/adm/ras/errlog.alternate
errpt -i /var/adm/ras/errlog.alternate -d H
errpt -aD
errpt -a -J DISK_ERR1,DISK_ERR2 -s 0801000004 -e 0831235904"
Item | Description |
---|---|
/etc/objrepos/SWservAt | Contains the software service aids attributes object class; that is, the error log configuration database. |