ShowTmr is a utility that can help explore potential                    
problems with the system "timers" table.                                
                                                                        
It should run on MPE/iX 4.0 through at least MPE/iX 7.5                 
                                                                        
Commands:                                                               
                                                                        
Exit              (or: //)                                              
                                                                        
Help              (or: ?)                                               
                                                                        
SET/RESET [<DEBUG1 | PAGING | SHOWHEX | SHOWLINKS>]                     
                                                                        
SHOWtimers [ <ALL | Badport | SHOWBAD | SHOWDIF | SHOWHEX>]             
                                                                        
   Reports the overall distribution of timers (e.g., number free,       
   number in use), and optionally displays some or all timers.          
                                                                        
   By default, SHOWTIMERs displays only a summary.  The ALL and         
   SHOWBAD options will report more information.                        
                                                                        
   ALL tells SHOWTIMERS to display information about all timers.        
                                                                        
   SHOWBAD displays information about all timers that are "bad"         
   in any way.  (There are three kinds of "bad":  in-use timer          
   with a bad port#, in-use timer with a 0 port #, and free timer       
   with a non-0 port #.)                                                
                                                                        
   BADPORT tells SHOWTIMERS to restrict any "SHOW"s to just the         
   timers that appear to be associated with a bad port.                 
                                                                        
   A "bad port" timer is one whose TE_REPLY_PORT appears to be          
   invalid.  (get_port_addr is used to map a port number to a           
   port record address ... if that routine returns NIL, then the        
   port number is bad.)                                                 
                                                                        
   SHOWHEX causes any reported timers to be displayed in hex as         
   well as in an interpreted manner.  Note: the first three words       
   (TE_FORWARD_LINK, TE_BACKWARD_LINK, and TE_WHEEL_LINK) are not       
   displayed unless you do:  SET SHOWLINKS                              
                                                                        
   In "SHOW ALL", if any value has changed since the last time,         
   it will be displayed in inverse video.                               
                                                                        
WATCH      [ <ALL | ANY | DUMPdif | SHOWHEX> ]                          
                                                                        
                                                                        
Since MPE/iX 4.0 a timer entry has looked like the following:           
                                                                        
TIMER_ENTRY_REC =                                                       
   RECORD                                                               
   TE_FORWARD_LINK      : TIMER_ENTRY_PTR ($0.0 @ 4.0);                 
   TE_BACKWARD_LINK     : TIMER_ENTRY_PTR ($4.0 @ 4.0);                 
   TE_WHEEL_LINK        : TIMER_ENTRY_PTR ($8.0 @ 4.0);                 
   TE_STATE             : INTEGER ($c.0 @ 4.0);                         
   TE_DEALLOCATE_ENTRY  : BOOLEAN ($10.0 @ 1.0);                        
   TE_START_NEW_TIMEOUT : BOOLEAN ($11.0 @ 1.0);                        
   TE_FREE_ENTRY        : SHORTINT ($12.0 @ 2.0);                       
   TE_ENTRY_NUM         : INTEGER ($14.0 @ 4.0);                        
   TE_HEARTBEAT_OFFSET  : INTEGER ($18.0 @ 4.0);                        
   TE_REPLY_PORT_NUM    : INTEGER ($1c.0 @ 4.0);                        
   TE_REPLY_SUBQUEUE    : SUBRANGE_32 ($20.0 @ 1.0);                    
   TE_REPLY_MSG         : TIMER_REPLY_ARRAY ($24.0 @ 10.0);             
   TE_REPLY_LENGTH      : INTEGER ($34.0 @ 4.0);                        
   END ($0.0 @ 38.0)                                                    

ShowTmr 20150128