home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 124 / COMBAT23.ZIP / COMBAT.DOC < prev    next >
Encoding:
Text File  |  1993-08-15  |  9.7 KB  |  218 lines
  1.  
  2.  
  3.  
  4.                    ComBat Batch File Compiler  Version 2.30
  5.                    Copyright, (c) 1993  By: Jack R. Vanatta
  6.                              All Rights Reserved
  7.  
  8.  
  9.                                  USER SUPPORT
  10.  
  11.        This program is "user supported."
  12.  
  13.        That does NOT mean public domain.  We retain all rights.  What it
  14.        does mean is that this is an experiment in marketing.  If you are
  15.        uncomfortable with "shrink wrap" agreements, copy protection, and
  16.        a price that more represents advertising costs than development
  17.        costs, then user supported software is the only reasonable altern-
  18.        ative.  We signify our trust in the user community by offering our
  19.        product for sale in this manner.  We hope you respond in kind.
  20.        ComBat is not copy protected, but ComBat and all of the batch file
  21.        utilities included are copyrighted software.  You are encouraged to
  22.        make evaluation copies for your friends.  After all, if you can't
  23.        try it, how do you know if you like it?  The diskette with all files
  24.        may be copied and shared with others, so long as no charge is made,
  25.        and it is unmodified and copied in its entirety.  These files may be
  26.        distributed via modem from bulletin board systems, provided that all
  27.        files are transmitted (archived) together.
  28.  
  29.        If, after evaluation, you find the program useful to you and wish
  30.        to own a copy, see the registration/order form at the end of this 
  31.        documentation.  Registration costs $29.95.
  32.  
  33.  
  34.  
  35.  
  36.        ComBat is a batch file compiler that will make a .COM file from a
  37.        batch (.BAT) file.  With ComBat it is possible to include some .COM
  38.        files directly into your compiled code.  That will be explained later
  39.        in this documentation.  ComBat requires at least an 80286 processor.
  40.        COMBAT.EXE and INCLUDE.EXE will end with a message that an 80286 is
  41.        required.  A ComBat compiled program will work properly on an 8088/8068
  42.        so long as the feature to include a .COM file directly into the 
  43.        compiled code is not used.  If .COM files are included an 8088/8086 
  44.        will hang the first time it tries to run one.  To install ComBat copy
  45.        the following files into a directory named COMBAT:
  46.  
  47.           COMBAT.DOC   - This documentation file.
  48.           COMBAT.EXE   - This is the main part of the batch file compiler. 
  49.           COMBAT2.EXE  - Called by COMBAT.EXE, not a stand alone program.
  50.           COMBAT.RUN   - Binary file used by COMBAT.EXE
  51.           INCLUDE.EXE  - Used to create the files neccessary to include a
  52.                          .COM file directly into the compiled code.
  53.  
  54.        BAT-UTIL.ZIP - Useful batch file utilities included free of charge.
  55.        Install these helpful utility programs in a directory listed in the 
  56.        DOS path.
  57.  
  58.        Using ComBat is really quite simple.  Create your batch file using 
  59.        your text file editor.  Then debug it like you normally would.  Compile
  60.        it with the command:
  61.  
  62.           COMBAT [path]filename[.bat]
  63.  
  64.        After the file has been compiled if you type the name the .COM file 
  65.        will execute.  DOS automatically finds a .COM file and executes it 
  66.        before it looks for a .BAT (or .EXE) file.
  67.  
  68.        There are a few minor differences between a Combat .COM file and a 
  69.        batch file.  Most of them are just due to the differences between a 
  70.        compiler and an interpreter.
  71.  
  72.        ECHO is always OFF.  An "ECHO OFF" or ECHO ON" command will not do
  73.        anything.
  74.  
  75.        BREAK is also ineffective.  <CTRL> - <BREAK> or <CTRL> - C are trapped
  76.        better than they are in a batch file.
  77.  
  78.        EXIT ends the compiled program, without closing the command 
  79.        interpreter.  When ComBat sees an EXIT command it changes it to a goto 
  80.        that is processed internally.  Because of this the command "ECHO EXIT"
  81.        will not echo EXIT.
  82.  
  83.        Most TSR programs will not work.  They usually crash, however I had a 
  84.        little luck with TSR programs that follow strictly the rules set forth 
  85.        in "Undocumented DOS" published by Addison-Wesley Publishing Co.  Be 
  86.        careful.
  87.  
  88.  
  89.  
  90.        As mentioned earlier ComBat has the ability to include a .COM file 
  91.        directly into the compiled code.  Unless otherwise stated all of the 
  92.        utility .COM files on this disk have been tested and will work when 
  93.        included.  However many .COM files will not.
  94.   
  95.        All TSR programs will fail when included.  INCLUDE.EXE has a built in
  96.        TSR detector which will not allow you to include some TSR programs, but
  97.        it can be fooled.
  98.  
  99.        Programs that shell out to run other programs can not be included.
  100.        When DOS starts a program that program is allocated all remaining 
  101.        memory.  That program must re-allocate memory to free up all of the
  102.        memory it does not need.  The re-allocation will release memory needed 
  103.        by the ComBat compiled program.
  104.  
  105.        DO.COM, one of utility programs included with ComBat, will work when
  106.        included directly into the ComBat compiled code.  It was specially
  107.        written to work around this problem.  If you have registered your copy
  108.        of ComBat and ask for information on how to write a program to call 
  109.        another program that can be included I will gladly supply it.
  110.  
  111.        The DOS pipe or re-direction can not be used with an included program.
  112.        ComBat will run a line in a batch file that uses the pipe or re-
  113.        direction by passing it along to COMMAND.COM.  It will work properly if
  114.        the programs can be located via the DOS path.
  115.  
  116.        Most of the programs I have tried that will work when included were 
  117.        written in assembly language.  A lot of high level language compilers 
  118.        seem to do something that is incompatible with ComBat.  I have tried to 
  119.        make it possible to include as many programs as possible but there are 
  120.        many different ways to write a .COM file and it would impossible to 
  121.        write something that would include them all.  
  122.  
  123.  
  124.  
  125.  
  126.        In order to include a .COM file directly into the ComBat Compiled code 
  127.        you must first run the INCLUDE.EXE program.  INCLUDE.EXE creates the 
  128.        following two files:
  129.  
  130.           C-B.INC - This file holds the binary images of the .COM files to be 
  131.                     included, modified slightly to make them compatible with
  132.                     ComBat.
  133.  
  134.           C-B.LST - This file is a list of the .COM files to be included, and
  135.                     their length.  ComBat uses this file to calculate the 
  136.                     addres where it can find the included code.  You can look 
  137.                     at this file to see what .COM files will be included.
  138.  
  139.        All of the .COM files listed in the C-B files will be included whether
  140.        or not they are used.  It is best to the erase the C-B files and 
  141.        recreate them when starting a new project.
  142.  
  143.        To use the include feature of ComBat write your batch file, debug it, 
  144.        then compile in the normal manner.  When everything is working properly 
  145.        include the .COM files with the command:
  146.  
  147.           INCLUDE [path]filename[.com]
  148.  
  149.        The C-B files will be created the first time INCLUDE.EXE is run.  On all 
  150.        subsequent runs INCLUDE.EXE will append the information to the existing 
  151.        C-B files.  Now use COMBAT.EXE to re-compile the program.
  152.  
  153.        COMBAT.EXE, COMBAT2.EXE and INCLUDE.EXE were written for and compiled 
  154.        using Spectra PowerBASIC version 2.10a.  COMBAT.RUN was written for and 
  155.        assembled using CHASM version 4.14.
  156.  
  157.        CHASM is "the CHeap ASseMbler", an excellent shareware assembler by Dave
  158.        Whitman.  If you want to write .COM files to include in your ComBat
  159.        programs this is the assembler to use.  This plug was unsolicited.
  160.  
  161.  
  162.           ComBat Batch File Compiler
  163.  
  164.           The ComBat Batch File Compiler creates a .COM file
  165.           From a batch file.  This batch file compiler has
  166.           the unique ability to include existing .COM files
  167.           directly into the compiled code.
  168.  
  169.           $29.95 to register or order Combat                      ___________ 
  170.  
  171.  
  172.           Simple Menu System
  173.  
  174.           Simple Menu System is an automatic menu program.
  175.           Just install it in your DOS path and it will
  176.           display a menu of all your executable files
  177.           automatically.
  178.  
  179.           $19.95 to register or order Simple Menu System          ___________ 
  180.  
  181.  
  182.           Security System
  183.  
  184.           Security System is program to password protect 
  185.           your computer system.  It features the ability
  186.           to change passwords easily and includes two 
  187.           different security levels.
  188.  
  189.           $19.95 to register or order Security System             ___________ 
  190.  
  191.  
  192.           DO.COM source code
  193.  
  194.           This is the source code for DO.COM.  It shows
  195.           how to write a program that can tell if it is
  196.           being included directly into the compiled code
  197.           of a ComBat program or running as a stand alone
  198.           Program.
  199.  
  200.           Free to registered users of ComBat                      ___________
  201.  
  202.           [ ] Register only 
  203.           [ ] Send programs on 5 1/4" Diskette
  204.           [ ] Send programs on 3 1/2" Diskette
  205.  
  206.                                         Pre Tax Total             ___________
  207.  
  208.                Minnesota Residents Add 6.5% Sales Tax             ___________
  209.  
  210.                                                 TOTAL             ___________
  211.  
  212.           Send Check or Money Order Payable to:
  213.  
  214.                               Jack R. Vanatta
  215.                               3408 39th Ave So
  216.                               Mpls, MN  55406
  217.  
  218.