INTRODUCTION to the YAM Communications Utility The "YAM" family of programs Gettinç "YAM¢ tï youò computeò YAMBOOT details The YAM/MODEM Handshake Protocol Other programs which WILL work with YAM ** 20/Jun/84 ** Other programs which MAY work with YAM Preconfigured versions of YAM for specific computers XYAM Using CRCK to check file transfers Adapt this help file to your needs :Introduction Thå  concepô  oæ  Remotå CP/Í (RCPM© systemó relieó  oî  useró havinç thå abilitù tï transfeò fileó tï anä froí thå systeí iî somå  securå  manner®  Thå  securitù  comeó  froí  handshakinç betweeî  thå sendeò anä receiveò tï leô thå sendeò  kno÷  thaô thå receiveò goô á gooä (nï errors© copù oæ thå file. Prioò tï thå advenô oæ RCPÍ typå systemó therå haä beeî littlå neeä  foò theså typå oæ programó iî Australiá aó microcomputeò useró havå noô beeî stronglù communicationó  oriented¬  mostlù duå  tï  restrictivå  policieó oî thå parô  oæ  Telecom®  Whaô littlå  neeä  therå  haó  beeî  haó  beeî  met¬  iî  thå  CP/Í environmenô aô least¬ bù commerciaì programó sucè aó BSTAM® Whaô  ió  requireä foò interactivå communicatioî witè  á  RCPÍ systeí  ió utilitù whicè wilì allo÷ ASCIÉ  communicationó  foò logiî  anä  RCPÍ  commanä  instigatioî  anä  wilì  alsï  allo÷ handshakinç  (oò  protocol© filå transferó iî botè  directionó withouô  havinç  tï  returî tï thå  operatinç  systeí  commanä level. Iî thå USA¬  RCPÍ systemó havå beeî oî linå foò severaì  yearó anä  numerouó  programó whicè fulfilì thå  abovå  requirementó havå beeî developed® Development has follwed twï streams. Thå firsô streaí ió thå serieó oæ programó whicè gï undeò  thå generiã  titlå  oæ  "MODEM"®  Theså programó alì steí  froí  á prograí  writteî  bù  Warä  Christenseî  foò  thå  verù  firsô microcomputeò bulletiî boarä systeí iî thå world¬  thå Chicagï CBBS® Thå MODEÍ programó arå alì writteî iî assembleò codå anä arå iî thå publiã domain. Thå  seconä streaí ió á serieó oæ programó whicè gï undeò  thå namå oæ YAÍ ("Y"eô "A"notheò "M"odem program)®  Theså programó steí  froí attemptó tï rewritå thå MODEÍ programó intï thå "C¢ higè leveì language® Thå YAÍ programs¬ bù Chucë Forsberg¬ gre÷ froí  thå MODEM.à programs®  YAÍ offeró manù  morå  facilitieó thaî  MODEÍ  anä ió easieò tï maintain®  YAÍ programó uså  thå samå  protocoló aó thå MODEÍ programó anä theù wilì "talk¢  tï eacè other. They are also in the public domain. :The "YAM" family of programs Š YAÍ ió writteî iî á modern¬  higè leveì language¬  "C"® Iô waó writteî  witè thå ideá thaô iô shoulä bå transportablå tï non- CP/Í  environmentó  anä  ió thå best choicå  iæ  yoõ  arå  noô runninç  in a CP/M environment.  É alsï consideò iô  thå  besô choice if you are running CP/M. Thå  prograí  ió writteî iî á modulaò manneò anä alì thå  UARÔ dependenô  routineó  arå containeä iî á  singlå  module®  Somå otheò  hardwarå dependenô informatioî (sucè aó porô  addresseó etc©  ió  containeä  iî headeò files®  Thió makå  iô  easù  tï supporô  multiplå versionó oæ YAÍ froí substantiallù thå  samå seô  oæ files®  Thå SYSOÐ ió currentlù supportinç ³  differenô UARÔ versionó oæ YAÍ froí thå onå seô oæ sourcå files. Yoõ  wilì neeä tï havå thå BDÓ "C¢ compiler¬  versioî 1.50  oò later¬ tï compilå YAM-80® Iæ  yoõ  arå  comfortablå witè thå  "C¢  languagå  yoõ  shoulä definitelù  uså  YAÍ  insteaä oæ MODEM®  Eveî iæ yoõ  arå  noô familiaò  witè "C¢ iô ió wortè thå efforô oæ learning¬  tï  bå ablå tï compilå YAM®  YAÍ ió á mucè morå flexiblå utilitù thaî MODEÍ  anä  ió  typicaì oæ thå numerouó  higè  qualitù  publiã domaiî utilitieó availablå iî "C". Thå versioî oæ YAM-8° currentlù availablå ió YAÍ 3.12® Seå thå filå YAM.DOà foò fulì documentatioî oî thå program® A CP/M-86 version of YAM is also available from SIG/M. :Getting "YAM" to your computer Untiì  yoõ havå á copù oæ YAÍ thå onlù waù tï transfeò datá ió aó  ASCIÉ  text®  YAÍ  ió á biç prograí  anä  thå  chanceó  oæ transferrinç iô viá phonå withouô somå erroró ió noô good. Thå solutioî ió tï uså eitheò oæ thå shorô programó  YAMBOOT.à oò  MBOOT.ASM®  YAMBOOÔ ió á minimaì versioî oæ YAÍ (welì sorô of© anä MBOOÔ ió á minimaì versioî oæ MODEÍ ®  Virtuallù  alì theù caî dï ió receivå fileó usinç thå "Christensen¢ protocol® Thå  basiã  ideá ió thaô yoõ transfeò YAMBOOT.à oò  MBOOT.ASM¬ whicè  arå relativelù short¬  tï youò systeí aó ASCIÉ texô  bù typinç  thå  file®  (Seå thå "YAMBOOÔ  details¢  categorù  foò details)®   Yoõ  theî  compile/assemblå  YAMBOOT/MBOOT¬   witè appropriatå UARÔ datá foò youò system¬  anä uså iô tï transfeò YAÍ witè thå securitù oæ á protocoì transfer. Theî yoõ compilå thå YAÍ sourcå codå witè foò youò computer. Š :YAMBOOT details Therå  ió á prograí calleä YAMBOOT.à whicè ió thå madå uð froí partó oæ thå YAÍ prograí buô haó nï 'frills'. Iæ  yoõ  havå somå waù tï prinô youò dialoç witè  thió  systeí theî TYPÅ thå file¬  anä prinô iô tï youò printer®  YAMBOOÔ ió theî smalì enougè tï typå intï youò systeí anä compile. Alternativelù  iæ yoõ havå aî ASCIÉ transfeò prograí  sucè  aó BSTMS¬  TELNET¬  ASCOÍ  etã whicè allowó yoõ tï capturå  ASCIÉ texô  froí á remotå system¬  yoõ caî savå thå  YAMBOOÔ  sourcå texô aó á filå anä avoiä thå retypinç beforå compilinç it® Wheî  YAMBOOÔ haó beeî compileä yoõ caî down-loaä thå fulì YAÍ program. Seå  thå READ-ME.YAÍ filå anä YAMBOOT.à itselæ foò detailó  oæ whaô yoõ neeä tï kno÷ tï compilå YAMBOOT. YAMBOOÔ ió thå MUCÈ easieò tï geô goinç thaî MBOOÔ iæ yoõ havå thå BDÓ "C¢ compiler® Yoõ onlù neeä tï havå youò BDSCIO.È filå seô  uð correctlù foò youò modeí porô (whicè ió obviouslù  thå caså  iæ  yoõ arå usinç TELNET)®  Theî yoõ shoulä bå  ablå  tï compilå YAMBOOÔ withouô anù changeó aô all. :The YAM/MODEM Handshake Protocol Botè  YAÍ  anä  MODEÍ  uså thå  samå  handshakå  protocoì  foò transferrinç  singlå fileó anä caî worë witè eacè other®  Theù uså á differenô protocoì iî thå "batch¢ modå anä wilì NOÔ worë witè eacè otheò iî thió mode®  Botè YAÍ anä MODEÍ uså thå samå CRà checë wheî runninç iî thaô modå anä wilì worë  witè  eacè otheò foò singlå filå transfers. Thå "Christensen¢ protocoì useä bù YAÍ anä MODEÍ ió  describeä iî thå filå PROTOCOL.LBR available through SIG/M. :Other programs which WILL work with YAM Listeä  belo÷  arå otheò programó whicè thå SYSOР knowó  wilì worë YAM® Iæ yoõ kno÷ oæ otheró pleaså leavå á messagå foò thå SYSOP. "RCPMLINK.COM" foò thå Osbornå ± computeò. Thió  prograí useó thå "Christensen¢ protocoló anä ió  claimeä tï  bå  fullù compatiblå witè MODEM®  Thå SYSOÐ haó testeä  iô witè YAÍ anä successfullù transferreä fileó iî botè directionó iî  thå  singlå filå mode®  RCPMLINË ió á  commerciaì  prograí baseä oî MODEM® Š "CMODEM.Ã" Thió prograí ió froí thå "CNODE¢ RCPÍ systeí iî thå USÁ anä ió writteî  iî BDÓ "C"®  É havå testeä iô witè XYAÍ anä iô  workó fine® Iô ió aî enhanceä versioî oæ YAMBOOÔ anä wilì senä fileó aó  welì  aó receivå them¬  buô ió reallù onlù á verù  minimaì communicationó utility® It is a public domain program. Sincå  thå  fulì YAÍ sourcå ió availablå anä iô  offeró  many¬ manù morå facilitieó thaî CMODEM¬  therå seemó littlå poinô iî usinç CMODEM® Howeveò iæ yoõ havå unusuaì hardwarå anä finä iô difficulô  tï geô YAÍ goinç CMODEÍ woulä probablù bå á  easieò tï adapt®  Iô shoulä certainlù ruî oî anù systeí thaô caî  ruî TELNET®  Alternativelù iæ yoõ havå á lo÷ capacitù disë systeí oò  arå  shorô  oæ memorù thå smalleò sizå oæ  CMODEÍ  maù  bå attractivå   tï   you®   Seå   thå  starô  oæ   CMODEM.à  foò documentation. "MODEM86" Thió  prograí ió froí Compuvie÷ Productó anä runó  undeò  botè CP/M-8¶ anä MSDOS® Iô ió basicallù aî "86¢ versioî oæ MODEÍ 7® Iô  haó  á fe÷ installatioî selectionó buô unlesó yoõ havå  aî IBM-Pà oò  Sirius-±  bå  prepareä tï  dï  somå  8¶  assembleò programminç  tï geô thió prograí working®  É waó ablå  tï  geô MODEM8¶  runninç  oî  mù  Godbouô systeí anä oî  thå  NEà APà withouô toï mucè hassle® Oncå itó running¬ iô workó well¡ "TELED" Thió  publiã domaiî prograí ió distributeä witè BDÓ Ã  Versioî 1.5°  oò  later®  Iô  offeró considerablù morå  featureó  thaî CMODEÍ  buô  considerablù  lesó thaî  YAM®  É  woulä  ratå  iô relativelù easù tï geô goinç anä á gooä firsô excerciså iæ yoõ aå jusô gettinç useä tï à aó á programminç language®  Iô workó welì  witè  XYAM®  "MITE" Thió  commerciaì  prograí ió froí Mycrofô Labó  anä  ió  quitå nicelù  done®  Iô ió availablå iî CP/M-80¬  CP/M-8¶ anä  MSDOÓ versions®  Iô  comeó witè interfaceó tï severaì populaò micro- computeró aó welì aó enougè informatioî tï writå á  customiseä interfacå iæ yoõ can'ô uså onå oæ thå supplieä ones®  Iô tooë må á fe÷ houró onå eveninç tï writå á 265± USARÔ interfacå foò mù Godbouô S-10° system® Thå prograí haó botè á menõ systeí oò á  serieó oæ direcô commands®  Alsï usefuì ió á parameteò filå systeí whicè allowó alì thå parameteró whicè goverî  operatioî witè  anù  particulaò  remotå systeí tï bå stasheä awaù  iî  á parameteò file¬ theî recalleä anä automaticallù seô. Aó welì aó Christenseî protocoì iô supportó thå Mycroft¬ CLINË anä LYNà binarù protocols®  Workó welì witè XYAM®  Thå  manuaì alsï   containó   somå   gooä  tutoriaì   materiaì   oî   datá communicationó anä thå RS-232-à standard® Somewherå abouô halæ waù betweeî MODEÍ anä YAÍ iî termó oæ featureó anä facilities. "ASCOM" Lateò versionó oæ thió prograí froí DMÁ supporô whaô theù terí "CP/Í   Useò   Grouð  Protocol¢  whicè  ió  theiò   namå   foò "Christensen¢ protocol® É havå testeä ASCOÍ Veò 2.´ oî á CP/M- 8¶  systeí witè XYAÍ anä iô workeä finå iî filå transfeò  modå iî botè directions®  É assumå thaô thå equivalenô CP/M-8°  anä MSDOÓ  versionó  shoulä  alsï worë OK®  Bå  carefuì  witè  thå interfacå  routineó foò yoõ USART®  É haä tï rewritå thå  825± interfacå foò thå NEà APÃ É waó usinç tï tesô ASCOÍ on¬ aó thå APà interfacå supplieä bù DMÁ haä nï hopå oæ working. "MODEM-901/86" Thió ió á publiã domaiî prograí translateä tï CP/M-8¶ froí thå CP/M-8°  versioî  bù  Mikå  Mellingeò  anä  I®  Iô  shoulä  bå adaptablå  foò  anù CP/M-8¶ systeí (buô  noô  witè  Concurrenô CP/M-8¶   withouô  furtheò  work)®   Iô  haó  beeî  testeä  oî Godbout/Compupro¬  NEà APà anä DEà Rainbo÷ 10°  systems®  Iô available through SIG/M in MODEM-86.LBR. MODEM68 Thió ió á publiã domaiî prograí writteî iî 680° assembleò  foò operatioî undeò thå FLEØ operatinç system® Iô waó developeä aô Telecoí Australiá anä ió claimeä bù Telecoí 680° useró tï worë well®  Aó É don'ô havå accesó tï á 680° systeí É haven'ô  eveò useä  iô myself®  Thå prograí ió supposeä tï "look¢ verù  mucè likå MODEM· aó faò aó thå useò interfacå goes. MODEM6¸ ió availablå through SIG/M as MOD68-13.LBR UMODEM Thió prograí ió writteî iî "C¢ foò Uniø systems® Iô implementó thå  "Christensen¢  protocoì anä ió compatiblå  witè  YAÍ  anä MODEM®  Versioî 2.· haó beeî implementeä oî thå BASSER-VAØ aô Sydneù Universitù anä workó finå iî non-batcè mode. PC-TALK Thió prograí ió writteî iî BASIà foò thå IBM-Pà runninç PCDOS® Iô  implementó Christenseî protocoì anä ió compatiblå witè YAÍ anä MODEM®  Beinç writteî iî BASIà iô ió slow¬  gooä onlù  foò 30°  bpó operatioî witè thå IBÍ BASIà interpreteò anä 120° bpó operatioî  witè  IBÍ  BASIà compiler®  Thå  sourcå  codå  anä documentatioî arå availablå oî PC/BLUE volumeó 3± anä 32. DOS/65 MODEM Thió  comeó  witè thå DOS/6µ operatinç systeí foò  650²  baseä machines® Severaì useró havå tolä må thaô iô doeó successfullù transfeò fileó witè XYAÍ froí thió system®  É don'ô kno÷ wherå you get it. :Other programs which MAY work with YAM Listeä  belo÷ arå otheò programó whicè thå SYSOÐ suspectó  maù worë  witè  YAM®  Theså programó havå NOÔ beeî testeä anä  thå SYSOÐ woulä appreciatå anù furtheò information. **ª  Therå  arå  nï programó whicè fiô thió  categorù  aô  thå moment *** :Preconfigured version of YAM for specific systems Witè reasonablå skill¬  thå "standard¢ versionó oæ YAM/YAMBOOÔ shoulä  bå ablå tï bå implementeä oî anù CP/Í system®  Howeveò duå tï thå non-standarä naturå oæ somå  systems¬  particularlù systemó noô originallù intendeä foò CP/Í operatioî sucè aó thå Applå 2¬  á preconfigureä versioî oæ thå YAÍ maù bå available® Thå   filå  READ-ME.YAÍ  wilì  telì  yoõ  whicè  preconfigureä versionó arå currentlù available. Theså preconfigureä versionó havå beeî contributeä bù useó whï haä tï develoð theí thå "hard¢ way® Iæ yoõ dï á ne÷ versioî oæ thå communicationó utilitieó foò youò systeí pleaså contributå youò  versioî sï thaô otheò useró oæ youò typå oæ  systeí  caî benefiô froí youò efforts. :XYAM XYAÍ  ió á speciaì versioî oæ YAM®  Iô ió designeä foò uså  oî RCPÍ  systemó  anä  aó  sucè  iô  haó  somå  speciaì  featureó necessarù iî thaô sorô oæ environment. Generallù theså featureó arå designeä tï makå theí iô foò  thå remotå  useò  tï controì (i.e®  morå messages© anä tï  prevenô "dangerous¢  thingó  happeninç tï thå RCPÍ  systeí  (i.e®  COÍ fileó  beinç  senô tï thå RCPÍ systeí anä theî beinç  useä  tï crasè thå system)® Oî  anù  RCPÍ systeí therå arå certaiî systeí fileó whicè  arå noô  availablå foò transfeò (foò á varietù  oæ  reasons)®  Thå XYAÍ  prograí  caî detecô theså fileó anä  wilì  noô  transfeò them. XYAÍ ió á superioò replacemenô foò XMODEM® YAÍ anä XYAÍ caî bå builô  froí  thå samå seô oæ sourcå files®  Yoõ onlù  neeä  tï change a few definitions in the header files and recompile. :Using CRCK to check file transfers Š Whateveò methoä yoõ uså tï transfeò fileó froí á remotå systeí therå ió á waù yoõ caî seå iæ yoõ endeä uð witè á gooä copù oæ thå files® Iô involveó comparinç CRà checksumó oæ thå files. Tï  obtaiî  thå CRà checksuí oæ á filå oî thå RCPÍ systeí  uså the XYAM utility. At the XYAM prompt give the command CRCK filename XYAÍ  wilì givå yoõ á ´ digiô hexadecimaì numbeò whicè ió  thå checksum of the file derived using the CCITT polynomial. Tï obtaiî thå CRà checksuí aô youò enä uså thå CRCË commanä iî youò  copù  oæ YAÍ oò iæ yoõ aren'ô usinç YAÍ uså thå  CRC.COÍ utility®  Thå  CRà checksuí produceä bù CRC.COÍ ió thå samå aó ió produceä bù thå CRCË functioî iî YAM. Thå CRCË numberó foò thå filå oî thå RCPÍ systeí anä thå  dowî loadeä  filå oî youò systeí shoulä bå identical®  Iæ theù  arå not, an error occurred during the file transfer. Thå  samå methoä caî bå useä tï checë thaô fileó uð loadeä  tï the RCPM system were received correctly. Thå  morå  recenô Useò Grouð volumeó wilì havå CRà fileó  witè checksumó  foò  alì thå fileó oî thå volumå oò wilì  havå  CRà informatioî  iî  thå  volumå -CATALOÇ file®  Iæ  yoõ  havå  tï archivå  youò  owî  programó  itó á gooä ideá  tï  puô  á  CRà checksuí  filå oî eacè archivå disk¬  wheî yoõ neeä tï  accesó thå archivå fileó yoõ caî easilù checë tï seå iæ thå fileó arå stilì intacô beforå usinç them. :Adapt this help file to your needs Thió  helð  filå foò YAÍ ió simplù á cuô dowî versioî  oæ  thå helð  filå  thaô É uså oî thå Softwarå Tooló RCPÍ tï  describå botè thå MODEÍ anä YAÍ tï useró oæ thå system®  Oî onå oæ  thå previouó  SIG/Í volumeó you'lì finä aî earlieò versioî oæ  thå compositå YAM/MODEÍ filå calleä MODEM.HLP. Yoõ  shoulä  adapô thió helð filå tï meeô YOUÒ needó  oî  youò system¬  iô ió reallù herå simplù aó á guidå towardó thå sortó oæ  thingó ne÷ useró wilì neeä tï know®  Thå greaô benefiô  oæ thå HELÐ utilitù anä HLÐ fileó ió thaô useró seeí tï  actuallù REAÄ  them¬  whicè  ió somethinç theù rarelù seeí tï  dï  witè conventionaì DOà files. Mù  ideá witè thió helð filå ió tï arouså enougè  interesô  iî thå  prospectivå YAÍ useò tï makå theí WANÔ tï gï ouô anä reaä thå otheò YAÍ documentatioî files. Bill Bolton, Š Software Tools RCPM June 1, 1984