INTRODUCTION to Communications Utilities The "MODEM" family of programs The "YAM" family of programs Gettinç "YAM/MODEM¢ tï youò computeò YAMBOOT details MBOOT details The YAM/MODEM Handshake Protocol Other programs which WILL work with YAM/MODEM Other programs which MAY work with YAM/MODEM Preconfigured versions of YAM/MODEM7 for specific computers XYAM and XMODEM XSTAM details XSTAM caveats Using CRCK to check file transfers :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. Tï  datå 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ä severaì programó whicè fulfilì thå abovå requirementó havå beeî developed® Theså havå developeä iî 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î iî Chicagï foò  thå  verù firsô  RCPÍ  systeí  calleä  CBBÓ  (actuallù  thå  verù  firsô microcomputeò  bulletiî boarä systeí iî thå world)®  Thå MODEÍ programó arå alì writteî iî 808° assemblù 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ò "Modem¢ 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. :The "MODEM" family of programs Thå  "MODEM¢ familù oæ programó arå writteî iî  808°  assemblù languagå   anä  arå  probablù  noô  portablå  tï  non-8080/Z8° environmentó withouô á greaô deaì oæ work. Thå  programó  arå writteî arounä PMMÉ anä  D.C®  Hayeó  S-10° modeí cards¬  theså cardó arå BELÌ 10³ standarä modemó anä arå quitå  uselesó  iî Australia®  Thå programó supporô  autodial¬ auto-answeò  anä callbacë facilitieó whicè arå  generallù  noô applicablå  tï thå externaì modemó anä acoustiã coupleró  useä iî Australia® Thå programó caî bå modifieä with¬ somå care¬ tï ruî successfullù witè externaì modems/couplers. Yoõ  cannoô assemblå thå MODEÍ programó witè thå standarä CP/Í assembler¬  ASM.COM®  Thå  Digitaì  Researcè  macrï  assembleò MAC.COÍ ió required¬  thougè yoõ coulä probablù geô awaù  witè thå  Microsofô M80.COÍ assembleò provideä yoõ werå prepareä tï dï á biô morå editinç oæ thå sourcå files®  Witè haä expansioî oæ thå macroó iô jusô maù bå possiblå tï uså ASM.COM. Iæ  yoõ arå comfortablå witè 808° assembleò codå anä kno÷  thå technicaì detailó oæ thå UARÔ whicè driveó youò  modem/coupleò yoõ shoulä bå ablå tï modifù MODEÍ tï suiô youò needs. Thå  versioî  oæ MODEÍ currentlù availablå oî thió  systeí  ió calleä   MODEM7®   Seå  thå  filå  MODEM7.DOà foò  thå   fulì documentatioî oî thå program. :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å onlù choicå  iæ  yoõ  arå  noô runninç aî 8080/Z8° processor. 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ï thå BDÓ "C¢ compiler¬  versioî 1.4± oò later¬ tï  compilå YAM®  Iæ yoõ havå á versioî earlieò thaî 1.4¶  (oò perhapó 1.45a© yoõ maù alsï neeä thå MAà assembleò iæ yoõ wanô tï  modifù  thå twï assembleò moduleó YAM¸ anä  YAM9®  Iî  thå normaì  courså  oæ  eventó yoõ wilì noô neeä  tï  toucè  theså modules¬  thå preassembleä CRÌ fileó foò theså twï moduleó arå availablå  foò downloadinç froí thió system®  Versionó oæ  thå BDÓ  "C¢  compileò froí 1.4¶ onwarä allo÷ thå uså  oæ  ASÍ  tï producå  CRÌ  files¬  buô  yoõ woulä theî neeä tï  modifù  thå YAM8/9.ASÍ moduleó tï suiô thå ne÷ method. 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æ YAÍ currentlù availablå oî thió systeí ió  YAÍ 3.09®  Seå  thå  filå YAM.DOà foò fulì  documentatioî  oî  thå program. (Unix users ask the SYSOP about UMODEM27.C) :Getting "YAM/MODEM" to your computer Untiì yoõ havå á copù oæ YAÍ oò MODEÍ thå onlù waù tï transfeò datá  ió  aó  ASCIÉ  text®  Botè YAÍ anä MODEÍ  arå  botè  biç programó  anä  thå  chanceó  oæ transferrinç  theí  viá  phonå withouô somå erroró arå 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Í oò MODEÍ witè thå securitù oæ á protocoì transfer. Theî  yoõ compile/assemblå thå YAM/MODEÍ sourcå codå witè  foò youò computer. :YAMBOOT details Therå  ió  á  prograí calleä YAMBOOT.à oî  thió  system®  Thió prograí  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ó BSTMÓ oò TELNET¬ 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Í oò MODEM· 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. :MBOOT details Yoõ  wilì neeä tï havå reaä thå precedinç  categorù  YAMBOOT.à beforå readinç thió one. Dowî   loaä  MBOOÔ  aó  outlineä  foò  YAMBOOÔ  anä  puô   thå appropriatå UARÔ datá foò youò modeí porô intï it®  Notå  thaô MBOOT.ASÍ  haó haä severaì spacå savinç trickó applieä tï  it¬ tï  minimizå itó sizå anä transmissioî time®  Iô maù noô  looë likå  thå  assembleò codå thaô yoõ arå useä tï seeinç  buô  iô wilì assemblå OK® Wheî  MBOOÔ haó beeî assembleä yoõ caî dowî loaä thå fulì  YAÍ oò MODEM· program. MBOOÔ wilì onlù worë witè Z8° oò 808° CPUs®  Remembeò yoõ neeä tï  havå patcheä intï iô thå statuó anä datá porô  informatioî relevanô tï youò seriaì I/Ï board. :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.DOC. Tï  determinå thå differenceó iî thå batcè modå protocoló  seå thå fileó YAM.DOà anä MODEM7.DOC. :Other programs which WILL work with YAM/MODEM ŠListeä  belo÷  arå otheò programó whicè thå SYSOР knowó  wilì worë witè YAÍ oò MODEM7®  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® Sincå thå fulì YAÍ sourcå ió availablå oî thió system¬  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. :Other programs which MAY work with YAM/MODEM Listeä  belo÷ arå otheò programó whicè thå SYSOÐ suspectó  maù worë  witè YAÍ oò MODEM7®  Theså programó havå NOÔ beeî testeä anä thå SYSOÐ woulä appreciatå anù furtheò information. UMODEM27 Thió prograí ió writteî iî "C¢ foò Uniø systems® Iô implementó thå "Christensen¢ protocoló anä shoulä bå compatiblå witè  YAÍ and MODEM7. All I need is some Unix user to try it out. M.I.T.E. Noô  tï  bå  confuseä witè HITE®  Thió CP/Í  prograí  ió  froí Mycrofô  Labó iî thå U.S.A®  anä ió supposeä tï implemenô  thå "Christensen¢ protocols® I'vå neveò eveî seeî á copy. :Preconfigured version of YAM/MODEM7 for specific systems Witè reasonablå skill¬  thå "standard¢ versionó oæ YAM/YAMBOOÔ anä  MODEM7/MBOOÔ 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å communications utilities may be on line for down loading. Thå  onlù  preconfigureä  versioî  kepô oî linå  arå  foò  thå populaò   machines¬   i.å  Apple¬   Sorcereò   etc®   buô   iæ versionó  foò  otheò machineó arå availablå therå  wilì  bå  á documenô  filå oî thå Aº  oò Bº  drive¬  whicè wilì aô  leasô mentioî thå availability¬ bù request, oæ otheò versions. 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 and XMODEM XYAÍ  anä XMODEÍ arå speciaì versionó YAÍ anä MODEM®  Theù arå designeä foò uså oî RCPÍ systemó anä aó sucè havå somå speciaì featureó necessarù iî thaô sorô oæ environment. Generallù  theså featureó arå designeä tï makå theí  easù  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å XYAM/XMODEÍ  programó  caî  detecô theså fileó  anä  wilì  noô transfeò them. Thå  prograí  useä  oî thió systeí ió XYAM®  :XSTAM details XSTAÍ  ió  á  BSTAÍ  compatiblå utility®  BSTAÍ  ió  faò  froí satisfactorù foò uså oî aî RCPÍ system® Iô ió difficulô tï leô thå  remotå useró WHÙ á transfeò operatioî waó noô  successfuì anä  iô ió impossiblå tï aborô thå senä enä froí  thå  receivå end®  BSTAM/HITE/XSTAÍ havå tï bå ruî aó stanä alonå programs¬ theù  havå  nï ASCIÉ communicationó capabilitù anä  thió  alsï makeó theí mucè morå cumbersomå tï use. Howeveò  quitå á fe÷ useró seeí tï alreadù havå BSTAÍ oò  HITÅ sï  thå XSTAÍ utilitù ió provideä foò theså users®  Yoõ reallù shoulä  onlù  uså XSTAÍ tï geô dowî loaä YAÍ oò  MODEM·  iî  á securå  manneò anä theî geô YAÍ oò MODEM· runninç aó theså arå faò superioò utilitieó iî everù respect. Notå  thaô  XSTAÍ  wilì noô transmiô fileó thaô  wilì  noô  bå transmitteä bù XYAÍ (seå previouó categorù foò detailó oæ  thå restrictionó  XYAÍ applies)®  However¬  unlikå YAÍ oò  MODEM7¬ Štherå  ió nï waù foò XSTAÍ tï telì yoõ whaô happened¬  iô wilì simplù thinë thaô yoõ didn'ô specifù anù filå foò transmissioî iæ yoõ specifù á restricteä file. :XSTAM caveats "XSTAM.COM¢  workó exactlù likå BSTAÍ  "TRANSMIT.COM"¬  excepô thaô  iô  ió  lesó  verboså  aó faò  aó  thå  remotå  useò  ió concerned®  Yoõ  wilì  neeä tï starô thå utilitù oî  thå  RCPÍ systeí  firsô anä theî exiô froí youò  communicationó  prograí anä starô thå appropriatå BSTAÍ oò HITÅ utilitù aô youò end. XSTAÍ  shoulä  alwayó  aborô aô thå RCPÍ enä iæ therå  arå  2° erroò messageó oæ anù typå (eitheò beforå transmissioî  startó oò  betweeî successfullù transmitteä blocks© displayeä aô  thå RCPÍ end®  Verù fe÷ messageó froí XSTAÍ arå senô tï thå remotå user¬  howeveò  theù dï stilì displaù oî thå RCPÍ console®  Iæ yoõ  geô continuaì "TIMÅ OUÔ ERRORS¢ aô youò  end¬  XSTAÍ  haó probablù aborted. Iæ therå arå á relativelù smalì numbeò oæ carrieò losseó (>10© XSTAÍ  wilì  aborô  anä  iæ carrieò ió losô foò  morå  thaî  µ secondó XSTAÍ wilì abort® Yoõ shoulä definitelù noô trù tï uså XSTAÍ  iæ  thå  RCPÍ  systeí haó  troublå  holdinç  ontï  youò carrier®  Theså carrieò losó aborô measureó arå necessarù  duå tï  thå  desigî  oæ BSTAM¬  whicè reallù expectó  tï  havå  aî operatoò aô eacè end. Iî mosô caseó XSTAÍ wilì returî yoõ tï CP/Í commanä leveì wheî iô  abortó  buô  thå communicationó supervisoò maù  decidå  tï terminatå  thå  calì  iæ thå XSTAÍ aborô waó  duå  tï  carrieò losseó  ("HELР THIS-SYS¢ giveó detailó oæ  thå  circumstanceó undeò  whicè  thå  communicationó  supervisoò  maù   terminatå calls). Iæ yoõ havå BSTAÍ oò HITÅ É expecô thaô yoõ kno÷ ho÷ tï uså iô correctly®  É  wilì  noô  providå  assistancå  tï  useró  witè BSTAM/HITÅ  problemó unlesó theù caî bå clearlù traceä tï  thå RCPÍ  end®  Dï noô expecô XSTAÍ tï bå alwayó availablå oî thió system®  Aó thå numbeò oæ YAM/MODEM· useró increaseó XSTAÍ anä implementationó  foò  thå morå commoî  computeró  arå  readilù available¬ XSTAÍ wilì probablù bå withdrawn. Iæ yoõ havå BSTAÍ oò HITÅ yoõ shoulä definitelù uså iô tï dowî loaä  YAÍ  oò  MODEM7¬  insteaä oæ thå  YAMBOOT/MBOOÔ  method¬ describeä iî thå followinç categories. "HELP THIS-SYS" gives more details of running XSTAM. :Using CRCK to check file transfers Whateveò  methoä  yoõ uså tï transfeò fileó froí  thió  systeí therå ió á waù yoõ caî seå iæ yoõ endeä uð witè á gooä copù oæ the files. It involves comparing CRC checksums of the 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å  CRCK.COÍ utility®  CRCK.ASÍ ió alwayó onlinå foò dowî loadinç froí thió system® (Thå  CRà checksuí produceä bù CRCK.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. Somå  oæ  thå morå recenô Useò Grouð volumeó  wilì  havå  CRCË fileó witè checksumó foò alì thå fileó oî thå volumå containeä iî  them®  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®