OS/2 Professional/OS2PRO194.ISO/os2/sysutils/go/go.doc

Text File | 1993-11-27 | 3.9 KB | 106 lines

                             ┌─────────────────┐
                             │    GO! v.1.2    │
                             │ (Rev. 93/11/27) │
                             └─────────────────┘

                         (c) 1993 by Carsten Wimmer

  Introduction:
  ~~~~~~~~~~~~
   This is a small tool I have written to test some OS/2 API calls. GO! is
   able to show you a list of processes, to switch to or kill a specific
   process. It is running on the command-line and is easy to use.
   I don't have any future plans for GO!, but if you want it to have more
   features in upcoming versions, feel free to write an email to me. Only
   user feedback keeps the development of a program alive!

   Many thanks to Kai Uwe Rommel for his informations about the undocumented
   DosQProcStatus() call.


  Usage:
  ~~~~~
   Here is a list of available command-line options:

      go.exe                          Show a list of all running processes.
      go.exe someunknownparameter     Show a list of all running processes.

      go.exe ?                        Short help.
      go.exe h                        Short help.
      go.exe help                     Short help.

      go.exe j <pid-number>           Jump to process. Supply a process id.
      go.exe jump <pid-number>        Jump to process. Supply a process id.
      go.exe j <exe-name>             Jump to process. Supply an .EXE name.
      go.exe jump <exe-name>          Jump to process. Supply an .EXE name.

      go.exe k <pid-number>           Kill a process. Supply a process id.
      go.exe kill <pid-number>        Kill a process. Supply a process id.
      go.exe k <exe-name>             Kill a process. Supply an .EXE name.
      go.exe kill <exe-name>          Kill a process. Supply an .EXE name.

   You may omit the .EXE extension in the <exe-name> parameter, if you are
   as lazy as me. ;-)

   Example:

      Assuming EPM (the Enhanced Editor) is running in the background,
      its name is EPM.EXE and its process ID is 42.

      Now you can switch to this application with the following command:

            go j 42
        or  go j epm
        or  go j epm.exe

      Kill it with the following command:

            go k 42
        or  go k epm
        or  go k epm.exe


   GO! exits with a return code of 0, if everything is fine. But
   sometimes GO! isn't able to determine the PID of a given exe-name
   or to kill/switch to a process. In these cases GO! exits with a
   return code of 1 (Can't kill or switch to given Process ID) or
   with a return code of 2 (Can't find Process ID for given exe-name).
   You can check for the return codes in your batch-file (using the IF and
   the ERRORLEVEL statement) or in the prompt of 4OS2, if you have
   installed 4OS2 and if you have put the errorlevel-macro in your shell
   prompt. See your Commandline-Shell Manual or the 4OS2 documentation
   for further details. Of course GO! shows an error-message on the screen
   if anything went wrong.


  Legal Disclaimer:
  ~~~~~~~~~~~~~~~~

   GO! is provided as is, with no warranty of any kind, either expressed
   or implied. GO! is only guaranteed to occupy disk space. You are free
   to copy and distribute the GO! archive freely, provided no changes or
   additions are made to the package.

   Carsten Wimmer (The Author) shall in no event be held liable to you or
   anyone else for any damages of ANY kind, incidental or consequential,
   arising from the use or inability to use this program.


  Final Note:
  ~~~~~~~~~~
   If you want to contact me, use one of the following:

     BBS             -> The Ghost Train, [phone], 24 hours a day
     FAX             -> [phone]
     FidoNet Classic -> 2:242/53.0
     IntlNet Europe  -> 57:4950/0.0
     Usenet          -> [e-mail] -or-
                        [e-mail]

   Have fun!
   Carsten Wimmer