home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / zcpr33 / 0nzcom.doc < prev    next >
Text File  |  1994-07-13  |  14KB  |  286 lines
  1.  
  2.          Preliminary Information about New Z-Com v2.0 (NZ-COM)
  3.                                    by
  4.                                Joe Wright
  5.                                4 June 88
  6.  
  7.                         ** NEW Z-COM RELEASED **
  8.  
  9. As Murphy always knew, if a Manual can be late, it will be. On the other
  10. hand we expect it to  be  worth  the wait.  Initial purchasers of NZ-COM
  11. will have the following information and the Manual will be mailed later.
  12. Thank you for your indulgence.  SYSOPs:  Please distribute this  file as
  13. widely as possible.  Thank you.
  14.  
  15. Most of you who are reading this may already have a fair grasp of the Z-
  16. System and how its many features work so well for us.  I won't go into a
  17. lengthy explanation of it here.  Z-System will be covered  more fully in
  18. the Manual.  In the meantime almost any material you read about Z-System
  19. is generally applicable to New Z-Com v2.0.
  20.  
  21.  
  22. 1.  Introduction:
  23. -----------------
  24. NZ-COM, like its predecessor Z-Com,  will  allow the user to install the
  25. Z-System on his CP/M 2.2 system automatically,  without  any programming
  26. or assembly.  You will have it running on your computer in seconds. This
  27. is where the similarity ends.
  28.  
  29. NZ-COM will allow you to  customize your operating system environment in
  30. ways you could have only dreamed about. You can change operating systems
  31. at any time, even in the middle of a multiple command line.  You  can do
  32. it manually from the  command line or automatically from within alias or
  33. menu command scripts using flow controls depending on system conditions.
  34.  
  35. You can  change  the  whole operating system or any part of it.  You can
  36. switch from one command processor to  another or from one DOS to another
  37. with a simple command.
  38.  
  39. Need more memory temporarily for  a specific application?  Simply load a
  40. new system without IOP or RCP and FCP if not needed, run the memory hun-
  41. gry application (PerfectCalc comes to mind)  and  when  you're finished,
  42. load up  your normal system again.  All this is done in seconds with one
  43. multiple command.
  44.  
  45. Using NZ-COM is really  simplicity  itself.  You don't need source code.
  46. You don't have to assemble or link anything.  You don't even need SYSGEN
  47. or DDT to get NZ-COM running.  You don't have to 'hack' on anything (un-
  48. less you really want to).
  49.  
  50. If you have a floppy system, copy  the distribution files to a work disk
  51. then put the distribution disk away.  If you have a  hard disk system, I
  52. suggest you copy these files to the 'A0:'  partition of  the  hard disk.
  53. NZ-COM will work from any drive and user but 'A0:' is preferred and will
  54. speed things up considerably.
  55.  
  56. Getting NZ-COM running the first  time  is a two-step process almost too
  57. easy to talk about. First use MKZCM.COM to define the system you want to
  58. build and then use NZCOM.COM to build it.  Here's how:
  59.  
  60.                            A>MKZCM NZCOM<cr>
  61.  
  62. MKZCM will present a full screen  describing a full-up Z-System for your
  63. computer.  For the sake of argument, let's say you like it as now shown.
  64. Press 'S' for save and MKZCM will create two  files  for you:  NZCOM.ZCM
  65. and NZCOM.ENV.  Second step:
  66.  
  67.                               A>NZCOM<cr>
  68.  
  69. In about three shakes of the  old  lamb's tail, NZCOM will have loaded 7
  70. or so modules, written two files and  given  you  the  Z-System A0:BASE>
  71. prompt.  You are now in the world of the living.  You have a fully func-
  72. tional full-featured Z-System at your disposal.  You have arrived!
  73.  
  74. One of the primary  features  of  Z-System  is the TERMinal CAPabilities
  75. (TERMCAP or TCAP) segment in the environment.  As  delivered,  NZCOM in-
  76. stalls a  minimum  Lear-Siegler ADM-3A TCAP.  This will suffice for most
  77. Osborne and Kaypro computers and  for  most Televideo and Wyse terminals
  78. and many others.  If your terminal doesn't like ADM  stuff  or  has more
  79. capability, now  is  a good time to create your own NZCOM.Z3T file.  Use
  80. 'TCSELECT NZCOM' and choose your computer or terminal from the list. You
  81. can load the resulting  descriptor  with  NZCOM  NZCOM.Z3T (or of course
  82. with LDR or JetLDR).
  83.  
  84. NZ-COM is delivered  with  a  minimal  NZCOM.NDR Named Directory module,
  85. naming A0:BASE and A15:ROOT. This file is loaded automatically  by NZCOM
  86. whenever there  is  space available for it.  You may use MKDIR NZCOM.NDR
  87. to modify this file to taste or to make new ones.
  88.  
  89.  
  90. 2.  Practice:
  91. -------------
  92. Now that we know  we  have  Z-System,  let's play around a little.  Type
  93. MKZCM<cr> again and get the system  environment  map  display.  You will
  94. note that  each  of  the  segments have an address as well as a definite
  95. size.  MKZCM calculates the addresses of the segments based on the CBIOS
  96. address (where your computer's BIOS really  starts) and the sizes of the
  97. various segments.  The order of the segments is fixed by MKZCM but their
  98. sizes are definable by you.  You may lengthen,  shorten  or  eliminate a
  99. particular segment by defining its size.
  100.  
  101. Let's define a really small (large TPA) system. Note the TPA size report
  102. near the bottom of the screen. We need CCP, DOS and BIO segments as they
  103. are for the present.  Leave  them  alone.  The  IOP  (12 records) is the
  104. first candidate for elimination. Type '4'.  Now type '0' and return. The
  105. new display will show no IOP and a TPA 1.5k larger. Continue with selec-
  106. tions 5, 6, and 7 for RCP, FCP and NDR and notice how the  addresses and
  107. the TPA  size change.  Due to a technicality which requires our BIO seg-
  108. ment on a page rather  than  record  boundary,  you will not gain TPA by
  109. eliminating the SHS Shell Stack segment.  Leave it at 4 x 32.
  110.  
  111. Now type 'S'. You will be asked for a filename. Type 'SMALL' and return.
  112. MKZCM will create SMALL.ZCM and SMALL.ENV in the current directory.  Now
  113. type NZCOM SMALL.ZCM and return.  Voila, mesdames et messieurs, the Min-
  114. imum Z-System.  You will note (run  MKZCM  again) that the difference of
  115. the real CBIOS address and our NZ- COM Bios address is 400h or  only 1k.
  116. That is  the  total  overhead of Z-System.  Whithin 1k, you get multiple
  117. commands, the Z3 messages, external Path  and FCB, the Wheel, the Z3 en-
  118. vironment and TERMCAP as well as a full  4-entry  shell  stack.  Still a
  119. full-capability Z-System  and  only 1k larger than your old CP/M system.
  120. Magic.  You return to the full-up system with ZCOM<cr>.
  121.  
  122.  
  123. 3.  What's Going On Here?
  124. -------------------------
  125. NZ-COM (and Z3PLUS*) is a little more  than just cute.  It is a true ad-
  126. vance of the art.  Operating systems and  segments  thereof  have, until
  127. now, been  'black' magic.  The OS was just something you learned to live
  128. with.  From the largest mainframes to  the most modest micros, users had
  129. to simply take what the got and do the best they could with it. No more.
  130. The New Z-System puts a definite end to that.  The User, not just HAL or
  131. BigSoft, determines his own operating system  environment.  The  User is
  132. not stuck, either, with his last best choice.  Any part of NZ-COM can be
  133. modified in  many ways and at any time by the User from the command line
  134. or from alias or menu command script.  The New World.
  135.  
  136. NZ-COM consists of two Major  command  files, MKZCM.COM and NZCOM.COM, a
  137. selection of Z-system ReLocatable (ZRL) files and  a  number  of utility
  138. command files.  We  have  already  touched  on MKZCM and NZCOM.  The ZRL
  139. files contain the building blocks of  the system.  There are six of them
  140. contained in NZCOM.LBR:
  141.  
  142.      NZCPR.ZRL This is Jay Sage's ZCPR34 Command Processor
  143.  
  144.      NZDOS.ZRL This is Dennis Wright's ZRDOS at version 1.9c
  145.  
  146.      NZBIO.ZRL Mini-BIOS for warm-boot of NZ-COM (2 records)
  147.  
  148.      NZIOP.ZRL Dummy IOP structure
  149.  
  150.      NZRCP.ZRL The Resident Command Processor
  151.  
  152.      NZFCP.ZRL The Flow Control Processor
  153.  
  154. ZRL files are actually REL files  which  can  be produced by many of our
  155. favorite assemblers.  They are renamed to ZRL to avoid the temptation to
  156. run a standard linker on them.  These files use a multiple  Named COMMON
  157. Block construct  which a normal linker simply can't handle.  Only NZCOM,
  158. Z3PLUS or JetLDR have any chance at these files.
  159.  
  160. NZ-COM uses a data structure  known  as an environment descriptor, Z3ENV
  161. to the initiated, for its operation.  Z3ENV contains or implies  the ad-
  162. dresses and sizes of all Z-System segments as well as other data used by
  163. the command  processor  and  Z3  utilities to determine or change system
  164. status.  Z3ENV fully describes a particular system for NZ-COM.
  165.  
  166. The output files from MKZCM (name.ZCM or name.ENV) define a complete and
  167. explicit system in terms of  the environment descriptor.  NZCOM can read
  168. either of these files and determine how (or whether) to make any changes
  169. to the current system.  You will note that .ZCM files are actually ASCII
  170. text in the form of a standard symbol table.  You might  edit  this file
  171. to fine-tune a system more to your liking.
  172.  
  173. The actual programs contained  in the  .ZRL  modules use  Z3ENV  for all
  174. inter-module references.  In this way, a newly loaded  RCP  can find the
  175. address of the command processor and other segments of interest.
  176.  
  177. NZCON.Z3T and NZCOM.NDR are binary  segments  which are not address sen-
  178. sitive.  They can be loaded anywhere.  If you already have  Z3T  and NDR
  179. files for your current Z3 system, you may simply rename them for use un-
  180. der NZ-COM.
  181.  
  182.  
  183. 4.  What's REALLY Going on Here?
  184. --------------------------------
  185. Once you play around a little  and  get  used  to what goes on, you will
  186. notice NZCOM searches an LBR for its files unless told not  to.  You may
  187. put any of these files into NZCOM.LBR or any other LBR and get them from
  188. there. Although it costs one directory search to open an LBR, subsequent
  189. accesses of  the  LBR  do  not  go the the directory and are, therefore,
  190. quick.  If you get conscientious you can place the ZCM (or ENV) files in
  191. the library and eliminate that  search.  If you get really conscientious
  192. and ensure that the LBR occupies contiguous  (or  contemuous) allocation
  193. blocks on your disk, it flies.
  194.  
  195. For you 'speed at any cost' types, NZCOM will build your favorite system
  196. an create a single ZCI image  file of it (name.ZCI).  This system can be
  197. loaded in the twinkling of an eye, without reference  to  even  the LBR.
  198. No free  lunch.  Each  of  these  ZCI files are 10 or 12 k long, costing
  199. disk space.
  200.  
  201. NZCOM is also a  hot  package  loader.  It  can  load  any of the system
  202. modules individually or in groups.  As  mentioned  earlier,  NZCOM looks
  203. for its  packages in an LBR file unless you tell it otherwise.  You tell
  204. it 'otherwise' with  an  explicit DU:  or DIR:  reference.  Consider the
  205. possibilities.
  206.  
  207.                             NZCOM NZRCP.ZRL
  208.  
  209. NZCOM will open NZCOM.LBR, read and load NZRCP.ZRL from it.  If you want
  210. to load a file  from  disk,  without  reference  to the LBR, the command
  211. might be:
  212.  
  213.                NZCOM A6:NZRCP.ZRL or NZCOM WORK:NZRCP.ZRL
  214.  
  215. NZCOM supports DU:  references under CP/M and either DU:  or DIR: refer-
  216. ences under NZ-COM.
  217.  
  218. Let's get really fancy and consider that  we have a seperate LBR for de-
  219. scriptors, NZCOM.LBR for the modules and some loose files  on  the disk.
  220. We can build a system this way.
  221.  
  222.        NZCOM B0:DESC.LBR, TEST.ZCM, A0:NEWRCP.ZRL, A15:NZCOM.LBR
  223.  
  224. This will get TEST.ZCM from  B0:DESC.LBR,  get NEWRCP.ZRL as a disk file
  225. from A0:  and then open A15:NZCOM.LBR for the rest  of  the  modules re-
  226. quired for the new system.
  227.  
  228.  
  229. 5.  Conclusion
  230. --------------
  231. This short note is not complete,  and is perhaps too technical.  We will
  232. wait for the Manual (75 pages by now!) for a more  complete description.
  233. The real  purpose of NZ-COM is to present to the normal user of Z80 com-
  234. puter systems, not just to  the  'techie' developer, the latest and best
  235. operating system environment possible.  I believe that  it  can  do just
  236. that.
  237.  
  238.  
  239. I am reminded that some of you  don't actually own NZ-COM yet, and can't
  240. really follow these examples on your own computers. Fortunately for both
  241. of us, this situation can be remedied almost at once for the price  of a
  242. good dinner.  At  $69.95, NZ-COM will not upset your stomach, is high in
  243. nutrients and has no cholesterol. Unlike a good dinner, NZ-COM will keep
  244. you satisfied for more  than eight hours. Guaranteed. Low-fat software..
  245. (Somebody, Stop him!).
  246.  
  247. If none of this has whetted your appetite, then I simply don't know what
  248. to tell you.  If, on the other hand, I have created a certain longing or
  249. even hunger in the pit of  your  stomach,  please send me the price of a
  250. good dinner and we will both be satisfied.  (Ok, ok.  I quit.)
  251.  
  252. * Z3PLUS by Bridger Mitchell  of  Plu*Perfect Systems is similar in many
  253. respects to NZ-COM and presents the New Z-System to  CP/M  3.0  users of
  254. Commodore 128,  Osborne Executive, Morrow MD-11 and others.  Also $69.95
  255. from Alpha Systems.
  256.  
  257.  
  258.                                ORDER FORM
  259.  
  260.           New Z-Com v2.0 (NZ-COM) $ 69.95 (+ Calif Sales Tax)
  261.  
  262.                        Alpha Systems Corporation
  263.                           711 Chatsworth Place
  264.                            San Jose, CA 95128
  265.                              (408) 297-5594
  266.  
  267.    Name:
  268.  
  269.    Company:
  270.  
  271.    Address:
  272.  
  273.    City/State/Zip:
  274.  
  275.    Disk Format:  IBM 8 in.  ___ Kaypro II ___ Ampro/SB180 DSDD ___
  276.  
  277.    Other  Format:  _____________________________  (Please  be  explicit)
  278.  
  279.    Payment:  Visa ___ MasterCard ___ Check ___ Money Order ___
  280.  
  281.    Card Number and Exp Date:
  282.  
  283.    Thank you for your order.
  284.  
  285. --------------------------------- end ----------------------------------
  286.