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 / LUX100.LBR / -READ.MZ / -READ.ME
Text File  |  2000-06-30  |  9KB  |  183 lines
  1.  
  2.                             LUX v100
  3.                           5 March 1987
  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 MAKELUX1
  19.  
  20.                 This uses M80, L80 and the included
  21.                 MAKELUX1.COM files to automatically
  22.                 generate a new LUX.COM.  (Thanks to
  23.                 whomever wrote this 'merging' pgm.)
  24.  
  25. LUX is a remote (RCPM) library utility that allows a caller to manipu-
  26. late archive (.ARC or .ARK) and library (.LBR) files and use simple
  27. commands to type or send member files.  LUX may only be used on Z80
  28. systems as it is NOT coded for 8080 CPUs.  It places itself under CCP
  29. (or BYE5) as a form of RSX.
  30.  
  31. LUX v100 is placed on A0: with your other normally-used .COM files.
  32. Options in the source code file allow placing the support files on any
  33. drive/user area you wish.  However, these are also usually placed on A0:
  34. so they may be used for normal purposes as well.  These are:
  35.  
  36.       * CHEK.COM        (current is CHEK15.COM, included, see below)
  37.         LCHEK.COM       (current is LCHEK11.com, included)
  38.         DIR.COM         (your SDxxx.COM renamed to DIR, not included)
  39.         TYPE.COM        (can type squeezed or cruched files, included)
  40.         UNARC.COM       (used as TYPE or DIR for .ARC and .ARK, included)
  41.  
  42. ------------------------------------------------------------------------
  43.  
  44. QUICK INSTALLATION:
  45. ------------------
  46.  
  47.    If using KMD, all you will likely need to do is the following:
  48.  
  49.         a) remove the member files.
  50.  
  51.         b) place the following files on A0:
  52.  
  53.                 1. CHEK.COM  (not used with LUX, see '*' area below)
  54.                 2. LCHEK.COM
  55.                 3. LUX.COM
  56.                 4. TYPE.COM  (in place of your current TYPE.COM pgm)
  57.                 5. UNARC.COM
  58.  
  59.         c) ready to use, all finished.  This should work equally well
  60.            on a small floppy system with two drives or on a 100 Mb
  61.            system with 12-14 drives, regardless how many user areas
  62.            are allowed.
  63.  
  64.         d) if using MBKMD or NUKMD you will need to use your editor to
  65.            change an equate in the LUX source code, reassemble and con-
  66.            vert to a .COM file using the method mentioned in the NOTE,
  67.            above.
  68.  
  69.  
  70. ------------------------------------------------------------------------
  71.  
  72.   *  Not used with LUX, but of value on your system to allow users
  73.      to get the CRC of any program to check against the CRC they get
  74.      for the same program on their own system, after completing the
  75.      download.  (This is actually CHEK15.COM, which you may already
  76.      have on A0:)  Thiis nicely complements the LCHEK.COM which per-
  77.      mits running a CRC check on a library member.  LCHEK is used
  78.      with LUX but may also be used as a stand-alone program on your
  79.      system.
  80.  
  81. The only transfer options listed are those available in LUX which are
  82. the KMD S, KMD SK, or SEND or SENDK options.  Since MBKMD and NUKMD are
  83. now using the KMD routines for extracting .ARC and .ARK files in addi-
  84. tion to .LBR files, an assembly time option is included to select KMD,
  85. MBKMD or NUKMD programs.  Since MBKMD and NUKMD have been regularly
  86. adopting features added to KMD, futher comments regarding KMD will in
  87. most cases also be pertinent for MBKMD or NUKMD.
  88.  
  89. KMD fully supports the 1k packet protocol used in IMP, MEX114, Pro-YAM
  90. and nearly all current MS-DOS modem programs.  This is a much more effi-
  91. cient way to send data at 2400 baud or ANY speed if using a satellite
  92. tele-service with delays.  KMD also supports YMODEM type batch transfers
  93. (used by IMP, MEX-PLUS and nearly all MS-DOS modem programs.  This
  94. feature is not used within LUX however as batch mode is not available if
  95. downloading library members.
  96.  
  97. LUX.COM as distributed was assembled from the LUX100.Z80 source code file
  98. which is included.  There are virtually no optins which might need to
  99. be changed.  A SUBMIT type file is included for use with the M80 / L80
  100. assembler-linker pair.  EX15.COM is included in the library.  You would
  101. first edit any changes into the LUX100.Z80 source code file (if any are
  102. needed) and then automatically assemble and link using this line:
  103.  
  104.                         B>EX15 MAKELUX1 <ret>
  105.  
  106. A few minutes later you will have a LUX.COM file ready to use on your
  107. RCPM.
  108.  
  109. A number of ready-to-use files are included, which enhance the versa-
  110. tility of the LUX program.  These are dual purpose and normally would
  111. be placed on A0: drive, then used for general purpose as well as for LUX:
  112.  
  113.                           TYPE.COM
  114.                           LCHEK.COM
  115.                           UNARC.COM
  116.  
  117.          NOTE:  You also need a conventional DIR.COM program
  118.                 with $L capability to show members of a .LBR
  119.                 file.  This is usually SDxxx.COM renamed to
  120.                 DIR.COM.  Since this changes so frequently,
  121.                 and has so VERY many options to individually
  122.                 set, this file was not included.  Most people
  123.                 are currently using SD116A.COM on A0: renamed
  124.                 DIR.COM.  (Both SD118 and SD120 have been seen
  125.                 on various RCPM systems.)
  126.  
  127.  
  128. The TYPE.COM program that is included in this file is a general-purpose
  129. program that can display normal, squeezed or crunched files - or any of
  130. those three types in a .LBR file.  This is a modified version of LT18
  131. written by Steven Greenberg and C. B. Falconer in December 1986.  If you
  132. have a TYPE.COM program on A0: that you prefer, ignore this one.  (You
  133. might want to try this one in place of your own first, however.  It is
  134. not dependent on wheel byte or user area.)
  135.  
  136.  
  137. The LCHEK.COM program is actually LCHEK11.COM (written by Sigi Kluger in
  138. January 1984).  It can be used for general purposes as well as for LUX.
  139. (It is likely the only way RCPM users can get a CRC check on a member
  140. file of a library since they are not allowed to use LU310 or NULU152.)
  141. This program has not changed for three years but many RCPM systems are
  142. apparently unaware it exists and have not had it available in the past.
  143. (You may also want to get CHEK15.COM, rename it to CHEK.COM and put it
  144. on A0: if not already in use.  This allows anyone to make a CRC check of
  145. any program (or programs as wild cards are accepted) on your system and
  146. nicely complements LCHECK11.COM which is only used on library members.)
  147.  
  148. UNARC.COM is used to display member contents of an .ARC or .ARK file.
  149. Again it can be used for a general purpose program as well as for LUX.
  150. This is wheel dependent - if the wheel is set for the SYSOP, he can then
  151. use the program to extract files from .ARC or .ARK libraries.
  152.  
  153.         Check addresses 010Ah and 010Bh for the wheel byte.
  154.         These will normally be 3Eh and 00h since the wheel
  155.         byte is normally at 003Eh on most systems.  If your
  156.         wheel is at FE0Eh, for example, those bytes would
  157.         be 0Eh and FEh.
  158.  
  159.         NOTE:  Be sure UNARC.COM has 16h at 0103h, not 08h.
  160.                This compensates for the 43 records in the
  161.                LUX100.COM file as a RSX sitting under BYE5.
  162.                (Not all 43 are moved under CCP/BYE5, though.)
  163.  
  164.  
  165.         NOTE:  ARC and .ARK compression methods are still
  166.                undergoing development so make sure you are
  167.                using the latest current version of UNARC.COM
  168.                on A0:  A current version as of this date is
  169.                included with this group of files.
  170.  
  171. COMMENT:
  172. -------
  173. This program has been ready since early September 1986 (except for the
  174. MBKMD and NUKMD options neither of these supported extraction of .ARC or
  175. .ARK files until 01 Feb 87.  KMD has supported this since April 1986 when
  176. Bob Freed made his routines exclusively available to KMD able for this
  177. purpose.)  It has been in use on a selective basis for testing on various
  178. RCPM systems while waiting on the NOAH program to create .ARK files with
  179. CP/M systems.
  180.                                 - notes by Irv Hoff, based in part
  181.                                   on comments by Norman Beeler in
  182.                                   his LUX52 and LUX53 releases.
  183.