home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / run / run160.doc < prev   
Encoding:
Text File  |  1993-12-23  |  8.7 KB  |  220 lines
  1.  
  2.                         README FILE FOR RUN-OS/2 (v1.60)
  3.                         --------------------------------
  4.  
  5. This package consists of;
  6.      1. RUN.EXE        (the main RUN-OS2 executable)
  7.      2. RUN160.DOC     (documentation - this file);
  8.  
  9. Please read the DISCLAIMER at the end of this file BEFORE attempting
  10. to use either of these programs.
  11.  
  12. "RUN" is a utility that allows OS/2 users to run OS/2 programs from a DOS
  13. session. The executable (RUN.EXE) can be run from either a DOS session
  14. or from an OS/2 session. Certain features are not available if it is
  15. run from an OS/2 session, and, indeed, there is nothing to be gained by
  16. so doing, since RUN-OS/2 is only designed to overcome the restriction of
  17. not being able to run OS/2 executables from a DOS session.
  18.  
  19. You use this program by supplying the name of the OS/2 program that you want
  20. to run as the first parameter, and after that you can specify whatever
  21. parameters you wish to pass to the OS/2 program. RUN-OS/2 will search the
  22. (DOS) path for the OS/2 program, and if it is not found in the path, it
  23. will optionally proceed to search the entire drive (if you supply
  24. the /SCAN parameter - if the program is on the drive, RUN-OS/2 will
  25. find it and try to run it).
  26.  
  27. Normally, you should supply the full name of the OS/2 program,
  28. e.g., "RUN PMCAMERA.EXE". If the extension .EXE is not supplied
  29. e.g., "RUN PMCAMERA", then the program will search for the various
  30. permutations of valid executable file extensions, in the following order;
  31.         [1] EXE
  32.         [2] CMD
  33.         [3] COM
  34.         [4] BAT
  35.  
  36. The first one that matches will be executed.
  37.  
  38. The fact that RUN-OS/2 looks for .COM and .BAT extensions indicates that it
  39. will also run DOS programs. However, it was written for the purpose of
  40. running OS/2 programs only. On my system, it runs DOS programs alright, but
  41. you might need to press ENTER before the DOS prompt returns to you. All I
  42. can say however, is that you should only use it to run OS/2 programs. I
  43. cannot be responsible for anything that happens if this advice is not
  44. adhered to.
  45.  
  46. This program works fine on my system, but your mileage may vary. There is
  47. really no way in which I can improve it further, so if it doesn't work fine
  48. on your system, then sorry ... you will just have to delete it.
  49.  
  50. Examples of usage:
  51. 1. RUN OS2EMACS.EXE TODAY.TXT
  52.       this will run os2emacs.exe, and pass "today.txt" as a parameter to it.
  53.  
  54. 2. RUN CKERMIT
  55.       this will try to locate [a] CKERMIT.EXE, or [b] CKERMIT.CMD , or
  56.       [c] CKERMIT.COM [d] CKERMIT.BAT, in that order. When any of them
  57.       is found, it will be run. If no match is found, then there will be an
  58.       error message.
  59.  
  60. 3. RUN CKERMIT /SCAN
  61.       try to locate CKERMIT. If it is not found in the DOS path, search
  62.       through the whole of the CURRENT drive for it. Note that the /SCAN
  63.       option is being phased out.
  64.  
  65. Note that you need to copy RUN.EXE into a directory which is in the "path"
  66. statement in your CONFIG.SYS and AUTOEXEC.BAT files.
  67.  
  68.  
  69. COMMAND LINE PARAMETERS
  70. -----------------------
  71. The syntax forRUN is
  72.            RUN <progname> [prog parameters] [exec switches]
  73.  
  74. The Exec Switches are:
  75.  
  76.              /D=<dir> = run PROGNAME from the directory <dir>
  77.              /P+      = PAUSE after running PROGNAME
  78.              /PM      = PROGNAME is a Presentation Manager program
  79.              /FG      = run PROGNAME in the FOREGROUND
  80.              /BG      = run PROGNAME in the BACKGROUND
  81.              /FS      = run PROGNAME in a   FULL SCREEN session
  82.              /WN      = run PROGNAME in a   WINDOWED session
  83.              /SCAN    = scan the entire drive for PROGNAME
  84.  
  85. RESTRICTIONS:
  86.  
  87.              /SCAN cannot be used with any of the other switches
  88.              /FS and /WN cannot be used at the same time
  89.              /FS and /PM cannot be used at the same time
  90.              /WN and /PM cannot be used at the same time
  91.              /FG and /BG cannot be used at the same time
  92.  
  93. Note that the EXEC SWITCHES should be supplied after you have supplied
  94. all the parameters you wish to pass to your OS/2 program. 
  95.  
  96. Of what use are the command line switches?
  97.  
  98. 1.     To enable a user to specify the directory from which an OS/2
  99.        program should be run (this is sometimes needed because RUN-OS2
  100.        usually opens the OS/2 sessions in the root directory of the OS/2
  101.        drive).
  102.  
  103.        To use this function of RUN-OS/2, you need to supply the parameter
  104.        /D=<directory name>
  105.  
  106.        e.g.  RUN CKERMIT.EXE /D=E:\OS2KERM
  107.  
  108.        What happens here is that RUN-OS2 will then change to the
  109.        directory E:\OS2KERM, and then call CKERMIT.EXE from there.
  110.  
  111.  
  112. 2.     To enable a user to force the OS/2 session to pause for a key press
  113.        before it closes. This is important when you want to see the output
  114.        from that session.
  115.  
  116.        To use this function of RUN-OS/2, you need to supply the parameter
  117.        /P+
  118.  
  119.        e.g.  RUN CKERMIT.EXE /D=E:\OS2KERM /P+
  120.  
  121.        Here, after exiting from CKERMIT.EXE, you will be prompted for a
  122.        key press before the OS/2 session closes.
  123.  
  124.  
  125. 3.     To enable a user to force the OS/2 session to run in either full
  126.        screen mode or in a window (if your application is one that can
  127.        be run in a window).
  128.  
  129.        For this purpose you need to supply either the parameter /FS
  130.        (for full screen mode) or /WN (for a windowed session). If neither
  131.        of these parameters is supplied, the program will probably be run
  132.        in a window, but that will depend on many things.
  133.  
  134.        e.g.  RUN CKERMIT.EXE /FS
  135.  
  136.              Here, CKERMIT will be run in full screen mode
  137.  
  138.        e.g. RUN CKERMIT.EXE /WN
  139.  
  140.              Here, CKERMIT will be run in a window
  141.  
  142.  
  143. 4.      To enable the user to force the OS/2 session to run in the
  144.         foreground or in the background.
  145.  
  146.          To use this facility you need to supply the parameter /FG
  147.          (to run in the foreground) or /BG (to run in the background).
  148.          If neither of these parameters is supplied, the program will
  149.          probably be run in the foreground, but that will depend on
  150.          many things.
  151.  
  152.        e.g. RUN CKERMIT.EXE /FG
  153.  
  154.                Here, CKERMIT will be run in the foreground
  155.  
  156.        e.g. RUN CKERMIT.EXE /BG
  157.  
  158.                Here, CKERMIT will be run in the background
  159.  
  160.  5.   To indicate that the OS/2 program to be run is a Presentation
  161.       Manager program. For this, you need to use the /PM option. When
  162.       this is done, RUN-OS/2 disables some of the other options (e.g.,
  163.       /FS and /WN)
  164.  
  165.  
  166.  6.   To scan the entire drive for the OS/2 program to be executed.
  167.       Sometimes, a program is not in your "path", and therefore cannot
  168.       be found by the command processor. You will then get a message
  169.       that the command is not recognised. If you are sure that the
  170.       program is on that drive, you can supply the /SCAN switch, and
  171.       RUN-OS/2 will find it, if indeed it is there.
  172.  
  173.       There is a restriction with the /SCAN switch - it CANNOT be used
  174.       in conjunction with any of the other switches supported by
  175.       RUN-OS/2. If you try to use it with any other switch, it is
  176.       guaranteed NOT to work properly. Please note this point.
  177.  
  178.  Note that the parameters can be supplied in any order, and any number
  179.  of them may be supplied together (as long as it makes sense to do so -
  180.  for example it does not make sense to supply /BG and /FG at the same
  181.  time).
  182.  
  183.  
  184. 4OS2 batch files
  185. ----------------
  186.  It _may_ be possible to run 4OS2 .BTM files through RUN-OS/2. I have not
  187.  tried this, since I do not have 4OS2. However, RUN.EXE often calls your
  188.  OS/2 session's command interpreter (your 'COMSPEC'). Thus if your
  189.  'COMSPEC' is 4OS2.EXE then it may be possible to run its .BTM files.
  190.  If anybody can confirm this one way or the other, please do let me know.
  191.  
  192. --------
  193. LICENSE
  194. --------
  195. The program is released as freeware. You may do with it as you please,
  196. provided that you do not change the program in any way, and that if it
  197. is to be distributed, this file is distributed with it.
  198.  
  199. DISCLAIMER
  200. ----------
  201. THE PROGRAM RUN.EXE IS SUPPLIED "AS IS", AND WITHOUT ANY WARRANTIES
  202. WHATSOEVER. I ACCEPT NO RESPONSIBILITY FOR ANY LOSS OR DAMAGE, WHETHER
  203. PHYSICAL, FINANCIAL, EMOTIONAL, MENTAL, MARITAL, OR OTHERWISE, THAT MAY
  204. RESULT FROM THE USE OR THE PURPORTED USE OF RUN-OS/2.
  205.  
  206. IF THESE TERMS ARE NOT ACCEPTABLE TO YOU, THEN YOU HAVE NO LICENSE TO
  207. THIS PROGRAM, AND YOU SHOULD DELETE IT FROM YOUR DISKS IMMEDIATELY,
  208. AND PERMANENTLY.
  209.  
  210.  
  211. {----------------------------------------------------------}
  212. (c) December 1993
  213. Dr. A. Olowofoyeku
  214. Keele University,
  215. England.
  216.  
  217. E-mail: laa12@seq1.keele.ac.uk
  218.  
  219. {---------------------------------------------------------}
  220.