1 03/26/85 display_cpu_error
 2 
 3 Syntax as a command:  display_cpu_error {-control_args}
 4 
 5 
 6 Function:  scans the syserr log and displays machine conditions and
 7 history registers.
 8 
 9 
10 Control arguments:
11 -from DT, -fm DT
12    starts scanning the log at the date/time given.
13 -to DT
14    stops scanning the log at the date/time given.
15 -for T
16    computes the ending time from the starting time, where T is a
17    relative time (such as "1hour").
18 -cpu CPU_LIST
19    displays information for the CPUs specified, where CPU_LIST is a
20    list of CPU tags (e.g., "a c").
21 -nothread
22    specifies that the history registers are not to be threaded.  The
23    history registers will be output in octal with no interpretation.
24    The default is off.
25 
26 
27 -expand, -exp
28    specifies that the history registers are not to be threaded but that
29    they are to be interpreted.
30 -match STR...STRn
31    matches strings against messages in the log, where STR is a text
32    string.  Messages are defined to contain process or machine
33    condition information.  Any message that contains a STRi is
34    displayed.
35 -exclude STR1...STRn, -ex STR1...STRn
36    matches strings against messages in the log as -match, where STR is
37    a text string.  Any message that contains a STRi is NOT displayed.
38 -all
39    specifies that all log entries that are defined to contain processor
40    machine information can be displayed.
41 
42 
43 Access required:  Read permission is required on the log segments
44 themselves and status permission is required on their containing
45 directories.
46 
47 
48 Notes:  If -from DT is not given, the scan starts with the earliest
49 entry in the syserr log.  The ending time can be specified by using
50 -for or -to, but not both.  If both are omitted, the scan terminates
51 with the last entry in the log.  All dates and times must be in a
52 format acceptable to the convert_date_to_binary_ subroutine described
53 in the Multics Subroutines and I/O Modules manual, Order No.  AG93.
54 
55 Unless the control arguments -all, -match, or -exclude are specified,
56 only hardware_fault entries will be processed.