home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / dskutl / read-pc.lbr / READ-PC.DZC / READ-PC.DOC
Text File  |  1987-07-06  |  11KB  |  199 lines
  1.                                 Documentation
  2.                                      for
  3.  
  4.                                    READ-PC
  5.  
  6.                        Version 1.0 -- 23 February 1986
  7.  
  8. Author:  TS Kelso
  9.          SYSOP - Celestial RCP/M
  10.          8000 B West Gate Blvd
  11.          Austin, TX   78745-6815
  12.          RCP/M:  (512) 892-4180        300/1200 Baud, 24 Hours
  13.  
  14. READ-PC is a Turbo Pascal program which permits CP/M systems to transfer files 
  15. from IBM PC-DOS/MS-DOS diskettes to CP/M diskettes.
  16.  
  17. Public Domain Notice
  18. --------------------
  19. The source code for READ-PC is placed in the public domain for unrestricted 
  20. private use with the sole requirement that the notice stating its origin 
  21. remain in the code.  The code may be modified, as needed, to support user 
  22. requirements, however, only the unmodified source code may be distributed in 
  23. the public domain.  The use of this code for commercial purposes without 
  24. express written permission from the author is strictly prohibited.
  25.  
  26. Requirements
  27. ------------
  28. READ-PC is a bare bones package which should run on any standard CP/M system 
  29. that meets the following requirements:
  30.  
  31.   (1)  Minimum of one 5 1/4" double-density soft-sector disk drive and one 
  32.        other disk drive of any type.  It is preferable that the 5 1/4" drive 
  33.        be double-sided, otherwise, it will be incapable of handling double-
  34.        sided PC-DOS/MS-DOS diskettes.
  35.  
  36.   (2)  Standard CP/M or compatible operating system.  READ-PC accesses the IBM 
  37.        configured drive through the use of standard CP/M BDOS and BIOS calls.  
  38.        If your system does not support the standard implementation described 
  39.        in Digital Research's documentation, this program will not work.
  40.  
  41.   (3)  The ability to configure the 5 1/4" drive to read a format which is 
  42.        compatible with that used for PC-DOS/MS-DOS diskettes.  Per the MS-DOS 
  43.        Technical Information, this requires the drive to be able to read 40-
  44.        track (48 tpi), soft-sectored, double-density diskettes with nine 512-
  45.        byte sectors per track.  Again, it should be capable of supporting 
  46.        double-sided diskettes if you want to read them.
  47.  
  48. Motivation
  49. ----------
  50. READ-PC was developed to provide a means for transferring PC-DOS/MS-DOS files 
  51. from 5 1/4" diskettes to CP/M files to satisfy a personal need.  The author 
  52. owns a 8086/8087 MS-DOS system which uses only 8" drives.  As a result, he had 
  53. no way to transfer files to that system from 5 1/4" PC-DOS/MS-DOS diskettes 
  54. except via modem (since no currently available software was available to fill 
  55. this need).
  56.  
  57. Unfortunately, this is inconvenient for large data files and usually 
  58. impossible for proprietary software purchases.  Fortunately, however, he also 
  59. owns a Heathkit H-89 (which runs the Celestial RCP/M) that, with its Magnolia 
  60. disk controller, provides a method (when combined with the appropriate 
  61. software, i.e., READ-PC) of satisfying this need through a transfer to CP/M 
  62. files.  While you may not have identical needs, this program will permit you 
  63. to transfer ASCII text or other data files from IBM PC compatible diskettes 
  64. for use on your CP/M system.
  65.  
  66. Operating READ-PC
  67. -----------------
  68. To run READ-PC, you must first compile the source code using Turbo Pascal.  
  69. The only system dependent features requiring possible modification are those 
  70. pertaining to the arrangement of drives on your system.  You must set LDrive 
  71. (almost always the A: drive), HDrive (the highest drive in your system), and 
  72. then the source (PC-DOS/MS-DOS), and target (CP/M) drives.  Current settings 
  73. are:
  74.  
  75.        LDrive = 'A'       HDrive = 'D'
  76.        source = 'D'       target = 'C'
  77.  
  78. To compile, use the Option command, select Compile, and set Start = 2500.  The 
  79. start address MUST be 2500H or greater to work!  Then Quit and Compile.  The 
  80. resulting file READ-PC.COM is now ready to go.
  81.  
  82. You may place READ-PC.COM on any CP/M diskette in your system, but if you put 
  83. it on the target drive, be sure that you will still have enough room to 
  84. receive all the files from the source drive.  Before executing READ-PC, be 
  85. sure that you have configured the source drive, if necessary.  If you forget, 
  86. you will be reminded when you run READ-PC.
  87.  
  88. There may be many ways of configuring the source drive to be 'IBM compatible'.  
  89. Your system may already use a compatible disk format.  On the Heathkit H-89 
  90. with Magnolia disk controller there is a program named MODE which allows 
  91. several different formats to be read.  As it turns out, the MMS format is IBM 
  92. compatible.  Users of the TRS-80 Model 4 with Montezuma Micro's CP/M have a 
  93. transfer utility which supports numerous CP/M formats.  They can even specify 
  94. a user defined format.  Owners of UNIFORM also have this ability.  All these 
  95. users need to do is specify the source drive as an IBM compatible format.
  96.  
  97. Now, place the source diskette in the source drive and a pre-formatted CP/M 
  98. diskette (with adequate space) in the target drive and type 'READ-PC'.  A 
  99. brief description of the program will be printed and then you will be asked if 
  100. you have configured the source drive.  Respond 'Y' or 'N' (no carriage return 
  101. is necessary).  If you respond 'Y', the program will show which drive you have 
  102. designated as source and which is the target.  You may hit any key to begin 
  103. the file transfer.
  104.  
  105. The program begins by reading both copies of the File Allocation Table and 
  106. compares them for errors.  If a miscompare occurs, an error message will be 
  107. displayed on line 24, followed by the number of miscompares.  If this happens, 
  108. one of two problems has occurred:  either the diskette does not conform to MS-
  109. DOS standards or there is an actual error in either (or both) FATs.  Since 
  110. this will almost certainly result in an unsuccessful transfer, the program 
  111. terminates under these circumstances.
  112.  
  113. The user may, however, modify the code to continue with the transfer.  Simply 
  114. remove the 'goto exit' statement in the main program where the FAT compare is 
  115. performed.  The transfer will continue to attempt the transfer.  There is no 
  116. need to be concerned about damage to your system if the FAT is actually 
  117. corrupted, since the program does limit checking on track and sector numbers.  
  118. If a corrupted FAT entry specifies an out-of-limit value, an error message 
  119. will display on line 24 and execution will continue.
  120.  
  121. If this happens, you are advised to type ^S followed by a ^C to terminate 
  122. execution since an obvious FAT error exists.  If you wish to attempt the 
  123. transfer using the second FAT instead of the first, simply change all 
  124. references to "FAT[1,...]" to "FAT[2,...]" in Function Next_Cluster and in the 
  125. main program where the Media Descriptor Byte is read (total of three 
  126. occurrences).  Then the program will use the second FAT to attempt to perform 
  127. the transfer.
  128.  
  129. The program then reads the Media Descriptor Byte as specified in the MS-DOS 
  130. Technical Information.  READ-PC uses this byte to determine whether the 
  131. diskette is single or double-sided.  Currently, only two values are recognized  
  132. and they are assumed to be as specified in MS-DOS documentation.  If the value 
  133. read is not one of these two values, the program will terminate.  Should this 
  134. happen, one of two things has occurred: either the format uses eight 512-byte 
  135. sectors per track (which READ-PC is not programmed to handle) or there is an 
  136. error in the File Allocation Table (FAT).  Under normal conditions, this 
  137. should not happen.
  138.  
  139. Once these hurdles have been cleared, the program begins reading the directory 
  140. and transferring the files, one at a time.  As each file is located, its name, 
  141. the time and date of its creation, and its size in bytes are displayed.  As 
  142. the transfer continues, each cluster number in the file is echoed, along with 
  143. the track and sector being accessed.  Any error conditions along the way are 
  144. reported on line 24.
  145.  
  146. That's about it.  When all files have been transferred, the program says so 
  147. and quits.  You now have the files (with their original filenames) as files on 
  148. your CP/M target diskette.  Enjoy!
  149.  
  150. Limitations
  151. -----------
  152. This is the first release of READ-PC (and depending upon user feedback, may 
  153. also be the last) and, as a result, there are still some limitations.  Future 
  154. releases should be expected to incorporate one or more of the following 
  155. features:
  156.  
  157.   (1)  Prompting of the user for the source and target drives.
  158.  
  159.   (2)  Prompting as to whether to continue with file transfer after discovery 
  160.        of a FAT miscompare.  If yes, transfer will be attempted first using 
  161.        FAT 1.  On discovery of an out-of-limit error condition, transfer would 
  162.        then continue with FAT 2 (going back to the beginning of the file in 
  163.        which the error occurred).
  164.  
  165.   (3)  Depending upon user needs, other values of the Media Descriptor Byte 
  166.        will be incorporated.
  167.  
  168.   (4)  Incorporation of code to directly modify the Disk Parameter Block in 
  169.        CP/M to support the source drive.  This would permit users not having 
  170.        any other way of configuring the source drive to use READ-PC.
  171.  
  172.   (5)  The current version of READ-PC makes no attempt to transfer files 
  173.        contained in sub-directories.  Since the need for the use of sub-
  174.        directories on 5 1/4" diskettes is normally not necessary or can be 
  175.        avoided, it is assumed that all files are in the root directory.  If 
  176.        this perception is incorrect, this feature will be corrected in a 
  177.        future release.
  178.  
  179. There is currently no intention of adding a capability to write to PC-DOS/MS-
  180. DOS diskettes.  Many IBM compatible systems already have utilities which 
  181. permit transferring CP/M files to PC-DOS/MS-DOS systems and there is no 
  182. perceived demand for such a capability here.
  183.  
  184. What to do if you don't have Turbo Pascal
  185. -----------------------------------------
  186. If you do not have the Turbo Pascal compiler, you may leave a message on the 
  187. Celestial RCP/M stating your computer (terminal) type, the drive you wish to 
  188. use to read the PC-DOS/MS-DOS diskettes from, and the CP/M drive you wish to 
  189. have them transferred to.  I will compile a copy for you and place it on the 
  190. system for you.
  191.  
  192. Further Information
  193. -------------------
  194. Requests for further information or questions on how to use, configure, or 
  195. expand READ-PC should be referred to the Celestial RCP/M at (512) 892-4180 or 
  196. sent by mail to the address at the beginning of this documentation file.
  197.  
  198.                                        - TS Kelso
  199.