NAME

uerf − ULTRIX error report formatter

SYNTAX

/etc/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.

OPTIONS

−A adapter ...
Selects adapter and device controller errors. All adapter error types are selected if none is specified.

aieReports errors for BVP-type controller. 

aioReports errors for BVP-type controller. 

blaReports errors for the BI LESI adapter. 

buaReports errors for the BI UNIBUS adapter. 

nmiReports errors for the Nautilus memory interconnect. 

ubaReports errors for the VAX UNIBUS adapter. 

−c classes Selects classes of events. 

errReports all hardware- and software-detected error conditions. 

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 disks Selects the mscp disk device type, for example, ra60, or class, for example, ra, about which to report errors.  If you do not specify any parameters, all disk types are reported.  See ra() for a list of supported mscp disk devices.

−f filename Outputs error information from the specified file rather than the default errorlog file /usr/adm/syserr/syserr.hostname.  Hostname is the name of the local system.  Use this option to look at old or backup errorlog files not in the default location /usr/adm/syserr.  You can also use this option to access the default single-user errorlog file /syserr.hostname.  Specify the full path name for the file.  Do not use the −n option with this option. 

−h Displays a brief help message.  If you specify any other option with the −h option, it is ignored. 

−H host Selects errors for the system indicated.  Use the −H option when you are logging errors from multiple remote systems to a single errorlog file on 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. 

−n Displays errors as they occur in real time before logging them in the errorlog file.  This option is useful in monitoring errors while a disk or tape exerciser is run.  You cannot use this option with the −f option. 

−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 ULTRIX operating system events are reported.

aefReports arithmetic exception faults

astReports asynchronous trap exception faults

bptReports breakpoint instruction faults

cmpReports compatibility mode faults

pagReports page faults

pifReports privileged instruction faults

proReports protection faults

ptfReports page table faults

rafReports reserved address faults

rofReports reserved operand faults

scfReports system call exception faults

segReports segmentation faults

traReports trace exception faults

xfcReports xfc instruction faults

−R reverse chronological order
Outputs selected error information in reverse chronological order.

−r records Reports 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
113ka650 error and status
Software Detected Errors
200panics (bug checks)
Informational ASCII Messages
250informational
2518600/8650 snapshot taken
Operational Messages
300start up
301shutdown
310time change
350diagnostic information

−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.

−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, default date is current date, default start time is 00:00:00, and default end time is 23:59:59.  The format is: uerf −t s:dd-mmm-yyyy,hh:mm:ss e:dd-mmm-yyyy,hh:mm:ss

sSpecifies the start date and time

eSpecifies the end date and time

ddday

mmmmonth

yyyyyear

hhhour

mmminute

sssecond

−T tapes Selects the tmscp tape types, for example, tk50, or class, for example, tk, for which to report errors.  If you do not specify any parameters, all tape types are reported.  See tms() for a list of supported tmscp tape types.

−x Excludes specified selection options from the report, whether they appear before or after the option.  This option does not affect the −f, −h, −H, −n, −o, −R, −t options. 

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 searches for the uerf data files as follows: If uerf is invoked with a full pathname, the uerf first checks that directory for the uerf data files. The /etc directory. Directories specified in the shell PATH environment variable.

The uerf command outputs the contents of the errorlog file in the directory specified in /etc/elcsd.conf. To report on any other errorlog file, such as the single-user errorlog file, you must use uerf with the −f option. 

Do not specify any other option with the −h option. 

You cannot use the −n option and the −f option together. 

Some hardware and system-related errors are logged as ASCII informational messages; for example, MASSBUS device errors and UNIBUS communication device errors.  To output these errors, use the −r option with record type 250. 

EXAMPLES

The following example produces a report containing all uba and nmi errors:

uerf −A uba,nmi

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 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.  The first example below lists all errors between 10:47 a.m. on April 13, 1986 and 5:30 p.m. on April 20, 1986.  The second example below 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-apr-1986,10:47:00 e:20-apr-1986,17:30:00
 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/syserr/syserr.system namemultiuser default errorlog file
/etc/uerf.erruerf error message file
/etc/uerf.hlpuerf help file
/etc/uerf.binevent information data base file

SEE ALSO

elcsd.conf(5), elcsd(8), eli(8)
Guide to the Error Logger System