home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol068 / plink65.doc < prev    next >
Encoding:
Text File  |  1984-04-29  |  4.0 KB  |  110 lines
  1.             PLINK65.DOC
  2.  
  3.  PLINK is a CP/M transient command which allows the user to
  4. communicate with a remote computer that is not running a special
  5. program.  It allows the user to selectively copy received text
  6. into memory and to later write the text onto a CP/M disk file.
  7. It also allows text to be transmitted from a disk file to the
  8. remote computer a line at a time, suppressing the line feeds and
  9. waiting for a trigger character such as a line feed from the
  10. remote computer before sending the next line of text.  Optionally
  11. the trigger character may be a BELL code, an X-ON, or text may
  12. be sent without pause including line feeds after the carriage
  13. return.  Note that none of these options work for sending to a
  14. DEC which uses an X-OFF, X-ON protocol when it gets more input than
  15. it can handle.
  16.  
  17.  This program currently supports the following modems or computers
  18. via conditional assembly:
  19.  
  20. 1. PMMI modem
  21. 2. Any serial I/O board (TUART included)
  22. 3. TRS-80 model 1
  23. 4. TRS-80 model 2
  24. 5. Heath H8 with 8251 UART at port 330q
  25. 6. D.C. Hayes 80-103A or Micromodem 100
  26. 7. MITS 2SI/O board, ports 10h &11h = console, 12h & 13h = modem
  27. 8. Intel SBC or National BLC multi-bus boards using 8251 USART
  28.  
  29.  
  30. Originally written by L.E. Hughes (EDCAM) in July, 1977.  Many
  31. modifications have been made since this time, as shown in the
  32. following summary.
  33.  
  34. Fixes/updates (in reverse order to minimize reading time):
  35.  
  36. June 26, 1981. Added message when exiting if last buffer was
  37. not saved.  Ted Shapin.
  38.  
  39. June 14, 1981, by Keith Petersen, W8SDZ.  Changed port
  40. equate to 'equ' instead of 'set'.  ASM doesn't like 'set'
  41. when later conditionals are based on a label defined that
  42. way.
  43.  
  44. June 7, 1981, by Tom Jorgenson (CP-MIG).  Changed CP/M 
  45. origin from being via SETs to referenced to BASE, added
  46. TRUE/FALSE rather than numeric values (for readability),
  47. changed ^Q function to ^W (write) because some systems
  48. (notably Micronet) use ^S/^Q to suspend/resume output,
  49. changed page 0 references in TRS routines to use
  50. BASE equate properly, changed PORT equates to default
  51. to TRUE, reinserted Heath equates, and cleaned up code
  52. in several places.
  53.  
  54. June 7, 1981, by Keith Petersen, W8SDZ.  Fixed problem with
  55. equates which prevented assembly by 'ASM' when TUART option
  56. was selected.
  57.  
  58. June 6, 1981, by Keith Petersen, W8SDZ.  Added version number,
  59. cleaned up file.
  60.  
  61. May 12, 1981, by T. Shapin.  Added code for 8251 USART on Intel 
  62. SBC or National BLC multibus board with modified CP/M origin.  
  63. Added prompt to signon. Added toggle to ^Y to save or ignore 
  64. incoming text. Added ^C abort on file name response.
  65.  
  66. (for earlier update info, see PLINK65.AQM.  Use USQ.COM to
  67.  unsqueeze)
  68.  
  69.  
  70. PLINK currently supports two way transfer of text files between
  71. the  CP/M disk and the remote computer.  The following control
  72. codes may be initiated from the console keyboard:
  73.  
  74. Control-E      Exit PLINK to CP/M "warm-boot".
  75.  
  76. Control-T      Transmit ASCII file to remote system, asks for
  77.                drive (A, B, etc.) and filename.typ.
  78.  
  79. Control-C      Aborts transmition of file to remote system.
  80.  
  81. Control-Y      Switches between saving and ignoring incoming
  82.            ASCII data in RAM buffer, for later transfer
  83.            to disk.
  84.  
  85. Control-Q      Writes RAM buffer to disk, and asks for drive
  86.                and filename.typ.
  87.  
  88. Del (delete)   Backspace when in command mode (e.g. ^T or ^Q).
  89.  
  90. Control-U      Aborts current line when in command mode.
  91.  
  92. (Note: all other control codes are passed to modem output, and
  93. may be interpreted by the remote system as various control
  94. functions.)
  95.  
  96. When sending to another computer, PLINK waits for a trigger
  97. response after sending each line before it will send the next.
  98. The following "trigger" equate is set to "lf" (linefeed)
  99. by default.  An optional trigger char may be passed via fcb1
  100.  
  101.  ie:  PLINK B        will set trigger to "bell"
  102.  
  103. The following options are allowed:
  104.  
  105.     1. B = bell  07h
  106.     2. X = xon   11h
  107.     3. U = upload no trigger check at all and send line feeds
  108.  
  109. any other ascii character may be passed through fcb1.
  110.