home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / RCPM / LUXI80.LBR / -READ.MZ / -READ.ME
Text File  |  2000-06-30  |  9KB  |  195 lines
  1.  
  2.                            LUXI80 v10
  3.                           22 March 1988
  4.  
  5.                  LUX - Library Utility eXtension
  6.  
  7.                  (supports KMD, MBKMD and NUKMD)
  8.  
  9.                 NOTE:  The M80 assembler is needed
  10.                 for this pgm, also the L80 linker.
  11.                 If using KMD, you likely can just
  12.                 use the program 'as is'.  If using
  13.                 MBKMD or NUKMD, change the correct
  14.                 equate then assemble and link.  A
  15.                 submit file is included to simpli-
  16.                 fy doing this:
  17.  
  18.                         A>EX15 MAKELUX
  19.  
  20.                 This uses M80, L80 and the included
  21.                 MAKELUX.COM files to automatically
  22.                 generate a new LUX.COM.  (Thanks to
  23.                 whomever wrote this 'merging' pgm.)
  24.  
  25. LUXI8░á i≤ ß remotσ (RCPM⌐ librar∙ utilit∙ tha⌠ allow≤ ßá calle≥á t∩ ì
  26. manipulatσá archivσ (.AR├ o≥ .ARK⌐ anΣ librar∙ (.LBR⌐ file≤ anΣá usσ ì
  27. simplσá command≤ t∩ typσ o≥ senΣ membe≥ files«á  I⌠ wa≤ deriveΣ froφ ì
  28. LUX10░ inorde≥ t∩ facilitatσ 8080/808╡ typσ hardware«á LUX10░á coulΣ ì
  29. onl∙ bσ useΣ oε Z8░ system≤ a≤ i⌠ wa≤ NO╘ codeΣ fo≥ 808░ CPUs«á Thu≤ ì
  30. thσá movtivatioε fo≥ translatinτ LUX10░ t∩ makσ LUXI8░ fo≥ thosσá oµ ì
  31. u≤á no⌠ fortunatσ enougΦ t∩ havσ Z80s«á LU╪ place≤ itselµ unde≥á CC╨ ì
  32. (o≥ BYE5⌐ a≤ ß forφ oµ RSX.
  33.  
  34. LUXI8░á v1░á i≤á placeΣ oε A0║á witΦ you≥ othe≥á normally-useΣá .CO═ ì
  35. files«á Option≤á iε thσ sourcσ codσ filσ allo≈ placinτá thσá suppor⌠ ì
  36. file≤á oεá an∙ drive/use≥ areß yo⌡ wish«á  However¼á thesσ arσá als∩ ì
  37. usuall∙á placeΣ oε A0║á s∩ the∙ ma∙ bσ useΣ fo≥ norma∞á purpose≤á a≤ ì
  38. well«  Thesσ are:
  39.  
  40.  * CHEK.COM        (current is CHEK15.COM, included, see below)
  41.    LCHEK.COM       (current is LCHEK11.com, included)
  42.    DIR.COM         (your SDxxx.COM renamed to DIR, not included)
  43.    TYPE.COM        (can type squeezed or cruched files, included)
  44.    UNARC.COM       (used as TYPE or DIR for .ARC and .ARK, included)
  45.  
  46. ------------------------------------------------------------------------
  47.  
  48. QUICK INSTALLATION:
  49. ------------------
  50.  
  51.    If using KMD, all you will likely need to do is the following:
  52.  
  53.         a) remove the member files.
  54.  
  55.         b) place the following files on A0:
  56.  
  57.                 1. CHEK.COM  (not used with LUX, see '*' area below)
  58.                 2. LCHEK.COM
  59.                 3. LUX.COM
  60.                 4. TYPE.COM  (in place of your current TYPE.COM pgm)
  61.                 5. UNARC.COM
  62.  
  63.         c) ready to use, all finished.  This should work equally well
  64.            on a small floppy system with two drives or on a 100 Mb
  65.            system with 12-14 drives, regardless how many user areas
  66.            are allowed.
  67.  
  68.         d) if using MBKMD or NUKMD you will need to use your editor to
  69.            change an equate in the LUX source code, reassemble and con-
  70.            vert to a .COM file using the method mentioned in the NOTE,
  71.            above.
  72.  
  73.  
  74. ------------------------------------------------------------------------
  75.  
  76.   *  Not used with LUX, but of value on your system to allow users
  77.      to get the CRC of any program to check against the CRC they get
  78.      for the same program on their own system, after completing the
  79.      download.  (This is actually CHEK15.COM, which you may already
  80.      have on A0:)  Thiis nicely complements the LCHEK.COM which per-
  81.      mits running a CRC check on a library member.  LCHEK is used
  82.      with LUX but may also be used as a stand-alone program on your
  83.      system.
  84.  
  85. Thσá onl∙á transfe≥ option≤ listeΣ arσ thosσ availablσ iε LU╪á whicΦ ì
  86. arσ thσ KM─ S¼á KM─ SK¼á o≥ SEN─ o≥ SEND╦ options«á  Sincσ MBKM─ anΣ ì
  87. NUKM─á arσ no≈ usinτ thσ KM─ routine≤ fo≥ extractinτ .AR├á anΣá .AR╦ ì
  88. file≤ iε additioε t∩ .LB╥ files¼ aε assembl∙ timσ optioε i≤ includeΣ ì
  89. t∩ selec⌠ KMD¼á MBKM─ o≥ NUKM─ programs«  Sincσ MBKM─ anΣ NUKM─ havσ ì
  90. beeεá regularl∙á adoptinτá feature≤ addeΣ t∩á KMD¼á futhe≥á comment≤ ì
  91. regardinτá KM─á wil∞ iε mos⌠ case≤ als∩ bσ pertinen⌠á fo≥á MBKM─á o≥ ì
  92. NUKMD.
  93.  
  94. KM─ full∙ support≤ thσ 1δ packe⌠ protoco∞ useΣ iε IMP¼á MEX114¼ Pro-ì
  95. YA═á anΣ nearl∙ al∞ curren⌠ MS-DO╙ modeφ programs«á  Thi≤ i≤ ßá mucΦ ì
  96. morσ efficien⌠ wa∙ t∩ senΣ datß a⌠ 240░ bauΣ o≥ AN┘ speeΣ iµ usinτ ß ì
  97. satellitσá tele-servicσ witΦ delays«á  KM─ als∩ support≤ YMODE═ typσ ì
  98. batcΦ transfer≤ (useΣ b∙ IMP¼á MEX-PLU╙ anΣ nearl∙ al∞ MS-DO╙á modeφ ì
  99. programs«  Thi≤ featurσ i≤ no⌠ useΣ withiε LU╪ howeve≥ a≤ batcΦ modσ ì
  100. i≤ no⌠ availablσ iµ downloadinτ librar∙ members.
  101.  
  102. LUX.CO═ a≤ distributeΣ wa≤ assembleΣ froφ thσ LUXI80.MA├ sourcσ codσ ì
  103. filσ whicΦ i≤ included«á  Therσ arσ virtuall∙ n∩ option≤ whicΦ migh⌠ ì
  104. neeΣ t∩ bσ changed«  ┴ SUBMI╘ typσ filσ i≤ includeΣ fo≥ usσ witΦ thσ ì
  105. M8░á »á L8░á assembler-linke≥ pair«á  EX15.CO═ i≤á includeΣá iεá thσ ì
  106. library«á  Yo⌡á woulΣá firs⌠á edi⌠ an∙ change≤ int∩á thσá LUXI80.MA├ ì
  107. sourcσ codσ filσ (iµ an∙ arσ needed⌐ anΣ theε automaticall∙ assemblσ ì
  108. anΣ linδ usinτ thi≤ line:
  109.  
  110.                         B>EX15 MAKELUX <ret>
  111.  
  112. ┴á fe≈á minute≤ late≥ yo⌡ wil∞ havσ ß LUX.CO═ filσ read∙ t∩á usσá oε ì
  113. you≥ RCPM.
  114.  
  115. ┴á numbe≥á oµ ready-to-usσ file≤ arσá included¼á whicΦá enhancσá thσ ì
  116. versatilit∙ oµ thσ LU╪ program«  Thesσ arσ dua∞ purposσ anΣ normall∙ ì
  117. woulΣ bσ placeΣ oε A0║á drive¼ theε useΣ fo≥ genera∞ purposσ a≤ wel∞ ì
  118. a≤ fo≥ LUX:
  119.  
  120.                           TYPE.COM
  121.                           LCHEK.COM
  122.                           UNARC.COM
  123.  
  124.          NOTE:  You also need a conventional DIR.COM program
  125.                 with $L capability to show members of a .LBR
  126.                 file.  This is usually SDxxx.COM renamed to
  127.                 DIR.COM.  Since this changes so frequently,
  128.                 and has so VERY many options to individually
  129.                 set, this file was not included.  Most people
  130.                 are currently using SD128.COM on A0: renamed
  131.                 DIR.COM.
  132.  
  133.  
  134. Thσá TYPE.CO═á prograφ tha⌠ i≤ includeΣ iε thi≤ filσ i≤á ßá general-ì
  135. purposσ prograφ tha⌠ caε displa∙ normal¼á squeezeΣ o≥ cruncheΣ file≤ ì
  136. - o≥á an∙ oµ thosσ threσ type≤ iε ß .LB╥ file«á  Thi≤ i≤ ßá modifieΣ ì
  137. versioεá oµ LT23 writteε b∙ Steveε Greenberτ anΣ C«á B«á Falcone≥ iε ì
  138. Decembe≥á 1986«á  Iµá yo⌡ havσ ß TYPE.CO═ prograφ oεá A0║á tha⌠á yo⌡ ì
  139. prefer¼á ignorσ thi≤ one«á  (Yo⌡ migh⌠ wan⌠ t∩ tr∙ thi≤ onσ iε placσ ì
  140. oµ you≥ owε first¼á however«á  I⌠ i≤ no⌠ dependen⌠ oε whee∞ bytσá o≥ ì
  141. use≥ area.)
  142.  
  143.  
  144. Thσá LCHEK.CO═á prograφá i≤ actuall∙ LCHEK11.CO═á (writteεá b∙á SigΘ ì
  145. Kluge≥á iεá Januar∙ 1984)«á  I⌠ caε bσ useΣ fo≥ genera∞ purpose≤á a≤ ì
  146. wel∞ a≤ fo≥ LUX« (I⌠ i≤ likel∙ thσ onl∙ wa∙ RCP═ user≤ caε ge⌠ ß CR├ ì
  147. checδá oε ß membe≥ filσ oµ ß librar∙ sincσ the∙ arσ no⌠á alloweΣá t∩ ì
  148. usσá LU31░ o≥ NULU152.⌐ Thi≤ prograφ ha≤ no⌠ changeΣ fo≥ threσ year≤ ì
  149. bu⌠ man∙ RCP═ system≤ arσ apparentl∙ unawarσ i⌠ exist≤ anΣ havσá no⌠ ì
  150. haΣ i⌠ availablσ iε thσ past«á (Yo⌡ ma∙ als∩ wan⌠ t∩ ge⌠ CHEK15.COM¼ ì
  151. renamσ i⌠ t∩ CHEK.CO═ anΣ pu⌠ i⌠ oε A0║ iµ no⌠ alread∙ iε use«  Thi≤ ì
  152. allow≤á anyonσá t∩ makσ ß CR├ checδ oµ an∙ prograφ (o≥á program≤á a≤ ì
  153. wilΣá card≤á arσá accepted⌐ oε you≥ systeφá anΣá nicel∙á complement≤ ì
  154. LCHECK11.CO═ whicΦ i≤ onl∙ useΣ oε librar∙ members.)
  155.  
  156. UNARC.CO═á i≤á useΣá t∩ displa∙ membe≥ content≤ oµ aε .AR├á o≥á .AR╦ ì
  157. file«á Agaiε i⌠ caε bσ useΣ fo≥ ß genera∞ purposσ prograφ a≤ wel∞ a≤ ì
  158. fo≥á LUX«á Thi≤á i≤ whee∞ dependen⌠ - iµ thσ whee∞ i≤á se⌠á fo≥á thσ ì
  159. SYSOP¼á hσá caεá theε usσ thσ prograφ t∩ extrac⌠ file≤ froφ .AR├á o≥ ì
  160. .AR╦ libraries.
  161.  
  162.         Check addresses 010Ah and 010Bh for the wheel byte.
  163.         These will normally be 3Eh and 00h since the wheel
  164.         byte is normally at 003Eh on most systems.  If your
  165.         wheel is at FE0Eh, for example, those bytes would
  166.         be 0Eh and FEh.
  167.  
  168.         NOTE:  Be sure UNARC.COM has 16h at 0103h, not 08h.
  169.                This compensates for the 43 records in the
  170.                LUXI80.COM file as a RSX sitting under BYE5.
  171.                (Not all 43 are moved under CCP/BYE5, though.)
  172.  
  173.  
  174.         NOTE:  ARC and .ARK compression methods are still
  175.                undergoing development so make sure you are
  176.                using the latest current version of UNARC.COM
  177.                on A0:  A current version as of this date is
  178.                included with this group of files.
  179.  
  180. COMMENT:
  181. -------
  182. LUXI8░á wa≤ writteε iε thσ middlσ oµ MarcΦ 198╕ anΣ baseΣá oεá prio≥ ì
  183. worδá donσá b∙á Ir÷á Hofµ a≤ LUX100«á LUX10░ wa≤á writteεá iεá earl∙ ì
  184. Septembe≥á 198╢ (excep⌠ fo≥ thσ MBKM─ anΣ NUKM─ option≤á neithe≥á oµ ì
  185. thesσá supporteΣá extractioε oµ .AR├ o≥ .AR╦ file≤ unti∞ 0▒ FeΓá 87«  ì
  186. KM─á ha≤á supporteΣ thi≤ sincσ Apri∞ 198╢ wheε BoΓá FreeΣá madσá hi≤ ì
  187. routine≤á exclusivel∙á availablσ t∩ KM─ fo≥ thi≤ purpose.⌐á  I⌠á ha≤ ì
  188. beeε iε usσ oε ß selectivσ basi≤ fo≥ testinτ oε variou≤ RCP═ system≤ ì
  189. whilσá waitinτá oε thσ NOA╚ prograφ t∩ creatσ .AR╦ file≤á witΦá CP/═ ì
  190. systems.
  191.                                 - notes by Irv Hoff, updated for
  192.                   LUXI80 by Bill Weinel, based in
  193.                   part on comments by Norman Beeler
  194.                   in his LUX52 and LUX53 releases.
  195.