AUTOM80 2.3 ----------- updated 12-18-84 AUTOM8° ió á speciaì prograí designeä tï keeð tracë oæ .MAà fileó anä  automaticallù assemblå ONLÙ thoså fileó thaô yoõ havå editeä sincå thå lasô timå yoõ assembleä them®  Thió ió quitå handù foò projectó  involvinç  manù modules¬  sincå iô relieveó yoõ oæ  thå tasë  oæ  keepinç  tracë  oæ whicè fileó  yoõ  havå  updateä  anä assemblinç  theí one-by-onå® There are three programs used with this function. AUTOM80 automatically assemble .MAC files SETOFF disable a file (turn it off) SETON enable a file (turn it on) SETOÎ allowó yoõ tï overridå thå previouó SETOFF¬  tï turî oî thå filå withouô havinç tï ediô it® Normallù thå filå wilì bå turneä on just by editing it. HOW TO USE AUTOM80 ------------------ Uså oæ thå AUTOM8° prograí ió simple®  Jusô typå iî AUTOM8° anä iô wilì dï thå rest®  Yoõ alsï havå thå optioî oæ specifyinç whicè drivå thå sourcå (.MAC© fileó arå on¬  whicè drivå yoõ wanô thå relocatablå (.REL© fileó on¬  á destinatioî foò thå .PRÎ filå (iæ any)¬  anä anù assemblù switches®  Iæ yoõ arå runninç  CP/M« (CP/Í  3.°  oò  greater)¬  yoõ musô havå thå  prograí  SUBMIT.COÍ present®  AUTOM8° expectó M80.COÍ anä SETOFF.COÍ (anä SUBMIT.COÍ undeò CP/M+© tï bå oî thå drivå yoõ arå loggeä into. Eacè  .MAà filå wilì bå iî onå oæ twï  conditions»  iô  wilì eitheò bå SEÔ OÎ (enableä foò assembling)¬ oò SEÔ OFÆ (disabled)® Notå  thaô theså conditionó wilì NOÔ affecô thå normaì  operatioî oæ M80¬  oò anù otheò prograí either®  Alì iô affectó ió whetheò AUTOM8°  recognizeó  iô oò not®  Á filå thaô haó neveò beeî  SEÔ beforå  wilì alwayó bå SEÔ ON®  Thaô ió thå  defaulô  condition® Thå onlù waù tï geô á filå SEÔ OFÆ ió witè thå SETOFÆ program¬ oò witè  AUTOM8° (whicè useó SETOFF)®  Tï geô á filå SEÔ OÎ yoõ maù ediô iô oò uså thå SETOÎ program®  Iæ yoõ copù á filå usinç PIP¬ thå ne÷ copù wilì bå SEÔ ON® Wheî yoõ invokå AUTOM8° iô lookó aô alì oæ thå .MAà fileó oî thå disë anä determineó whetheò theù arå SEÔ OÎ oò SEÔ  OFF®  Iæ thå  filå  ió  SEÔ  OÎ iô wilì bå addeä tï á  lisô  oæ  fileó  tï assemble®  Iæ  AUTOM8° doeó noô finä anù .MAà fileó SEÔ  ON¬  iô wilì  prinô thå messagå NONÅ FOUNÄ anä exiô witè nï  effect®  Iæ anù  arå found¬  theù wilì bå addeä tï thå $$$.SU filå oî  drivå A:®  Thió ió similaò tï usinç SUBMIT¬  anä thå systeí wilì  theî executå  thå ne÷ commandó aó thougè theù werå createä bù  SUBMIT® Eacè filå wilì bå assembleä anä theî SEÔ OFF¬ onå aô á time® Foò CP/M+¬ thå SUBMIÔ facilitù workó differently¬ sï AUTOM8° putó thå filå  nameó intï á filå calleä AUTOTEMP.SU anä chainó tï  SUBMIÔ wheî iô ió done. To summarize; 1) Edit whichever files you need to. 2) Execute AUTOM80. 3) For each SET ON .MAC file - a) The file is assembled. b) The file is SET OFF. 4) (CP/M+ only) AUTOTEMP.SUB is erased. 5) Finished. OPTIONS ------- Foò AUTOM8° versioî 2.3¬  thå syntaø foò thå optionó ió morå flexiblå  thaî foò versioî 2.1®  Thå drivå specifieró maù sho÷ uð almosô anywherå oî thå commanä line¬  spaceó arå usuallù ignored¬ anä  non-alphabetiã characteró arå usuallù  ignored®  Therå  havå alsï beeî several morå optionó added. AUTOM80 s d l ,spec /o /- ^ ^ ^ ^ ^ ^ ^ | | | | | | | AUTOM80 command--------------+ | | | | | | -options- | | | | | | 1) Drive location of source files----+ | | | | | 2) Destination drive for .REL files----+ | | | | 3) Destination drive for .PRN files------+ | | | 4) Destination for listings------------------+ | | 5) M80 switches----------------------------------+ | 6) Special AUTOM80 switch---------------------------+ 1) Locatioî oæ sourcå files®  Thió optioî specifieó whicè           disë   drivå  containó  thå  .MAà fileó  yoõ  wisè  tï           assemble®  Iæ  noô included¬  iô defaultó tï thå drivå           yoõ arå currentlù loggeä into® Thió optioî maù sho÷ uð           almosô anywherå oî thå commanä line¬ aó lonç aó iô doeó           noô  interferå  witè optionó 4¬  5¬  oò 6®  Iô  maù  bå           followeä bù á coloî oò á spacå iæ desired®  NOTEº  thió           optioî actó aó defaulô foò optionó ² anä 3¬ anä musô bå           useä iæ eitheò optioî ² oò ³ appears.      2) Destinatioî  foò .REL files®  Thió specifieó thå  disë           drivå oî whicè thå .REL fileó wilì bå written® Iæ thió           ió  noô  specified¬  iô  wilì defaulô  tï  whateveò  ió           selecteä  foò optioî 1®  Optioî ± musô bå specifieä foò           thió tï work¡  Thió optioî maù sho÷ uð almosô anywhere¬           aó  lonç aó iô ió afteò optioî ± anä doeó noô interferå           witè thå optionó 4¬  5¬  oò 6®  Iô maù bå followeä bù á           coloî  oò á spacå iæ desired®  Iô actó aó  defaulô  foò           optioî  3¬  anä musô bå specifieä iæ optioî ³  appears®           NOTEº  thió optioî ió otherwiså ignoreä iæ optioî ¶ (nï           .REÌ filå specification© ió invoked. 3) Destinatioî  drivå foò .PRÎ files®  Thió allowó yoõ  tï           specifù  whicè drivå thå listinç fileó wilì bå  writteî           tï  iæ  yoõ  requesô  thå lisô fileó  tï  gï  tï  disk»           otherwiså  iô  ió ignored®  Thió optioî maù  gï  almosô           anywhere¬ aó lonç aó iô doeó noô interferå witè optionó           4¬ 5¬ oò 6® Iô maù bå followeä bù á coloî oò á spacå iæ           desired. 4) Destinatioî   foò  listings®   Thió  optioî  haó   somå           interestinç properties® First¬ thå optioî ió terminateä           bù  á  spacå oò bù thå enä oæ thå line»  anythinç  elså           followinç  iô (beforå termination© wilì  bå  considereä           parô  oæ  thå devicå oò filå name®  Thió  includeó  thå           slasè  characteò useä iî optioî 4¡  Second¬  iæ á commá           appearó  withouô anù filå oò devicå name¬  thå  defaulô           .PRÎ namå ió useä anä thå filå wilì appeaò oî thå drivå           selecteä bù optioî 2®  (Thå phraså "defaulô .PRΠ name¢           meanó thaô iæ thå sourcå filå ió calleä "filename.MAC"¬           thå  listinç filå wilì bå calleä "filename.PRN¢ foò anù           filå name)®  Third¬ iæ yoõ specifù aî extensioî withouô           á  filå  namå (sucè aó ",.PRF")¬  iô  wilì  changå  thå           extensioî  used¬  buô  wilì uså thå currenô  filå  namå           (sucè  aó "filename.PRF")®  Finally¬  thió  optioî  maù           appeaò  anywherå oî thå commanä linå excepô  immediatlù           followinç  á  slasè (seå optioî 4)®  Bå careful»  iæ  á           filenamå  (witè oò withouô aî extension© ió  specified¬           theî  alì  oæ thå .MAà fileó thaô  arå  assembleä  wilì           writå  oveò  thaô  file¬  anä onlù thå  lasô  onå  wilì           remain®  Usuallù  yoõ wilì uså eitheò thå commá  alone¬           creatinç  á  uniquå .PRÎ filå foò eacè  .MAà file¬  oò           specifù  ",LST:"¬  whicè  wilì creatå á listinç oî  thå           printeò foò eacè .MAà file. 5) M8°  switches®   Thió  optioî  allowó  yoõ  tï  specifù           assemblù  timå switcheó tï bå used®  Thió allowó yoõ tï           uså thå switcheó alloweä bù M8° tï affecô thå formaô oæ           youò listinç files®  Exampleó areº /Ì forceó generatioî           oæ á listinç file»  /Ï causeó alì addresses¬  etc.¬  iî           thå  listinç tï bå iî octal»  /à forceó generatioî oæ á           crosó referencå file® Thå syntaø foò á switcè optioî ió           á  slasè  followeä bù á  character®  Alì  switcheó  arå           collecteä  togetheò beforå M8° execution¬  sï theù  maù           appeaò anywherå iî thå commanä line¬  excepô wherå theù           wilì  interferå  witè  optioî 3®  Nï checë ió  madå  bù           AUTOM8° foò thå validitù oæ thå switcheó requested. 6) Speciaì AUTOM8° switcè (/-)®  Invokinç thió optioî -- á           slasè  followeä bù á hypheî -- wilì noô bå passeä oî tï           M80¬  aó iô ió noô á valiä M8° switch¬  buô ratheò wilì           causå  AUTOM8° tï noô specifù á destinatioî  .REÌ  filå           namå oî thå commanä line® Foò example¬ thå command            AUTOM80 /L/-           might create the command line            M80 =SOURCE.MAC/L Š Spaceó maù appeaò anywherå exceptº  theù maù noô bå imbeddeä iî  thå devicå oò filå namå iî optioî 4¬  oò afteò thå commá iæ á filå oò devicå namå ió specified»  theù maù noô appeaò immediatlù afteò á slasè iî optioîs 5 or 6® Iæ  morå  thaî  threå  drivå nameó appeaò iî  thå  linå  (aó defineä foò optionó 1¬  2¬  anä 3)¬  onlù thå firsô threå wilì bå useä (foò optionó ± througè 3¬  respectively)» alì otheró wilì bå ignored®  Characteró outsidå thå rangå oæ A-P¬ anä noô beinç useä foò optionó 4¬ 5¬ oò 6¬ wilì bå ignored. Yoõ  maù  noticå  thaô usinç  thå  commá  bù  itself¬  whicè generateó  defaulô .PRÎ filå names¬  ió identicaì tï usinç thå /Ì switch® Thió ió theoreticallù true» however¬ therå ió á smalì buç iî  thå  M8°  assembler®  Iæ yoõ specifù  á  completå  .REÌ  filå destinatioî  filå  namå ANÄ invokå thå /Ì switch¬  thå .PRΠ filå wilì  enä  uð  witè á strangå  extension®  Sincå  AUTOM8°  alwayó specifieó alì filå nameó completely¬  thió wilì happeî everù timå yoõ  uså  thå /Ì switch®  Usinç thå commá insteaä wilì  givå  thå propeò results. UPDATEº  12-18-84®  Yoõ maù no÷ alternativelù specifù thå /- switcè tï defeaô thå probleí mentioneä above. Note: AUTOM80 may be imbedded in a SUBMIT file. EXAMPLES -------- The files TEST.MAC and MUNG.MAC are on drive A:. A>AUTOM80 <---- you type this in, Auto M80 version 2.3 the rest is automatic A>M8° TEST.REL=TEST.MAà <---- iô founä TEST.MAC No fatal error(s) A>SETOFF TEST.MAC <---- now, disable it TEST.MAC <---- show which file it sets A>M80 MUNG.REL=MUNG.MAC <---- it found MUNG.MAC No fatal error(s) A>SETOFF MUNG.MAC <---- disable it, it has been MUNG.MAC assembled. Remember, this happens automatically. A> Now¬ supposå yoõ ruî AUTOM8° again¬ witè nï editinç between: A>AUTOM80 <---- you type this in Auto M80 version 2.3 NONE FOUND. A> Theù havå alì beeî disabled¬ anä nonå havå beeî editeä sincå thå lasô timå yoõ assembleä usinç AUTOM80® No÷ ediô MUNG.MAà anä ruî AUTOM8° again: (edit session goes here!) A>AUTOM80 <---- you type this in again Auto M80 version 2.3 A>M80 MUNG.REL=MUNG.MAC <---- it found MUNG.MAC No fatal error(s) A>SETOFF MUNG.MAC <---- disable it, it has been MUNG.MAC assembled. A> ...anä  that'ó all¬  sincå yoõ didn'ô seô TEST.MAà oî again¬ either with SETON or by editing it. Thå uså oæ SETOÎ anä SETOFÆ ió verù simple®  Alì yoõ dï  ió typå  iî thå commanä witè thå namå oæ thå filå yoõ wanô set¬  anä SETON or SETOFF wilì dï thå rest. A>SETON MUNG.MAC <---- you type this in MUNG.MAC A>AUTOM80 <---- you type this in, too Auto M80 version 2.3 A>M80 MUNG.REL=MUNG.MAC <---- it found MUNG.MAC No fatal error(s) A>SETOFF MUNG.MAC <---- it disabled it, it has been MUNG.MAC assembled. A> ...just like when you edited it. Now let us suppose those files are on drive B:. A>AUTOM80 B: <---- you type this in Auto M80 version 2.3 (the : is optional!) A>M8° B:TEST.REL=B:TEST.MAà <---- iô founä TEST.MAC No fatal error(s) A>SETOFF B:TEST.MAC <---- now, disable it TEST.MAC <---- show which file it sets (the drive isn't shown) A>M80 B:MUNG.REL=B:MUNG.MAC <---- it found MUNG.MAC No fatal error(s) A>SETOFF B:MUNG.MAC <---- disable it MUNG.MAC A> Oò  yoõ  maù havå á fulì sourcå disë anä wanô tï puô alì  oæ the object files on drive A:. A>AUTOM80 BA <---- specify source on B:, Auto M80 version 2.3 destination on A: (colonó maù stilì be used here!) A>M80 A:MUNG.REL=B:MUNG.MAC <---- it found MUNG.MAC No fatal error(s) A>SETOFF B:MUNG.MAC <---- disable it, it has been MUNG.MAC assembled. A> Thå AUTOM8° commanä used abovå coulä looë likå this: A>AUTOM80 B: A: -or- A>AUTOM80 B:A: -or- A>AUTOM80 B A iæ  yoõ  wanô iô to®  Theù wilì alì acô  thå  same»  speciaì characteró anä spaceó arå ignored. Herå  arå somå exampleó foò thå commá  option®  Supposå  yoõ wanteä thå listinç tï comå ouô oî thå printer¿ Youò commanä mighô look like this: A>AUTOM80 ,LST: <---- specify list device for Auto M80 version 2.3 the listing destination A>M80 MUNG.REL,LST:=MUNG.MAC You can't see tell in this No fatal error(s) example, but the listing comes out on your printer. A>SETOFF MUNG.MAC <---- disable it, it has been MUNG.MAC assembled. A> Ho÷ abouô thå commá alone¿ Thaô causeó á uniquå .PRÎ filå tï bå generateä foò eacè .MAà filå assembled® Iô putó iô oî thå samå drivå  aó  thå  .REÌ  file®   I'lì  alsï  specifù  á  sourcå  anä destinatioî  drive¬  sï yoõ caî seå ho÷ theù worë  together®  Thå colons and spaces in the next command are all optional. A>AUTOM80 A: B: , <---- specify default file for Auto M80 version 2.3 the listing destination A>M80 B:MUNG.REL,B:MUNG.PRN=A:MUNG.MAC <---- Note that the destination drive for the No fatal error(s) .PRN and .REL files is the same drive. A>SETOFF A:MUNG.MAC A:MUNG.MAC A>M80 B:TEST.REL,B:TEST.PRN=A:TEST.MAC No fatal error(s) A>SETOFF A:TEST.MAC A:TEST.MAC A> Wanná creatå á crosó referencå filå foò these¿ Dï yoõ prefeò Octaì  tï  Hexidecimal¿  Jusô specifù thå  propeò  assemblù  timå switcèes in the command line. A>AUTOM80 B/C/O <---- specify drive B: as source Auto M80 version 2.3 and destination, and also create a cross reference A>M80 B:MUNG.REL=B:MUNG.MAC/C/O file; numbers will be in octal No fatal error(s) A>SETOFÆ B:MUNG.MAà <---- disablå it¬ iô haó been B:MUNG.MAC assembled. A> HOW IT WORKS ------------ Fileó createä whilå runninç undeò CP/Í normallù havå thå f1§ attributå turneä off®  CP/Í anä mosô applicationó programó dï noô kno÷  anythinç abouô thió attributå bit¬  anä sï theù ignorå  it® Editoró likå WORDSTAÒ whicè creatå á ne÷ filå everù timå yoõ ediô wilì noô seô thió attribute¬  sï everù timå yoõ ediô á file¬  thå ne÷ copù wilì havå thå attributå biô turneä off®  (Noteº  iæ yoõ uså thå ^KÓ commanä iî Wordstar¬  thå nexô ^KÄ wilì sometimeó NOÔ flaç thå ne÷ filå properly!© É havå takeî advantagå oæ thió fact¬ anä useä iô aó aî indicatioî thaô á filå haó beeî  edited®  Thió conditioî correspondó tï whaô É calì SEÔ ON¬ thaô is¬ enableä foò automatiã  assembling®  AUTOM8° lookó oî thå specifieä disë  foò alì  .MAà fileó thaô arå seô on®  Iæ iô findó any¬  iô createó á $$$.SU filå (or¬  iæ onå alreadù exists¬  openó iô foò updating© anä putó thå namå oæ eacè seô oî filå iî it® Wheî iô ió finisheä findinç  alì thå files¬  iô closeó $$$.SU anä returnó  tï  CP/M® Theî CP/Í executeó thå file¬  whicè iô thinkó waó madå bù SUBMIT® Eacè  filå  ió assembleä iî turn¬  anä theî seô ofæ bù  executinç SETOFF.COM® Neitheò SETOFF¬ SETOÎ noò AUTOM8° ió affecteä bù anù attributå bitó otheò thaî f1'¬ noò dï theù affecô them. Undeò CP/M« thå SUBMIÔ facilitù workó differently®  Tï makå AUTOM8°  worë  witè CP/M« É decideä tï creatå á normaì .SU  filå (calleä AUTOTEMP.SUB© witè thå statementó tï bå executed¬ anä ERÁ AUTOTEMP.SU  aô thå end¬  anä theî chaiî tï SUBMIT.COÍ witè  thå filå namå AUTOTEMÐ iî thå systeí filå controì blocë aô 05CH® Yoõ MUSÔ  havå SUBMIT.COÍ oî youò defaulô drive®  Iæ yoõ  insisô  oî renaminç   youò   SUBMIT.COÍ  filå  anä  yoõ  cannoô   re-compilå AUTOM80.PAS¬  theî uså DDÔ oò SIÄ tï finä thå strinç 'SUBMIT.COM§ withiî  AUTOM80.COM®  Yoõ  maù changå iô tï whateveò  yoõ  like» notice¬  however¬ thaô thå bytå previouó tï thå firsô bytå iî thå strinç ió á lengtè bytå anä shoulä bå changeä tï match. - Jeffrey J. Nonken Westminster, Ca.