home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / terminat.zip / TERMINAT.DOC next >
Text File  |  1994-01-23  |  4KB  |  107 lines
  1.  
  2.                      DOCUMENTATION FOR TERMINATOR/2
  3.                      ------------------------------
  4.  
  5. Terminator/2 is a program that terminates running processes by their
  6. Process ID numbers. There are other products that do the same thing
  7. (eg KILL, and KILLEM). Terminator/2 is similar to KILL in that the
  8. process ID number that you supply to it is the same as the one listed
  9. by PSTAT (when you type "pstat /c") but it is different from KILL in
  10. that it also gives you the option of terminating the child processes
  11. of the relevant process.
  12.  
  13. It is similar to KILLEM in that child processes of the process which
  14. you identified can be terminated along with the process, but it is
  15. different from KILLEM in that termination of child processes is an
  16. option which you have to specify explicitly (whereas in KILLEM, it
  17. is always done).
  18.  
  19. Finally, the executable file for Terminator/2 (TERMINAT.EXE) is far
  20. smaller than the executables of the other programs referred to above,
  21. in some cases, by an order of about 500% (it is only 5.8k in size,
  22. whereas some of the others are over 30k). Thus, if only for the sake
  23. of disk space, it might be a better alternative.
  24.  
  25. Why use Terminator/2?
  26. ---------------------
  27. Ever tried terminating some processes from the WPS, which just refuse
  28. to die? Well, try terminating them from the command line with
  29. Terminator/2 - you might just succeed.
  30.  
  31. What if you are not running the WPS (eg you are using TSHELL as your
  32. "protshell")? Well it becomes difficult to terminate hung processes
  33. without a command line utility. Enter Terminator/2. Get the gist?
  34.  
  35.  
  36. Syntax
  37. ------
  38. Terminator/2 can take up to 2 parameters (although only 1 is necessary).
  39.  
  40. The syntax is:
  41.  
  42.                TERMINAT <process ID> [/c]
  43.  
  44. The second parameter is optional, and is only used when you want to
  45. terminate a process, AND all it's child processes. If it is not
  46. supplied, then only the process identified by <process ID> is
  47. terminated.
  48.  
  49. Examples:
  50.        TERMINAT 0025     (terminates the process with ID number 0025)
  51.        TERMINAT 003C /c  (terminates the process with ID number 003C
  52.                           AND ALL its child processes)
  53.  
  54. Before you use the "/c" option, please make sure you know what you
  55. are doing.
  56.  
  57. You can obtain a list of the running processes and the process ID
  58. numbers by typing "pstat /c" from an os/2 command prompt. You will also
  59. see the process ID of the parent and child processes of each running
  60. process (this will help for example in determining whether you want
  61. to terminate child processes or not).
  62.  
  63. OS/2 sessions and programs are very easy to identify from the process
  64. list (when you type "pstat /c"). DOS and Windows sessions and programs
  65. are not always easy to identify. Thus if the process you wish to
  66. terminate is a DOS or Windows program, you have to study the process list
  67. carefully.
  68.  
  69. The program has only been tested under OS/2 v2.1, but is should work
  70. under version 2.0 as well. Because it is a 16-bit program, it may work
  71. under OS/2 v1.3, but I am not sure.
  72.  
  73. COMPILER
  74. --------
  75. For those who are interested, this program was written with Borland
  76. Pascal 7.0, with the OS/2 patch produced by the German c't magazine.
  77.  
  78.  
  79. --------
  80. LICENSE
  81. --------
  82. The program is released as freeware. You may do with it as you please,
  83. provided that you do not change the program in any way, and that if it
  84. is to be distributed, this file is distributed with it.
  85.  
  86. DISCLAIMER
  87. ----------
  88. THE PROGRAM TERMINATOR/2 IS SUPPLIED "AS IS", AND WITHOUT ANY WARRANTIES
  89. WHATSOEVER. I ACCEPT NO RESPONSIBILITY FOR ANY LOSS OR DAMAGE, WHETHER
  90. PHYSICAL, FINANCIAL, EMOTIONAL, MENTAL, MARITAL, OR OTHERWISE, THAT MAY
  91. RESULT FROM THE USE OR THE PURPORTED USE OF ANY OF THIS PROGRAM.
  92.  
  93. IF THESE TERMS ARE NOT ACCEPTABLE TO YOU, THEN YOU HAVE NO LICENSE TO
  94. USE THIS PROGRAM, AND YOU SHOULD DELETE IT FROM YOUR DISKS IMMEDIATELY
  95. AND PERMANENTLY.
  96.  
  97.  
  98. {----------------------------------------------------------}
  99. (c) January 1994
  100. Dr. A. Olowofoyeku
  101. Keele University,
  102. England.
  103.  
  104. E-mail: laa12@keele.ac.uk
  105.  
  106. {---------------------------------------------------------}
  107.