home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / top201.zip / TOP.TXT < prev    next >
Text File  |  1999-04-25  |  5KB  |  145 lines
  1.  
  2.                                  TOP V2.01
  3.  
  4.                                     by
  5.  
  6.                               Paul Ratcliffe
  7.                                (c) Apr. 1999
  8.  
  9.  
  10. TOP, PLIST, PKILL and PMEM are a collection of programs for monitoring the
  11. system CPU and memory usage and for querying and killing processes.
  12. The program is E-mailware and as such:
  13.  
  14.              USE OF THIS PROGRAM IS ENTIRELY AT YOUR OWN RISK.
  15.  
  16.  
  17. LICENSE
  18.  
  19. TOP was originally written by Ian Hargreaves, and is now maintained by Paul
  20. Ratcliffe.
  21.  
  22. The software and all associated files are copyrighted by Ian Hargreaves and
  23. Paul Ratcliffe. You may copy this software for backup purposes. You may
  24. also copy and share unmodified copies of the whole package, provided the
  25. copyright notice is reproduced and included on all copies. Please let me
  26. know if you plan to re-distribute TOP.
  27.  
  28. This software is E-mailware. Simply send a message to top@orac.clara.co.uk
  29. and you can use this software for as long as you want. Please mention where
  30. you got TOP from, and what version you are using.
  31.  
  32.  
  33.  
  34. TOP
  35.  
  36. This utility is similar to the Unix tool TOP. It displays a list of
  37. processes and the amount of CPU time they are using. The amount of CPU is
  38. calculated using the undocumented OS/2 call DosQProcStatus. This function
  39. gives details for each thread on how much System (Kernel) time and how much
  40. User (Application) time is being used.
  41.  
  42. TOP is NOT a load monitor - the statistics displayed are not real time,
  43. they are the statistics for the previous monitoring period (default 2
  44. seconds).
  45. The load is calculated by comparing the amount of CPU that a process has
  46. used in the current monitoring period, to the amount the same process used
  47. in the last monitoring period.
  48.  
  49. A list of active processes is displayed and sorted according to the current
  50. sort specification. This and many other options are configured in the text
  51. file TOP.OPT, a sample of which is included, along with explanatory notes.
  52.  
  53.  
  54. KEYBOARD CONTROLS
  55.  
  56. From the main menu, you can navigate through the program using the
  57. Left/Right cursor keys or the initial letter of each menu option. The Enter
  58. key is used as a Select key and the Escape key as a Cancel key.
  59.  
  60. On the pop up menus, the Enter key selects or deselects the option and
  61. cancels the menu, whereas the Space key just selects the option.
  62.  
  63. The standard PgUp, PgDn, Home, End, Ctrl-Home and Ctrl-End keys can be used
  64. to navigate the process list display.
  65. Pressing the Up/Down cursor keys allows a particular process to be
  66. selected. From this selection you can either press Enter to display the
  67. thread information for that process, or press K to attempt to kill it.
  68.  
  69. Other keys are:
  70.   F1  - Display this help text
  71.   ESC - Return to previous menu
  72.   Q - Quit program
  73.  
  74.  
  75. TECHNICAL INFORMATION
  76.  
  77. TOP uses 2 threads - one to process keyboard options, and the other one to
  78. call DosQProcStatus, calculate CPU usage and display the results.
  79. Both threads run at the default priority class and level and in total will
  80. not impact system performance by any significant amount.
  81.  
  82. If you see figures where TOP appears to be using lots (>10%) of CPU, this
  83. will be because you will probably have very few active processes running.
  84.  
  85. TOP is a VIO mode program. This means that if you increase the number of
  86. lines that are available at the command prompt (using the MODE command),
  87. TOP will use those extra lines to display more information.
  88.  
  89. Remember TOP is NOT a load monitor. Most load monitors work by having a
  90. background thread run constantly to calculate CPU usage. TOP spends most of
  91. its time sleeping between screen updates, during which time the CPU is free
  92. to do other more useful stuff.
  93.  
  94.  
  95.  
  96. PLIST
  97.  
  98. PLIST is a process listing tool which displays much the same information as
  99. TOP, but in a single shot operation rather than a continuous display.
  100. The process list can be sorted in the same way as TOP by using a command line
  101. switch. PLIST ? gives the options. The default is to do a reverse sort by
  102. process ID.
  103.  
  104.  
  105.  
  106. PMEM
  107.  
  108. PMEM is a process memory usage listing tool. It requires OS20MEMU.DLL and
  109. OS20MEMU.SYS to be installed. OS20MEMU is IBM EWS (Employee Written
  110. Software) program, that breaks down memory usage by process.
  111. The list can be sorted - PMEM ? gives the options. The default is a verbose
  112. unsorted display.
  113.  
  114.  
  115.  
  116. PKILL
  117.  
  118. PKILL is a process killer tool. It takes one parameter - either a decimal
  119. process ID, or part of a process name. If the same name appears more than
  120. once in the process list, then PKILL will only kill the first... beware
  121. killing the wrong process.
  122.  
  123.  
  124.  
  125. HISTORY
  126.  
  127. Version 2.01  26-4-99
  128.   Modification to allow the Q key to exit the program from most menus.
  129.  
  130. Version 2.0  4-4-99
  131.   Complete rewrite from original TOP 0.91 sources by Ian Hargreaves.
  132.  
  133.  
  134. OTHER
  135.  
  136. This program was developed under Warp 3 (without Win-OS/2) using VisualAge
  137. C++ 3.0 for OS/2.
  138.  
  139. If you use this program could you please let me know. Also if you have any
  140. comments, criticisms, bug reports or anything that could be improved.
  141. I will reply to all messages received.
  142.  
  143. Paul Ratcliffe: Internet: top@orac.clara.co.uk
  144.                 Internet: paul.ratcliffe@bbc.co.uk
  145.