


     XLR8SET(U1)          LS-DOS 6 - Utilities 1           XLR8SET(U1)



     Name
          XLR8SET - Loads the LS-DOS 6.3 accelerator patches for
          XLR8er-based systems.

     Syntax
          xlr8set [ -qs1?h ] [[ -m ] [ -b "program" ]]
          [ ; next command ]

     Description
          Xlr8set allows the user to dynamically apply patches to
          SYS0/SYS(L) and BOOT/SYS(L) that provide improved
          performance on systems equipped with the XLR8er adapter.
          This adapter uses the Hitachi HD64180 or the Zilog Z180
          processor.  Both provide a superset of Z80 instructions.
          These processors also perform many standard Z80 instructions
          in less time than a Z80 running at the same clock speed.

          The patches that xlr8set applies were published in the
          Misosys Quarterly, or are functionally-equivalent, higher-
          performance patches developed by M. A. D. Software.  (The M.
          A. D. Software version of the patches are considerably
          smaller than their predecessors.)

          The benefit is using xlr8set to apply the patches is that
          they do not have to be permanently applied to the
          BOOT/SYS(L) and SYS0/SYS(L) files on disk.  This allows the
          unused areas in these files to be used for other purposes
          while the system is booting, including booting from devices
          other than the standard floppy disk driver.

          When xlr8set loads patches into memory that require low
          memory space, xlr8set is able to relocate the patches to the
          next available location in low memory, rather than requiring
          the patches to be stored at absolute locations.  Xlr8set
          will also refrain from applying the patches if the HD64180
          or Z180 CPU is not present.  This lets you avoid
          reconfiguring the operating system if you need to switch
          over to a plain Z80 CPU for some reason.

          Xlr8set accepts several options.  Options are specified by
          single characters, and they may be entered in upper or
          lowercase.  Options are always preceded by a hyphen (a "-").
          If you are specifying multiple options, you can specify the
          options in any of these formats:
                -a -b -c   or   -abc   or   -a -bc   or  -ab -c

          The options are:

          -q   Causes xlr8set to run silently with no messages being
               displayed if everything works like it should.  Errors
               will be reported.




     Page 1                                             May 15th, 1993






     XLR8SET(U1)          LS-DOS 6 - Utilities 1           XLR8SET(U1)



          -s   By default, xlr8set reduces the number of wait-states
               generated by the 64180 to values that work well on most
               systems.  This option leaves the wait-state settings at
               maximum, but performs all other initializations.

          -b "program"
               This option causes xlr8set to execute the immediately-
               following program prior to installing the patches and
               configuring the processor.  This can be used to load
               the time-of-day clock or to perform other functions
               that require a CPU speed closer to that of a normal
               Model 4/4D/4P.

               Nested quotes are not allowed, so the #, $, %, &  and '
               characters can be used in place of the double-quotes.
               For example,
                     xlr8set -b 'program1 ....' ; program2
               will cause program1 to be execute before xlr8set runs
               and program2 will run after xlr8set has applied the
               patches and changed the CPU speed.
               The -b option may be used as many times as it is
               needed.
               NOTE: Xlr8set uses memory from 0x7a00 to 0x7fff.  Any
                     program run using the -b option must not clear or
                     overwrite this area.  Normally xlr8set will set
                     HIGH$(L) to protect itself from well-behaved
                     programs, but this will not stop a program from
                     writing over xlr8set, and crashing the system.

          -m   Prevents xlr8set from adjusting the location of
               HIGH$(L) while processing -r commands.  If drivers or
               other high memory modules are to be installed via -b
               commands, -m will leave HIGH$(L) undisturbed.  The -m
               option must appear before the first -b option.

          -1   Informs xlr8set that the system only contains 128K of
               RAM.  Banks three through ten will be marked as "in
               use".

          -? or -h
               Displays the help message.

          ; next command
               After xlr8set completes, the remainder of the command
               line is executed as a second command.  The command
               xlr8set -b "rdclk" -q ; do = startup/jcl will read a
               "Smartwatch" and set the system clock while the CPU is
               running at the reduced speed. Then xlr8set will apply
               the patches and reconfigure the system.  Finally, the
               JCL file STARTUP/JCL will be invoked.  This command
               could be made the system auto(L) command so that all of
               these steps are performed when the system boots.



     Page 2                                             May 15th, 1993






     XLR8SET(U1)          LS-DOS 6 - Utilities 1           XLR8SET(U1)



     Notes
          Xlr8set does not verify the presence of the 256K or RAM on
          the XLR8er adapter.  The presence of the 256K of RAM is
          assumed unless you use the -1 option.

          Xlr8set will not install the patches if any of the following
          conditions exist:  (an error message will be displayed)
                1.    The HD64180/Z180 CPU was not detected.
                2.    There is insufficient memory available in the
                      low-memory driver area.  Try running xlr8set
                      before loading filters and character drivers
                      since they can usually operate in high memory.
                      The forcehi(U1) utility can help you force
                      filters and drivers into high memory.
                3.    The patches are already present, either
                      permanently applied to the files or added by
                      xlr8set.  If xlr8set has already been run since
                      the system was booted and the patches were
                      loaded then, xlr8set will not try to load them
                      again.
                4.    The base system does not have 128K of RAM
                      installed.
                5.    The operating system is not LS-DOS 6.3.0 or
                      6.3.1.  Any other operating system may require
                      different patches.


          The patches that are applied by xlr8set which were published
          by the Misosys Quarterly are provided on an "AS IS" basis.
          Since the presence of other patches and software can prevent
          the patches xlr8set applies from performing the intended
          tasks, M. A. D. Software cannot be responsible for any
          consequences arising out of their use or the use of xlr8set.


          If you need more information on xlr8set(U1), please write to
          M.A.D. Software, P.O. Box 331323, Ft. Worth Texas, 76163.
          Please include a Self-Addressed-Stamped-Envelope when
          requesting information.
          ------
          305152














     Page 3                                             May 15th, 1993



