1 :Info: fim_meters:  2021-10-28  fim_meters
  2 
  3 Syntax as a command: fim_meters {FAULT_NAME} {-control_args}
  4 
  5 
  6 Function: Prints the per-system count of faults by fault type. This
  7 data is accumulated in wired_hardcore_data by ring-0 fault processing
  8 (fim, wired_fim, and page_fault).
  9 
 10 
 11 Arguments:
 12 FAULT_NAME
 13    is either a long or short name for a fault. See "List of fault
 14    names" for a list of acceptable values. If this argument is not
 15    provided, fim_meters reports on all faults.
 16 
 17 
 18 Control arguments:
 19 -report
 20    Causes a meter report to be generated and printed to the console
 21    (default).
 22 -reset, -rs
 23    Reset the meters so the next report reflects meters from the time
 24    reset.
 25 -report_reset, -rr
 26    Generates a report and then resets the meters.
 27 -long, -lg
 28    Includes sub-faults as well as primary faults.
 29 -total, -tt
 30    Provides totals of primary faults only (default).
 31 
 32 
 33 -sort KIND
 34    Sorts the output by the fault number (ordinal number of fault as
 35    defined by the hardware) or by the number of times the fault has
 36    been signalled. KIND can be either "number" or "count". This
 37    control argument is incompatible with -cpu.
 38 -cpu {CPU_TAGs}
 39    where CPU_TAG gives the letter identifier for a CPU whose meters
 40    are to be displayed. If no CPU_TAGs are given, meters for all CPUs
 41    are displayed. This control argument is incompatible with -sort.
 42 
 43 
 44 List of fault names:
 45    The following fault names are supported. Note that some faults have
 46    long and short names. Others only have a single name. The short
 47    name, if any, follows the long name for the fault.
 48 
 49 shutdown, sdf
 50 store, str
 51 mme1, mme
 52 fault_tag_1, ft1
 53 timer_runout, tro
 54 command, cmd
 55 derail, drl
 56 lockup, luf
 57 connect, con
 58 
 59 
 60 parity, par
 61 illegal_procedure, ipr
 62 op_not_complete, onc
 63 startup, suf
 64 overflow, ovf
 65 divide_check, div
 66 execute, exf
 67 segment_fault, df0
 68 page_fault, df1
 69 directed_fault_2, df2
 70 directed_fault_3, df3
 71 access_violation, acv
 72 linkage_fault, ft2
 73 fault_tag_3, ft3
 74 
 75 
 76 trouble, trb
 77 illegal_opcode
 78 null_pointer
 79 illegal_modifier
 80 illegal_ring_order
 81 not_in_execute_bracket
 82 no_execute_permission
 83 not_in_read_bracket
 84 no_read_permission
 85 not_in_write_bracket
 86 no_write_permission
 87 not_a_gate
 88 not_in_call_bracket
 89 outward_call
 90 
 91 
 92 bad_outward_call
 93 inward_return
 94 cross_ring_transfer
 95 ring_alarm_fault
 96 am_fault
 97 out_of_bounds
 98 fixedoverflow
 99 overflow
100 underflow
101 stringsize
102 illegal_procedure
103 stack_out_of_bounds
104 packed_pointer_fault
105 lot_fault
106 isot_fault
107 
108 
109 system_packed_pointer
110 size
111 neti
112 sus_
113 trm_
114 wkp_
115 undefined_pointer
116 
117 
118 Examples:
119 Typical output from this command with no arguments follows:
120 
121 Total Metering Time:           362:02:19
122 
123 Fault Type                  Total Fault Count
124 timer_runout                         20973050
125 connect                              13305077
126 illegal_procedure                           9
127 overflow                                    1
128 segment_fault                          127201
129 page_fault                             260845
130 access_violation                       187563
131 linkage_fault                           98447
132 
133 
134 :hcom:
135 /****^  HISTORY COMMENTS:
136   1) change(2021-11-06,Swenson), approve(2021-11-06,MCR10100),
137      audit(2021-11-07,GDixon), install(2021-11-07,MR12.8-1007):
138      Created info segment for this program.
139                                                    END HISTORY COMMENTS */