Kermit-MPX Program: L. Tate, Simulation Associates Inc. Derived from CYBER-170 version 1.0, Jim Knutson, University of Texas. Language: Gould Fortran 77 4.2, with some assembler routines Version: 2.3 Date: May 1986 Documentation: L. Tate, Simulation Associates Inc., Mike Niswonger, Computer Science and Applications Kermit-MPX Capabilities at a glance: Local operation Yes; MPX 3.2B or later Remote operation Yes Transfers text files Yes Transfers binary files No Wildcard send No ^X/^Y interruption No Filename collision avoidance No Can time out Yes 8th-bit prefixing No Repeat count prefixing No Alternate block checks No Terminal emulation No Communication settings No Transmit Break Yes IBM communication Yes Transaction logging No Session logging Yes Raw upload No Act as server Yes Talk to server Yes Advanced commands for servers No Local file management No Handle file attributes No Command/init files Yes Printer control No 14.1 Kermit-MPX Description Kermit-MPX runó oî Gould'ó Concepô anä Serieó computeró runninç MPØ 2.Ø oò  MPØ 3.Ø  operatinç  systems®  MPØ 3.2 anä lateò versionó allo÷ truå  fulì  dupleø terminaì  operationó  sï  theså installationó maù uså thå Kermiô prograí  iî  á locaì modå althougè thå responså ió verù poor. Thió  Kermiô  requireó thå uså oæ aî eighô linå asynchronouó  (8LAS©  interfacå (sorrù  ALIÍ  anä  ADÓ users© oî aî IOP®  Thió interfacå  bufferó  thå  input¬ performinç  somå  rudimentarù translationó likå loweò tï uppeò caså  anä  blocë readó anä writes®  Unfortunately¬ it'ó efficiencù ió verù pooò foò singlå bytå readó  anä writes¬  thuó thå connecô mode'ó effectivå throughpuô ió onlù  abouô 30°  baud®  Tï makå matteró worså wheî thå type-aheaä buffeò ió fulì  (40-12¸ characters©  theî  thå  buffeò emptieó anä á prograí  interruptioî  (break©  ió generated® Alsï á breaë caî bå generateä bù recognitioî bù thå 8LAÓ oæ á 'wake- up§ character®  Convenienô foò thå terminaì processor¬ buô reallù baä foò filå Štransfeò iæ thå wake-uð characteò ió á '?' or any other printable character. Thió  Kermiô haó á timeouô thaô functionó aô randoí intervals®  Iæ thå  timeouô doesn'ô worë theî sendinç á breaë shoulä wakå iô up. Thå initializatioî filå KERMIT.INÉ maù bå useä tï initializå Kermit®  Thå filå musô  bå iî thå currenô directorù wheî startinç Kermiô up®  Anù valiä Kermit- MPØ commanä maù bå included. 14.2 Kermit-MPX Commands Kermit-MPØ useó thå DECSYSTEM-2° keyworä stylå commanä language®  Eacè keyworä maù bå abbreviateä tï itó minimuí length®  "?¢ maù bå typå tï requesô á menõ oæ thå availablå optionó foò thå currenô fielä aô anù poinô iî á command. Kermit-MPØ promptó witè 'Kermit-§ witè thå machinå typå concatenateä oî tï  it® Foò examplå oî á Concepô 32/2· machine¬ thå prompô wilì bå 'Kermit-27>'. BYE Sendó  á messagå tï thå remotå serveò tï loç ouô thå remotå Kermiô anä          exitó locaì Kermiô tï systeí level® Sincå Kermit-MPØ cannoô loç itselæ          off¬ iô just exits the task. CONNECT Enteò  terminaì  emulatioî  mode®  Presentó  thå  illusioî  oæ  beinç          directlù  connecteä aó á terminaì tï thå remotå system®  Wheî  escapå          characteò ió typed¬ interpretó next character as follows: 0 (zero) transmits a null B transmits a BREAK C close a connection, return to local Kermit Q quit logging (if being done) R resume logging ? show available arguments escape character transmits the escape character Invalid arguments are beeped and reenters connect mode. EXIT Exit from local Kermit. FINISH Sendó á messagå tï thå remotå serveò tï shuô itselæ down¬  leavinç thå          locaì Kermiô aô commanä level¬ anä thå remote at system level. GET remote-filename Tells a remote Kermit to send a file. HELP topic Typinç  HELÐ alonå printó á brieæ summarù oæ Kermiô anä itó  commands®          Yoõ caî alsï type HELP commandŠ foò  anù  Kermiô command¬  e.g®  "HELÐ SEND"¬  tï  geô  morå  detaileä          informatioî abouô á specifiã command® Type HELP ?          tï  seå  á  lisô oæ alì thå availablå helð commands¬  oò  consulô  thå          Kermiô Useró Guide. QUIT Exit from local Kermit. RECEIVE Expects one or more files to arrive. SEND local-filename Sends a file to remote Kermit. SERVER Acô  aó á serveò foò anotheò Kermit®  Takå alì furtheò commandó  froí          thå  otheò Kermit®  Afteò issuinç thió command¬  escapå bacë tï  youò          locaì systeí anä issuå SEND¬ GET¬ BYÅ oò otheò server-orienteä commanä          froí there® Iæ youò locaì Kermiô doeó noô havå á BYÅ command¬ iô doeó          noô  havå  thå fulì abilitù tï communicatå witè á  Kermiô  serveò  (iî          whicè caså yoõ caî onlù uså thå senä command). SET Establisè  system-dependenô parameters®  Yoõ caî examinå theiò valueó          witè  thå  SHO×  command®   Numeriã  valueó  maù  bå  decimal¬  octaì          (postfixeä witè aî Ï oò B)¬ oò hexadecimaì (postfixeä witè aî H)® Thå          followinç maù bå SET: DEBUG options Show packet traffic explicitly. Options are: ALL Set all debug options. LOG-FILE local-filename Log states and packets to the specified file. The default log-file is file L.KERMLOG OFF Don't display debugging information. (this is the default). If debugging was in effect, turn it off and close any log file. PACKETS Display each incoming and outgoing packet (lengthy) STATES Show Kermit state transitions and packet numbers (brief). LOG options Log all inputs from remote port during connection. Options are: LOG-FILE local-filename Log inputs to specified file. The default log-file is file L.SESSION OFF Turn off the session logging ON Turn on the session logging Š PORT terminal-address Setó thå communicatioî port»  tï whicè connect¬  send¬  receivå anä             serveò  interacô  with®  Anù  MPØ terminaì addresó  maù  bå  used®             Examplesº TY7EC0¬ U17CC4¬ oò UT.             Default is UT. ESCAPE number Control character used to escape from connect mode. Default is 29, (^]) ECHO on/off Turns on or off the echo by Kermit during connect mode. Echo is normally off. DELAY number Ho÷  manù secondó tï waiô beforå sendinç thå  firsô  packet®  Thió             giveó yoõ timå tï "escape¢ bacë anä issuå á RECEIVÅ command®  Delaù             defaultó tï µ seconds. INIT-RETRY number Seô   thå  maximuí  numbeò  oæ  retrieó  alloweä  foò  thå  initiaì             connectioî beforå givinç up®             Defaulô ió 20. RETRY number Seô thå maximuí numbeò oæ retrieó alloweä foò sendinç á  particulaò             packet®             Defaultó tï 5. SEND parameter Parameters for outgoing packets as follows: EOLCHR number Thå  octaì  valuå  oæ thå ASCIÉ characteò tï bå useä  aó  á  linå               terminatoò  foò packets¬  iæ onå ió requireä bù thå otheò system®               Carriagå returî (0DH© bù default. PACKLEN number Maximuí packeô lengtè tï send¬ decimaì number¬ betweeî 2° anä 94.               9´ bù default. PADCHR number Character to use for padding. Default is NUL. PADLEN number How much padding to send before a packet.               Default is no padding. QUOTECHR number Whaô   printablå  characteò  tï  uså  foò  quotinç   oæ   controì               characters® Thå defaulô ió '#§ (23H)® Therå shoulä bå nï reasoî               tï changå this. SYNCCHR number Thå  controì  characteò thaô markó thå beginninç oæ  thå  packet® Š              Normallù SOÈ (Control-A¬  ASCIÉ 1)® Therå shoulä bå nï reasoî tï               changå this. TIMEOUT number Ho÷  manù  secondó thå otheò Kermiô wantó beforå beinç askeä  foò               retransmission® Defaulô ió 1° seconds. RECEIVE parameter Parameters to request or expect for incoming packets, as follows: EOLCHR number               Thå  octaì  valuå  oæ thå ASCIÉ characteò tï bå useä  aó  á  linå               terminatoò foò packets¬  iæ onå ió requireä bù thå otheò  system®               Carriagå returî (0DH© bù default. PACKLEN number Maximuí packeô lengtè tï send¬ decimaì number¬ betweeî 2° anä 94.               9´ bù default. PADCHR number Character to use for padding. Default is NUL. PADLEN number How much padding to send before a packet.               Default is no padding. QUOTECHR number Whaô   printablå   characteò  tï  uså  foò  quotinç  oæ   controì               characters® Thå defaulô ió '#§ (23H)® Therå shoulä bå nï reasoî               tï changå this. SYNCCHR number Thå  controì  characteò thaô markó thå beginninç oæ  thå  packet®               Normallù SOÈ (Control-A¬  ASCIÉ 1)® Therå shoulä bå nï reasoî tï               changå this. TIMEOUT number Ho÷  manù secondó thå otheò Kermiô wantó beforå beinç  askeä  foò               retransmission® Defaulô ió 1° seconds. SHOW Displaù currenô SEÔ parameters¬ versioî oæ Kermit¬ anä otheò info. STATUS          Give statistics about the most recent file transfer. TAKE local-filename Read and execute Kermit commands from a local file. X Exit from Kermit. 14.3 Software Installation ŠMPX-3.2  anä  lateò operatinç systemó supporô truå fulì dupleø TSÍ  terminals® Witè theså operatinç systeí versionó seô thå LOCALOÎ flaç .TRUE® iî thå includå filå KVER.INS® Thió allowó thå locaì commandó tï bå used» BYE¬ CONNECT¬ FINISÈ anä GET® Otherwise¬ Kermit-MPØ ió gooä aó á remotå serveò (whicè ió it'ó primå functioî anyway). The source is a series of files; KVER.INS version include file KDEF.INS Kermit definitions KPROT.COM protocol common KPACK.COM communication parameters of Kermits KFILE.COM I/O package common data KTIME.COM Timing of connect mode KDBUG.COM Debug output control KMSG.COM Prompt and version message GM2KERM.INS Consolidated include file (has all above files in it) GM2KERM.F77 main Kermit code GM2KERM.ASM assembler routines for I/O system GM2KERM.BAT batch deck to compile, assemble and catalog task image Thå  smalì COÍ anä INÓ fileó arå founä iî thå largeò GM2KERM.INÓ file®  Uså  á texô editoò tï spliô ouô thå smalleò fileó foò thå Fortraî compileò tï  access® Wheî creatinç thå task¬ ediô thå batcè decë foò appropriatå directorù nameó anä filå names® 14.4 Hardware Requirements Thå fronô enä oæ á Goulä caî bå quitå trouble-some¬ requirinç somå expertiså tï overcomå somå oæ thå 8LAÓ shortcomings. Thå  wakeuð  characteò  oî manù systeí ió thå '?'®  Thió  ió  á  valiä  Kermiô character¬  buô  everù timå iô ió sent¬  iô breakó thå terminaì thuó endinç thå packet®  Tï  avoiä  thió wå changå thå wakeuð characteò tï á non-valiä  Kermiô characteò sucè aó control-Å (05H). Thå  connecô  modå ió ratheò slow¬  havinç aî aggregatå ratå oæ  30°  baud¬  iæ systeí  loaä ió low®  However¬  wå usuallù likå tï transfeò aô 960°  oò  19.2ë baud®  Iî onå installation¬  wå seô thå bauä ratå tï maximum® Sincå thå remotå systeí ió sendinç characteró bacë aô thå samå higè rate¬  iô outpaceó thå locaì Kermiô  anä wå loså thå buffeò (remembeò thå break© iî connecô mode®  Notå thaô thió  doeó  noô affecô thå serveò modå wherå transferó occuò  aô  fulì  channeì speed®  Logginç  iî  anä  activatinç thå serveò doeó noô requirå  mucè  systeí interactioî  anä droppeä characteró caî bå tolerateä foò thå shorô duratioî  oæ thå  connecô  modå required®  Thió limitatioî oæ connecô modå  emphasizeó  thå primarù  uså  oæ Kermit-MPØ aó á filå server¬  noô aó  aî  interactivå  connecô terminaì program® Thå otheò solutioî ió tï dynamicallù changå thå bauä ratå froí 30° tï 960°  anä back® Thió requireó á prograí tï changå thå bauä ratå dynamicallù anä á direcô linkagå betweeî computers® Thå procedurå ió tï loç oî tï thå remote'ó terminal¬ changå thå bauä ratå tï desireä rate¬  closå youò locaì connection¬  changå thå Šbauä ratå oæ connecô port¬ theî reopeî connection. Á  porô  characteristiã changinç prograí waó noô builô intï Kermiô  becauså  oæ it'ó systeí dependence®  Alì that'ó needeä ió á prograí tï translatå thå  porô characteristicó tï á ³ bytå ACÅ codå useä 8LAS®  Thió maù bå senô tï thå  porô usinç  thå  M.WRITÅ macro¬  witè thå datá formaô inhibiô (DFI© biô seô anä  thå transmiô  ACÅ  parameteò  biô set®  Seå MPØ referencå  manual¬  volumå  É  foò details® A good future enhancement. 14.5 Future Work Install a port setting capability to Kermit.      Improve CONNECT speed. Suggested alternatives could be; Block reads with 1 sec timeouts and special character detect. Totaì interrupô driven®  Thió requireó assembleò routine¬  anä uså oæ          M.CALÌ tï IOCÓ sincå M.WRITE/M.REAÄ doeó noô perforí welì iî interrupô          driveî environment. Activate Kermit to get higher priority. This sounds cheap.      Added server commands for file management, particularly; cd change directory copy copy file rename rename file delete delete file list list file dir directory listing, Theså commandó arå mosô needeä sincå it'ó difficulô tï uså volumå  manageò      aô 960° bauä connected. Correcô  erroò  reporting®  Erroò packetó arå noô displayeä anä foò  somå      reason¬ senô erroò packetó arå noô displayed by other Kermits. 14.5 Kermit-MPX Revision List 2.3 Addeä tï SERVEÒ thå abilitù tï recognizå thå É packet®  Thió packeô            ió  useä  bù  advanceä Kermitó (aô leasô MS-Kermiô 2.2· anä  up©  tï            initializå  thå  server®  Changeä  thå methoä bù  whicè  nowaiô  ió            establisheä sï thaô iæ ECHÏ waó ofæ beforå Kermiô operation¬ theî iô            wilì remaiî sï afterwards®  Gooä foò networë operation®  Correcteä            thå erroò reportinç codå such thaô thå erroò messageó arå  produced®            However¬  theù  caî  bå verù cryptic®  Whaô ió needeä ió á  generaì            methoä  oæ handlinç text¬  likå helð anä erroò messages¬  sucè  thaô            memory is not filled but ready access is available.             L. Tate, SAI, May 1986. 2.2 Improveä  receive/geô reliabilitù bù movinç thå  terminaì  reportinç            beforå  thå ACK/NAË ió sent®  Thå probleí seemó tï havå beeî durinç            thå reportinç time¬ thå sendinç floodeä thå 8-linå buffeò anä causeä            á break¬  losinç data® Alsï correcteä erroò iî printì routinå whicè            wrotå tï stdout instead of the parameter fd. Š            L. Tate, SAI, Mar. 1986. 2.1 Correcô buç iî SUDT® Wheî uså thå SVà 1,X'27§ whicè seô fulì dupleø            oî á terminaì iô previouslù useä á trasheä filå controì block® Thió            haä  causeä  unpredictablå resultó iî á loô oæ thå I/Ï  includinç  ²            readó  pendinç aô once®  Correctinç thió probleí alloweä removaì  oæ            HIOALÌ  routine®  Fileó tï bå reaä arå openeä witè OPENMODE='R§  anä            fileó  tï bå writteî arå openeä witè OPENMODE='U'®  Alsï addeä  thå            TAKÅ command®             L® Tate¬ SAI¬ Mar® 1986. 2.0 Addeä  thå  CONNECT¬  GET¬  FINISH¬  BYÅ  commands®  Thió  requireä            significanô  changeó tï thå iï interface®  Thå locaì on/ofæ  optioî            waó alsï parô oæ this®             L® Tate¬ SAI¬ Nov® 1985. 1.0 Thió  Kermiô waó thå direcô implementatioî oæ thå Cyber-17° version¬            Universitù oæ Texas®             L® Tate¬ SAI¬ Sept® 1985.