home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / cmdshell.zip / README.DOC < prev   
Text File  |  1994-01-31  |  5KB  |  111 lines
  1. CMDSHELL verson 1.0, (c) 1/29/1994, John M. Warren
  2.  
  3. WARRANTY 
  4.  
  5.         No warranty whatsoever.
  6.  
  7.  
  8. REGISTRATION
  9.          "I have 500,000 copies in use.", always looks good on a resume!
  10.  
  11.          This program is free.  However,  I'm in desperate need of an OS/2
  12.          C++ compiler ($350.00) so I can begin writing some really usefull
  13.          utilites/games/applications and other stuff for OS/2.  So any
  14.          contributions to fund my continuing education into C++ programming
  15.          is greatly appreciated. However, a simple note that you are using
  16.          it will get you added to my future mailing list, if you contribute
  17.          then of course your added automatically.
  18.          Please send checks, or requests to be added to my mailing list to :
  19.  
  20.    John M. Warren
  21.    OS/2 Utilites
  22.    P.O. Box 609
  23.    Vernon, Fl. 32462
  24.  
  25.    I can be contacted at my bbs for technical support.
  26.  
  27.    The Code 3 BBS, The Programmers
  28.    Connection 904-535-1705 14.4k
  29.    Source Code, Game Code, & over 1.5G of shareware   Full access first call.
  30.    1 Hour per day.  No UL/DL restrictions.
  31.             
  32.  
  33. WHAT IS CMDSHELL
  34.  
  35.  
  36.      CMDSHELL (Command Shell) is a small REXX program that I cooked up.
  37.      I have quite a few programs which are command line programs, or rather
  38.      programs that run by typing instructions at the OS/2 command prompt.
  39.      Wow, wouldn't it be nice to have a Presentation Manager icon that you
  40.      could click on to run these command line utilities..........well that's
  41.      fine, but what if you wanted to change the command line parameters every
  42.      time you ran the program?   Without CMDSHELL you would have to modify
  43.      the settings of the program each time before you ran it. Then this
  44.      program is for you.   With CMDSHELL you can easily set up your OS/2
  45.      programs to ask you for command line parameters before the program is
  46.      actually ran.   Why didn't IBM think of this?  Well I told them about it!
  47.  
  48.      Ok, here is an example for you non-techies out there.  Ok say you want to
  49.      set up a program object so that when it was clicked on, that it would give
  50.      you a directory listing of C: drive.   However, sometimes you want to
  51.      display the directory listing the old fashioned way....in a single column,
  52.      and sometimes you want to display the directory listing in the "/Wide"
  53.      format.   Without CMDSHELL you would have to create two program objects.
  54.      The first would contain the command "DIR C:" and the second would contain
  55.      the command "DIR C: /W".  Fine, but what if you wanted to use "/P"
  56.      parameter to display only a page at the time?  Bummer, you would have to
  57.      create program object number 3, "DIR /P".  See what I mean?   Why not just
  58.      use CMDSHELL, it will ask you to type in the parameters before the program
  59.      is ran.
  60.  
  61.  
  62. USING CMDSHELL
  63.  
  64.  
  65.     1.  Simply create a new program object.
  66.     2.  Under the "Path and file name" instead of putting the name and path of
  67.          your executable program, put the name and path of this command file.
  68.  
  69.          example :     C:\OS2\CMDSHELL.CMD
  70.  
  71.     3.  Next, under the "Parameters" field add the path and filename of your
  72.          program.
  73.  
  74.          example :   DIR C:
  75.  
  76.                       (important hint : you can parameters that
  77.                                         you use ALL the time after
  78.                                         the filename too.)
  79.  
  80. For convenience sake I would recommend opening your Templates folder, making
  81. a copy of the "Program" object and perform step 2.   From then on you could
  82. just copy this template object and would only have to fill in the path and
  83. filename.
  84.  
  85.  
  86. Heres what it looks like :
  87.  
  88.      ┌────────────────────────────────────────────────────────┐
  89.      │ [ ]  Program Name - Settings                           │
  90.      │ ┌────────────────────────────────────────────────────┐ │
  91.      │ │                                          General   │ │
  92.      │ │                                         ┌─────────┬┘ │
  93.      │ │  Required                               │         │  │
  94.      │ │    Path & Filename                      ├────────┬┘  │
  95.      │ │   ┌─────────────────────────┐ ┌───────┐ │        │   │
  96.      │ │   │ C:\PROGRAMS\CMDSHELL.CMD│ │ FIND..│ ├────────┘   │
  97.      │ │   └─────────────────────────┘ └───────┘ │            │
  98.      │ │        ^----------------------------------- you will need to modify
  99.      │ │                                         │   the path to the location
  100.      │ │  Optional                               │   where you put CMDSHELL.CMD
  101.      │ │    Parameters                           │            │
  102.      │ │   ┌─────────────────────────┐           │            │
  103.      │ │   │ DIR                     │ <------------ the optional path and
  104.      │ │   └─────────────────────────┘           │   name of the program to
  105.      │ │     Working Directory                   │   execute. │
  106.      │ │   ┌─────────────────────────┐           │            │
  107.      │ │   │                         │ <------------ optional location of the
  108.      │ │   └─────────────────────────┘           │   program your going to run
  109.      │ └─────────────────────────────────────────┘            │
  110.      └────────────────────────────────────────────────────────┘
  111.