UPTIME 20030422                                                         
Copyright (c) 1996  Allegro Consultants, Inc.                           
Author: sieler@allegrosupport.com                                              
                                                                        
UPTIME reports how long the system has been up, and                     
the last five bootup commands.                                          
                                                                        
The default mode of running is to assume that you want the most         
information available:                                                  
                                                                        
   MPE/iX 6.0; System started @ 15:04 on 2000-01-20                     
    3:04pm  up 0 days,  0:00   6 users                                  
                                                                        
   Boot history:                                                        
                                                                        
  T  Date          Time     Group     Command                           
  -  ---------------------  --------  ----------------                  
     1999-12-02 @ 10:13 AM  CONFIG    START NORECOVERY                  
     1999-10-29 @ 10:28 AM  CONFIG    start norecovery                  
                                                                        
  T  1998-12-14 @  2:09 PM            install                           
  T  1999-09-16 @  2:15 PM            update                            
                                                                        
     1999-12-02 @ 10:08 AM            dump                              
                                                                        
(The above is discussed later in this help.)                            
                                                                        
The "MPE-style uptime" reports the operating system version and         
the actual startup time and date.                                       
                                                                        
The "MPE-style bootinfo" reports the four most recent system            
startup commands (with date and time).                                  
                                                                        
The "Unix-style uptime" reports the current time, how long the          
system has been up (days, hours:minutes), and the number of users       
currently logged on (HPUSERCOUNT).                                      
                                                                        
UPTIME accepts options via the INFO string (with "-" being              
optional):                                                              
                                                                        
   -BOOTINFO  display bootup command history                            
                                                                        
   -MPE    display MPE-style uptime information:                        
                  MPE/iX 6.0; System started @ 13:51 on 1999-01-09      
                                                                        
   -UNIX   display UNIX-style uptime information:                       
                   2:17pm  up 1 day, 0:26   13 users                    
                                                                        
   -ALL    display all information                                      
                                                                        
If no options are specified, -ALL is usually assumed, based upon        
the program's name and/or PARM value.                                   
                                                                        
If UPTIME's program file is called UPTIME.HPBIN@.@ (e.g.,               
UPTIME.HPBIN.SYS), then it defaults to -UNIX.                           
                                                                        
If UPTIME's program file is called BOOT@.@.@ (e.g.,                     
BOOTINFO.PUB.SYS), then it defaults to -BOOTINFO.                       
                                                                        
The PARM value provides an alternative method of specifying             
options:                                                                
                                                                        
   PARM bit 15 (PARM = 1) :: UNIX                                       
   PARM bit 14 (PARM = 2) :: MPE                                        
   PARM bit 13 (PARM = 4) :: BOOTINFO                                   
                                                                        
Although UPTIME must reside in a group.account with PM                  
capability, it does not modify any operating system data                
structures.                                                             
                                                                        
UPTIME should run on all versions of MPE/iX.  It has been tested        
through MPE/iX 6.5.                                                     
                                                                        
-----------------------------------------------------------------       
BOOTINFO output:                                                        
                                                                        
   Boot history: (chronological)                                        
                                                                        
  T  Date          Time     Group     Command                           
  -  ---------------------  --------  ----------------                  
  T  1998-12-14 @  2:09 PM            install                           
  T  1999-09-16 @  2:15 PM            update                            
     1999-10-29 @ 10:28 AM  CONFIG    start norecovery                  
     1999-12-02 @ 10:08 AM            dump                              
     1999-12-02 @ 10:13 AM  CONFIG    START NORECOVERY                  
                                                                        
The "T" flag probably means "started from tape".                        
                                                                        
UPTIME will report the history log in any of three formats:             
GROUPED (default), RAW, or SORTED.                                      
                                                                        
The GROUPED order first shows the two most recent START commands,       
then the last INSTALL, the last UPDATE, and the last DUMP (if           
any).  (Note: this is based on my understanding of the meaning of       
the raw order (see below).)                                             
                                                                        
The RAW order shows the five entries in the order they're found         
on disk. This ordering appears to be:                                   
                                                                        
   1) most recent START command                                         
   2) most recent INSTALL command                                       
   3) most recent UPDATE  command (if any)                              
   4) prior START command         (if any)                              
   5) most recent DUMP command    (if any)                              
                                                                        
The SORTED order is the default, and can be specified                   
via the "SORTED" keyword.  In this ordering, the oldest entry           
is shown first.                                                         

20160331