home *** CD-ROM | disk | FTP | other *** search
/ Inside Multimedia 1995 May / IMM0595.ISO / share / tools / hkfree / hkfree.doc next >
Encoding:
Text File  |  1992-08-20  |  10.4 KB  |  262 lines
  1.                                   HKFree
  2.                              Windows Monitor
  3.                                  Ver 1.10
  4.  
  5. HKFree Windows Monitor was born out of the need for me, a programmer, to be
  6. able to examine many aspects of the Windows environment while programming or
  7. launching or working without invoking all of the 4-5 other Windows utilities
  8. that each seperately show a piece of the Windows puzzle.
  9.  
  10. The following features were available in Ver 1.00:
  11.    - Icon with GDI resources and System Clock.
  12.    - System Information Screen
  13.    - Memory Management screen (Global, Paged, Virtual) with a Global
  14.      Memory Compact option.
  15.    - Resource Detail screen that lets you walk through the Global and Local
  16.      heap values.
  17.    - Windows List much like System spy showing all active Windows in your
  18.      system and relevant information.
  19.    - Task List that shows Task and Handles with a Task Termination feature
  20.      to eliminate Hung/Looping tasks.
  21.  
  22. These new features are available in Ver 1.10
  23.    - Configurable Icon, you can see Date, Time, GDI% or User% on any line
  24.      of the Icon.
  25.    - Network Mapping. Option to interrogate Network connection and display
  26.      a list of all attached servers (Novell).
  27.    - Disk Mapping. Modified System info screen to map all disks and show
  28.      a percentage of disk free as well as available and total disk size.
  29.    - Windows Detail. You can select a window from the windows list and get
  30.      a detailed report on its resources, memory allocation, size, position
  31.      and handles.
  32.    - Option to make the Icon 'On Top' of all others.
  33.    - Option to change the Icon refresh rate.
  34.  
  35. The key problem was how to show information in a way that minimized the
  36. impact on my already FULL screen and also didn't tie up valuable resource
  37. space or memory.
  38.  
  39. At the same time I thought it might be nice to show the system time since
  40. that would get rid of 1 icon (the clock) while using the timer hook that
  41. I grabbed anyways for the Windows monitor.
  42.  
  43. So HKFree was born. (By the way HK stands for House Keeper which is a Windows
  44. shareware program I wrote).
  45.  
  46. -----------------------------------------------------------------------------
  47. Installing HKFree Windows Monitor:
  48.  
  49.    1. Copy the TOOLHELP.DLL file into your Windows directory or Windows\System
  50.       directory.  This is a benign Borland Library that is used for some system
  51.       calls.  Must be present in order for HKFree to run.
  52.  
  53.    2. Create an HKFree directory (if desired).
  54.    3. Copy HKFREE.EXE to the directory you chose to place it.
  55.    4. Return to Windows.
  56.    5. Using Program Manager, add HKFree to your STARTUP group.
  57.  
  58. -----------------------------------------------------------------------------
  59. What does HKFree display:
  60.  
  61. The Icon
  62. --------
  63.  
  64.      The Icon is split into a Top and Bottom Line as well as the Name Line.
  65.      The Top Line shows the available GDI resources while the Bottom line
  66.      displays the system time as a default.  The Name Line will default to
  67.      'Windows Monitor' however all the various data shown on the Icon can be
  68.      changed using the Configuration option on the Menu.
  69.  
  70.      The Icon is updated every 1/2 second however the display is only updated
  71.      if the Available resources or the time changes. (Other resource monitors
  72.      flash every second or so which bugs the bytes out of me!).
  73.  
  74.      Clicking the Left Mouse button on the HKFree icon will bring up a MENU
  75.      with the HKFree reporting options.
  76.  
  77. Configuration
  78. -------------
  79.  
  80.      You can use configuration to set up how the Windows Monitor Icon looks
  81.      and operates.  For each of the 3 status areas of the Icon (Top Line,
  82.      Bottom Line and Name) you can chose either Resource or Date/Time
  83.      information.  The Icon will immediately change (even in the background)
  84.      when you make a selection.
  85.  
  86.      When you select Date/Time or GDI/User data for the Icon Name they will
  87.      display more complete information than what fits in either the Top or
  88.      Bottom line of the Icon.
  89.  
  90.      Refresh Rate:  Windows Monitor will check on the Icon values every 1/2
  91.      second by default, however you can lower or raise the rate as you see
  92.      fit.  Note that you will use more processing cycles if you lower the
  93.      refresh rate.
  94.  
  95.      Icon On Top:  If you select the Icon On Top button it will force the
  96.      Windows Monitor Icon to be On Top of every other Window that is
  97.      displayed on your screen including Word,Excel,Program Manager, etc.
  98.      The only drawback with this option is that you can not Un-On-Top it
  99.      without shutting down Windows Monitor and starting a fresh copy. This
  100.      is due to a quirk in the Windows API call that doesn't quite act like
  101.      the documentation says.
  102.  
  103. System Information
  104. ------------------
  105.  
  106.      Windows Version.
  107.         - You better be on at least 3.1 or you deserve to crash....
  108.  
  109.      Windows Mode.
  110.         - You would be suprised on what Mode some systems are running.
  111.  
  112.      CPU Type.
  113.         - 80x86 to 80486.
  114.  
  115.      CoProcessor.
  116.         - Is a co-processor present??
  117.  
  118.      Dos Version.
  119.  
  120.      Logged Disk Drive and Directory.
  121.         - Calls the system to find out the DEFAULT drive (On a network this
  122.           usually will give the Logged drive) as well as the current working
  123.           directory.
  124.  
  125.      Disk Map.
  126.        - This List Box will map out all Physical and Logical drives available
  127.          to you. In addition each drive will show the % Disk Free (in Kb) as
  128.          well as the available and total Kb on that drive.
  129.  
  130. Network Information
  131. -------------------
  132.  
  133.      This option was added by request of several corporate users that had
  134.      Networks installed.
  135.  
  136.      Network:  Will show the type of Network software that is running on
  137.      the system including Netware,NetBois and PCLan.  Other network types
  138.      will probably appear as 'Unknown'.  A message will appear if your
  139.      network software is loaded but no network connection is made.
  140.  
  141.      Attached Servers: For Novell networks this will List the servers to
  142.      which you currently have access.
  143.  
  144. Resource Detail
  145. ---------------
  146.  
  147.      Global Heap Values.
  148.         - Displays the number of Heap items, the number that are LRU (Least
  149.           recently used).
  150.  
  151.           If you Click the mouse on the 'Next Global Heap' button you will
  152.           scroll through the Global Heap items. Each of these relates to a
  153.           resource/window..
  154.  
  155.      System Heap.
  156.         - Heap % Available for User.
  157.         - Heap % available for GDI. (Resource space free)
  158.  
  159.      Local Heap Values.
  160.         - Few Global Heap items will actually have Local Heap declared.
  161.           If one does the Local Heap window will show the number of local
  162.           Heap items and the the 'Next Local Heap' key will ungrey itself.
  163.  
  164.           You can then press the 'Next Local Heap' key to scroll thru the
  165.           Local Heap values until the 'Last Local Heap' Messagebox appears.
  166.  
  167. List of All Windows
  168. -------------------
  169.  
  170.      If you are familiar with Systems SPY now distributed with Windows then
  171.      you will understand the information listed.  Since every window has a
  172.      handle it was relatively simple to Enumerate the windows and list the
  173.      information that would be useful to us.
  174.  
  175.      The fields shown in the List Box are:
  176.  
  177.          Window Type.
  178.             Types include 'Top Level', 'Icon', 'Popup' and 'Child'.
  179.          Handle.
  180.             - The windows handle.
  181.          Parent Handle.
  182.             - Don't expect this windows parent to preceed this window in the
  183.               list, sometimes it will appear farther along.  Top Level windows
  184.               will have a parent handle of 0000.
  185.          Class Name.
  186.             - The resource or window class name.
  187.          Windows Title.
  188.             - This is the title the programmer gave the window, icon, dialog
  189.               box or button, ie: what usually appears on the screen below
  190.               the icon box.
  191.  
  192.      If you select any Window listed you can then press the 'Detail' button
  193.      located on the bottom right of the screen.  This will provide you with
  194.      the 'core' details of the window you have selected:
  195.         - Window Style.  These are the Resource attributes of the window you
  196.           have selected.
  197.         - Class Style.  The resource attributes of the Window Class.
  198.         - Windows Function.
  199.         - Extra Allocation.
  200.         - Window Position and Size.
  201.         - Handle List.
  202.  
  203. Memory Information
  204. ------------------
  205.  
  206.      Free Global Memory.
  207.         - Calculated thru a call to 'GetFreeSpace' function.  Shows the
  208.           amount of free memory in the Global Heap.
  209.  
  210.      Paged Memory.
  211.  
  212.      Virtual Memory.
  213.  
  214.      Compact Global Memory Button.
  215.         - Compacts Global Memory and removes discardable segments. When it
  216.           is finished a message box appears for confirmation.
  217.  
  218. Task List
  219. ---------
  220.  
  221.      Displays a List Box with the Task Name, its Handle and its Parents
  222.      Handle.
  223.  
  224.      Press the OK button to End
  225.  
  226.      Select a Task and Press the TERMINATE TASK button to eliminate the
  227.      selected task from Windows.  This has been useful while developing
  228.      windows applications that tend to Hang/Choke/Loop which the normal
  229.      Windows task termination feature would not terminate.
  230.  
  231.      Note this feature is dangerous!! None of the resources or memory
  232.      allocated to the task are reclaimed, they become virtual dangling
  233.      parcipicles (?) so I recommend that you reboot/restart Windows after
  234.      doing this though I have seen an application reclaim resources when
  235.      rerun.
  236.  
  237. Resident Modules List
  238. ---------------------
  239.  
  240.      This option provides you with a current list of all modules that Windows
  241.      has loaded.  This includes programs, DLLs, Fonts, etc..  In addition
  242.      you will see the full Name and Path of where the modules was loaded from.
  243.  
  244.      Use this option to determine extrenuous modules that have been loaded or
  245.      incorrect versions of modules.
  246.  
  247. About Windows Monitor
  248. ---------------------
  249.  
  250.      My speech......
  251.  
  252. -----------------------------------------------------------------------------
  253. ShareWareShareWareShareWareShareWareShareWareShareWareShareWareShareWare
  254.  
  255.      Please support the author of this shareware program, see the
  256.      attached order form...
  257.  
  258. ShareWareShareWareShareWareShareWareShareWareShareWareShareWareShareWare
  259. -----------------------------------------------------------------------------
  260.  
  261.    Note:  'Windows' is TM MicroSoft Corp.
  262.