CPDOS.DOC    12/31/81
  BY  ALEX MALUTA

CPDOS IS A UTILITY THAT ALLOWS TRANSFERRING FILES FROM
AN APPLE CP/M DISK TO A APPLE DOS 3.3 DISK.
   THE PROGRAM RUNS UNDER APPLESOFT (ROM) AND DOS 3.3.
IT USES THE RWTS SUBROUTINE TO SEARCH THE CP/M DISK FOR
THE DESIRED FILE, DUMP IT SECTOR BY SECTOR INTO MEMORY,
AND THEN SAVE IT TO A DOS DISK.
   IT IS PRESENTLY CONFIGURED FOR THE FOLLOWING SETUP:
      48K APPLE II
       2 DRIVES IN SLOT 6
       APPLESOFT IN ROM
IT WILL TRANSFER ANY TYPE OF CP/M FILE (AS LONG AS IT IS
NO LONGER THAN 30208K BYTES LONG), BY TREATING IT PURELY
AS DATA.  THEREFORE, IT IS POSSIBLE TO TRANSFER .BAS, .HEX

  THE PROGRAM WAS GENERALLY DESIGNED TO TRANSFER .BAS FILES
TO APPLESOFT, SO IT AUTOMATICALLY SETS THE MSB.
   ALSO, SINCE LINE FEEDS ARE GENERALLY NOT NEEDED BY APPLESOFT,
THIS PROGRAM WILL CHANGE THE <CR> <LF> SEQUENCE OF CP/M TO
<CR> <SPACE>.
  THE PROGRAM CREATES A BINARY FILE ON THE APPLE DOS DISK.
THIS FILE CAN THEN BE MANIPULATED USING REGULAR DOS.

GETTING CPDOS TO RUN IN APPLESOFT :
  THE FILE CPDOS.BAS IS WRITTEN IN APPLESOFT.  IT WILL NOT
WORK UNDER MBASIC OR GBASIC. THEREFORE, IT ITSELF MUST BE
BROUGHT DOWN TO APPLE DOS.
  THERE ARE TWO WAYS OF DOING THIS:
 1] TRANSFER NORMALLY FROM THIS SYSTEM TO YOUR APPLE CP/M DISK
USING THE MODEM/XMODEM TRANSFER. PRINT A HARDCOPY LISTING OF
THE PROGRAM, AND RETYPE IT IN MANUALLY UNDER APPLESOFT -OR-
 2] IF YOU HAVE A DATA CAPTURE PROGRAM IN APPLESOFT, LIST
CPDOS AT THIS END ('TYPE CPDOS.BAS'), CAPTURE IT TO MEMORY
AT YOUR END, THEN SAVE NORMALLY TO DISK.

AN EXAMPLE OF TAKING AN APPLE CP/M BASIC PROGRAM AND DOWNLOADING
TO A DOS BASIC PROGRAM:
 1] RUN THE CPDOS PROGRAM
 2] YOU SHOULD NOW HAVE A BINARY FILE ON THE APPLE DOS DISK
    THAT CONTAINS ALL THE DATA OF THE CP/M PROGRAM.
 3] CONVERT THE BINARY FILE TO A TEXTFILE.
     (THE EASIEST METHOD OF DOING THIS IS TO RUN A SHORT
      MACH. LANG. PROGRAM FOUND ON PAGE A-20 OF 'BENEATH
      APPLE DOS' BY DON WORTH AND PIETER LECHNER -- }I WOULD
      HAVE INCLUDED IT IN THE PROGRAM BUT I THINK THE ROUTINE
      IS COPYRIGHTED)
 4] YOU NOW HAVE A TEXTFILE. IF ALL THE COMMANDS IN THE CP/M
    VERSION MAKE SENSE TO APPLESOFT, YOU CAN SIMPLY 'EXEC' THE
    TEXTFILE, AND YOU WILL HAVE THE PROGRAM IN APPLESOFT.
    IF THERE ARE INVALID EXPRESSIONS IN THE FILE, YOU CAN USE
    EDITORS SUCH AS THE DOS TOOLKIT TO CHANGE THEM.
  IF YOU EXEC A FILE WITH SYNTAX ERRORS, APPLESOFT WILL KEEP
THOSE LINES THAT MAKE SENSE, AND THROW OUT THE OTHERS.

NOTE: THIS PROGRAM IS IN ITS RUDIMENTARY STAGES. WITH A LITTLE
 MODIFICATION, IT COULD BE MADE TO ACCEPT LARGER FILES, DO
 SINGLE DRIVE COPIES, FILTER CERTAIN DATA, ETC.

IF YOU HAVE ANY COMMENTS OR SUGGESTIONS, LEAVE ME A MESSAGE ON
THE BBS.                              THANK YOU.