home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / bye5 / kmd.hqp / KMD.HLP
Text File  |  1986-04-18  |  10KB  |  220 lines
  1. SYSOPS:  SEE SPECIAL NOTE AT END WHICH YOU MIGHT PREFER TO DELETE
  2.  
  3.  
  4.            USING KMD TO TRANSFER FILES
  5.            ---------------------------
  6.                by Irv Hoff
  7.               03 March 1986
  8.  
  9.  
  10.  
  11.    There are three basic file transfer methods with KMD:
  12.  
  13.          1) requesting the RCPM system to send you a file
  14.          2) telling the RCPM system you want to send it a file
  15.          3) receiving an individual library member file
  16.  
  17.          KMD <ret>    shows a summary of the commands below
  18.  
  19.  
  20. 1) TELLING THE RCPM TO SEND YOU A FILE:
  21.    ===================================
  22.  
  23.     a)   KMD S HELLO.DOC
  24.     b)   KMD SK HELLO.DOC
  25.     c)   KMD SB HEL*.*
  26.     d)   KMD SB HE*.* SD*.* FILT7.LBR FOR*.LBR
  27.     e)   KMD SP SYSOP.FIL
  28.  
  29. a) Method normally used for asking the RCPM to send you a file.  It will
  30.      find the file, tell you how long it is (so you can tell if you have
  31.      that much room) and tell you how long it will take.
  32.  
  33. b) KMD is capable of sending (or receiving) files with 1k protocol.  It
  34.      can do this from an automatic request made by the IMP modem program
  35.      (only one currently offering this feature) or if you manually type
  36.      'SK'.  Programs such as MEX, Pro-YAM, etc. require this manual com-
  37.      mand if the user wants 1k protocol.  (If unfamiliar with this term,
  38.      it essentially sends blocks of 1024 bytes, rather than 128 bytes,
  39.      stopping 1/8 as often for an acknowledgement it was received ok.
  40.      This speeds up the file tranfer about 8-9% at 1200 bps and 14-15%
  41.      at 2400 bps.  Some of the newer modem programs have 1k protocol.)
  42.  
  43. c) KMD has 'batch file transfer' capability.  This permits sending one
  44.      file or a number of files sequentially.  The illustration shows how
  45.      several files starting with the characters 'HEL' can be sent, using
  46.      wildcards which CP/M accepts.  Adding a 'K' to force 1k protocol
  47.      is of no benefit as the KMD-batch mode assumes you have 1k ability.
  48.  
  49. d) Another example of sending a group of files via batch mode.    Each is
  50.      separated by a space, and shows how wild cards may be used for any
  51.      of them.  The time needed to transfer the requested files is added
  52.      together and you are informed to make another selection if you do
  53.      not have that much time left on the system.
  54.  
  55.          NOTE:    Sending even a single file via
  56.             batch mode is beneficial, as you
  57.             only need type the file name at
  58.             the sending end.  Even then, you
  59.             can use wildcards, additionally
  60.             simpifying the typing needed.
  61.  
  62. e) The SYSOP has a private area where he can hide a file which you may
  63.      receive using the 'SP' command.  He would then leave you a private
  64.      message telling the name of the file.  Nobody else would be able to
  65.      get it since they would not know its name.  This offers ample se-
  66.      curity for the short period of time he would keep it available.
  67.  
  68.  
  69.  
  70. 2) TELLING THE RCPM SYSTEM TO RECEIVE A FILE FROM YOU:
  71.    ==================================================
  72.  
  73.     a)   KMD R
  74.     b)   KMD RB
  75.     c)   KMD R HELLO.DOC
  76.     d)   KMD RC HELLO.DOC
  77.     e)   KMD RM MESSAGE.TXT   * not available on all systems
  78.     f)   KMD RP HELLO.DOC
  79.     g)   KMD RPC HELLO.DOC
  80.     h)   KMD RX HELLO.DOC
  81.  
  82.  
  83.          NOTE:  All of these requests will cause the
  84.             RCPM to tell you how much room is left
  85.             on the disk where the file will be re-
  86.             ceived.  Check this before you start
  87.             the transfer to insure you don't get
  88.             cut off when partially finished.
  89.  
  90.  
  91. a) Will receive a file or a number of files from you, using the KMD-type
  92.      batch mode.  Currently IMP is the only modem program which supports
  93.      this type of batch mode fully.  It is compatible with programs that
  94.      use the YMODEM protocol such as Pro-YAM and MEX-PC.
  95.  
  96. b) Same as a) - either 'B' or 'RB' may be used for the KMD-batch mode.
  97.      (This is not compatible with the MODEM7 batch mode which has no
  98.      header block for sending the file name, doing this via checksum
  99.      with no file length information.)
  100.  
  101. c) Normal method of telling the RCPM to receive a file you will send,
  102.      named HELLO.DOC
  103.  
  104. d) Tells the RCPM you plan to send a file using checksum.  This saves
  105.      time - otherwise KMD waits up to 40 seconds assuming you will use
  106.      CRC before it switches and attempts to use checksum, instead.  Some
  107.      modem programs do not offer CRC for error-checking even though they
  108.      use XMODEM protocol.  These are invariably commercial programs.
  109.  
  110. e) This is a new feature which allows you to send a file with pre-typed
  111.      messages to a RCPM.  It automatically goes to the private upload
  112.      area, so does not ask for a file description and does not appear in
  113.      the "FOR" file.  Any FILENAME.EXT is suitable since using the 'RM'
  114.      command tells KMD that this file is to be appended to the bulletin
  115.      board message file.  If the RCPM system does not use a BBS that has
  116.      this feature, you will get an error message if requesting 'RM'.
  117.  
  118. f) Receives a file in the private area for the SYSOP's own use.  It will
  119.      not ask for a file description when finished and does not display
  120.      the name of the file in the "NEW" file most users check to see what
  121.      files have been recently obtained.
  122.  
  123. g) Receives a file in the private area using checksum mode.
  124.  
  125. h) When receiving a file, KMD normally tells the sender it has automatic
  126.      1k protocol.  IMP is currently the only modem program that can use
  127.      this information.    There may be times (even if using IMP) that you
  128.      might want to intentionally transfer with the smaller 128 character
  129.      blocks.  Some programs capable of sending 1k protocol assume the
  130.      other end already has this capability without being told.    One such
  131.      program (newest versions of MITE) even gets confused when KMD fur-
  132.      nishes this information, which can be inhibited by using 'RX'.
  133.  
  134.  
  135. 3) TELLING THE RCPM SYSTEM TO SEND YOU A FILE FROM A LIBRARY:
  136.    =========================================================
  137.  
  138.     a)   KMD L HELLO.LBR HELLO.DOC
  139.     b)   KMD L HELLO HELLO.DOC
  140.     c)   KMD LK HELLO HELLO.DOC
  141.  
  142. a) Using the 'L' option will send a member file from a library.  First
  143.      comes the library name followed by the name of the file contained
  144.      in that library, that you want.
  145.  
  146. b) Another example, showing the customary method - the 'L' command does
  147.      not require you include the '.LBR' extent since it assumes that is
  148.      the name of a .LBR file...
  149.  
  150. c) Shows how people using programs with manual 1k protocol (such as MEX,
  151.      Pro-YAM, etc.) can request the file be sent using 1k protocol.  IMP
  152.      users do not need to add the 'K' as IMP automatically makes this
  153.      request.
  154.  
  155.  
  156. AFTER THIS, WHAT?
  157. =================
  158.  
  159. After telling KMD what it should do (send you a file or receive one from
  160. you), it winds up its part of the operation with a line telling you to
  161. use several CTL-X characters to abort.
  162.  
  163. That is your clue to do  what is needed to tell your own system to re-
  164. ceive the file (or send the one you told the RCPM to expect from you).
  165.  
  166. This guide assumes you have an instruction book for your modem program,
  167. or some prior experience in using it.  If it is a MODEM7, COMM7, MDM7,
  168. SMODEM, IMP or MEX program (just to name a few that are available free)
  169. you would return to the command mode (with a CTL-E or ESC-E, typically)
  170. and then use commands almost identical to those mentioned above for KMD.
  171.  
  172. Other programs, particularly those for 16-bit computers running MS-DOS
  173. often have menus from which the user makes the appropriate selection.
  174. This triggers the start of the file transfer.
  175.  
  176.  
  177. SUMMARY:
  178. =======
  179.  
  180. You can abort a file transfer with several CTL-X characters.  This nor-
  181. mally works quite well in terminating both at your end and at the RCPM
  182. end.  If you return to the terminal mode after an intentional abort, the
  183. RCPM system may not have received your request.  Usually a few manually
  184. sent CTL-X will then abort.  In any case, the fact you are not sending
  185. automatic acknowledgements should cause the RCPM system to time out in
  186. roughly 1-1/2 minutes and return to the prompt.  Don't despair too soon
  187. and disconnect, planning to phone right back.  That normally is not very
  188. helpful.
  189.  
  190. When the RCPM system sends you a file you have requested, it then waits
  191. for your modem program to tell it whether you have CRC or checksum and
  192. also accepts information regarding automatic 1k protocol capability.  It
  193. is only when you send a file to the RCPM that you may need to mention
  194. things like checksum or to suspend its automatic 1k output information.
  195.  
  196.  
  197. If this modest help guide is still insufficient, or even has whetted the
  198. appetite for more information, look at some of the files in the KMD-SUPP
  199. file.  They go into far more depth on some of these topics, in what we
  200. hope is a very interesting and readable manner, telling how and why some
  201. of these protocols were developed.
  202.  
  203. (Thanks to Wayne Masters, SYSOP of Potpourri RCPM in San Jose, CA for
  204. suggesting a summary such as this might be helpful to some of his users
  205. who have not previously attempted file CP/M file transfers.)
  206.  
  207.                     - Irv Hoff W6FFC
  208.                       Los Altos Hills, CA 94022
  209.                       (415) 948-2166 (voice)
  210.  
  211.  
  212. NOTE TO SYSOPS:  THIS SIMPLE HELP GUIDE ON HOW TO TRANSFER FILES WITH
  213.          KMD MIGHT BE PLACED ON SOME EASILY ACCESSIBLE DISK
  214.          LOCATION SO YOU CAN REFER NEW USERS TO ITS CONTENTS,
  215.          HOPEFULLY SAVING YOU A LOT OF TIME IN ANSWERING SUCH
  216.          QUESTIONS.  YOU MAY ALSO NOT KNOW ABOUT THE PRIVATE
  217.          'SP' COMMAND WHICH FOR SECURITY DOES NOT WORK WITH
  218.          WILDCARDS OR BATCH MODE.
  219.  
  220.