home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / submit / ex15.lbr / EX15.DQC / EX15.DOC
Encoding:
Text File  |  1985-12-02  |  5.9 KB  |  190 lines
  1.                  EX 1.4 - 11/20/82
  2.  
  3.  
  4.   Thanks to Joe Cutler, Stan Hanson, and Ron Fowler for EX.* and the
  5.   information used to create this version.  This file and the source for
  6.   EX14 are based upon the previous EX*.* files.
  7.  
  8.  
  9.   EX 1.4 is a maintenance update to EX 1.2 and EX 1.3 (never released).
  10.  
  11.   Problem:    BASCOM would not execute under EX.
  12.  
  13.   Reason:    BASCOM is doing system integrity checks using the
  14.         BDOS+1 address.  EX was not preserving the required
  15.         information so that BASCOM would execute.
  16.  
  17.   Resolution:    See next problem resolution.
  18.  
  19.  
  20.   Problem:    Unpredictable results when executing MBASIC under EX.
  21.  
  22.   Reason:    MBASIC (and others) were not subtracting 6 from the
  23.         BDOS+1 address when determining available memory.
  24.  
  25.   Resolution:    EX now refreshes the storage in the 6 bytes below the
  26.         BDOS+1 address during any warmboot request.
  27.  
  28.  
  29.   The enhancements added with EX 1.2 are:
  30.  
  31.        ^:        EX runtime re-execution function
  32.        ^?        EX runtime wait for carriage return
  33.             `Xsub Already Present' logic
  34.             Input/EX buffer overlap detection
  35.             EX runtime recursion prevention (Ex Already Present)
  36.             EX runtime prompt mode character logic
  37.  
  38.   The enhancements added with EX 1.1 are:
  39.  
  40.        ;;        EX only comment support
  41.        ^.        Print suppression toggle
  42.        ^<..^>    Immediate print function
  43.        ^#        EX message suppression toggle
  44.        ^|        Carriage return/line feed function
  45.        ^$        Default parameters' support
  46.             Logic to prevent ZCPR re-entrance to EX.COM
  47.             (EX.COM is not reentrant)
  48.  
  49.                 --Larry Steeger
  50.                   [70315,1120] on CompuServe
  51.  
  52.  
  53.   [note: The changes from file EXFIX.DOC have been incorporated into EX12.*]
  54.  
  55.  
  56.   EX is a nifty and fast way of executing .SUB files,
  57.   (uses ram as the SUB file buffer rather than spreading
  58.   it out on disk).  EX also allows batch entry of a series
  59.   of commands which it stores in memory for subsequent
  60.   continuous execution.  EX relocates itself and its buffer
  61.   to high memory just below CCP and adjusts the CP/M BDOS
  62.   entry to protect itself.
  63.  
  64.                 --Stan Hanson       05/24/82
  65.  
  66.   EX replaces the functions of both SUBMIT.COM and XSUB.COM
  67.   from Digital Research, Inc.
  68.  
  69.                 --Larry Steeger    08/06/82
  70.  
  71.  
  72.   The files used to assemble EX14.ASM using EX14.SUB are:
  73.  
  74.       ED.COM
  75.       EX14.ASM
  76.       EX14.SUB
  77.       MAC.COM
  78.       RELS.UTL (or REL.UTL see note in EX14.SUB)
  79.       SID.COM
  80.       SUBMIT.COM and XSUB.COM (or a previous version of EX.COM may be used)
  81.  
  82.       [note: REL.UTL is available on CP/MUG Volume #38]
  83.       [note: RELS.UTL is available on CP/MIG XA1 ACCESS database]
  84.  
  85.   The files used to test EX14.COM are:
  86.  
  87.       EX14.COM
  88.       EX14.TST (must be renamed to .SUB before executing test)
  89.       XSUB.COM
  90.  
  91.   The files used to execute EX14.COM are:
  92.  
  93.       EX14.COM
  94.       SUB.COM  (used to generate simple *.SUB files)
  95.  
  96.       [note: Any good CP/M editor may be used to create *.SUB files]
  97.  
  98.  
  99.   (cr is carriage return)
  100.  
  101.   EX14.COM may be invoked two ways:
  102.  
  103.     1. EX14 cr
  104.  
  105.        This form will cause EX to prompt with a line number and `:'
  106.        for each command line to be executed.  A carriage return
  107.        entered by itself terminates the prompting and starts
  108.        execution of the command lines that have been entered.
  109.  
  110.  
  111.     2. EX14 <submit file> <parameters> cr
  112.  
  113.        This form will cause EX to load the <submit file> into
  114.        memory and perform <parameters> substitution the same as
  115.        SUBMIT, with the addition of the `^$' support for missing
  116.        parameters.    After all parameters have been substituted
  117.        the text from the file is executed as if was entered from
  118.        the console.
  119.  
  120.  
  121.   EX14.COM may be terminated during execution by entering control-C from
  122.   the console.
  123.  
  124.  
  125.   EX14.COM submit file conventions are:
  126.  
  127.     [note: unless otherwise stated, the `<.......>' sequences
  128.            are used only to indicate character strings that
  129.            must be replaced with the values described.]
  130.  
  131.     ^<a character: A thru underscore>  generates the corresponding
  132.                        control character.
  133.  
  134.                        Lowercase letters a thru z
  135.                        are converted to uppercase.
  136.  
  137.     $<1 thru 9> generates parameter <1 thru 9> substitution
  138.             the same as SUBMIT, unless `^$' is being used
  139.             as described below.
  140.  
  141.     ^$<parm1 parm2 . . . parm9>  will generate a list of parameters
  142.                      that will be used in the $<1 thru 9>
  143.                      parameter substitution if the user
  144.                      does not provide any parameters or
  145.                      only some of the parameters on the
  146.                      EX command line.
  147.  
  148.     ;; generates an EX only comment (the ;; and the remainder of
  149.                      the current line are not
  150.                      moved to the EX command buffer.).
  151.  
  152.     |  generates a Carriage Return.
  153.  
  154.     ^|  generates a Carriage Return and Line Feed.
  155.  
  156.     |,cr,lf,1AH(EOF)  will eliminate all characters from the last |
  157.               thru this sequence.
  158.  
  159.     ^.  toggles print suppression for characters from SUBMIT file.
  160.  
  161.        (Example:  DIR ^.*.COM^. will execute DIR *.COM but only DIR
  162.               will be echoed to the console.)
  163.  
  164.     ^<  forces immediate display of the characters following it
  165.         until ^> is encountered.  ^<char> control support, $<1 thru 9>
  166.         parameter substitution, and $<char> escape support continues
  167.         during this display mode.
  168.  
  169.        (Example:  ^<^[ETest EX 1.4^|^> will generate the sequence to
  170.               clear the screen on the H/Z19 terminal and display
  171.               `Test EX 1.4' at the upper-lefthand corner of the
  172.               screen and the cursor will be on the next line.)
  173.  
  174.     ^: causes EX to re-execute the .SUB file from the beginning.
  175.  
  176.     ^? causes EX to wait for a carriage return response from the
  177.        console.  Control-C will terminate EX at this point also.
  178.  
  179.     $$ generates the $ (dollar-sign).
  180.  
  181.     $^ generates the ^ (caret or up-arrow).
  182.  
  183.     $| generates the | (broken vertical bar).
  184.  
  185.  
  186.   EX14.COM(.BIN or .OBJ) was generated from EX14.ASM using EX14.SUB and
  187.   the files mentioned above.
  188.  
  189.                 --Larry Steeger     11/20/82
  190. BIN or .OBJ) was generated from EX14.ASM using