uerf(8) — Maintenance
Digital
NAME
uerf − Error report formatter
SYNOPSIS
/usr/sbin/uerf [ option ... ]
DESCRIPTION
The uerf command prints a record of system events. These events include error messages relating to the system hardware and the software kernel as well as information about system status, startup, and diagnostics.
FLAGS
-c classesSelects classes of events.
errReports all hardware- and software-detected errors.
maintReports any event that occurs during system maintenance, for example, running the on-line functional exercisers.
operReports information on system status, autoconfiguration messages, device status or error messages, time stamps, and system startup and shutdown messages.
-D disksSelects the disk device type (rz55 for example) or class (rz for example) about which to report errors. If you do not specify any parameters, all disk types are reported.
-f filenameOutputs error information from the specified file rather than the default errorlog file /usr/adm/binary.errlog. The filename and location of the default error log file is defined by the binary.err entry in the /etc/syslog.conf file. Use this option to look at old or backup errorlog files not in the default location. Specify the full path name for the file.
-hDisplays a brief help message. If you specify any other option with the −h option, it is ignored.
-H hostSelects errors for the system indicated. Use the −H option when errors from multiple remote systems ae being forwarded to the local host.
-M mainframe_errors
Selects mainframe error types. If you do not specify any parameters, all error types are reported.
cpuReports CPU-related errors such as machine checks.
memReports memory-related errors such as single-bit CRD (corrected read data) and double-bit uncorrectable errors.
-o output
Outputs errors in brief, full, or terse format. The default output is brief.
briefReports error information in a short format.
fullReports all available information for each entry.
terseReports error information and displays register values, but does not translate.
-O operating_system_events
Selects operating system events such as panics and exceptions and faults. If you do not specify any parameters, all operating system events are reported. Reports are as follows:
aefArithmetic exception faults
astAsynchronous trap exception faults
pagPage faults
pifPrivileged instruction faults
proProtection faults
ptfPage table faults
rafReserved address faults
rofReserved operand faults
scfSystem call exception faults
segSegmentation faults
-R reverse chronological order
Outputs selected error information in reverse chronological order.
-r recordsReports errors for the selected record codes. Valid codes are:
Hardware-Detected Errors
100Machine check
101Memory corrected read data/read data substitute (crd/rds)
102Disk errors
103Tape errors
104Device controller errors
105Adapter errors
106Bus errors
107Stray interrupts
108Asynchronous write errors
109Exceptions/faults
112Stack dump
130General Error and status registers
200Panics
201ci ppd info
202scs events
Informational ASCII Messages
250Informational
Operational Messages
300Start up
-s sequence_numbers
Reports errors for selected sequence numbers. When used by itself, this option will give all records with specified sequence numbers in the file.
−SProduces a summary report of selected events.
-t time_range
Selects errors for the specified time range. Without the −t option, the uerf command processes the errorlog file from beginning to end. A start date or time or an end date or time must be specified with the −t option. For partial entries, the default date is the current date, the default start time is 00:00:00, and the default end time is 23:59:59. The format is as follows:
uerf −t s:dd-mmm-yyyy,hh:mm:ss e:dd-mmm-yyyy,hh:mm:ss
Where:
sSpecifies the start date and time
eSpecifies the end date and time
ddDay
mmmMonth
yyyyYear
hhHour
mmMinute
ssSecond
-T tapesSelects the tape types (tz30, for example) or class (tz, for example) for which to report errors. If you do not specify any parameters, all tape types are reported.
-u unit number
Selects records by unit number. This option can be used with −D and/or −T option.
-xExcludes specified selection options from the report, whether they appear before or after the −x option. This option does not affect the −f, −h, −H, −o, −R, −t options.
-ZDisplays the entry in hex format.
RESTRICTIONS
The uerf command uses the data files uerf.bin, uerf.hlp, and uerf.err. The uerf.bin file is the event information data base, the uerf.hlp file is the help file, and the uerf.err file is the error message file. The uerf command expects to find the data files in the /usr/sbin directory.
By default the uerf command outputs the contents of the errorlog file specified by the binary.err entry in /etc/syslog.conf. To report on any other errorlog file errorlog file, you must use uerf with the −f option.
Do not specify any other option with the −h option.
Some hardware and system-related errors are logged as ASCII informational messages. Use the −r option with record type 250 to output these errors.
Additional error information is also logged by syslogd in the file specified by the kern.debug and syslog.debug entries in /etc/syslog.conf. These log files are plain ASCII text and do not require the use of uerf.
EXAMPLES
The following example produces a report containing all error events excluding logged operating system errors and operator and maintenance class errors:
uerf -O -x -c oper,maint
The following example produces an error report from the named file:
uerf -f /usr/adm/syslog/olderrorfile
The following examples show how to produce error reports for specific record codes:
uerf -r 100,102
uerf -r 100-109
The following examples show how to produce error reports using the −t option. This example lists all errors between 10:47 a.m. on April 13, 1986 and 5:30 p.m. on April 20, 1986.
uerf -t s:13-apr-1986,10:47:00 e:20-apr-1986,17:30:00
The following example produces an error report for all logged errors on the current day and year, which starts at 1:20 p.m. and ends at the current time.
uerf -t s:13:20
The next example produces an error report for all logged errors and displays it in reverse chronological order, starting with the current date and time.
uerf -R
FILES
/usr/adm/binary.errlog default errorlog file
/usr/sbin/uerf.err uerf error message file
/usr/sbin/uerf.hlp uerf help file
/usr/sbin/uerf.bin event information data base file