home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / rdcbm21.arc / RDCBM.DOC < prev   
Encoding:
Text File  |  1989-09-27  |  7.9 KB  |  164 lines
  1.                                    RDCBM
  2.  
  3.                    A Commodore To CP/M File Copy Utility
  4.  
  5.                              By Rob Tillotson
  6.    
  7.                          Version 2.1 - Mar. 8, 1987
  8.  
  9.                 Copyright 1986,1987 by TurboPenguin Software
  10.  
  11.  
  12.  
  13.         This program is a general purpose file copier, which copies from a
  14.     Commodore DOS format disk to a CP/M disk.  It is designed to be faster
  15.     and more convenient to use than any of the existing CBM->CP/M copiers.
  16.     It uses burst mode on 1571 drives, and can write to the 17xx RAM
  17.     expander or to a 1571 onto any format disk the drive supports.  It does
  18.     not require you to exit from CP/M to use it, as it is a CP/M transient
  19.     utility.
  20.         Version 2.1 adds some support for GEOS disks.  Now, GEOS files will
  21.     be displayed in the directory with their GEOS filetype, time/date
  22.     stamp, and write protect status.  If the disk is a GEOS disk, this fact
  23.     will be noted, as will be the presence of the "Master" or "Boot" flag. 
  24.     Also, the Off-Page Directory Block will be searched whenever a file is
  25.     opened or the directory is displayed.  Finally, a new option is
  26.     available on the menu which will display the Information Block of a
  27.     GEOS file.
  28.         Other small improvements include a "[more]" pause at the end of
  29.     each screen page during a directory listing or text file viewing, and
  30.     the display of the disk name and ID at the top of the directory.
  31.  
  32.     Hardware requirements are as follows:
  33.  
  34.         o A Commodore 128 computer
  35.  
  36.     o At least one 1541 or 1571 disk drive (1571 recommended)
  37.  
  38.     o Optional but recommended 1700 or 1750 RAM expansion
  39.  
  40.  
  41.         The program is set up to operate with two drives, and in fact this
  42.     decreased the code size substantially.  However, it works reasonably
  43.     well with one floppy if you select drive E as the second drive.
  44.  
  45.         RDCBM expects to find a Commodore DOS disk in one drive, and a CP/M
  46.     disk in the other.  The Commodore drive must be a real floppy, either
  47.     1571 or 1541.  The CP/M drive may be a physical drive, or a pseudo-
  48.     drive such as E: or M: if you have a RAM expander.  The program
  49.     defaults to Commodore disk in A: and CP/M disk in M:; these may be
  50.     changed at the main menu.
  51.  
  52.         When copying, RDCBM uses an internal 24k buffer to hold file data,
  53.     to cut down on the amount of disk swapping necessary on a one drive
  54.     system, and to reduce the number of file operations performed on the
  55.     CP/M disk.  The net effect of this is that when you copy to drive E:,
  56.     you only have to swap disks every 24k or when the file is complete.
  57.  
  58.         To use this program, place RDCBM.COM on any active drive, and type
  59.     RDCBM.  The program will load and a menu will be displayed, along with
  60.     the letters of the selected drives.  At this time, you should place the
  61.     Commodore disk in the drive you wish to copy from.  If you do not like
  62.     the default drive choices, use the P option to change them.
  63.  
  64.         To select an option, type it's letter in upper or lower case alone
  65.     at the prompt and hit return.  The options are:
  66.  
  67.     [B] Binary CBM -> CP/M Copy
  68.  
  69.         Copies a BINARY file from the Commodore disk to the CP/M
  70.         disk.  No conversions are done.
  71.  
  72.     [D] Directory of CBM Disk
  73.  
  74.                 Displays the directory of the Commodore disk, in a
  75.                 reasonably Commodore-like format.  GEOS files will
  76.                 have all of their pertinent information displayed:
  77.                 type, structure, size in K, time/date stamp, and a
  78.                 reversed block for write protect.  If the disk is a
  79.                 GEOS one, the Off-Page Directory will be searched as
  80.                 well.
  81.  
  82.                 Please note that since GEOS uses true ASCII, GEOS file
  83.                 names aren't readable when treated as Commodore ASCII.
  84.                 Therefore, GEOS file names will be displayed AS YOU
  85.                 WOULD SEE THEM UNDER GEOS, not as they would appear in
  86.                 the Commodore directory.  In any case, when entering a
  87.                 file name, enter it as you see it in the directory
  88.                 shown by this program.  Since GEOS and Commodore files
  89.                 are non-interchangeable, this should not present a
  90.                 problem... just be aware that the directory you see in
  91.                 this program might not match the one you see when you
  92.                 view it in 128 or 64 mode.
  93.  
  94.         [I] Information on a GEOS File
  95.  
  96.                 This option prompts for the name of a GEOS file on the
  97.                 CBM disk.  It will display all of the information,
  98.                 except the icon, from the Information Block of the
  99.                 file.  This is very similar to the "info" menu
  100.                 selection under GEOS DeskTop, but gives a bit more
  101.                 information.
  102.  
  103.     [S] Select Drives
  104.  
  105.         Change the drives used to copy from and to.  Simply
  106.         type the letter of the drive and hit return when you
  107.         are prompted.
  108.  
  109.     [T] Text CBM -> CP/M Copy
  110.  
  111.         Copy a TEXT file from the Commodore disk to the CP/M
  112.         disk.  The file is converted from Commodore-ASCII to
  113.         true ASCII, and linefeeds are inserted after carriage
  114.         returns.  Use this on text files.
  115.  
  116.     [V] View CBM Text File
  117.  
  118.         Similar to [T], but displays the file instead of
  119.         copying it.
  120.  
  121.     [X] - Exit to CP/M.
  122.  
  123.  
  124.     Entomology and Comments
  125.     -----------------------
  126.  
  127.         This is the third release of RDCBM.  The first one was an
  128.     incredibly bug-infested and slow hack.  Version 2.0 was the first
  129.     usable version... at that time, I converted it to Turbo Pascal.  The
  130.     result was much faster and worked well.  This is version 2.1, which
  131.     adds a few new capabilities to version 2.0.
  132.         As you may notice, most of the improvements have to do with GEOS. 
  133.     I feel GEOS support is important, because soon it will be THE Commodore
  134.     operating system.  It is an orders of magnitude better than Commodore
  135.     DOS, and I expect that more and more software will be GEOS compatible
  136.     in the future.  Since an 80-column version of GEOS for the 128 will be
  137.     out soon, it will be even more important to 128 owners.
  138.         Now, to the bugs.  Number one is really a feature, but since it may
  139.     be surprising to some people I should mention it anyway.  Like the two
  140.     versions before it, this version of RDCBM ignores the Commodore file
  141.     type when it copies a file.  I don't intend to change this in the
  142.     future.  Anyway, this has some interesting results.
  143.         Copying a PRG file will give you the whole file, including the two-
  144.     byte load address at the beginning.  Since the first two bytes are
  145.     often NOT a load address, they will be copied and if you don't want
  146.     them you must edit them out later.  Copying a REL file will give you
  147.     the contents of the data portion of the file, in fixed-length records
  148.     of the length specified when the file was created.
  149.         Number two bug is that it will not work on a 1571-format disk in a
  150.     1541.  So far, I haven't found a reliable way to determine the type of
  151.     drive, and the CP/M BIOS does not mask off improper track numbers.  So
  152.     if you attempt to read a file from the back of a 1571 disk with a 1541,
  153.     the 1541 will try to read a track number higher than 35.  This can
  154.     cause the drive head to jam outside of normal range.  To reset the
  155.     head, issue a "format" command without a disk in the drive.  If this
  156.     doesn't work after several tries, open the drive and move the head back
  157.     manually.  As you can see, it's better to avoid the problem entirely.
  158.         Finally, I do plan to make more improvements to RDCBM in the
  159.     future.  Version 2.2 should add support for copying GEOS text and
  160.     program files, and GEOS Note Pad and Text Scrap support.  After that, I
  161.     plan to add the ability to write to CBM disks.
  162.  
  163.         Enjoy.
  164. nd GEOS