Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

uerf(8) [ultrix man page]

uerf(8) 						      System Manager's Manual							   uerf(8)

Name
       uerf - ULTRIX error report formatter

Syntax
       /etc/uerf [ option ... ]

Description
       The  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.

		     aie    Reports errors for BVP-type controller.

		     aio    Reports errors for BVP-type controller.

		     bla    Reports errors for the BI LESI adapter.

		     bua    Reports errors for the BI UNIBUS adapter.

		     nmi    Reports errors for the Nautilus memory interconnect.

		     uba    Reports errors for the VAX UNIBUS adapter.

       -c classes  Selects classes of events.

		     err    Reports all hardware- and software-detected errors.

		     maint  Reports any event that occurs during system maintenance, for example, running the on-line functional exercisers.

		     oper   Reports information on system status, autoconfiguration messages, device status or error messages,	time  stamps,  and
			    system startup and shutdown messages.

       -D disks    Selects  the  mscp  or scsi disk device type, for example, ra60 or rx23, or class, for example, ra or rx, about which to report
		   errors.  If you do not specify any parameters, all disk types are reported.	See for a list of supported

       -f filename Outputs error information from the specified file rather than the default errorlog file /usr/adm/syserr/syserr.hostname.  Host-
		   name  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 sin-
		   gle 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.

		     cpu    Reports CPU-related errors such as machine checks.

		     mem    Reports 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.

		     brief  Reports error information in a short format.

		     full   Reports all available information for each entry.

		     terse  Reports 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. Reports are as follows:
		     aef    Arithmetic exception faults
		     ast    Asynchronous trap exception faults
		     bpt    Breakpoint instruction faults
		     cmp    Compatibility mode faults
		     pag    Page faults
		     pif    Privileged instruction faults
		     pro    Protection faults
		     ptf    Page table faults
		     raf    Reserved address faults
		     rof    Reserved operand faults
		     scf    System call exception faults
		     seg    Segmentation faults
		     tra    Trace exception faults
		     xfc    Reports 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

		     100   Machine check
		     101   Memory corrected read data/read data substitute (crd/rds)
		     102   Disk errors
		     103   Tape errors
		     104   Device controller errors
		     105   Adapter errors
		     106   Bus errors
		     107   Stray interrupts
		     108   Asynchronous write errors
		     109   Exceptions/faults
		     110   8800 EMM exceptions/faults
		     111   Console timeouts
		     112   Stack dump
		     113   ka650 error and status
		     114   6200 vector 60
		     115   6200 vector 54
		     116   ka420 error and status registers
		     117   ka3100 error and status registers
		     118   6400 vector 60
		     119   6400 vector 54
		     120   ka60 mbus error
		     121   ka60 error and status registers
		     130   General Error and status registers
		     131   General Interrupt 60 errors
		     132   General Interrupt 54 errors
		     133   v9000 syndrome error
		     134   v9000 Keep Alive Failure
		     135   v9000 clock error entry
		     136   v9000 scan entry
		     137   v9000 configuration entry
		     138   Vector Entry
		     200   Panics (bug checks)
		     201   ci ppd info
		     202   scs events

		     Informational ASCII Messages

		     250   Informational
		     251   8600/8650 snapshot taken

		     Operational Messages

		     300   Start up
		     301   Shutdown
		     310   Time change
		     350   Diagnostic information
		     351   Repair 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.

       -S	   Produces a summary report of selected events.

       -t time_range
		   Selects  errors for the specified time range.  Without the -t option, the 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:
		     s	    Specifies the start date and time
		     e	    Specifies the end date and time
		     dd     Day
		     mmm    Month
		     yyyy   Year
		     hh     Hour
		     mm     Minute
		     ss     Second

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

       -u unit number
		   Selects records by unit number. This option can be used with -D and/or -T option.

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

       -Z	   Displays the entry in hex format.

Restrictions
       The  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 command searches for the data files as follows:

	    1.	If is invoked with a full pathname, the first checks that directory for the data files.

	    2.	Then the directory is checked.

	    3.	And finally, directories specified in the Shell PATH environment variable are checked.

       The command outputs the contents of the errorlog file in the directory specified in To report on any other errorlog file, such as the  sin-
       gle-user errorlog file, you must use 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 communi-
       cation device errors.  Use the -r option with record type 250 to output these errors.

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 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
       multiuser default errorlog file

       uerf error message file

       /etc/uerf.hlp			    uerf help file

       event information data base file

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

																	   uerf(8)
Man Page