home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / MBUG / MBUG020.ARC / BASPAT3.DOC < prev    next >
Text File  |  1979-12-31  |  4KB  |  119 lines
  1. BASPAT3 (AUTO-LOAD FOR MICROWORLD DISK TINY BASIC) DOCUMENTATION
  2. by Julian Loke, 13th January 1986
  3. No distribution for profit without author's express permission.
  4.  
  5. UPDATES
  6.  
  7. BASPAT.HEX     Original loader patch
  8. BASPAT2.HEX    Fix for KEY$ bug in BASPAT.HEX
  9. BASPAT3.HEX    Fix for Empty file error message
  10.  
  11. END OF UPDATE DOCUMENTATION
  12.  
  13.                           INTRODUCTION
  14.  
  15.      It is often useful to invoke programs from the CP/M  command 
  16. level,  especially  for those who appreciate the features of  the 
  17. SUBMIT  and XSUB utilities,  and for those who like turn-key disk 
  18. systems.
  19.  
  20.      Unfortunately  my  version of MicroWorld BASIC  (TM  Applied 
  21. Technology)  did not support this otherwise  "standard"  feature.  
  22. So, to get an application program up and running, I had to invoke 
  23. BASIC, then load and run the application.
  24.  
  25.      This  file  describes  an  auto-load  patch  program   which 
  26. replaces  the standard BASIC loader.   With this patch installed, 
  27. it is possible to type the name of the application program at the 
  28. CP/M command level.   For example, if you wished to run the BASIC 
  29. program ACCOUNTS.MWB, you could type:
  30.  
  31.                         A>basic accounts
  32.  
  33. The lower case letters are typed by the user.   BASIC would load, 
  34. then  the  file  ACCOUNTS.MWB would be  loaded  into  memory  and 
  35. executed.
  36.  
  37.                          USAGE AND NOTES
  38.  
  39.      The syntax for the auto-load patch appears below:
  40.  
  41.                  BASIC [ [ <d> : ] <filename> ]
  42.  
  43. Notes:
  44.      1)   No parameters- load and run BASIC without auto-load.
  45.           e.g.
  46.                          A>basic
  47.  
  48.      2)   With parameter- load BASIC then run <filename>.MWB
  49.           e.g.
  50.                          A>basic b:inventry
  51.  
  52.           In this example,  BASIC will load, then drive B will be 
  53.           searched  for the file  INVENTRY.MWB.   If  found,  the 
  54.           program is loaded and executed.
  55.      3)   A  filetype of .MWB is assumed.  ONLY files which  were 
  56.           created  using BASIC's SAVE command can be run in  this 
  57.           way.
  58.  
  59.  
  60.                     ERRORS AND ERROR MESSAGES
  61.           
  62.      1)   No File.
  63.                The program file could not be found.  BASIC aborts 
  64.           back to the CP/M command level.
  65.  
  66.      2)   Empty File.
  67.                The  program  file  was not long enough  to  be  a 
  68.           program file.   Check to see that it was created  using 
  69.           BASIC's SAVE command.
  70.  
  71.      3)   Bad patch version.
  72.                If you get this message,  your version of BASIC is 
  73.           not supported by the auto-load patch.  A new patch will 
  74.           need to be written and installed.   If this needs to be 
  75.           done, please drop me a line via the MBUG bulletin board 
  76.           (Melbourne Australia 03-82-1571 (24hrs)).
  77.  
  78.  
  79.                       INSTALLING THE PATCH
  80.  
  81.      To install the patch, you will need the following files:
  82.  
  83.           BASIC.COM      your copy of MicroWorld Tiny BASIC
  84.           BASPAT3.HEX    the auto-load patch
  85.           DDT.COM        a standard CP/M utility
  86.  
  87.      Make sure that you have backed-up all your files,  and  that 
  88. you are not altering your master disk.
  89.  
  90.      Use the following command sequence to install the patch onto 
  91. the file ABASIC.COM.   Once the patched version is tested, it can 
  92. be  renamed to BASIC.COM.  (Note that the lower case letters  are 
  93. typed by the user.)
  94.  
  95.                A>ddt basic.com
  96.                DDT VERS 2.2
  97.                NEXT  PC
  98.                4900 0100
  99.                -ibaspat3.hex
  100.                -r
  101.                NEXT  PC
  102.                4900 0000
  103.                -g0
  104.  
  105.                A>save 72 abasic.com
  106.                A>
  107.  
  108.      Don't worry if DDT's NEXT display shows 4700.  What YOU type 
  109. remains the same.
  110.      You  can now test BASIC with the AUTO-LOAD patch.   See  the 
  111. USAGE  AND  NOTES  section for more information.   Once  you  are 
  112. satisfied that all is well, rename ABASIC.COM back to BASIC.COM.
  113.  
  114.                A>era basic.bak
  115.                A>ren basic.bak=basic.com
  116.                A>ren basic.com=abasic.com
  117.  
  118. END OF DOCUMENTATION
  119.