home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / os2 / sysinfo.arj / SYSINFO.DOC < prev    next >
Encoding:
Text File  |  1990-10-12  |  3.4 KB  |  68 lines
  1.         SYSINFO Documentation
  2.  
  3.         Summary
  4.  
  5.         Sysinfo  combines  the  functions  of  several  commonly   found 
  6.         daemons,  including  a free memory display, CPU meter and clock, 
  7.         along with some less common values as the free disk space  on  a 
  8.         selected  drive  and  the  size of the swap file.  By default it 
  9.         will hide its frame controls to lessen the amount of screen real 
  10.         estate used.  They can be restored by double  clicking  anywhere 
  11.         in the client area.
  12.  
  13.         Syntax
  14.  
  15.         sysinfo [drive_letter [/cal]]
  16.  
  17.         Sysinfo  will monitor a single drive for free space.  This drive 
  18.         can be specified on the command line.  No colon is required.  If 
  19.         not specified, it defaults to C.
  20.  
  21.         The /cal parameter is used to obtain a calibration value for the 
  22.         CPU meter  (see  the  Details  section  for  more  info).   This 
  23.         parameter  may  only  be  present  if  a  drive  letter  is also 
  24.         specified.  When invoked with this parameter the  system  should 
  25.         be in an idle state so that the calibration value is correct.
  26.  
  27.         Details
  28.  
  29.         When  started, sysinfo positions itself at the top of the screen 
  30.         using 2 times the standard system font  height.   It  hides  its 
  31.         frame  controls;  they may be restored by double clicking in the 
  32.         client area.  Whenever the controls are hidden it  moves  itself 
  33.         back up to the top of the screen, but it is possible to move the
  34.         display by dragging anywhere in the client area.  It creates  10
  35.         subsidiary  windows,  spaced  evenly across the client area. The 
  36.         windows look fine on a VGA display.  They  are  probably  rather 
  37.         crowded on an EGA and lonely on an 8514/A.  
  38.  
  39.         The free memory display is  actually  the  largest  single  free 
  40.         block  of  of  memory  so  is  of  relatively  little value.  By 
  41.         combining it with the swap file size you get a  better  idea  of 
  42.         whether  memory  is actually overcommitted or merely fragmented.  
  43.         If the swap file grows, memory  is  being  overcommitted.   This 
  44.         code  assumes  that  the swap file is c:\os2\system\swapper.dat. 
  45.         The swap file size is only updated every 3 seconds.
  46.         
  47.         The usage of the time of day value should be obvious.
  48.         
  49.         The CPU meter is  implemented  using  a  separate  thread  which 
  50.         simply  counts the number of iterations through a loop made each 
  51.         .75 seconds.  This is then expressed  as  a  percentage  of  the 
  52.         number  of  iterations  made with the system idle (this value is 
  53.         set by using /cal value discussed above).  The  counting  thread 
  54.         runs  as  idle class at priority 1, since I have heard that OS/2 
  55.         itself runs a null job at idle/0.  I have never  found  evidence 
  56.         of  this  thread  but  it  is  very  common  in  priority  based 
  57.         schedulers, since it lets the scheduler always find  a  runnable 
  58.         thread.
  59.         
  60.         The disk free value is computed every 3 seconds.  If free  space 
  61.         on the watched drive drops below 10%, the display turns red.
  62.         
  63.         This program is freeware.  Please feel free to use and modify it
  64.         as you see fit.  If you like it, pass it on to other boards.
  65.         
  66.         Joe Fromm, National Computer Systems.
  67.         
  68.