home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / old / misc / cpmtools / mload.doc < prev    next >
Text File  |  2020-01-01  |  4KB  |  87 lines

  1.     MLOAD - a multi-file hex load utility for CP/M
  2.  
  3. Written by Ron Fowler, Fort Atkinson, Wisconsin.  This documentation
  4. was extracted from the source file (MLOAD21.ASM), with trivial 
  5. modifications.
  6.  
  7. This program is a replacement for the CP/M "LOAD" program.  Why replace
  8. "LOAD"?  Well... LOAD.COM has a few deficiencies.  For example, if your
  9. hex file's origin is above 100h, LOAD.COM prepends blank space to the
  10. output file to insure it will work as a CP/M transient.  It cares not if
  11. the file is not intended as a CP/M transient.  It also doesn't like hex
  12. records with mixed load addresses (for example, one that loads below a
  13. previous record -- which is a perfectly legitimate happenstance).  Also,
  14. LOAD.COM can load only one program at a time, and has no provision for a
  15. load bias in the command specification.  Finally, there is no provision
  16. for user specification of output file name. 
  17.  
  18. Hence, this program....
  19.  
  20. Command syntax is as follows:
  21.  
  22.     MLOAD [<outnam>=] <file1>[,<file2>...] [bias]
  23.  
  24. where:
  25.     <outnam> is the (optional!) output file name (only the drive
  26.     spec and primary filename may be specified; the output filetype
  27.     is derived exclusively from the 3-byte string at 103h within
  28.     MLOAD). 
  29.  
  30.     <filen> are the input files.  <file1> may specify an extension,
  31.     in which case it is assumed to be a binary file (starting at
  32.     100h).
  33.  
  34.     <bias> is the offset within the saved image to apply when
  35.     loading the file. 
  36.  
  37.  
  38. MLOAD with no arguments prints a small help message -- this message is
  39. also printed whenever a command line syntax error occurs. 
  40.  
  41. Filenames may contain drive specs, and must not contain wildcards.  Input
  42. filenames must be separated by commas, and a space is required between
  43. the last filename and the optional bias.  Note that ZCPR2-style
  44. drive/user notation may be used in all file specifications (e.g.,
  45. "B3:MYFILE.COM, "A14:MDM7.HEX"). 
  46.  
  47. A load information summary is printed at the successful conclusion of
  48. the load.  Any errors in loading will generally include the name of the
  49. file in question. 
  50.  
  51. If no output filename is specified, it will be derived from the first
  52. input filename, with filetype of 'COM' (this default filetype may be
  53. patched directly into MLOAD via DDT -- its location is at 103h in
  54. MLOAD.COM).  Note that a command line of the form "C:=<filename>" will
  55. place the output file on the "C" drive with the same primary filename as
  56. the first input file. 
  57.  
  58. In its simplest form, MLOAD's syntax is identical to LOAD.COM; thus
  59. there should be no problem in learning to use the new program.  The only
  60. significant difference here is that, under LOAD.COM, all files are
  61. output starting at 100h, even if they originate elsewhere.  MLOAD
  62. outputs starting at the hex file origin (actually, the first hex record
  63. specifies the output load address).  The bias option may be used to
  64. override this. 
  65.  
  66. An example should clarify this.  Suppose you have a file that loads at
  67. 1000h.  LOAD.COM would save an output file that begins at 100h and loads
  68. past 1000h (to wherever the program ends).  MLOAD will save an output
  69. file starting from 1000h only.  If, for some reason you need the file to
  70. start at 100h in spite of its 1000h origin (I can think of several
  71. circumstances where this would be necessary), you'd have to specify a
  72. bias to MLOAD.  Thus, using this example, "MLOAD MYFILE 0F00" would do. 
  73.  
  74. Note that this program re-initializes itself each time it is run. Thus,
  75. if your system supports a direct branch to the TPA (via a zero-length
  76. .COM file, or the ZCPR "GO" command), you may safely re-execute MLOAD. 
  77.  
  78. Please report any bugs, bug fixes, or enhancements to me at:
  79.  
  80.         "Fort Fone File Folder" RCPM/CBBS
  81.         Fort Atkinson, Wisconsin
  82.         (414) 563-9932 (no ring back)
  83.  
  84.                 --Ron Fowler
  85.                   03/08/84
  86.  
  87.