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 / ZCPR2 / KP10NZ2.LBR / ZCPR2.DQC / ZCPR2.DOC
Text File  |  2000-06-30  |  9KB  |  218 lines
  1.                        ZCPR-2 on the KAYPRO 10
  2.                        =======================
  3.  
  4.                               ----------
  5.  
  6. REVISION NOTE:
  7.  
  8.      This file has been revised since its original release.  The major 
  9. changes  are to accomodate the three (!) different  operating  systems 
  10. that  have been released for the Kayrpo 10 and provide two options  of 
  11. CPR systems for general use and SYSOP's of RCPM systems.
  12.  
  13.                               ----------
  14.  
  15. The  accompanying files allow installation of Rich Conn's     replace
  16. ment  console  command  processor on the Kaypro  10.   This  processor 
  17. replacement, and its rich collection of utilities, greatly enhance the 
  18. utility  and  flexibility of this hard disk machine.   It is  in  this 
  19. environment that ZCPR-2 really shines!
  20.  
  21. The  Kaypro 10 has limited graphics capability by defining each  char
  22. acter  block into 8 segments.   These 8 segments are turned on by  the 
  23. appropriate characters in the 128 - 255 character range,  i.e.,  those 
  24. with the eighth bit set.   Since some programs (and some ZCPR-2 utili
  25. ties)  depend  on this eighth bit being set,  a method was  needed  to 
  26. prevent  this graphics character being displayed when  standard  ascii 
  27. text should be displayed.
  28.  
  29. This has been accomplished by the simple expedient of adding a mask in 
  30. the  CONOUT routine of the BIOS which tests a specific byte in  memory 
  31. and,  if it is set,  allows graphic character display; if it is clear, 
  32. the  eighth  bit is masked off and the standard character set is  dis
  33. played.  This byte, located at 04FH, is set by a command that has been 
  34. added to the ZCPR2 CPR.   This command, "GRAF", is used like any other 
  35. resident command, such as, REN or ERA.  It toggles the graphic byte at 
  36. 04FH.   This  is indicated on the display by the CPR prompt  ">".   In 
  37. ZCPR-2 installations, this prompt character has the eighth bit set so, 
  38. when the graphics mode is enabled, a block character is displayed next 
  39. to  the drive/user number.   Merely type "GRAF <cr>" and the  standard 
  40. cpr prompt ">" appears.
  41.  
  42. The  Kaypro 10 has an open block of memory between 0F100 and 0F600 and 
  43. this space is used for the ZCPR-2 buffers.   This allows  installation 
  44. without  further shrinking the available TPA.   A full featured ZCPR-2 
  45. installation  is provided with the sole exception of  IO  redirection.  
  46. (My assembly language programming isn't good enough for this yet.)  
  47.  
  48. There  are  three versions of the CPM operating system that  has  been 
  49. released  by Kaypro for the 10.   These may be identified by the  cold 
  50. boot sign on message.  In the remainder of this document, I will refer 
  51. to  them  as  versions 0,  D and F.   The sign  on  messages  and  the 
  52. corresponding versions are as follows:
  53.  
  54. .pa
  55.  
  56. Sign on Message                    Version    
  57. ---------------                    -------    
  58.  
  59. KAYPRO 10 CP/M Version 2.2            0
  60. KAYPRO 10 CP/M Version 2.2D           D
  61. KAYPRO 10 CP/M Version 2.2F           F
  62.  
  63.  
  64.  
  65.      The  following  description  of the two  "systems"  describe  the 
  66. options that may be generated using the appropriate BIOSPAT.ASM  along 
  67. with the Z2STD.HEX/Z2SEC.HEX files.   The source code modifications to 
  68. ZCPR2.ASM  and ZCPRHDR.LIB are described in the accompanying Z2PAT.DOC 
  69. file.  The only files you need to supply are your distribution copy of 
  70. PUTSYS.COM and DDT.COM.
  71.  
  72.  
  73.                               PUTSTD.COM
  74.                               ----------
  75.  
  76.      This  file is used in place of PUTSYS.COM,  as supplied with  the 
  77. Kaypro.  This version of ZCPR2 is a more or less standard version with 
  78. resident DIR, TYPE, LIST commands.  Because it is a full featured CCP, 
  79. external  buffers are used for the CCP stack as well as the  CCP  file 
  80. control   block.    This  version  is  intended  as  a  "general  use" 
  81. implementation.
  82.  
  83.  
  84.                               PUTSEC.COM
  85.                               ----------
  86.  
  87.      This version is also used in place of PUTSYS.COM but is  intended 
  88. for  use in situations requiring security such as RCPM  systems.   The 
  89. DIR,  LIST  and  TYPE commands have been deleted to allow  replacement 
  90. with  limited  transient programs to accomplish  the  same  functiion.  
  91. Additionally,  a  patch has been added to ZCPR2 CCP to allow  limiting 
  92. the maximum disk and user when the WHEEL byte is reset.  All remaining 
  93. ZCPR2 resident commands,  except the DU: command, have been made wheel 
  94. oriented commands.   Thus, a SYSOP can have a reasonably secure system 
  95. and  be  able  to  open it up for his personal use without  a  lot  of 
  96. passworded files.   In fact,  using the limited user area approach, it 
  97. is  possible  to  put  up a RCPM system with  NO  .COM  files  in  the 
  98. accessible  user  areas  and  yet through a  double  password  system, 
  99. totally open up the machine.   Much of this implementation depends  on 
  100. the  use of the powerful ZCPR2 utilities such as CD,  MKDIR,  STARTUP, 
  101. PATH,  LD  along  with customized versions of RBBS,  XMODEM  and  BYE.  
  102. (Note  that  CD MUST be modified to run under BYE with BYE LOW  as  is 
  103. done with the Kaypro 10.)
  104. .pa
  105.                            Buffer Locations
  106.                            ----------------
  107.  
  108.  
  109. Buffer Name              PUTSTD.COM          PUTSEC.COM
  110. -----------              ----------          ----------
  111.  
  112. WHEEL BYTE               003E                003E
  113. External Path            0040-004E           0040-004E
  114. GRAPHICS BYTE            004F                004F
  115. CPR FCB                  F2D0-F2F0           Internal to CPR
  116. Named Directory          F300-F4FF           F300-F4FF
  117. Multicommand line        F500-F5CF           F500-F5CF
  118. CPR Stack                F5D0-F600           Internal to CPR
  119.  
  120.                             Files Included
  121.                             --------------
  122.  
  123. BIOSPAT0.ASM   Patch file for version 0
  124.  
  125. BIOSPATD.ASM   Patch file for version D
  126.  
  127. BIOSPATF.ASM   Patch file for version F
  128.  
  129. Z2STD.HEX      Overlay file for PUTSTD.COM
  130.  
  131. Z2SEC.HEX      Overlay file for PUTSEC.COM
  132.  
  133. Z2PAT.DOC      Description of ZCPR2 CPR Modifications.
  134.  
  135. NZ2KP10.DOC    This file
  136. .pa
  137.                         Installation Procedure
  138.                         ----------------------
  139.  
  140. The  only  files  needed beyond those supplied here  are  DDT.COM  and 
  141. PUTSYS.COM.  The latter writes CPM on the hard disk. Before beginning, 
  142. I  suggest you edit the PATH:  section of the appropriate  BIOSPAT.ASM 
  143. file to suit your needs.   As this one is coded,  the PATH is  current 
  144. user, drive A, then Drive A, user 0.  The idea is to overlay CCP and a 
  145. CCP  patch  added at the end of the BIOS with the ZCPR-2 CPR  and  the 
  146. BIOSPATCH routine.   This is accomplished as follows:  (Lines you type 
  147. indicated by <--- )
  148.  
  149.  
  150. A0>ASM BIOSPATx.AAZ <cr>        <--- (Insert 0,D or F for x as
  151. CP/M ASSEMBLER VERSION 2.0            appropriate)
  152. nnnn                            <--- (Depends on version: 0 - EC4B 
  153. 000H USE FACTOR                                           D - ECFE
  154. END OF ASSEMBLY                                           F - ED11)
  155.  
  156. Warm Boot
  157.  
  158. A1>DDT PUTSYS.COM <cr>        <---
  159. DDT VERS 2.2
  160. NEXT  PC
  161. 2300 0100
  162. IZ2STD.HEX            <--- (or, for PUTSEC, IZ2SEC.HEX)
  163. R3580                <---
  164. NEXT  PC
  165. 2300 D400
  166. IBIOSPATx.HEX            <--- (Insert 0, B or D for x as
  167. R3580                <---  appropriate.)
  168. NEXT  PC
  169. 2300 CC68                       <--- PC depends on version
  170. G0                <---
  171.  
  172. Warm Boot
  173.  
  174. A0>SAVE nn PUTSTD.COM        <--- (or PUTSEC.COM. Note that nn 
  175.                                      the  decimal  equivalent  of 
  176.                                      the hex number given under
  177.                                      NEXT when DDT is invoked.  Values 
  178.                                      for nn are: 0 - 35
  179.                                                  D - 34
  180.                                                  F - 40)
  181.  
  182.  
  183. You  can now use PUTSTD.COM or PUTSEC.COM to rewrite the modified CP/M 
  184. on  the system track of the hard disk.   Run it then do a  cold  boot.  
  185. You  should get a new sign-on message with the line  "STARTUP?".   The 
  186. Multicommand line buffer is initialized to look for and execute a file 
  187. called "STARTUP.COM" so you can rename any desired starting program to 
  188. get an automatic execution on cold boot.  (If anything goes wrong, put 
  189. a floppy disk with CP/M on it, into the drive, do a cold boot, and run 
  190. PUTSYS.COM  (not PUTSTD.COM or PUTSEC.COM) and that will get you  back 
  191. to go.)
  192.  
  193. Assuming all is ok to here, you will see a block character next to A0.  
  194. Type "GRAF <cr>" and you should see the normal CPR prompt.
  195.  
  196. The following hex values associated with this ZCPR-2 installation:
  197.  
  198.  
  199. Some  excellent  manuals on all the ZCPR2 documentation are  available 
  200. from:
  201.  
  202.         New York Amateur Computer Club
  203.         P. O. Box 106, Church St. Station
  204.         New York, NY  10008
  205.  
  206. Ask  for Book 6:  ZCPR2 User & Reference Manual and Book  7:  ZCPR2  & 
  207. SYSLIB These are $10.00 each and well worth it.
  208.  
  209. Thanks  to  Rich Conn for his excellent contribution to public  domain 
  210. software.   I  hope  I  have  done his effort  justice  by  the  above 
  211. installation.   Any  "bug" reports can be left on the Syracuse  Kaypro 
  212. Network at 315-468-2887.
  213.  
  214.  
  215.             John C. Smith
  216.             Manlius, NY 
  217.             December 4, 1983
  218.