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 / ENTERPRS / CPM / UTILS / S / SUPERMIT.ARK / SUPERMIT.DOC < prev    next >
Text File  |  1989-09-27  |  9KB  |  277 lines
  1. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  2. SUPERMIT.DOC, Vers. 3.0
  3. Copyright 1986, Logic Associates, Chicago
  4. 4/5/86
  5.  
  6.  
  7.                        SUPERMIT (TM), Vers. 3.0
  8.  
  9.          For all versions of CP/M 2.2 and most 8080/Z80 relatives.
  10.                (CP/M 3, CP/M+, ZCPR, probably MP/M, etc.)
  11.  
  12.  
  13.    []  A batch-job programming language, similar to BASIC.
  14.  
  15.    []  Includes several uniquely flexible, stand-alone utilities.
  16.  
  17.    []  SUPERMIT Version 3.0--
  18.  
  19.     o  Provides virtually universal compatibility with CP/M's
  20.        "family and friends."
  21.  
  22.         o  Fixes miscellaneous, minor problems in earlier versions.
  23.  
  24.  
  25.  
  26.     ("CP/M" is a registered trademark of Digital Research, Inc.)
  27.  
  28. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  29.  
  30. BACKGROUND:  Batch jobs
  31.  
  32.  
  33. The SUBMIT utility of CP/M lets your computer do your typing for you. 
  34.  
  35. Instead of typing each of a sequence of individual commands at the time
  36. needed, you can put all the commands into a disk file, and tell CP/M to
  37. get commands from disk instead of the console.  Then, while your system
  38. is busy doing all the work, you put up your heels, relax, and read the
  39. newspaper.
  40.  
  41. If you have a set of commands that can be expressed as a straight-forward,
  42. once-through sequence of steps, a standard SUBMIT job will do the trick.
  43.  
  44. But unlike a true program, such a job isn't very bright.  It can't--
  45.  
  46.    1)  Perform a job step only if conditions warrant.
  47.  
  48.    2)  GO TO different job steps.
  49.  
  50.    3)  Create and manipulate dynamic variables.
  51.  
  52.    4)  Use arrays, loops, or other basic programming structures.
  53.  
  54. In effect, standard batch jobs operate as though each command were being
  55. read off the top of a deck of punched cards, and then discarded.
  56.  
  57. SUPERMIT rescues batch jobs from the era of the punched card.
  58.  
  59.  
  60.  
  61. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  62.  
  63. THE SUPERMIT CONCEPT
  64.  
  65.  
  66. SUPERMIT gives batch jobs a "BASIC-like" capability.
  67.  
  68. SUPERMIT brings to SUBMIT files the three essential elements of
  69. programming--
  70.  
  71.         o  IF...THEN...ELSE
  72.         o  GOTO
  73.         o  dynamic variables
  74.  
  75.  
  76. The result is a quantum leap in the power of batch jobs.
  77.  
  78. *  IF...THEN...ELSE allows job steps to be executed or bypassed
  79.    according to environmental conditions, including "result" codes
  80.    from previous steps.
  81.  
  82. *  GOTO can jump to any line within the job.
  83.  
  84. *  FOR...NEXT, DO...WHILE, and ON...GOTO structures can be created
  85.    to allow looping and branching among job steps.
  86.  
  87. *  Nesting is available for IF...THEN...ELSE, for commands, and even
  88.    for variables.
  89.  
  90. *  String variables can be up to 120 characters long.
  91.  
  92. *  Single-dimensioned string arrays are supported.
  93.  
  94. *  Numeric variables can have up to 8-digit precision.
  95.  
  96. *  Filenames can be added, subtracted, multiplied, and/or divided.
  97.    (Wild cards are supported.)
  98.  
  99. *  Filename characters can be replaced, transposed, and/or deleted.
  100.    (Wild cards are supported.)
  101.  
  102. *  Subroutines and subjobs are feasible.
  103.  
  104.  
  105. None of this diminishes the space available in main memory to run
  106. programs.  All SUPERMIT modules are totally transient.
  107.  
  108. And like BASIC, the SUPERMIT modules help job-writing by providing
  109. extensive run-time diagnostics.
  110.  
  111.  
  112.  
  113. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  114.  
  115. SUPERMIT MODULES
  116.  
  117.  
  118.                                                              Works with CP/M--
  119. Module          Function                             Version       2.2      clones
  120. ------------  ---------------------------------  -------     -----------------
  121.  
  122.  
  123. SUPERMIT.DOC  This text file.                      3.0
  124.  
  125. IF.COM        Like the IF command in BASIC.       3.0          X        Some
  126.  
  127. IF+.COM       = IF.COM with some limitations.      3.0          X          X
  128.  
  129. #.COM         ("ARRAY.COM") Extracts a line       3.0          X        Some
  130.           from any standard text file,
  131.           inserts into command line.
  132.  
  133. #+.COM        = #.COM with some limitations.       3.0          X          X
  134.  
  135. GOTO.COM      Like the GOTO command in BASIC.      3.0          X        Some
  136.  
  137. SET.COM       Like the LET command in BASIC.       3.0          X          X
  138.           Treats filenames like variables.
  139.  
  140. SUPTEST1.SUB  Test for IF, #, GOTO, and SET.       3.0          X        Some
  141.  
  142. SUPTEST2.SUB  Test for IF+, #+, GOTO, and SET.     3.0          X        Some
  143.  
  144. SUPTEST3.SUB  Test for IF+, #+, and SET.           3.0          X          X
  145.  
  146.  
  147.  
  148. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  149.  
  150. INSTRUCTIONS
  151.  
  152.  
  153. Condensed instructions for each module are displayed by that module
  154. when it is executed without parameters.  For instance, to display
  155. instructions for IF.COM, simply type--
  156.  
  157.        IF<cr>           where "<cr>" means the RETURN or ENTER key.
  158.  
  159. The instructions also tell how to get the complete SUPERMIT User's
  160. Manual for $9.95.
  161.  
  162. We recommend purchasing the User's Manual, which contains additional
  163. instructions, helpful shortcuts, and programming tips.  Items include--
  164.  
  165.     o  How to write FOR...NEXT and other loops.
  166.  
  167.     o  How to restart a job at any desired step without reprogramming.
  168.  
  169.     o  How to create executable libraries that are more compact
  170.        than .LBR files, and yet can be changed with any text editor.
  171.  
  172.     o  How to write conditional compile/link/go jobfiles.
  173.  
  174.     o  How to write complex conditionals with IF.COM.
  175.  
  176.     o  How to use multiple string-operations to rename any file.
  177.  
  178.     o  How you might inadvertently disable the nesting capability
  179.        of IF.COM and #.COM.
  180.  
  181.     o  How to create and invoke jobstep subroutines.
  182.  
  183.  
  184.  
  185. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  186.  
  187. "+" VERSIONS
  188.  
  189.  
  190. The plus versions of IF.COM and #.COM were adapted for compatibility
  191. with CP/M+.  They are fully usable with CP/M 2.2 and most of its clones.
  192.  
  193. The plus versions are identical in function to their counterparts, but
  194. do not recognize the resident commands of the CCP.  In standard CP/M 2.2,
  195. these resident commands are TYPE, ERA, USER, SAVE, and DIR.
  196.  
  197. If any of these resident commands are needed for use with the plus
  198. versions, a suitable utility program can be created or obtained that
  199. performs the same function.
  200.  
  201. For instance, XDIR.COM or SD.COM may be used instead of DIR.  And
  202. instead of the ERA command, a simple four-line assembly language
  203. program can be created, called ERA.COM.  (Complete instructions for
  204. creating ERA.COM are given in the SUPERMIT User's Manual.)
  205.  
  206.  
  207.  
  208. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  209.  
  210. WHICH MODULES SHOULD I USE?
  211.  
  212.  
  213. Three tests for compatibility are provided:  SUPTEST1.SUB, SUPTEST2.SUB,
  214. and SUPTEST3.SUB.  They are numbered in order of decreasing functionality.
  215.  
  216. Begin testing by reading the test instructions contained in SUPTEST1.SUB,
  217. then executing that test.  If the test is successful, you can use modules
  218. IF, #, GOTO, and SET.  This set of modules comprises the fullest set of
  219. SUPERMIT functions.
  220.  
  221. If SUPTEST1.SUB is not completely successful, read the instructions contained
  222. in SUPTEST2.SUB and then execute it.  If this test is successful, you can
  223. use modules IF+, #+, GOTO, and SET.  This set of modules contain essentially
  224. the same functions as those in SUPTEST1.SUB.
  225.  
  226. (The "plus" modules are implemented in a different manner from the others,
  227. to make them compatible with a wider variety of CP/M look-alikes.  The trade-
  228. off is that the "plus" modules cannot execute the resident commands of the
  229. CCP:  TYPE, DIR, ERA, USER, and SAVE.)
  230.  
  231. If SUPTEST2.SUB encounters an error, examine and execute SUPTEST3.SUB.
  232. This is equivalent to SUPTEST2.SUB without the GOTO module.  (The SUPERMIT
  233. manual tells how to emulate GOTO if your system cannot use the GOTO module.)
  234.  
  235. No errors should occur when executing SUPTEST3.SUB.  If any do, please
  236. contact Logic Associates at the address given below.
  237.  
  238.  
  239.  
  240. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  241.  
  242. COPYRIGHT
  243.  
  244.  
  245. Each SUPERMIT module is copyrighted by Logic Associates.
  246.  
  247. Logic Associates hereby permits non-commercial distribution and use
  248. of SUPERMIT, provided all the modules of SUPERMIT are distributed
  249. together and without alteration of any kind.  If changes are necessary,
  250. please notify Logic Associates.
  251.  
  252.  
  253.  
  254. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  255.  
  256. CORRESPONDENCE
  257.  
  258.  
  259. We welcome your comments and suggestions.  You can write us at--
  260.  
  261.         Logic Associates
  262.         1433 W. Thome
  263.         Chicago, IL 60660
  264.  
  265.  
  266. Thank you.  We're sure you'll find SUPERMIT a unique and useful product.
  267.  
  268.                                             Sincerely,
  269.  
  270.                                                 Roy Lipscomb,
  271.                                                 Logic Associates
  272.  
  273.  
  274.  
  275. <><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><><>
  276. (end)
  277.