home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / sysutl / parapass.arc / PARAPASS.DOC < prev   
Text File  |  1988-05-31  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                            Parapass Version 0.0 BETA Test
  8.             
  9.                                 Rusty Baldwin
  10.                                 4783 W. 133rd St. #12
  11.                                 Hawthorne, CA  90250
  12.             
  13.             
  14.             INTRODUCTION
  15.             ------------
  16.             
  17.             Parapass stands for Parameter Pass. This program provides
  18.             the ability to interactively pass parameters (filenames,
  19.             switches, etc.) to programs which normally requires that the
  20.             parameters be on the command line. This can be useful with
  21.             operating environments such as DESQview or other multi-
  22.             tasking programs which will only pass fixed parameters to
  23.             programs. The most common example of a program with which
  24.             this would helpful is the Microsoft editor EDLIN which
  25.             (unfortunately) requires the name of the file to be edited
  26.             to be supplied on invocation line.
  27.                  Parapass can also be used within batch files to prompt
  28.             the user for input before running a program. Examples of
  29.             this follow.
  30.             
  31.             
  32.             RUNNING PARAPASS
  33.             ----------------
  34.             
  35.             To run Parapass just type PARAPASS <program name> </q> . The
  36.             parameters within the < > are optional and if specified do
  37.             not require the < >'s to be typed in. The program name MUST
  38.             be a fully qualified program name with the path to the
  39.             program specified. Example :
  40.             
  41.             PARAPASS A:\MYDIR\MYPROGRAM.COM
  42.             
  43.             Notice that the .COM extension is included. The optional
  44.             switch /Q runs PARAPASS in the quiet mode. In this mode
  45.             PARAPASS will not prompt the user for parameters but rather
  46.             wait silently for the user to type them in. This can be
  47.             useful in batch files when you want to supply your own input
  48.             prompt. Example batch file :
  49.             
  50.             ECHO OFF
  51.             ECHO PLEASE INPUT THE FILE TO EDIT.
  52.             REM THE NEXT ECHO STATEMENT WILL ECHO A BLANK LINE. NOTICE
  53.             REM THERE IS NO SPACE BETWEEN THE 'O' AND THE '.'
  54.             ECHO.
  55.             PARAPASS A:\MYDIR\MYEDITOR.EXE /Q
  56.             EXIT
  57.             
  58.                  If a program name for PARAPASS is not specified on the
  59.             command line when PARAPASS is run, PARAPASS will prompt for
  60.             the program to run whether the /Q switch was used or not.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.             
  74.             
  75.             
  76.             OTHER USES                              Parapass - Page 2
  77.             ----------
  78.             
  79.             Although it is possible to run batch files (.BAT) with
  80.             parapass, it appears to me to be of limited usefulness.
  81.             However, in the interest of being complete I am including
  82.             the instructions on how to do so.
  83.                  To run a batch file, invoke PARAPASS as follows
  84.             (substitute the appropriate path for COMMAND.COM on your
  85.             system in place of the path I have shown) :
  86.             
  87.             PARAPASS C:\COMMAND.COM
  88.             
  89.             When you are prompted for parameters input :
  90.             
  91.             /C \MYDIR\MYBATCH.BAT <PARAMETERS>
  92.             
  93.             Notice that the '/C' MUST be included BEFORE your batch
  94.             filename. The optional <PARAMETERS> are any parameters that
  95.             the batch file may require or be expecting.
  96.             
  97.             OTHER
  98.             -----
  99.             
  100.             I use this program daily and have attempted to make it as
  101.             bug free as possible. Any comments or suggestions would be
  102.             appreciated and can be directed to the address on page one.
  103.             I will attempt to act promptly on any bugs reported. The
  104.             source code has been included with this package and is
  105.             written in A86 assembly language. If you decide to modify
  106.             the source to suit your particular needs please do NOT
  107.             upload it to any bulletin boards. If you modify the source
  108.             code to fix a bug PLEASE tell me about it. I do encourage
  109.             you to distribute any unmodified version of this package
  110.             however.  Please include all files provided in the package.
  111.             These include:
  112.             
  113.             PARAPASS.DOC - This file.
  114.             PARAPASS.COM - The executable file.
  115.             PARAPASS.ASM - The source code.
  116.             
  117.             A86 ASSEMBLER
  118.             -------------
  119.             
  120.             The assembler used in this program is Eric Isaacson's A86
  121.             assembler. Along with the companion debugger D86 they make
  122.             up some of the best assembly language program development
  123.             tools available anywhere. These programs can be obtained
  124.             from:
  125.             
  126.             Eric Isaacson
  127.             416 E. University Street
  128.             Bloomington, IN     47401
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           
  140.                                           
  141.             
  142.             
  143.             DISCLAIMER                         Parapass - Page 3
  144.             ----------
  145.             
  146.             This program is hereby released into the public domain. The
  147.             author (Rusty Baldwin) assumes no liability for any loss, or
  148.             damage caused or alleged to be caused directly or indirectly
  149.             by this program, any part thereof, or its usage. No
  150.             guarantee is made of the accuracy of any information in the
  151.             manual, and revisions in the product may be made without
  152.             notice. I specifically disclaim any implied warranties of
  153.             merchantability or fitness for any particular purpose. This
  154.             product is supplied on an "as is" basis.
  155.             
  156.             The names of all companies mentioned in this manual are
  157.             trademarks or registered trademarks , and the names of all
  158.             products mentioned are trademarks of their producers.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.