home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpmug / cpmug025.ark / MODEM.DOC < prev    next >
Encoding:
Text File  |  1984-04-29  |  2.2 KB  |  54 lines
  1. DOCUMENTATION OF THE CP/M MODEM PROGRAM
  2.  
  3.         by Ward Christensen
  4.  
  5. MODEM is a program for transferring files between CP/M systems.
  6. Files are sent a sector at a time.  The program prints mes-
  7. sages showing how things are going.  A hexadecimal sector
  8. number is printed, in a message: "WAITING FOR SECTOR NN" on
  9. one system, and "SENDING SECTOR NN" on the other system.
  10.  
  11. Users of the program should list it and study it if they
  12. are interested in learning more about it.  At a minimum, it
  13. must be edited and modified for the particular serial
  14. interface used for the modem.  As it stands, it is for my
  15. MITS dual serial I/O board, ports 4 and 5.
  16.  
  17. To use the program, one user types:
  18.     MODEM SEND filename.filetype
  19. The other user types:
  20.     MODEM RECEIVE filename.filetype
  21.  
  22. (SEND and RECEIVE may be abbreviated S and R)
  23.  
  24. The program has an error counter.  Each block is tried up
  25. to 10 times.  If 10 occur, it asks if you want to retry
  26. or quit.  If you are near the beginning of a file, you
  27. might want to quit, and re-dial the phone to get a better
  28. connection.  If you are further along in the transmission,
  29. you would likely want to retry.  Note that the program does
  30. not close the file if you say quit.
  31.  
  32. There is one known design error in this program:  After the
  33. file is sent, the sending program sends a single EOT character.
  34. The receiving program, upon receiving an EOT, takes closes
  35. the file, and returns to CP/M.  This is normally not a problem,
  36. but means that if the receiving program gets a glitch when
  37. it is looking for the start of a block, it will shut down
  38. early.  Also if the valid EOT from the sender is glitched,
  39. the receiving program will wait, eventually timing out.
  40.  
  41. I have nearly completed a version of the program which does
  42. better handshaking at EOF, which closes the file if you
  43. quit, and which allows a 'second logical channel' allowing
  44. keyboard-to-keyboard communications in parallel with the
  45. file transfer.  Thus, you could type "I'll send you spat.com
  46. when this is done, OK" and this message will be sent after
  47. the next data block is sent or received.  The other user
  48. will see the message and can reply. 
  49.  
  50.                 Ward Christensen
  51.                 c/o CACHE
  52.                 Box 52
  53.                 South Holland, Il. 60473
  54.