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 / DOSPLS25.ARK / -INSTALL.DOS < prev    next >
Text File  |  1986-10-07  |  13KB  |  283 lines
  1. This file is not paginated, allowing you to set up your own pagination.
  2.  
  3. DOS+, CCP+, DDTZ, INITDIR, MOVDOS+, FDATE, SETFLAGS, XJOB
  4. and all related documentation are Copyright (c) 1986 by:
  5.      C.B. Falconer, 680 Hartford Tpk, Hamden CT 06517,
  6.      Tel (203) 281-1438.
  7.  
  8. They may be freely copied and distributed provided no charges are
  9. made, and that they are not included with other items for sale.
  10. For commercial permission contact C.B. Falconer.
  11.  
  12. Contributions are solicited.  All contributions of $20 or over will
  13. receive notices of available updates and/or revisions.  $50 or over is
  14. considered registration, and major revisions (on Kaypro 4 or IBMPC
  15. format disks, as desired) will be made for 1 year, with source code.
  16.  
  17.                 --- Installing DOS+ and CCP+ ---
  18.  
  19. A detailed example.  What you enter is shown in lower case.  The computer
  20. responses are usually shown as upper case.   ( ) encloses commentary.
  21.  
  22. IN CASE OF ERROR, use a scratch BOOTABLE disk and copies of the files.
  23.  
  24. (You may also use DDTZM in place of DDTZ if you are used to MSDOS debug. )
  25. (The command letters are changed to agree with DEBUG.   )
  26.  
  27. (Start from a just-booted system, no extra things added such         )
  28. (as add-on hard disk drive systems that load below BDOS, etc.        )
  29. (You need DDTZ.COM, MOVDOS+.COM, HOWBIG.COM, and your own SYSGEN.COM )
  30. (which last knows where the image is to be placed on your disks.     )
  31. (If your system did not provide a SYSGEN program, see  DOS+.DOC file.)
  32.  
  33. 1.        (Find out the size of your system)
  34. ==
  35.  
  36. A>howbig                    (The simplest method)
  37.  
  38. Current effective sizes in K ("/n" indicates n extra 256 byte pages)
  39. TPA size = 58  CPM size = 63
  40.                         ( ^-- Note this value )
  41.  
  42. 2.          (now that we know the size, make the right system image)
  43. ==
  44.  
  45. A>movdos+ 63                (use "62/3" if HOWBIG returned that)
  46.  
  47. DOS+ Mover Ver. 1.2
  48. Constructing 63k DOS+ V 2.5 System for Kaypro 2/4 (83)
  49. Ready for "SYSGEN" or "SAVE 33 DOS63K.SYS"
  50. A>save 33 dos63k.sys        (do it as instructed)
  51.             (now you have a system ready to run on Kaypro 2/4, 1983 version)
  52.             (for others, you must install your own bios and bootstrap.     )
  53.  
  54. 3.          (get an image of your present system, for the bios and bootstrap)
  55. ==
  56. A>sysgen
  57. SOURCE DRIVE NAME (OR RETURN TO SKIP)a       ( enter a )
  58. SOURCE ON A, THEN TYPE RETURN                < enter <cr> )
  59. FUNCTION COMPLETE
  60. DESTINATION DRIVE NAME (OR RETURN TO REBOOT) ( enter <cr> )
  61.  
  62. A>save 36 cpm63k.sys           (for 63k, or whatever name you prefer)
  63.       ( ^-- This number may not be right for you, see your documentation)
  64.  ***  (     The Osborne 1 wants 39 here, for example )
  65.  
  66.             ( you MAY customize DOS+ and CCP+ to your liking     )
  67. 4.          ( This is OPTIONAL - the default settings should be usable)
  68. ==          (      If you do this to MOVDOS+ it will create)
  69.             (      customized versions in the future.      )
  70.  
  71. A>ddtz dos63k.sys
  72. DDTZ v2.5  by C.B. Falconer.  CPU=Z80     (If this says 8080 S T O P )
  73. Next  PC   Save                           (system needs a z80 cpu. )
  74. 2500 0100  36
  75. -d 1160,119f    (just to display the patchable area. CCP+ to 117f, then DOS+)
  76. 1160 43 4F 4D 00 00 43 43 50  58 54 45 4E 44 53 59 53 COM..CCPXTENDSYS
  77. 1170 05 FF 0D 00 00 00 00 00  00 00 00 00 00 00 00 00 ................
  78. 1180 00 00 00 00 00 00 C3 11  E8 3C EB 5B EB 6E EB 60 ................
  79. 1190 EB C3 1C E8 00 00 00 00  58 00 00 00 00 00 79 32 ....F.@.p...v2..
  80.                 (the values beginning with E will change with system size)
  81.                 (in fact they will be E8 less in MOVDOS+, a 0 based image)
  82.  
  83.                 (NOTE: 'CCPXTEND.SYS will be run whenever a transient is )
  84.                 (not found.  It searches libraries automatically, and has)
  85.                 (provision for a further extension if .COM file not found)
  86.                 ('COM' at 1160 above is the extension for transients.    )
  87.                 (byte 1163 is the user, and 1164 the drive, for CCPXTEND.)
  88.                 (set to default drive (implies A also) and user 0.       )
  89.  
  90.              (customize CCP+)
  91. -s 1170
  92. 1170 05 4    (you enter the last number. This is columns to use for DIR)
  93. 1171 FF      (just <ret> here. A 0 will flip the initial state of CAPS)
  94. 1172 1F #15  (maximum user allowed.  Note '#' for decimal entry)
  95. 1173 0D #12  (maximum user when wheel is off.  For BBS systems)
  96. 1174 00 45   (low byte of address of wheel byte. keep 0 if none in system)
  97.                     (to use the bios MUST set it to 0ffh on cold boot)
  98. 1175 00      (can change if wheel not in page 0. keep 0 if none)
  99. 1176 00 .    (the "." exits the mode. Now we need to calculate 2 masks)
  100.  
  101.              (customize commands when WHEEL is off.  For BBS systems)
  102.              ( The following values represent commands:
  103.              ( Any login (ex B:) 1       DIR 2     ERA  4     TYPE 8   )
  104.              (              SAVE 10      REN 20    CAPS 40      GO 80  )
  105.              (              KILL 100                                   )
  106.              ( du restriction on login  400                            )
  107.              ( du restriction on DIR    800                            )
  108.              ( du restriction on COM    1000  i.e. what can be run     )
  109.              ( disable A: search        8000  (when using DOS+ paths)  )
  110.              (  (applies to wheel also)       (avoid multiple search)  )
  111.  
  112.              (assume you want non-wheel (remote) users to be unable to )
  113.              (use the ERA, SAVE, REN commands, and you also want to    )
  114.              (restrict them from specified drives and user areas on    )
  115.              (logins, DIR, and running .COM files.   You add by:       )
  116.  
  117. -h 4,10                (ERA and SAVE)
  118. 0014 FFF4 65516 .
  119. -h 14,20               (also REN)
  120. 0034 FFF4 65516 .
  121. -h 34,400              (restrict login areas)
  122. 0434 FC34 64564 4
  123. -h 434,800             (restrict DIR areas visible)
  124. 0C34 FC34 64564 4
  125. -h C34,1000            (restrict .COM files runnable)
  126. 1C34 FC34 64564 4
  127. -h 1C34,8000           (I am using DOS+ paths, no A: search needed)
  128. 9C34 9C34       4      (the 9C34 is the required mask)
  129. -s 1176
  130. 1176 00 34             (put in the lower byte first)
  131. 1177 00 9c
  132. 1178 00 .              (done with this operation)
  133.  
  134.              (For disk drives, the following hex numbers describe)
  135.              (  A: 1        B: 2        C: 4        D: 8         )
  136.              (  E: 10       F: 20       G: 40       H: 80        )
  137.              (  I: 100      J: 200      K: 400      L: 800       )
  138.              (  M: 1000     N: 2000     O: 4000     P: 8000      )
  139.              ( my system has drives A, B, and M available, so..  )
  140.              (NOTE: ALWAYS INCLUDE DRIVE A)
  141. -h ffff,1           (ffff is the starting point, 1 for drive A)
  142. 0000 FFFE 65534 .
  143. -h fffe,2           (using 2nd column above, 2 for drive B)
  144. 0000 FFFC 65532 .
  145. -h fffc,1000        (again, with 1000 for drive M)
  146. 0FFC EFFC 61436 .
  147.              (keep the 2nd column in mind, or write it down "EFFC" here)
  148.  
  149.              (we will not allow non-wheel users on drive M, and use the)
  150.              (value before including M: above for them, i.e. FFFC      )
  151. -s 1178
  152. 1178 00 fc          (first the overall system, everyone. lower byte 1st)
  153. 1179 00 ef
  154. 117A 00 fc          (and now the non-wheel users. lower byte 1st)
  155. 117B 00 ff
  156. 117C 00 .           (done with CCP+ customization)
  157.  
  158.  
  159.              (customize DOS+.  Patchable area from 1194 to 119Dh only)
  160.  
  161.              (Calculate the 'feature' mask. The values are:    )
  162.              (  Timer is a routine, not a string location  80  )
  163.              (  Enable a 'break' key on most DOS calls     40  )
  164.              (  Also enable break on DCIO calls (#6)       20  )
  165.              (  Allow access date/time stamping of files   10  )
  166.              (  "Compatible" mode, looks like CPM2.2       08  )
  167.              (    (affects version, DCIO calls)                )
  168.              (  To have DOS+ start with list copying       01  )
  169.              (    as if CTL-P had already been entered         )
  170.  
  171.              (    See documentation for effects. Note that the )
  172.              (timer is disabled unless a suitable address is   )
  173.              (entered below. The default system breaks on a    )
  174.              (nul key (i.e. CTL-@ on most keyboards), but not  )
  175.              (on the DCIO calls.  This is compatible with most )
  176.              (programs, but can be disabled if desired.        )
  177.              (See DOS+.DOC for timer considerations.           )
  178.  
  179.              (I want my system to break on all calls, and do   )
  180.              (access time stamping, so:                        )
  181. -h 40,20         (breaks enabled, DCIO break enabled)
  182. 0060 0020 32
  183. -h 60,10         (and access stamps on suitable disks only. Compatible.)
  184. 0070 0050 80     (Only omit if you want to use write protected disks)
  185. -s 1194
  186. 1194 00 46       (I have a PATH string at 046h. TO USE THE BIOS must
  187. 1195 00                   (initialize it to a 0 byte on cold boot)
  188. 1196 00 40       (I have a timer STRING at 0040h)
  189. 1197 00                   (if above and this left 0 no timer operations)
  190. 1198 58 70       (The 'features' mask from above)
  191. 1199 00          (here I can set the key to do the breaking. Kept a nul)
  192. 119A 00 48       (I have a "punch" status call available at 0F648h)
  193. 119B 00 F6       (lo byte first.  LEAVE 0 IF YOU HAVE NO SUCH CALL)
  194. 119C 00 4B       (and I have a "reader" status call at 0F64Bh)
  195. 119D 00 F6       (lo byte first.  LEAVE 0 IF YOU HAVE NO SUCH CALL)
  196. 119E 79 .        (Exit.  DON'T change this byte)
  197. -k               (write the patched file back.  No need to SAVE)
  198. DOS63K  .SYS exists, purge (y/n)?y           (answer y to overwrite it)
  199.  
  200.                  (You MAY initialize the path, assuming at 046h, here)
  201. -s46             (but the BIOS cold boot MUST put 0 at the path start)
  202. 0046 00 'A'
  203. 0047 00 '$'      (A drive, default user)   (note char. entries quoted)
  204. 0048 00 'B'
  205. 0049 00 '$'      (B: default user) (use "#nn" for actual user #'s)
  206. 004A 00 0        (make sure null terminated)
  207. 004B .
  208. -^C              (CTL-C to end the session)
  209. A>          (and we are all done customization)
  210.  
  211.  
  212. (Now you still have to install your own bios in the DOS63K.SYS file and  )
  213. (do a SYSGEN.  The size of your bios is a variable, but it will usually  )
  214. (start at location 1f80 in your own CPMxxk.SYS file, which you  created  )
  215. (with SYSGEN (i.e. GET system from disk, exit, and SAVE the appropriate  )
  216. ({unknown to me} size). Similarly for the bootstrap loader, which usually)
  217. (is found at 900 to 980, and should be copied into the same location in  )
  218. (DOSxxk.SYS file.  Or you can copy the appropriate portion of DOSxxk.SYS )
  219. (into your CPMxxk.SYS file (or whatever names) by:                       )
  220.  
  221. 5.               (generate system image for YOUR machine)
  222. ==
  223.  
  224. A>ddtz dos63k.sys    (or whatever name you used)
  225. DDTZ v2.5  by C.B. Falconer.  CPU=Z80      (If this says 8080  S T O P )
  226. Next  PC   Save                            (system needs a z80 cpu.    )
  227. 2500 0100  36
  228. -i scratch           (define a file name)
  229. -k 980,1f7f          (creates scratch with ONLY this portion in it)
  230. -i cpm63k.sys        (or whatever name you used)
  231. -r                   (read it all in)
  232. Next  PC   Save
  233. 2500 0100  36    *** (if these numbers change from above yours is bigger)
  234. -i scratch           (now we will overwrite with the saved portion)
  235. -r 880               (100h less than we wrote from, reads into 980 up)
  236. -i newsys.sys
  237. -k                   (make new file NEWSYS.SYS with the combination)
  238. -^C                  (CTL-C, all done)
  239.  
  240. (WARNING: a few rare systems do not put their systems images at these )
  241. (standard locations.  They are usually offset upwards by some multiple)
  242. (of 080h.  For these alter the "r 880" number above appropriately.    )
  243.  
  244. 6.            (Install the image on your system tracks)
  245. ==
  246.  
  247. A>sysgen newsys.sys      (or whatever name you used)
  248. DESTINATION DRIVE NAME (OR RETURN TO REBOOT)a  ( enter a    )
  249. DESTINATION ON A, THEN TYPE RETURN             ( enter <cr> )
  250. FUNCTION COMPLETE
  251. DESTINATION DRIVE NAME (OR RETURN TO REBOOT)   ( enter <cr> )
  252.  
  253. (Now reset, and try it out.)
  254.  
  255. (and you can create new disks on drive B in the future with)
  256.  
  257. A>sysgen newsys.sys
  258. DESTINATION DRIVE NAME (OR RETURN TO REBOOT)b  ( enter b    )
  259. DESTINATION ON B, THEN TYPE RETURN             ( enter <cr> )
  260. FUNCTION COMPLETE
  261. DESTINATION DRIVE NAME (OR RETURN TO REBOOT)   ( enter <cr> )
  262.  
  263.               ---------------------
  264.  
  265. In case of difficulty:
  266. =====================
  267.  
  268. Check that you can create bootable disks with your CPMxxK.SYS file.
  269. If not, you have made a mistake with your original system.
  270.  
  271. Most problems arise from confusion about system locations (especially
  272. on the Osborne I, which uses non-standard nomenclature).  Assuming
  273. you are starting from a standard CPM system, you should look at the
  274. code at location 1186h in your CPMxxK.SYS file with DDTZ
  275.  
  276. d>ddtz cpmxxk.sys
  277.  ......
  278. -l1186,1188
  279. 1186 C311nn   JMP nn11          (note the "nn" value)
  280.  
  281. and repeat with your NEWSYS.SYS file.  THE CODE SHOULD BE IDENTICAL.
  282. If not, you have made a sizing mistake.
  283. ª+