home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / apple / applutil.lbr / CPDOS.DOC < prev    next >
Encoding:
Text File  |  1986-09-21  |  2.9 KB  |  67 lines
  1. CPDOS.DOC    12/31/81
  2.   BY  ALEX MALUTA
  3.  
  4. CPDOS IS A UTILITY THAT ALLOWS TRANSFERRING FILES FROM
  5. AN APPLE CP/M DISK TO A APPLE DOS 3.3 DISK.
  6.    THE PROGRAM RUNS UNDER APPLESOFT (ROM) AND DOS 3.3.
  7. IT USES THE RWTS SUBROUTINE TO SEARCH THE CP/M DISK FOR
  8. THE DESIRED FILE, DUMP IT SECTOR BY SECTOR INTO MEMORY,
  9. AND THEN SAVE IT TO A DOS DISK.
  10.    IT IS PRESENTLY CONFIGURED FOR THE FOLLOWING SETUP:
  11.       48K APPLE II
  12.        2 DRIVES IN SLOT 6
  13.        APPLESOFT IN ROM
  14. IT WILL TRANSFER ANY TYPE OF CP/M FILE (AS LONG AS IT IS
  15. NO LONGER THAN 30208K BYTES LONG), BY TREATING IT PURELY
  16. AS DATA.  THEREFORE, IT IS POSSIBLE TO TRANSFER .BAS, .HEX
  17. .ASM, .COM, ETC. FILES.
  18.   THE PROGRAM WAS GENERALLY DESIGNED TO TRANSFER .BAS FILES
  19. TO APPLESOFT, SO IT AUTOMATICALLY SETS THE MSB.
  20.    ALSO, SINCE LINE FEEDS ARE GENERALLY NOT NEEDED BY APPLESOFT,
  21. THIS PROGRAM WILL CHANGE THE <CR> <LF> SEQUENCE OF CP/M TO
  22. <CR> <SPACE>.
  23.   THE PROGRAM CREATES A BINARY FILE ON THE APPLE DOS DISK.
  24. THIS FILE CAN THEN BE MANIPULATED USING REGULAR DOS.
  25.  
  26. GETTING CPDOS TO RUN IN APPLESOFT :
  27.   THE FILE CPDOS.BAS IS WRITTEN IN APPLESOFT.  IT WILL NOT
  28. WORK UNDER MBASIC OR GBASIC. THEREFORE, IT ITSELF MUST BE
  29. BROUGHT DOWN TO APPLE DOS.
  30.   THERE ARE TWO WAYS OF DOING THIS:
  31.  1] TRANSFER NORMALLY FROM THIS SYSTEM TO YOUR APPLE CP/M DISK
  32. USING THE MODEM/XMODEM TRANSFER. PRINT A HARDCOPY LISTING OF
  33. THE PROGRAM, AND RETYPE IT IN MANUALLY UNDER APPLESOFT -OR-
  34.  2] IF YOU HAVE A DATA CAPTURE PROGRAM IN APPLESOFT, LIST
  35. CPDOS AT THIS END ('TYPE CPDOS.BAS'), CAPTURE IT TO MEMORY
  36. AT YOUR END, THEN SAVE NORMALLY TO DISK.
  37.  
  38. AN EXAMPLE OF TAKING AN APPLE CP/M BASIC PROGRAM AND DOWNLOADING
  39. TO A DOS BASIC PROGRAM:
  40.  1] RUN THE CPDOS PROGRAM
  41.  2] YOU SHOULD NOW HAVE A BINARY FILE ON THE APPLE DOS DISK
  42.     THAT CONTAINS ALL THE DATA OF THE CP/M PROGRAM.
  43.  3] CONVERT THE BINARY FILE TO A TEXTFILE.
  44.      (THE EASIEST METHOD OF DOING THIS IS TO RUN A SHORT
  45.       MACH. LANG. PROGRAM FOUND ON PAGE A-20 OF 'BENEATH
  46.       APPLE DOS' BY DON WORTH AND PIETER LECHNER -- }I WOULD
  47.       HAVE INCLUDED IT IN THE PROGRAM BUT I THINK THE ROUTINE
  48.       IS COPYRIGHTED)
  49.  4] YOU NOW HAVE A TEXTFILE. IF ALL THE COMMANDS IN THE CP/M
  50.     VERSION MAKE SENSE TO APPLESOFT, YOU CAN SIMPLY 'EXEC' THE
  51.     TEXTFILE, AND YOU WILL HAVE THE PROGRAM IN APPLESOFT.
  52.     IF THERE ARE INVALID EXPRESSIONS IN THE FILE, YOU CAN USE
  53.     EDITORS SUCH AS THE DOS TOOLKIT TO CHANGE THEM.
  54.   IF YOU EXEC A FILE WITH SYNTAX ERRORS, APPLESOFT WILL KEEP
  55. THOSE LINES THAT MAKE SENSE, AND THROW OUT THE OTHERS.
  56.  
  57. NOTE: THIS PROGRAM IS IN ITS RUDIMENTARY STAGES. WITH A LITTLE
  58.  MODIFICATION, IT COULD BE MADE TO ACCEPT LARGER FILES, DO
  59.  SINGLE DRIVE COPIES, FILTER CERTAIN DATA, ETC.
  60.  
  61. IF YOU HAVE ANY COMMENTS OR SUGGESTIONS, LEAVE ME A MESSAGE ON
  62. THE BBS.                              THANK YOU.
  63.  
  64. A, ETC.
  65.  
  66. IF YOU HAVE ANY COMMENTS OR SUGGESTIONS, LEAVE ME A MESSAGE ON
  67. T