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 / BDOS / DOSPLSOR.ARK / DOSRELOC.DOC < prev    next >
Text File  |  1986-11-14  |  8KB  |  179 lines
  1.  
  2.               THE DOS+ RELOCATOR SYSTEM - INSTRUCTION MANUAL
  3.               ==============================================
  4.  
  5.                 Copyright (c) 1980, 1986 by C.B. Falconer.
  6.           Released to the public domain for non-profit use only.
  7.  
  8. INTRODUCTION
  9. ============
  10.  
  11. This  system  allows  the user to construct his own "MOVDOS+"  or  "MOVCPM"
  12. program,  containing  his own BIOS and BOOTSTRAP (instead of that  for  the
  13. Intel  MDS  on  the original MOVCPM program or Kaypro 83  on  the  original
  14. MOVDOS+ program).  After construction the final system will perform identi-
  15. cally  to the original Digital Research supplied MOVCPM program,  with  the
  16. following additions:
  17.  
  18.    1:     As stated, the users BIOS and BOOTSTRAP are present.
  19.  
  20.    2:     The  system can relocate DOS+ or CPM on 256  byte  bound-
  21.           aries. This is specified by adding "/n", where n is 1, 2,
  22.           or  3,  to the normal size specifier.  This will relocate
  23.           the  system  that number of 256 byte  pages  higher  than
  24.           normal.
  25.  
  26.    3:     Should  the user make his own patches to the DOS+ or  CPM
  27.           systems,  they can be incorporated in the DOSRELOC  prog-
  28.           ram,  and  that modified system can then be relocated  as
  29.           desired.
  30.  
  31.                                  NOTE:
  32.           The  CP/M system proper is not supplied with this system.
  33.           It  is  up  to the user to ensure that he  uses  a  valid
  34.           system,   with   the  appropriate  serial  numbers   etc.
  35.           embedded.  CP/M is the trademark of DIGITAL RESEARCH, who
  36.           can  supply the system.   DOSRELOC will copy  all  serial
  37.           numbers etc correctly,  if installed as listed below,  so
  38.           that all Digital Research subsystems (e.g.  PIP,  SYSGEN,
  39.           etc.) will function properly.   DOS+ and CCP+ is supplied
  40.           with the system, and executes on Z80 cpus only.
  41.  
  42.                        NOTE (for MOVCPM generation):
  43.           If you already have a suitable MOVCPM for your system, it
  44.           is not necessary to create all  the modules  below.   The
  45.           existing bios and boot portions are probably satisfactory
  46.           images.  Such images are probably to be found 080h offset
  47.           from the locations needed for this system.  Check it.
  48.  
  49. OPERATION
  50. =========
  51.  
  52.    1:     IF  YOUR SYSTEM IS NOT A Kaypro 2/4 (83) edit the  source
  53.           for   DOSRELOC   (the   initial  set   of   customization
  54.           equates) and re-assemble to create DOSRELOC.HEX.
  55.  
  56.    2:     Generate  the  appropriate  CBIOS00.HEX  and  SBOOT00.HEX
  57.           files,  as outlined in the appendix below.  Make sure you
  58.           have   backup   copies  of  everything  in  case   of   a
  59.           malfunction.  Make  sure you can boot the system up  from
  60.           the  one  disc  you are using.  This disc  will  need  to
  61.           contain  copies  of  the  system,  DDTZ.COM,  MOVCPM.COM,
  62.           CPMRELOC.HEX, SBOOT00.HEX and CBIOS00.HEX.
  63.  
  64.    3:     THIS  STEP only needed if you wish to generate a  MOVCPM.
  65.           DOS+ systems are supplied.
  66.  
  67.           With DDTZ, load the existing "MOVCPM" program by
  68.  
  69.                 A>DDTZ MOVCPM.COM
  70.  
  71.           and  move  the existing CCP/BDOS (as supplied by  Digital
  72.           Research) image down by 080h bytes by:
  73.  
  74.                 -MA00,1FFF,980
  75.  
  76.           For clarity, clean out the junk by:
  77.  
  78.                 -F100,97f,0
  79.  
  80.           Now install the assembled DOSRELOC by:
  81.  
  82.                 -IDOSRELOC.HEX
  83.                 -R
  84.  
  85.    3a:    Insert your own BIOS, prepared as below, by
  86.  
  87.                 -ICBIOS00.HEX
  88.                 -R980
  89.  
  90.           and your own bootstrap, again prepared as below, by
  91.  
  92.                 -ISBOOT00.HEX
  93.                 -Rvalue        (see notes for value)
  94.                                (Usually 900 for boot at 0,)
  95.  
  96.           exit with control-c (^C) and save the result by
  97.  
  98.                 A>SAVE 34 DOSRELOC.COM
  99.  
  100.                    (or ^ other number for your system)
  101.  
  102.    4:     Run the relocator generator by
  103.  
  104.                 A>DOSRELOC
  105.  
  106.           the response will be
  107.  
  108.                 Now "SAVE 34 MOVDOS+.COM"        DO IT
  109.                 A>SAVE 34 MOVDOS+.COM
  110.  
  111.                                  CAUTION
  112.           DOSRELOC  cannot be run under DDT etc., since it uses the
  113.           actual  CCP code to generate relocation  information.  In
  114.           addition  the  system disc,  when DOSRELOC is  run,  must
  115.           contain  the proper booter for the running system AND the
  116.           identicaal system must be running.
  117.  
  118.    5:     Read  Digital Research's manual on the use of MOVCPM  and
  119.           treat MOVCPMY in exactly the same manner,  EXCEPT that to
  120.           generate  an immediately executing system the  2nd  para-
  121.           meter must be "G" (rather than defaulting to execution) .
  122.           Unless you modify your bootstrap or your bios you can now
  123.           generate any size DOS+ or CPM system in about 2  seconds,
  124.           including  immediately executing systems.  The output  of
  125.           MOVDOS+ is suitable for inserting new BIOS's, bootstraps,
  126.           etc.,  just  as  was the original MOVCPM output.  If  you
  127.           generate a system by
  128.  
  129.                 A>MOVDOS+ 32             {for example}
  130.  
  131.           you may follow this immediately by a
  132.  
  133.                 A>SYSGEN
  134.  
  135.           and  input the CR to skip system loading.   I.E  when  in
  136.           doubt, follow Digital Research's instructions.
  137.  
  138.                                  CAUTION
  139.           If an immediate execution system is generated, it will be
  140.           unable to reboot itself properly, because the disk proper
  141.           contains  the original system.   However,  until a reboot
  142.           occurs everything will be normal.   Remember     that any
  143.           program that does a "JMP 0", or a control-c, will usually
  144.           reboot.  DDT and DDTZ always exits with a reboot.
  145.  
  146. APPENDIX
  147. ========
  148.  
  149. To  use this system the user MUST have an operational DOS+ or CP/M  system,
  150. of  sufficient size to load MOVCPM with DDT.  For CP/M 2.2 this requires  a
  151. 17K minimum system,  although when completed the system will run in a 16/1K
  152. system.  In addition the user should have the source code for his BIOS  and
  153. BOOTER.  The  BIOS  must be assembled for a DOS+ or CPM that originates  at
  154. zero,  i.e. as if CCP begins at address zero, and, for CP/M 2.2, as if BDOS
  155. begins at address 0800H.  In this case the BIOS would be assembled as if it
  156. began at address 01600H.  The booter image will vary,  depending on how  it
  157. operates.  The point is to place a booter,  assembled as if it would load a
  158. DOS+  or CPM that began at zero,  at addresses 900H through 97FH in step  3
  159. above.  Remember that the booter will normally operate in a fixed  location
  160. for  all size systems,  but will load the system into different  addresses,
  161. and transfer control accordingly.
  162.  
  163.                                CAUTION
  164.      Remember that the CBIOS and SBOOT loaded in step 3 above  MUST
  165.      be  identical  to those in the executing  system,  except  for
  166.      execution  addresses.   If you can't change just one value  in
  167.      the source code to generate either,  this system will probably
  168.      not work.  If you don't have the source code for these modules
  169.      complain viciously to your supplier.
  170.  
  171.  
  172. If  patches or changes are made to the DOS+ or CPM  systems,  corresponding
  173. patches   should  be  made  in  the  zero  based  image  contained  in  the
  174. DOSRELOC.COM module generated in step 3.  The result should relocate satis-
  175. factorily, provided that no unclean practices (such as self-modifying code)
  176. have  been used.  Again,  if the CBIOS uses self-modifying code the  system
  177. probably  will  not function,  and you should complain to  the  knucklehead
  178. (possibly yourself) who wrote such code.
  179. á