home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / s / transfer.ark / TRANSFER.DOC < prev   
Encoding:
Text File  |  1989-09-27  |  6.6 KB  |  151 lines
  1.  
  2.  
  3.  
  4.                            **************************
  5.                            * TRANSFER DOCUMENTATION *
  6.                            *      version 1.0       *
  7.                            **************************
  8.  
  9.                                        by
  10.                                    David Koski
  11.                                   P.O. Box 1078
  12.                            Fort Bragg, CA  95437-1078
  13.  
  14.  
  15.  
  16.         I. INTRODUCTION
  17.  
  18.         TRANSFER is a utility that provides an easy method of transfering 
  19.         files  to  and  from  MS/DOS compatable disks with  a  CP/M  host 
  20.         system.   Written completely in Turbo Pascal,  it includes  these 
  21.         features:
  22.  
  23.                   - Full Access  of  directory of MS/DOS  with  ambiguous
  24.                     file reference
  25.  
  26.                   - Access   to   CP/M  directory  with  ambiguous   file 
  27.                     reference
  28.  
  29.                   - Display of MS/DOS FAT (File Allocation Table)
  30.  
  31.                   - FAT recovery from backup FAT (Careful!)
  32.  
  33.                   - File  transfer  to  and from  MS/DOS  using  PIP-like 
  34.                     ambiguous (wild card) file references
  35.  
  36.                   - Source code - - of course
  37.  
  38.  
  39.         II. INSTALLAtTION
  40.  
  41.         After making a working copy of the distribution disk,  with  your 
  42.         original  disk  in  a safe place you should  have  the  following 
  43.         files:
  44.  
  45.              TRANSFER.COM  TRANS-01.INC  TFR-INST.COM
  46.              TRANSFER.DOC  TRANS-02.INC  TFR-INST.MSG
  47.              TRANSFER.PAS  TRANS-03.INC  TFR-INST.DTA
  48.                            TRANS-04.INC
  49.                            TRANS-05.INC
  50.  
  51.         For  screen  functions  use TFR-INST,  a  GINST-made  instalation 
  52.         program.  Install TRANSFER the same way you install TURBO PASCAL. 
  53.         TFR-INST.MSG and TFR-INST.DTA are used by TFR-INST.COM.
  54.  
  55.         Now  the  BIOS in your system must know that your MS-DOS disk  is 
  56.         "foreign".   Many systems come with a utility to accomplish this.  
  57.         Your  BIOS usually not only must know the sector size of the  MS-
  58.         DOS  disk  (usually 512) but the Density (Double).  In short  You 
  59.         must  "tell" your BIOS that the drive with the MS-DOS disk in  it
  60.         is "IBM-PC DS" or something similar. For reasons mentioned above,
  61.         TRANSFER is system BIOS dependent.   If that wasn't enough,  each 
  62.         different  BIOS likes to do the BIOS function call  Sectran  it's 
  63.         own way.   Some systems need TRANSFER to call Sectran before each 
  64.         sector  read.   Also,  in some systems a sector bias needs to  be 
  65.         applied  to each BIOS call from TRANSFER.   These variations  are 
  66.         accomplished by patching the constants in the source TRANSFER.PAS 
  67.         and  recompiling.   Some  experimenting may  be  necessary.   For
  68.         example  some  Kaypros need "SO = 4" to give a sector bias of  4.
  69.         This  is  because of 4 CP/M records (128 bytes) are in  each  512
  70.         byte MS-DOS sector.
  71.  
  72.         Many  systems  automaticly identify newly logged  on  disks.  The
  73.         trouble  is they usually come up with the wrong inentity for  the
  74.         MS-DOS  disk  and often think it is single  sided.   If  you  are
  75.         unable to patch your BIOS to prevent this then you may be able to
  76.         use  single  sided  MS-DOS disks only,  or trick your  system  by
  77.         logging  on to a standard double sided disk first.  Then  without
  78.         warmbooting, bring up TRANSFER.  Systems with single sided drives
  79.         can  of coarse only transfer single sided disks and TRANSFER  may
  80.         need minor modification.
  81.  
  82.  
  83. ******************************************************************************
  84.  
  85.  
  86.                ---------- Version 1.2C (for C-128) ----------
  87.  
  88. This is the Commodore 128 CP/M adaptation of original TRANSFER version 1.0.
  89. It allows transfer of files between C-128 CP/M and MS-DOS disks. The four
  90. different types of MS-DOS disks can be used: single/double sided, 8/9 sectors
  91. per track.
  92.  
  93.  
  94. The enhancements made are:
  95.  
  96.  1) The new version can be used with a single C-1571 drive.
  97.  2) It can format MS-DOS disks.
  98.  3) It allows you to view a text file directly from a MS-DOS disk.
  99.  4) It can rename a file on MS-DOS disk.
  100.  
  101.  
  102. Things to be aware of when using this program:
  103.  
  104.  1) When C-128 displays a disk format selection at the bottom of the screen,
  105.     use the right/left arrow keys to make this format match the type of
  106.     MS-DOS disk in the drive.  Valid choices are MSDOS-1 DS or MSDOS-1 SS
  107.     (the 8 sector/track formats from older MSDOS versions), and MSDOS-2 DS
  108.     or MSDOS-2 SS (the newer 9 sector/track formats).  Do not choose
  109.     IBM-8 DS or IBM-8 SS as these are not MSDOS formats.  When the correct
  110.     format is displayed, the return key should be pressed to continue with
  111.     the program.
  112.  
  113.  2) Always use scratch disk as a "messenger disk" to carry files between
  114.     C-128 CP/M and a MS-DOS machine.  Avoid allowing one disk to be written
  115.     to by two different host systems, although it may seem harmless most of
  116.     the time.
  117.  
  118.  3) If you need to change disks, the best time to do it is when you see the
  119.     main selection menu displayed on the screen.  After changing disks
  120.     (before starting a new File Transfer operation) it is suggested that
  121.     you execute a dummy Directory operation just to log onto the new disk.
  122.     Otherwise, you may get the TURBO PASCAL error message such as "I/O
  123.     Error F0, Disk Write Error".  This is equivalent to the familiar CP/M
  124.     error message "BDOS Error, Read Only" caused by changing disks before
  125.     writing to it.
  126.  
  127.  4) While transferring many files by using a wildcard file designation,
  128.     the <ESC> key can be used, if desired, to abort the operation.
  129.  
  130.  5) Be careful with Menu Selection 7 (Restore FAT on MS-DOS).  Avoid using
  131.     this option unless you are absolutely sure you know what you are doing.
  132.     It can destroy your disk instantly.  What it does is restoring FAT area
  133.     number one using FAT area number two as the backup FAT.  But it does not
  134.     restore Directory area.  (This program modifies FAT area number one only,
  135.     and leaves the number two area untouched.)  In case you need to use this
  136.     option, the FAT Size in Sectors is 1 for MSDOS-1 DS and MSDOS-1 SS, and
  137.     2 for MSDOS-2 DS and MSDOS-2 SS.
  138.  
  139.  
  140. The present version (1.2C) employed techniques used by Frank Prindle in his
  141. C programs RDMS233C.C and UNIDRIVE.C, both of which were written to be run
  142. on C-128 with C-1571 drive.
  143.  
  144.  
  145. B-J Lee
  146. Nov 1987
  147. [71171, 3260]
  148.  
  149.  
  150. ******************************************************************************
  151.