home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / c64 / c64modem.doc < prev    next >
Text File  |  1984-02-10  |  4KB  |  129 lines
  1.  
  2. MODEM64: DOCUMENTATION
  3. BY CHRIS LAMPTON, 75275,1373
  4. 01/29/84
  5.  
  6.  
  7.     MODEM64 IS A SIMPLE TERMINAL
  8. EMULATOR WITH XMODEM DOWNLOAD FACILI-
  9. TIES, DESIGNED TO RUN UNDER COMMODORE
  10. 64 CP/M. IT WILL NOT RUN UNDER OTHER
  11. VERSIONS OF CP/M; IN FACT, IT WILL ONLY
  12. RUN UNDER THE CP/M PACKAGE OFFERED BY
  13. COMMODORE BUSINESS MACHINES.
  14.     WHEN FIRST RUN, MODEM64 IS IN
  15. NORMAL TERMINAL MODE. ASCII DATA RE-
  16. CEIVED THROUGH THE RS-232 PORT IS DIS-
  17. PLAYED ON THE SCREEN. DATA TYPED ON THE
  18. KEYBOARD IS TRANSMITTED. PARITY IS
  19. IGNORED. MOST STANDARD ASCII CONTROL
  20. CODES ARE IMPLEMENTED. TO EXIT MODEM64
  21. PRESS FUNCTION KEY F2 (SHIFT-F1).
  22. XMODEM DOWNLOADS ARE INITIATED BY
  23. PRESSING FUNCTION KEY F8 (SHIFT-F7).
  24.  
  25.  
  26. USING MODEM64 WITH AN RCP/M
  27. (REMOTE CP/M DATABASE)
  28.  
  29.  
  30.     THE STANDARD RCP/M COMMAND FOR
  31. XMODEM TRANSMISSION IS:
  32.  
  33. XMODEM S FILENAME.EXT
  34.  
  35.     IF THE SPECIFIED FILE IS AVAILABLE,
  36. THE RCP/M WILL RESPOND WITH THE NUMBER
  37. OF 128 BYTE BLOCKS IN THE FILE AND THE
  38. APPROXIMATE DOWNLOAD TIME. IF YOU
  39. SHOULD DECIDE AT THIS POINT THAT YOU
  40. WISH TO ABORT THE DOWNLOAD, PRESS
  41. CTRL-'X' TO SEND AN ASCII CANCEL
  42. SIGNAL TO THE SENDING COMPUTER.
  43. TO BEGIN THE DOWNLOAD, PRESS F8,
  44. AND MODEM64 WILL AUTOMATICALLY
  45. REQUEST THE RCP/M TO START TRANS-
  46. MITTING. THE MESSAGE 'XMODEM TRANSMIS-
  47. SION INITIATED' WILL APPEAR ON THE
  48. SCREEN. IF FOR ANY REASON THE TRANS-
  49. MISSION IS NOT RECEIVED, MODEM64 WILL
  50. CONTINUE BROADCASTING THE REQUEST FOR
  51. APPROXIMATELY 100 SECONDS BEFORE
  52. ABORTING THE DOWNLOAD AND RETURNING TO
  53. TERMINAL MODE. SHOULD THIS OCCUR, THE
  54. MESSAGE 'BLOCK NOT RECEIVED, XMODEM
  55. TRANSMISSION ABORTED' WILL BE DIS-
  56. PLAYED. THE DOWNLOAD MAY BE MANUALLY
  57. ABORTED BY PRESSING THE RUN-STOP KEY.
  58.     ONCE TRANSMISSION HAS BEGUN, THE
  59. DOWNLOADED BLOCKS WILL BE AUTOMATICALLY
  60. SAVED TO THE DISK IN CP/M FORMAT. AS
  61. EACH BLOCK IS RECEIVED, THE MESSAGE
  62. 'BLOCK #NN RECEIVED' WILL BE DISPLAYED,
  63. WHERE NN IS THE BLOCK NUMBER IN HEXA-
  64. DECIMAL. IF MORE THAN 255 (FF HEX)
  65. BLOCKS ARE TRANSMITTED, THE BLOCK
  66. NUMBER WILL ROLL OVER TO 00. CHECKSUMS
  67. ARE USED TO VERIFY THE ACCURACY OF THE
  68. TRANSMITTED DATA. AT THE END OF TRANS-
  69. MISSION, MODEM64 WILL INFORM THE
  70. SENDING COMPUTER OF THE SUCCESSFUL
  71. RECEIPT OF THE FILE AND WILL DISPLAY
  72. THE MESSAGE 'XMODEM TRANSMISSION COM-
  73. PLETED' BEFORE RETURNING TO TERMINAL
  74. MODE.
  75.     FILES WILL BE SAVED TO THE DISK
  76. UNDER THE FILENAME 'NEWFILE,' WITH THE
  77. EXTENSION '.XMD'. FILES DOWNLOADED
  78. DURING A SINGLE SESSION WILL BE SEQUEN-
  79. TIALLY NUMBERED, WITH THE FIRST FILE
  80. GIVEN THE NAME 'NEWFILE1.XMD,' THE
  81. SECOND FILE THE NAME 'NEWFILE2.XMD,'
  82. AND SO FORTH. LETTERS OF THE ALPHABET
  83. WILL BE USED ONCE THE TEN NUMERALS ARE
  84. EXHAUSTED. GIVEN THE OBVIOUS LIMITATION
  85. ON FILE NAMES, IT IS RECOMMENDED THAT
  86. YOU NOT DOWNLOAD MORE THAN 35 FILES IN
  87. ONE SESSION, OR YOU MAY FIND UNTYPABLE
  88. ASCII CHARACTERS IN THE NAMES.
  89.     IT IS ALSO RECOMMENDED THAT YOU
  90. RENAME ALL DOWNLOADED FILES IMMEDIATELY
  91. AFTER THE SESSION, USING THE CP/M REN
  92. COMMAND, BECAUSE EXISTING NEWFILES ON
  93. THE DISK WILL BE DELETED BY MODEM64
  94. DURING LATER SESSIONS TO MAKE ROOM FOR
  95. FRESHLY DOWNLOADED FILES WITH THE SAME
  96. SEQUENCE NUMBERS.
  97.     IN THE EVENT THAT YOU ATTEMPT TO
  98. DOWNLOAD TO A FULL DISK (OR A FULL DISK
  99. DIRECTORY), AN ERROR MESSAGE WILL BE
  100. PRINTED AND THE DOWNLOAD ABORTED. ANY
  101. DATA DOWNLOADED TO THE CURRENT FILE
  102. BEFORE THE DISK LIMIT WAS REACHED WILL
  103. BE PRESERVED.
  104.     THIS IMPLEMENTATION OF XMODEM IS
  105. NOT BULLET PROOF. IT IS POSSIBLE FOR
  106. THE SENDING COMPUTER AND THE RECEIVING
  107. COMPUTER TO FALL OUT OF SYNC AND NOT
  108. RECOVER, THOUGH THIS IS NOT A VERY
  109. LIKELY EVENT. SHOULD IT OCCUR, THE
  110. DOWNLOAD WILL MORE THAN LIKELY ABORT
  111. BY ITSELF. HOWEVER, SHOULD YOU NOTICE
  112. AN UNUSUALLY LONG PAUSE BETWEEN BLOCKS
  113. -- SAY 20 SECONDS OR MORE -- YOU SHOULD
  114. ABORT MANUALLY WITH THE RUN-STOP KEY.
  115. THE SENDING COMPUTER MAY CONTINUE
  116. BROADCASTING DATA, BUT WILL NOTICE
  117. WITHIN A FEW SECONDS THAT NO ACKNOW-
  118. LEDGING SIGNAL IS BEING RECEIVED AND
  119. WILL CANCEL THE DOWNLOAD. YOU MAY THEN
  120. INITIATE THE DOWNLOAD AGAIN. THIS HAS
  121. HAPPENED TO ME ONCE IN ROUGHLY 40
  122. DOWNLOADS. SECURITY WILL BE TIGHTENED
  123. IN SUBSEQUENT VERSIONS.
  124.     SUGGESTIONS FOR FUTURE IMPROVEMENTS
  125. AND REPORTS OF CURRENT BUGS SHOULD
  126. BE CONVEYED TO THE AUTHOR VIA COMPU-
  127. SERVE INFORMATION SERVICE EMAIL OR THE
  128. CIS COMMODORE-64 SIG.
  129.