home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / filutl / unload22.lbr / UNLOAD22.DZC / UNLOAD22.DOC
Encoding:
Text File  |  1987-09-10  |  2.8 KB  |  71 lines
  1.                                 UNLOAD22
  2.  
  3.      UNLOAD22 is derived from UNLOAD21, a venerable P.D. program that
  4. converts .COM files to .HEX files, the opposite of Digital Research's
  5. LOAD.COM.  This is useful if you want to send the data to a PROM
  6. programmer, send it to a 7 bit device like a paper tape punch, (in
  7. 1987?) or down a serial link where the .HEX file's built in checksum
  8. gives some degree of confidence in an ASCII transfer.
  9.  
  10.      Having used UNLOAD21 on a regular basis, I quickly found some
  11. deficiencies.  The most annoying was the fact that UNLOAD21 forced the
  12. input file to be a .COM file.  Not defaulted, FORCED.  As I was often
  13. UNLOADing files that weren't even 8080/Z-80 code, I didn't want these
  14. non-executable files called .COM files on my CP/M disk.  Makes for
  15. confusion, I prefer to call these files .CIM for Core IMage.  The next
  16. problem I found was in the EOF record.  UNLOAD21 output an EOF record
  17. (End Of File record) consisting of ten (10) ASCII zeros.  This is also
  18. the EOF record output by ASM.COM, MAC.COM, & maybe others.  This type of
  19. EOF record does not meet the Intel specification, and caused at least
  20. one PROM programmer I was working with to "choke".  The third problem
  21. was mainly one of preference.  A previous programmer had changed
  22. UNLOAD21 to output 32 byte data records, to conserve disk space.  This
  23. is perfectly legal, however it does reduce the reliability of the
  24. checksum.  I prefer the more standard 16 byte data record.
  25.  
  26.      All the above problems have been fixed with UNLOAD22!  The program
  27. defaults to a .COM filetype for the input file, but allows .CIM or other
  28. input filetypes as well.  The EOF record now meets the Intel
  29. specification.  The user now has the option of setting the output data
  30. record size.  (Defaults to 16)
  31.  
  32.  
  33.         Invoke as follows:
  34.  
  35. UNLOAD22 FILENAME<.EXT> <ADDR></X>
  36.  
  37.  
  38.         Where:
  39.  
  40.  
  41.          FILENAME  is the name of the file you wish to convert
  42.  
  43.          <.EXT>  is the extension, if not given, assumes .COM
  44.  
  45.          <ADDR>  is the load address, if not given defaults to 0100H
  46.  
  47.          </X>  is the data record size, if given after an address
  48.  
  49.          parameter, there must be no spaces!  Where X:
  50.  
  51.  
  52.         /S   Small, 8 bytes per data record, for max reliability
  53.  
  54.              (Within reason) of checksum.
  55.  
  56.  
  57.         /M   Medium, 16 bytes per data record, the old standby.
  58.  
  59.  
  60.         /L   Large, 32 bytes per data record, some prefer it because
  61.  
  62.              the resultant file is smaller.
  63.  
  64.  
  65.         /E   Extra large, 64 bytes per data record.  Produces even
  66.  
  67.              smaller files.
  68.  
  69. Notes by Mark D. Pickerill, SYSOP Hacker Heaven BBS, (408) 646-3547
  70. 9/5/87
  71.