home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / 22rsx / rxmd.ark.2 / RXMDHDR.MAC < prev   
Encoding:
Text File  |  1985-12-12  |  9.6 KB  |  185 lines
  1. ; This portion of RXMD source generates no object code, and may be
  2. ; replaced by an empty file for assembly.  It contains all credits,
  3. ; history, etc.
  4. ;
  5. ; --------------------------------------
  6. ; This is a development from KMD08, by Irv. Hoff.  This version uses
  7. ; the facilities of BYERSX, rather than those of BYE502 or BYE339,
  8. ; and is intended to allow use as a replacement for MDM, MODEM, IMP,
  9. ; MEX, etc.  This development was done by C.B. Falconer.
  10. ;
  11. ; Carrier checking is now under the control of BYERSX status. Delays,
  12. ; clockrate, baudrate are supplied by BYERSX calls.  This facilitates
  13. ; use in hard-wired situations and avoids all installation.  For BBS
  14. ; use BYERSX again supplies all values.  Security provisions are in
  15. ; force whenever RXMD is operated remotely, as indicated by the
  16. ; BYERSX "remon" status bit, and can be over-ridden by the "whlbit".
  17. ;
  18. ; The batch mode protocol, as used in KMD08, supplies an initial
  19. ; header record #0, containing the ASCIIZ file name (in lower case)
  20. ; as the initial bytes, and bytes 126 and 127 contain the file 
  21. ; length, in 128 byte records, as a low byte first integer.  (This
  22. ; assumes 0 based indexing).  All intermediate bytes are zeroed.  I
  23. ; (C.B. Falconer) intend to define further fixed fields, from byte
  24. ; 125 down, for such things as exact byte count, time/date stamps,
  25. ; etc. to enable use as a universal protocol.  BYERSX already has
  26. ; provisions for time and date interfaces.
  27. ;
  28. ; The name is intended to indicate that it operates under the BYERSX
  29. ; system, and to avoid confusion with its ancestors, XMODEM and KMD.
  30. ;
  31. ; Most of the following verbiage is taken directly from KMD08.
  32. ; --------------------------------------
  33. ;
  34. ; Introduction:
  35. ; ------------
  36. ; This program is designed to run in conjunction with BYERSX and gets
  37. ; all port, modem and console routines directly from the main BYERSX
  38. ; program.  It also supports 1k transmissions to give more efficient
  39. ; file transfers at the faster baud rates.  If too many errors occur
  40. ; due to poor conditions, the advantages of 1k protocol can quickly
  41. ; vanish.  The program then automatically switches back to 128 byte
  42. ; groups.  This ratio is set to optimum for 1200 bps with one value
  43. ; and another for 2400 bps. Other features include progress reporting
  44. ; messages to inform the SYSOP of the protocol being used, type of
  45. ; errors encountered and the ability to abort uploads or downloads
  46. ; with two consecutive CTL-X. The disk buffer is also filled when the
  47. ; send file is opened so it is immediately ready when the receiving
  48. ; system sends its protocol character. This speeds up downloads and
  49. ; increases the reliability.  Batch mode has been added, giving this
  50. ; program tremendous versatility. For downloads, the total amount of
  51. ; time for all files is accumulated and displayed prior to starting
  52. ; - if this exceeds the allowable time set by the SYSOP, the download
  53. ; is aborted.  A time clock is not needed to limit these downloads,
  54. ; as the time for each file is accumulated and compared against the
  55. ; original time allowed.  The batch mode displays the length of each
  56. ; file being sent or received.  This feature previously has been
  57. ; available only to users of the PRO-YAM MS-DOS modem program.
  58. ;
  59. ; Discussions were conducted with Ward Christensen relative to the
  60. ; automatic 1k protocol, which he likes and has endorsed.  Manual
  61. ; protocol of course is available to remain compatible with YAM
  62. ; users.  Ward suggested several other things he has been using on
  63. ; his CBBS system in Chicago since the first version of his protocol
  64. ; was developed.  These have been incorporated into KMD and RXMD.
  65. ;
  66. ; KMD has been developed concurrently by Irv Hoff and Wayne Masters
  67. ; and is released free of charge to the public domain.  Similarly
  68. ; RXMD is released by C.B. Falconer, provided that no charges are
  69. ; made for distribution, use, etc.
  70. ;
  71. ; ===================================================================
  72. ;        Current changes.  Move others down.
  73. ;
  74. ; 1.0.0    85/12/12    C.B. Falconer
  75. ;    Initial release.
  76. ;
  77. ; ===================================================================
  78. ;
  79. ; Acknowledgements:
  80. ; ----------------
  81. ; KMD is based on previous programs called XMODEM. The original
  82. ; version of XMODEM was adapted for RCPM use by Keith Petersen from
  83. ; MODEM 2.0 by Ward Christensen.  Numerous other programmers have
  84. ; contributed through the years prior to the work done in KMD.  A few
  85. ; of those include Paul Hansknecht who wrote the CRC routines, Sigi
  86. ; Kluger who opened the way for the original overlay idea (which KMD
  87. ; and RXMD no longer need), Paul Traina and Irv Hoff and many other
  88. ; contributors whose names we have not been able to verify.  Thanks
  89. ; to all who have helped to make these programs what they are today.
  90. ;
  91. ;
  92. ; Using 1k protocol:
  93. ; -----------------
  94. ; The 1k protocol used in RXMD is automatically triggered and is
  95. ; transparent to modem programs designed to utilize this feature.
  96. ; It also supports MEX114, YAM and PRO-YAM users who need to manually
  97. ; type 'SK' to the sending host unit for 1k transmissions. (YAM users
  98. ; need to be sure to use 'RC' at their end to be in CRC mode. Earlier
  99. ; PRO-YAM users may see an error at the beginning of an upload to a
  100. ; host unit when using 1k mode due to their noise burst detector
  101. ; - this has since been corrected with current PRO-YAM versions.)
  102. ; The program also supports the IMP modem program in both the manual
  103. ; mode like those previously mentioned as well as the KMD automatic
  104. ; mode where no operator intervention is needed.
  105. ;
  106. ; RXMD and KMD send a C and a K to alert modem programs capable of
  107. ; this protocol that it can automatically accept their 1k blocks.
  108. ; This has no effect on other modem programs as they stop looking
  109. ; when they see the 'C'.  The KMD automatic feature is thus trans-
  110. ; parent to all users.  This can be easily modified to send only one
  111. ; character after the 1k protocol is established as the normal
  112. ; operating preference.  If no transfer has commenced after about 40
  113. ; seconds "NAK" is sent to inform the host that checksum can be
  114. ; accepted.  All this is compatible with the original Christensen
  115. ; protocol to which CRC was added in 1981.  One of the minor changes
  116. ; Ward has made since that time was to send the protocol character
  117. ; every two seconds instead of every 10 seconds. This initiates the
  118. ; start of the program transfer whenever the remote system is ready
  119. ; to send.  After considerable testing with various modem programs,
  120. ; RXMD and KMD use a compromise and send the protocol character each
  121. ; 4 seconds until the upload is commenced.
  122. ;
  123. ; Selecting options:
  124. ; -----------------
  125. ; RXMD has NO options, other than the buffer size to be used.  All
  126. ; configuration information is ascertained from BYERSX, including
  127. ; clock speeds, baud rates, stop bits, etc.  The program dynamically
  128. ; re-configures itself when operated from a remote terminal, to 
  129. ; impose security restrictions.  These can be over-ridden by suitable
  130. ; password protected commands.
  131. ;
  132. ; There are no external overlays or inserts required for this program
  133. ; since all support code is located in BYERSX.  The function keys in
  134. ; BYERSX will also work while this program is running.
  135. ;
  136. ; NOTE: This file assumes that anybody allowed to enter the CP/M
  137. ;    data area is limited only in what he can upload or download
  138. ;    by the restrictions of drive and user number and the time
  139. ;    he is allowed to remain on the system.    Files may also be
  140. ;    "tagged" and RXMD will protect those from being downloaded.
  141. ;       The file types COM, PCD, SYS, and PRL are automatically
  142. ;    protected against download, as are files tagged by the F1
  143. ;    or F2 bits, and those tagges as "SYS" files.  Uploads of
  144. ;    such file types are automatically renamed.
  145. ;
  146. ;
  147. ; -------------------------------------------------------------------
  148. ;
  149. ; This program allows a remote or local user to transfer files (to or
  150. ; from) RCPM systems or other systems.  Files may be loaded to a
  151. ; specific user area, keeping all new programs in that one area. This
  152. ; aids the SYSOP as well as the remote user.  If uploading a .COM
  153. ; file, it will be changed automatically to an .OBJ file in remote
  154. ; mode. This security feature prevents intentional uploading of
  155. ; programs that could be used to alter (or erase, etc.) those already
  156. ; present.  "RP" may be used to upload files to a private area for
  157. ; SYSOP use only.
  158. ;
  159. ; At present the description feature of KMD is not included, but is
  160. ; planned using the chain facilities of BYERSX.
  161. ;
  162. ; If the WHEEL bit is set (for the SYSOP, etc.) files may be uploaded
  163. ; to any specified drv/user area, their filenames are unrestricted.
  164. ;
  165. ; Programs may be uploaded to a non-public area for the private use
  166. ; of the SYSOP.  (Use "RP" or "RPC" for the private area.)  It also
  167. ; allows private programs to be downloaded from a special area which
  168. ; gives the SYSOP the ability to make any person a temporary priv-
  169. ; ileged user. (A private note tells the person the name of the file.
  170. ; Others would be unaware such a file existed, ensuring excellent
  171. ; security.)
  172. ;
  173. ; Individual files from a library group may be downloaded.  The
  174. ; library extent (.LBR) need not be included, in which case it is
  175. ; automatically added.  Using library groups permits greater utiliza-
  176. ; tion of the available disk space, plus puts all associated files
  177. ; into one file.  An example is shown in the menu.
  178. ;
  179. ; Many people have contributed greatly to the present program.
  180. ;
  181. ; - Notes by Irv Hoff and Wayne Masters, modified by C.B. Falconer
  182. ;
  183. ; *  *  *  *  *  Revision history, LIFO order  *  *  *  *  *
  184. ;
  185. ╔c