home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / sigm / vol183 / yam.hqp / YAM.HLP
Encoding:
Text File  |  1985-02-10  |  16.1 KB  |  390 lines

  1. INTRODUCTION to the YAM Communications Utility
  2. The "YAM" family of programs
  3. Gettinτ "YAMó t∩ you≥ compute≥ 
  4. YAMBOOT details
  5. The YAM/MODEM Handshake Protocol
  6. Other programs which WILL work with YAM ** 20/Jun/84 **
  7. Other programs which MAY work with YAM
  8. Preconfigured versions of YAM for specific computers
  9. XYAM
  10. Using CRCK to check file transfers
  11. Adapt this help file to your needs
  12. :Introduction
  13.  
  14. Thσá concep⌠á oµá Remotσ CP/═ (RCPM⌐ system≤ relie≤á oεá user≤ ì
  15. havinτ thσ abilit∙ t∩ transfe≥ file≤ t∩ anΣ froφ thσ systeφ iε ì
  16. somσá securσá manner«á Thσá securit∙á come≤á froφá handshakinτ ì
  17. betweeεá thσ sende≥ anΣ receive≥ t∩ le⌠ thσ sende≥á kno≈á tha⌠ ì
  18. thσ receive≥ go⌠ ß gooΣ (n∩ errors⌐ cop∙ oµ thσ file.
  19.  
  20. Prio≥ t∩ thσ adven⌠ oµ RCP═ typσ system≤ therσ haΣ beeε littlσ ì
  21. neeΣá fo≥ thesσ typσ oµ program≤ iε Australiß a≤ microcompute≥ ì
  22. user≤ havσ no⌠ beeε strongl∙ communication≤á oriented¼á mostl∙ ì
  23. duσá t∩á restrictivσá policie≤ oε thσ par⌠á oµá Telecom«á Wha⌠ ì
  24. littlσá neeΣá therσá ha≤á beeεá ha≤á beeεá met¼á iεá thσá CP/═ ì
  25. environmen⌠ a⌠ least¼ b∙ commercia∞ program≤ sucΦ a≤ BSTAM« 
  26.  
  27. Wha⌠á i≤á requireΣ fo≥ interactivσ communicatioε witΦá ßá RCP═ ì
  28. systeφá i≤ utilit∙ whicΦ wil∞ allo≈ ASCI╔á communication≤á fo≥ ì
  29. logiεá anΣá RCP═á commanΣá instigatioεá anΣá wil∞á als∩á allo≈ ì
  30. handshakinτá (o≥á protocol⌐ filσ transfer≤ iε botΦá direction≤ ì
  31. withou⌠á havinτá t∩á returε t∩ thσá operatinτá systeφá commanΣ ì
  32. level.
  33.  
  34.  
  35. Iε thσ USA¼á RCP═ system≤ havσ beeε oε linσ fo≥ severa∞á year≤ ì
  36. anΣá numerou≤á program≤ whicΦ fulfil∞ thσá abovσá requirement≤ ì
  37. havσ beeε developed« Development has follwed tw∩ streams.
  38.  
  39. Thσ firs⌠ streaφ i≤ thσ serie≤ oµ program≤ whicΦ g∩ unde≥á thσ ì
  40. generiπá titlσá oµá "MODEM"«á Thesσ program≤ al∞ steφá froφá ß ì
  41. prograφá writteεá b∙á WarΣá Christenseεá fo≥á thσá ver∙á firs⌠ ì
  42. microcompute≥ bulletiε boarΣ systeφ iε thσ world¼á thσ Chicag∩ ì
  43. CBBS« Thσ MODE═ program≤ arσ al∞ writteε iε assemble≥ codσ anΣ ì
  44. arσ iε thσ publiπ domain.
  45.  
  46. Thσá seconΣ streaφ i≤ ß serie≤ oµ program≤ whicΦ g∩ unde≥á thσ ì
  47. namσ oµ YA═ ("Y"e⌠ "A"nothe≥ "M"odem program)«á Thesσ program≤ ì
  48. steφá froφ attempt≤ t∩ rewritσ thσ MODE═ program≤ int∩ thσ "Có ì
  49. higΦ leve∞ language« Thσ YA═ programs¼ b∙ Chucδ Forsberg¼ gre≈ ì
  50. froφá thσ MODEM.├ programs«á YA═ offer≤ man∙á morσá facilitie≤ ì
  51. thaεá MODE═á anΣ i≤ easie≥ t∩ maintain«á YA═ program≤ usσá thσ ì
  52. samσá protocol≤ a≤ thσ MODE═ program≤ anΣ the∙ wil∞ "talkóá t∩ ì
  53. eacΦ other. They are also in the public domain.
  54.  
  55. :The "YAM" family of programs
  56. è
  57. YA═ i≤ writteε iε ß modern¼á higΦ leve∞ language¼á "C"« I⌠ wa≤ ì
  58. writteεá witΦ thσ ideß tha⌠ i⌠ shoulΣ bσ transportablσ t∩ non-ì
  59. CP/═á environment≤á anΣá i≤ thσ best choicσá iµá yo⌡á arσá no⌠ ì
  60. runninτá in a CP/M environment.á ╔ als∩ conside≥ i⌠á thσá bes⌠ ì
  61. choice if you are running CP/M.
  62.  
  63. Thσá prograφá i≤ writteε iε ß modula≥ manne≥ anΣ al∞ thσá UAR╘ ì
  64. dependen⌠á routine≤á arσ containeΣ iε ßá singlσá module«á Somσ ì
  65. othe≥á hardwarσ dependen⌠ informatioε (sucΦ a≤ por⌠á addresse≤ ì
  66. etc⌐á i≤á containeΣá iε heade≥ files«á Thi≤ makσá i⌠á eas∙á t∩ ì
  67. suppor⌠á multiplσ version≤ oµ YA═ froφ substantiall∙ thσá samσ ì
  68. se⌠á oµ files«á Thσ SYSO╨ i≤ currentl∙ supportinτ │á differen⌠ ì
  69. UAR╘ version≤ oµ YA═ froφ thσ onσ se⌠ oµ sourcσ files.
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78. Yo⌡á wil∞ neeΣ t∩ havσ thσ BD╙ "Có compiler¼á versioε 1.50á o≥ ì
  79. later¼ t∩ compilσ YAM-80« 
  80.  
  81. Iµá yo⌡á arσá comfortablσ witΦ thσá "Cóá languagσá yo⌡á shoulΣ ì
  82. definitel∙á usσá YA═á insteaΣ oµ MODEM«á Eveε iµ yo⌡á arσá no⌠ ì
  83. familia≥á witΦ "Có i⌠ i≤ wortΦ thσ effor⌠ oµ learning¼á t∩á bσ ì
  84. ablσ t∩ compilσ YAM«á YA═ i≤ ß mucΦ morσ flexiblσ utilit∙ thaε ì
  85. MODE═á anΣá i≤á typica∞ oµ thσ numerou≤á higΦá qualit∙á publiπ ì
  86. domaiε utilitie≤ availablσ iε "C".
  87.  
  88. Thσ versioε oµ YAM-8░ currentl∙ availablσ i≤ YA═ 3.12« Seσ thσ ì
  89. filσ YAM.DO├ fo≥ ful∞ documentatioε oε thσ program« 
  90.  
  91. A CP/M-86 version of YAM is also available from SIG/M.
  92.  
  93. :Getting "YAM" to your computer
  94.  
  95. Unti∞á yo⌡ havσ ß cop∙ oµ YA═ thσ onl∙ wa∙ t∩ transfe≥ datß i≤ ì
  96. a≤á ASCI╔á text«á YA═á i≤ ß biτ prograφá anΣá thσá chance≤á oµ ì
  97. transferrinτ i⌠ viß phonσ withou⌠ somσ error≤ i≤ no⌠ good.
  98.  
  99. Thσ solutioε i≤ t∩ usσ eithe≥ oµ thσ shor⌠ program≤á YAMBOOT.├ ì
  100. o≥á MBOOT.ASM«á YAMBOO╘ i≤ ß minima∞ versioε oµ YA═ (wel∞ sor⌠ ì
  101. of⌐  anΣ MBOO╘ i≤ ß minima∞ versioε oµ MODE═ «á Virtuall∙á al∞ ì
  102. the∙ caε d∩ i≤ receivσ file≤ usinτ thσ "Christensenó protocol« ì
  103. Thσá basiπá ideß i≤ tha⌠ yo⌡ transfe≥ YAMBOOT.├ o≥á MBOOT.ASM¼ ì
  104. whicΦá arσ relativel∙ short¼á t∩ you≥ systeφ a≤ ASCI╔ tex⌠á b∙ ì
  105. typinτá thσá file«á (Seσ thσ "YAMBOO╘á detailsóá categor∙á fo≥ ì
  106. details)«áá Yo⌡á theεá compile/assemblσá YAMBOOT/MBOOT¼áá witΦ ì
  107. appropriatσ UAR╘ datß fo≥ you≥ system¼á anΣ usσ i⌠ t∩ transfe≥ ì
  108. YA═ witΦ thσ securit∙ oµ ß protoco∞ transfer.
  109.  
  110. Theε yo⌡ compilσ thσ YA═ sourcσ codσ witΦ fo≥ you≥ computer.
  111. è
  112. :YAMBOOT details
  113.  
  114. Therσá i≤ ß prograφ calleΣ YAMBOOT.├ whicΦ i≤ thσ madσ u≡ froφ ì
  115. part≤ oµ thσ YA═ prograφ bu⌠ ha≤ n∩ 'frills'.
  116.  
  117. Iµá yo⌡á havσ somσ wa∙ t∩ prin⌠ you≥ dialoτ witΦá thi≤á systeφ ì
  118. theε TYP┼ thσ file¼á anΣ prin⌠ i⌠ t∩ you≥ printer«á YAMBOO╘ i≤ ì
  119. theε smal∞ enougΦ t∩ typσ int∩ you≥ systeφ anΣ compile.
  120.  
  121. Alternativel∙á iµ yo⌡ havσ aε ASCI╔ transfe≥ prograφá sucΦá a≤ ì
  122. BSTMS¼á TELNET¼á ASCO═á etπ whicΦ allow≤ yo⌡ t∩ capturσá ASCI╔ ì
  123. tex⌠á froφ ß remotσ system¼á yo⌡ caε savσ thσá YAMBOO╘á sourcσ ì
  124. tex⌠ a≤ ß filσ anΣ avoiΣ thσ retypinτ beforσ compilinτ it« 
  125.  
  126. Wheεá YAMBOO╘ ha≤ beeε compileΣ yo⌡ caε down-loaΣ thσ ful∞ YA═ ì
  127. program.
  128.  
  129. Seσá thσ READ-ME.YA═ filσ anΣ YAMBOOT.├ itselµ fo≥ detail≤á oµ ì
  130. wha⌠ yo⌡ neeΣ t∩ kno≈ t∩ compilσ YAMBOOT.
  131.  
  132.  
  133.  
  134.  
  135. YAMBOO╘ i≤ thσ MUC╚ easie≥ t∩ ge⌠ goinτ thaε MBOO╘ iµ yo⌡ havσ ì
  136. thσ BD╙ "Có compiler« Yo⌡ onl∙ neeΣ t∩ havσ you≥ BDSCIO.╚ filσ ì
  137. se⌠á u≡ correctl∙ fo≥ you≥ modeφ por⌠ (whicΦ i≤ obviousl∙á thσ ì
  138. casσá iµá yo⌡ arσ usinτ TELNET)«á Theε yo⌡ shoulΣ bσá ablσá t∩ ì
  139. compilσ YAMBOO╘ withou⌠ an∙ change≤ a⌠ all.
  140.  
  141. :The YAM/MODEM Handshake Protocol
  142.  
  143. BotΦá YA═á anΣá MODE═á usσ thσá samσá handshakσá protoco∞á fo≥ ì
  144. transferrinτá singlσ file≤ anΣ caε worδ witΦ eacΦ other«á The∙ ì
  145. usσ ß differen⌠ protoco∞ iε thσ "batchó modσ anΣ wil∞ NO╘ worδ ì
  146. witΦ eacΦ othe≥ iε thi≤ mode«á BotΦ YA═ anΣ MODE═ usσ thσ samσ ì
  147. CR├á checδ wheε runninτ iε tha⌠ modσ anΣ wil∞ worδá witΦá eacΦ ì
  148. othe≥ fo≥ singlσ filσ transfers.
  149.  
  150. Thσ "Christensenó protoco∞ useΣ b∙ YA═ anΣ MODE═ i≤á describeΣ ì
  151. iε thσ filσ PROTOCOL.LBR available through SIG/M.
  152.  
  153. :Other programs which WILL work with YAM
  154.  
  155. ListeΣá belo≈á arσ othe≥ program≤ whicΦ thσ SYSO╨á know≤á wil∞ ì
  156. worδ YAM« Iµ yo⌡ kno≈ oµ other≤ pleasσ leavσ ß messagσ fo≥ thσ ì
  157. SYSOP.
  158.  
  159. "RCPMLINK.COM" fo≥ thσ Osbornσ ▒ compute≥.
  160. ì
  161. Thi≤á prograφ use≤ thσ "Christensenó protocol≤ anΣ i≤á claimeΣ ì
  162. t∩á bσá full∙ compatiblσ witΦ MODEM«á Thσ SYSO╨ ha≤ testeΣá i⌠ ì
  163. witΦ YA═ anΣ successfull∙ transferreΣ file≤ iε botΦ direction≤ ì
  164. iεá thσá singlσ filσ mode«á RCPMLIN╦ i≤ ßá commercia∞á prograφ ì
  165. baseΣ oε MODEM« 
  166. è
  167.  
  168. "CMODEM.├"
  169.  
  170. Thi≤ prograφ i≤ froφ thσ "CNODEó RCP═ systeφ iε thσ US┴ anΣ i≤ ì
  171. writteεá iε BD╙ "C"«á ╔ havσ testeΣ i⌠ witΦ XYA═ anΣ i⌠á work≤ ì
  172. fine« I⌠ i≤ aε enhanceΣ versioε oµ YAMBOO╘ anΣ wil∞ senΣ file≤ ì
  173. a≤á wel∞á a≤ receivσ them¼á bu⌠ i≤ reall∙ onl∙ ß ver∙á minima∞ ì
  174. communication≤ utility« It is a public domain program.
  175.  
  176.  
  177. Sincσá thσá ful∞ YA═ sourcσ i≤ availablσ anΣ i⌠á offer≤á many¼ ì
  178. man∙ morσ facilitie≤ thaε CMODEM¼á therσ seem≤ littlσ poin⌠ iε ì
  179. usinτ CMODEM« Howeve≥ iµ yo⌡ havσ unusua∞ hardwarσ anΣ finΣ i⌠ ì
  180. difficul⌠á t∩ ge⌠ YA═ goinτ CMODE═ woulΣ probabl∙ bσ ßá easie≥ ì
  181. t∩ adapt«á I⌠ shoulΣ certainl∙ ruε oε an∙ systeφ tha⌠ caεá ruε ì
  182. TELNET«á  Alternativel∙ iµ yo⌡ havσ ß lo≈ capacit∙ disδ systeφ ì
  183. o≥á arσá shor⌠á oµ memor∙ thσ smalle≥ sizσ oµá CMODE═á ma∙á bσ ì
  184. attractivσáá t∩áá you«áá Seσáá thσá star⌠á oµáá CMODEM.├áá fo≥ ì
  185. documentation.
  186.  
  187.  
  188. "MODEM86"
  189.  
  190. Thi≤á prograφ i≤ froφ Compuvie≈ Product≤ anΣ run≤á unde≥á botΦ ì
  191. CP/M-8╢ anΣ MSDOS« I⌠ i≤ basicall∙ aε "86ó versioε oµ MODE═ 7« ì
  192. I⌠á ha≤á ß fe≈ installatioε selection≤ bu⌠ unles≤ yo⌡ havσá aε ì
  193. IBM-P├á o≥á Sirius-▒á bσá prepareΣ t∩á d∩á somσá 8╢á assemble≥ ì
  194. programminτá t∩ ge⌠ thi≤ prograφ working«á ╔ wa≤ ablσá t∩á ge⌠ ì
  195. MODEM8╢á runninτá oεá m∙á Godbou⌠ systeφ anΣ oεá thσá NE├á AP├ ì
  196. withou⌠ to∩ mucΦ hassle« Oncσ it≤ running¼ i⌠ work≤ wellí  
  197.  
  198.  
  199. "TELED"
  200.  
  201. Thi≤á publiπ domaiε prograφ i≤ distributeΣ witΦ BD╙ ├á Versioε ì
  202. 1.5░á o≥á later«á I⌠á offer≤ considerabl∙ morσá feature≤á thaε ì
  203. CMODE═á bu⌠á considerabl∙á les≤ thaεá YAM«á ╔á woulΣá ratσá i⌠ ì
  204. relativel∙ eas∙ t∩ ge⌠ goinτ anΣ ß gooΣ firs⌠ excercisσ iµ yo⌡ ì
  205. aσ jus⌠ gettinτ useΣ t∩ ├ a≤ ß programminτ language«á I⌠ work≤ ì
  206. wel∞á witΦá XYAM«á ì
  207.  
  208.  
  209. "MITE"
  210.  
  211. Thi≤á commercia∞á prograφ i≤ froφ Mycrof⌠ Lab≤á anΣá i≤á quitσ ì
  212. nicel∙á done«á I⌠ i≤ availablσ iε CP/M-80¼á CP/M-8╢ anΣá MSDO╙ ì
  213. versions«á I⌠á come≤ witΦ interface≤ t∩ severa∞ popula≥ micro-ì
  214. computer≤ a≤ wel∞ a≤ enougΦ informatioε t∩ writσ ßá customiseΣ ì
  215. interfacσ iµ yo⌡ can'⌠ usσ onσ oµ thσ supplieΣ ones«á  I⌠ tooδ ì
  216. mσ ß fe≈ hour≤ onσ eveninτ t∩ writσ ß 265▒ USAR╘ interfacσ fo≥ ì
  217. m∙ Godbou⌠ S-10░ system« Thσ prograφ ha≤ botΦ ß men⌡ systeφ o≥ ì
  218. ßá serie≤ oµ direc⌠ commands«á Als∩ usefu∞ i≤ ß paramete≥ filσ ì
  219. systeφ whicΦ allow≤ al∞ thσ parameter≤ whicΦ goverεá operatioε ì
  220. witΦá an∙á particula≥á remotσ systeφ t∩ bσ stasheΣ awa∙á iεá ß ì
  221. paramete≥ file¼ theε recalleΣ anΣ automaticall∙ se⌠.
  222.  
  223. A≤ wel∞ a≤ Christenseε protoco∞ i⌠ support≤ thσ Mycroft¼ CLIN╦ ì
  224. anΣ LYN├ binar∙ protocols«á Work≤ wel∞ witΦ XYAM«á Thσá manua∞ ì
  225. als∩áá contain≤áá somσáá gooΣá tutoria∞áá materia∞áá oεáá datß ì
  226. communication≤ anΣ thσ RS-232-├ standard« Somewherσ abou⌠ halµ ì
  227. wa∙ betweeε MODE═ anΣ YA═ iε term≤ oµ feature≤ anΣ facilities.
  228.  
  229.  
  230. "ASCOM"
  231.  
  232. Late≥ version≤ oµ thi≤ prograφ froφ DM┴ suppor⌠ wha⌠ the∙ terφ ì
  233. "CP/═áá Use≥áá Grou≡á Protocolóá whicΦá i≤á thei≥áá namσáá fo≥ ì
  234. "Christensenó protocol« ╔ havσ testeΣ ASCO═ Ve≥ 2.┤ oε ß CP/M-ì
  235. 8╢á systeφ witΦ XYA═ anΣ i⌠ workeΣ finσ iε filσ transfe≥á modσ ì
  236. iε botΦ directions«á ╔ assumσ tha⌠ thσ equivalen⌠ CP/M-8░á anΣ ì
  237. MSDO╙á version≤á shoulΣá als∩ worδ OK«á Bσá carefu∞á witΦá thσ ì
  238. interfacσá routine≤ fo≥ yo⌡ USART«á ╔ haΣ t∩ rewritσ thσá 825▒ ì
  239. interfacσ fo≥ thσ NE├ AP├ ╔ wa≤ usinτ t∩ tes⌠ ASCO═ on¼ a≤ thσ ì
  240. AP├ interfacσ supplieΣ b∙ DM┴ haΣ n∩ hopσ oµ working.
  241.  
  242.  
  243. "MODEM-901/86"
  244.  
  245. Thi≤ i≤ ß publiπ domaiε prograφ translateΣ t∩ CP/M-8╢ froφ thσ ì
  246. CP/M-8░á versioεá b∙á Mikσá Mellinge≥á anΣá I«á I⌠á shoulΣá bσ ì
  247. adaptablσá fo≥á an∙ CP/M-8╢ systeφ (bu⌠á no⌠á witΦá Concurren⌠ ì
  248. CP/M-8╢áá withou⌠á furthe≥á work)«áá I⌠á ha≤á beeεá testeΣá oε ì
  249. Godbout/Compupro¼á NE├á AP├á anΣ DE├ Rainbo≈ 10░á systems«á I⌠ ì
  250. available through SIG/M in MODEM-86.LBR.
  251.  
  252.  
  253. MODEM68
  254.  
  255. Thi≤ i≤ ß publiπ domaiε prograφ writteε iε 680░ assemble≥á fo≥ ì
  256. operatioε unde≥ thσ FLE╪ operatinτ system« I⌠ wa≤ developeΣ a⌠ ì
  257. Telecoφ Australiß anΣ i≤ claimeΣ b∙ Telecoφ 680░ user≤ t∩ worδ ì
  258. well«á A≤ ╔ don'⌠ havσ acces≤ t∩ ß 680░ systeφ ╔ haven'⌠á eve≥ ì
  259. useΣá i⌠ myself«á Thσ prograφ i≤ supposeΣ t∩ "lookó ver∙á mucΦ ì
  260. likσ MODEM╖ a≤ fa≥ a≤ thσ use≥ interfacσ goes.
  261.  
  262. MODEM6╕ i≤ availablσ through SIG/M as MOD68-13.LBR
  263.  
  264.  
  265. UMODEM
  266.  
  267. Thi≤ prograφ i≤ writteε iε "Có fo≥ Uni° systems« I⌠ implement≤ ì
  268. thσá "Christensenóá protoco∞ anΣ i≤ compatiblσá witΦá YA═á anΣ ì
  269. MODEM«á Versioε 2.╖  ha≤ beeε implementeΣ oε thσ BASSER-VA╪ a⌠ ì
  270. Sydne∙ Universit∙ anΣ work≤ finσ iε non-batcΦ mode.
  271.  
  272.  
  273.  
  274. PC-TALK
  275.  
  276. Thi≤ prograφ i≤ writteε iε BASI├ fo≥ thσ IBM-P├ runninτ PCDOS« ì
  277. I⌠á implement≤ Christenseε protoco∞ anΣ i≤ compatiblσ witΦ YA═ ì
  278. anΣ MODEM«á Beinτ writteε iε BASI├ i⌠ i≤ slow¼á gooΣ onl∙á fo≥ ì
  279. 30░á bp≤ operatioε witΦ thσ IB═ BASI├ interprete≥ anΣ 120░ bp≤ ì
  280. operatioεá witΦá IB═á BASI├á compiler«á Thσá sourcσá codσá anΣ ì
  281. documentatioε arσ availablσ oε PC/BLUE volume≤ 3▒ anΣ 32.
  282.  
  283.  
  284. DOS/65 MODEM
  285.  
  286. Thi≤á come≤á witΦ thσ DOS/6╡ operatinτ systeφ fo≥á 650▓á baseΣ ì
  287. machines« Severa∞ user≤ havσ tolΣ mσ tha⌠ i⌠ doe≤ successfull∙ ì
  288. transfe≥ file≤ witΦ XYA═ froφ thi≤ system«á ╔ don'⌠ kno≈ wherσ ì
  289. you get it.
  290.  
  291. :Other programs which MAY work with YAM
  292.  
  293. ListeΣá belo≈ arσ othe≥ program≤ whicΦ thσ SYSO╨ suspect≤á ma∙ ì
  294. worδá witΦá YAM«á Thesσ program≤ havσ NO╘ beeε testeΣ anΣá thσ ì
  295. SYSO╨ woulΣ appreciatσ an∙ furthe≥ information.
  296.  
  297. **¬á Therσá arσá n∩ program≤ whicΦ fi⌠ thi≤á categor∙á a⌠á thσ ì
  298. moment ***
  299.  
  300. :Preconfigured version of YAM for specific systems
  301.  
  302. WitΦ reasonablσ skill¼á thσ "standardó version≤ oµ YAM/YAMBOO╘ ì
  303. shoulΣá bσ ablσ t∩ bσ implementeΣ oε an∙ CP/═ system«á Howeve≥ ì
  304. duσ t∩ thσ non-standarΣ naturσ oµ somσá systems¼á particularl∙ ì
  305. system≤ no⌠ originall∙ intendeΣ fo≥ CP/═ operatioε sucΦ a≤ thσ ì
  306. Applσ 2¼á ß preconfigureΣ versioε oµ thσ YA═ ma∙ bσ available« ì
  307. Thσáá filσá READ-ME.YA═á wil∞á tel∞á yo⌡á whicΦá preconfigureΣ ì
  308. version≤ arσ currentl∙ available.
  309.  
  310. Thesσ preconfigureΣ version≤ havσ beeε contributeΣ b∙ use≤ wh∩ ì
  311. haΣ t∩ develo≡ theφ thσ "hardó way« Iµ yo⌡ d∩ ß ne≈ versioε oµ ì
  312. thσ communication≤ utilitie≤ fo≥ you≥ systeφ pleasσ contributσ ì
  313. you≥á versioε s∩ tha⌠ othe≥ user≤ oµ you≥ typσ oµá systeφá caε ì
  314. benefi⌠ froφ you≥ efforts.
  315.  
  316. :XYAM
  317.  
  318. XYA═á i≤ ß specia∞ versioε oµ YAM«á I⌠ i≤ designeΣ fo≥ usσá oε ì
  319. RCP═á system≤á anΣá a≤á sucΦá i⌠á ha≤á somσá specia∞á feature≤ ì
  320. necessar∙ iε tha⌠ sor⌠ oµ environment.
  321.  
  322. Generall∙ thesσ feature≤ arσ designeΣ t∩ makσ theφ i⌠ fo≥á thσ ì
  323. remotσá use≥á t∩ contro∞ (i.e«á morσ messages⌐ anΣ t∩á preven⌠ ì
  324. "dangerousóá thing≤á happeninτ t∩ thσ RCP═á systeφá (i.e«á CO═ ì
  325. file≤á beinτá sen⌠ t∩ thσ RCP═ systeφ anΣ theε beinτá useΣá t∩ ì
  326. crasΦ thσ system)« 
  327.  
  328. Oεá an∙á RCP═ systeφ therσ arσ certaiε systeφ file≤ whicΦá arσ ì
  329. no⌠á availablσ fo≥ transfe≥ (fo≥ ß variet∙á oµá reasons)«á Thσ ì
  330. XYA═á prograφá caε detec⌠ thesσ file≤ anΣá wil∞á no⌠á transfe≥ ì
  331. them.
  332.  
  333. XYA═ i≤ ß superio≥ replacemen⌠ fo≥ XMODEM« YA═ anΣ XYA═ caε bσ ì
  334. buil⌠á froφá thσ samσ se⌠ oµ sourcσ files«á Yo⌡ onl∙á neeΣá t∩ ì
  335. change a few definitions in the header files and recompile.ì
  336.  
  337. :Using CRCK to check file transfers
  338. è
  339. Whateve≥ methoΣ yo⌡ usσ t∩ transfe≥ file≤ froφ ß remotσ systeφ ì
  340. therσ i≤ ß wa∙ yo⌡ caε seσ iµ yo⌡ endeΣ u≡ witΦ ß gooΣ cop∙ oµ ì
  341. thσ files« I⌠ involve≤ comparinτ CR├ checksum≤ oµ thσ files.
  342.  
  343. T∩á obtaiεá thσ CR├ checksuφ oµ ß filσ oε thσ RCP═ systeφá usσ ì
  344. the XYAM utility. At the XYAM prompt give the command
  345.  
  346.      CRCK filename
  347.  
  348. XYA═á wil∞ givσ yo⌡ ß ┤ digi⌠ hexadecima∞ numbe≥ whicΦ i≤á thσ ì
  349. checksum of the file derived using the CCITT polynomial.
  350.  
  351. T∩ obtaiε thσ CR├ checksuφ a⌠ you≥ enΣ usσ thσ CRC╦ commanΣ iε ì
  352. you≥á cop∙á oµ YA═ o≥ iµ yo⌡ aren'⌠ usinτ YA═ usσ thσá CRC.CO═ ì
  353. utility«á Thσá CR├ checksuφ produceΣ b∙ CRC.CO═ i≤ thσ samσ a≤ ì
  354. i≤ produceΣ b∙ thσ CRC╦ functioε iε YAM.
  355.  
  356. Thσ CRC╦ number≤ fo≥ thσ filσ oε thσ RCP═ systeφ anΣ thσá dowε ì
  357. loadeΣá filσ oε you≥ systeφ shoulΣ bσ identical«á Iµ the∙á arσ ì
  358. not, an error occurred during the file transfer.
  359.  
  360.  
  361.  
  362. Thσá samσ methoΣ caε bσ useΣ t∩ checδ tha⌠ file≤ u≡ loadeΣá t∩ ì
  363. the RCPM system were received correctly.
  364.  
  365. Thσá morσá recen⌠ Use≥ Grou≡ volume≤ wil∞ havσ CR├ file≤á witΦ ì
  366. checksum≤á fo≥á al∞ thσ file≤ oε thσ volumσ o≥ wil∞á havσá CR├ ì
  367. informatioεá iεá thσá volumσ -CATALO╟ file«á Iµá yo⌡á havσá t∩ ì
  368. archivσá you≥á owεá program≤á it≤ ß gooΣ ideßá t∩á pu⌠á ßá CR├ ì
  369. checksuφá filσ oε eacΦ archivσ disk¼á wheε yo⌡ neeΣ t∩á acces≤ ì
  370. thσ archivσ file≤ yo⌡ caε easil∙ checδ t∩ seσ iµ thσ file≤ arσ ì
  371. stil∞ intac⌠ beforσ usinτ them.
  372.  
  373. :Adapt this help file to your needs
  374.  
  375. Thi≤á hel≡á filσ fo≥ YA═ i≤ simpl∙ ß cu⌠ dowε versioεá oµá thσ ì
  376. hel≡á filσá tha⌠ ╔ usσ oε thσ Softwarσ Tool≤ RCP═ t∩á describσ ì
  377. botΦ thσ MODE═ anΣ YA═ t∩ user≤ oµ thσ system«á Oε onσ oµá thσ ì
  378. previou≤á SIG/═ volume≤ you'l∞ finΣ aε earlie≥ versioε oµá thσ ì
  379. compositσ YAM/MODE═ filσ calleΣ MODEM.HLP.
  380.  
  381. Yo⌡á shoulΣá adap⌠ thi≤ hel≡ filσ t∩ mee⌠ YOU╥ need≤á oεá you≥ ì
  382. system¼á i⌠ i≤ reall∙ herσ simpl∙ a≤ ß guidσ toward≤ thσ sort≤ ì
  383. oµá thing≤ ne≈ user≤ wil∞ neeΣ t∩ know«á Thσ grea⌠ benefi⌠á oµ ì
  384. thσ HEL╨ utilit∙ anΣ HL╨ file≤ i≤ tha⌠ user≤ seeφ t∩á actuall∙ ì
  385. REA─á them¼á whicΦá i≤ somethinτ the∙ rarel∙ seeφ t∩á d∩á witΦ ì
  386. conventiona∞ DO├ files.
  387.  
  388. M∙á ideß witΦ thi≤ hel≡ filσ i≤ t∩ arousσ enougΦá interes⌠á iε ì
  389. thσá prospectivσ YA═ use≥ t∩ makσ theφ WAN╘ t∩ g∩ ou⌠ anΣ reaΣ ì
  390. thσ othe≥ YA═ documentatioε files.
  391.  
  392.                                    Bill Bolton,
  393. è                                   Software Tools RCPM
  394.                                    June 1, 1984
  395.