home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / phome106.zip / GO.DOC < prev    next >
Text File  |  1993-11-27  |  4KB  |  106 lines
  1.  
  2.  
  3.  
  4.                              ┌─────────────────┐
  5.                              │    GO! v.1.2    │
  6.                              │ (Rev. 93/11/27) │
  7.                              └─────────────────┘
  8.  
  9.                          (c) 1993 by Carsten Wimmer
  10.  
  11.   Introduction:
  12.   ~~~~~~~~~~~~
  13.    This is a small tool I have written to test some OS/2 API calls. GO! is
  14.    able to show you a list of processes, to switch to or kill a specific
  15.    process. It is running on the command-line and is easy to use.
  16.    I don't have any future plans for GO!, but if you want it to have more
  17.    features in upcoming versions, feel free to write an email to me. Only
  18.    user feedback keeps the development of a program alive!
  19.  
  20.    Many thanks to Kai Uwe Rommel for his informations about the undocumented
  21.    DosQProcStatus() call.
  22.  
  23.  
  24.   Usage:
  25.   ~~~~~
  26.    Here is a list of available command-line options:
  27.  
  28.       go.exe                          Show a list of all running processes.
  29.       go.exe someunknownparameter     Show a list of all running processes.
  30.  
  31.       go.exe ?                        Short help.
  32.       go.exe h                        Short help.
  33.       go.exe help                     Short help.
  34.  
  35.       go.exe j <pid-number>           Jump to process. Supply a process id.
  36.       go.exe jump <pid-number>        Jump to process. Supply a process id.
  37.       go.exe j <exe-name>             Jump to process. Supply an .EXE name.
  38.       go.exe jump <exe-name>          Jump to process. Supply an .EXE name.
  39.  
  40.       go.exe k <pid-number>           Kill a process. Supply a process id.
  41.       go.exe kill <pid-number>        Kill a process. Supply a process id.
  42.       go.exe k <exe-name>             Kill a process. Supply an .EXE name.
  43.       go.exe kill <exe-name>          Kill a process. Supply an .EXE name.
  44.  
  45.    You may omit the .EXE extension in the <exe-name> parameter, if you are
  46.    as lazy as me. ;-)
  47.  
  48.    Example:
  49.  
  50.       Assuming EPM (the Enhanced Editor) is running in the background,
  51.       its name is EPM.EXE and its process ID is 42.
  52.  
  53.       Now you can switch to this application with the following command:
  54.  
  55.             go j 42
  56.         or  go j epm
  57.         or  go j epm.exe
  58.  
  59.       Kill it with the following command:
  60.  
  61.             go k 42
  62.         or  go k epm
  63.         or  go k epm.exe
  64.  
  65.  
  66.    GO! exits with a return code of 0, if everything is fine. But
  67.    sometimes GO! isn't able to determine the PID of a given exe-name
  68.    or to kill/switch to a process. In these cases GO! exits with a
  69.    return code of 1 (Can't kill or switch to given Process ID) or
  70.    with a return code of 2 (Can't find Process ID for given exe-name).
  71.    You can check for the return codes in your batch-file (using the IF and
  72.    the ERRORLEVEL statement) or in the prompt of 4OS2, if you have
  73.    installed 4OS2 and if you have put the errorlevel-macro in your shell
  74.    prompt. See your Commandline-Shell Manual or the 4OS2 documentation
  75.    for further details. Of course GO! shows an error-message on the screen
  76.    if anything went wrong.
  77.  
  78.  
  79.   Legal Disclaimer:
  80.   ~~~~~~~~~~~~~~~~
  81.  
  82.    GO! is provided as is, with no warranty of any kind, either expressed
  83.    or implied. GO! is only guaranteed to occupy disk space. You are free
  84.    to copy and distribute the GO! archive freely, provided no changes or
  85.    additions are made to the package.
  86.  
  87.    Carsten Wimmer (The Author) shall in no event be held liable to you or
  88.    anyone else for any damages of ANY kind, incidental or consequential,
  89.    arising from the use or inability to use this program.
  90.  
  91.  
  92.   Final Note:
  93.   ~~~~~~~~~~
  94.    If you want to contact me, use one of the following:
  95.  
  96.      BBS             -> The Ghost Train, +49 241 524204, 24 hours a day
  97.      FAX             -> +49 241 524204
  98.      FidoNet Classic -> 2:242/53.0
  99.      IntlNet Europe  -> 57:4950/0.0
  100.      Usenet          -> cawim@train.fido.de -or-
  101.                         cawim@pool.informatik.rwth-aachen.de
  102.  
  103.    Have fun!
  104.    Carsten Wimmer
  105.  
  106.