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 / BEEHIVE / ZCAT / ZIPFILES / ZCAT-013.ZIP / Z3-WKBK.WZ / Z3-WKBK.WS
Text File  |  1991-01-31  |  29KB  |  790 lines

  1. .cw 11
  2. .po 11
  3. .pn 1
  4. .fo                                                            Page #
  5.  
  6.  
  7.  
  8.  
  9.                  The ZCPR3 INSTALLATION WORKBOOK
  10.  
  11.                          by Richard Conn
  12.  
  13.  
  14.                   First Revision, 8 March 1985
  15.                 Original Draft, 20 February 1985
  16.  
  17.  
  18.  
  19.  
  20. .he                                   The ZCPR3 INSTALLATION WORKBOOK
  21.  
  22. About this Workbook
  23.  
  24.      Thi≤á workbooδá take≤ yo⌡ througΦ thσ eigh⌠ step≤á oµá ZCPR│ ì
  25. installation«á  Yo⌡ shoulΣ havσ ß cop∙ oµ thσ Installatioε Manua∞ ì
  26. (o≥á SAMPLER⌐ hand∙ a≤ yo⌡ worδ througΦ it«á  Thi≤ workbooδá wil∞ ì
  27. servσá t∩á direc⌠á you≥ readinτ oµ thσá Installatioεá Manua∞á anΣ ì
  28. providσ ß placσ fo≥ yo⌡ t∩ writσ dowε informatioε requireΣ durinτ ì
  29. thσá installatioεá process«á  Therσá arσ blank≤ t∩á fil∞á iεá anΣ ì
  30. scratcΦá area≤á iεá whicΦ yo⌡ ma∙ perforφ computation≤á anΣá makσ ì
  31. notes╗á i⌠ i≤ recommendeΣ tha⌠ yo⌡ makσ al∞ oµ you≥á computation≤ ì
  32. anΣ note≤ here«  Thi≤ workbooδ caε servσ a≤ ß documen⌠ oε ho≈ yo⌡ ì
  33. se⌠á u≡ you≥ ZCPR│ system¼á s∩ yo⌡ caε refe≥ bacδ t∩ i⌠ late≥á iµ ì
  34. yo⌡ wan⌠ t∩ makσ ß change.
  35.  
  36.      EacΦá ste≡á oµ thσ installatioε proces≤ i≤ detaileΣá iεá thσ ì
  37. followinτ page≤ anΣ i≤ presenteΣ witΦ thσ followinτ format:
  38.  
  39.           Objective:
  40.                The goal to be achieved
  41.           Required Files:
  42.                The programs and other files required to perform
  43.                this step
  44.           References:
  45.                The chapters and sections in the Installation
  46.                Manual and in ZCPR3:_The_Manual associated
  47.                with this step; the indicated sections of the
  48.                Installation Manual are required reading, while
  49.                those sections in ZCPR3:_The_Manual contain
  50.                supplementary information
  51.           Instructions:
  52.                Step-by-step details on what to do; places are
  53.                also provided for you to write down important
  54.                information
  55.  
  56.  
  57. .paè
  58. Overview of ZCPR3 Installation
  59.  
  60.      Objective To summarize the goals of the installation
  61.                process
  62.  
  63.      Required_Files None
  64.  
  65.      References
  66.           Installation Manual -- Chapter 1
  67.           ZCPR3: The Manual   -- Chapters 1, 2, 9-16
  68.  
  69.      Instructions
  70.      1«áá Revie≈áá chapte≥á ▒á oµá thσá Installatioεá Manua∞á anΣ ì
  71. (optionally⌐ revie≈ thσ indicateΣ chapter≤ oµ ZCPR3║_Thσ_Manual.
  72.  
  73.      2«á  Iε summary¼ thσ followinτ item≤ arσ goinτ t∩ bσ createΣ ì
  74. fo≥ you≥ microcompute≥ system.
  75.  
  76.           A«á ┴á ne≈á SYSGE╬ imagσ containinτ thσá ZCPR│á CommanΣ ì
  77. Processo≥á iε placσ oµ thσ CP/═ Consolσ CommanΣ Processo≥á (CCP)«  ì
  78. Thσá BIO╙á ma∙á als∩ bσ modified«á  Figurσ 1-▒ (pagσá 6⌐á oµá thσ ì
  79. Installatioεá Manua∞á show≤ thσ SYSGE╬ image≤ oµá ßá conventiona∞ ì
  80. CP/═ systeφ anΣ ß ZCPR│ system«  Thσ modifieΣ BIO╙ i≤ requireΣ iε ì
  81. orde≥ t∩ initializσ thσ ZCPR│ buffer≤ fo≥ you≥ system.
  82.  
  83.           B«á Thσá Systeφá Segment≤ requireΣ fo≥ you≥á choicσá oµ ì
  84. ZCPR│á configuration«á  Sectioεá 1.│ oµ thσá Installatioεá Manua∞ ì
  85. (pagσ 7⌐ anΣ chapter≤ 2¼á 10¼ anΣ 1╢ oµ ZCPR3║_Thσ_Manualô discus≤ ì
  86. thσ topiπ oµ thσ Systeφ Segments«  Thσ ZCPR│ Systeφ Segment≤ are:
  87.  
  88.                o Environment Descriptor
  89.                o TCAP File for your terminal
  90.                o Flow Command Packages
  91.                o Input/Output Packages
  92.                o Resident Command Packages
  93.                o Named Directory Files
  94.  
  95.           C«áá Thσá ZCPR│á Utilitie≤á installeΣá fo≥á you≥á ZCPR│ ì
  96. configuration«á  Sectioεá 1.┤ oµ thσ Installatioε Manua∞ (pagσ 7⌐ ì
  97. anΣ chapter≤ 3-8¼á 15¼á anΣ 1╢ oµ ZCPR3║_Thσ_Manualô discus≤á thσ ì
  98. utilities.
  99.  
  100. .paè
  101.      3«á Thσá installatioε proces≤ fo≥ ß ZCPR│ systeφ consist≤ oµ ì
  102. these steps:
  103.           1) Select the features of the target ZCPR3 system
  104.           2) Plan the memory structure of the target ZCPR3 system
  105.                (create Z3BASE.LIB)
  106.           3⌐ Modif∙ thσ colΣ boo⌠ routinσ iε thσ BIO╙ t∩
  107.                initialize buffers as required
  108.           4) Select the features of the ZCPR3 Command Processor
  109.                (create Z3HDR.LIB)
  110.           5⌐ Overla∙ thσ CP/═ CC╨ witΦ thσ ZCPR│ CommanΣ
  111.                Processor and overlay the old BIOS with the
  112.                new BIOS; create the new SYSGEN image for your
  113.                ZCPR3 System
  114.           6) Place the new SYSGEN image for your ZCPR3 System
  115.                onto the Operating System tracks of a disk
  116.           7) Select the features of your System Segments and
  117.                create the System Segments
  118.           8) Install the ZCPR3 utilities
  119.  
  120.      Read chapter 1 of the Installation Manual now.
  121.  
  122. .paè
  123. Step 1: Selecting the Features
  124.  
  125.      Objective Select the features your ZCPR3 System will
  126.                have
  127.  
  128.      Required_Files None
  129.  
  130.      References
  131.           Installation Manual -- Chapter 2
  132.           ZCPR3: The Manual   -- Chapters 2, 9-11, and 17
  133.  
  134.      Instructions
  135.      A« ReaΣ Chapte≥ ▓ oµ thσ Installatioε Manual.
  136.  
  137.      B. Make the following decisions:
  138.  
  139.           1« Arσ yo⌡ goinτ t∩ includσ thσ standarΣ     YES   NOì
  140. 1╦áá overheaΣá iεá you≥á ZCPR│á System┐áá  I⌠áá i≤ ì
  141. recommendeΣá tha⌠ yo⌡ answe≥ YE╙ t∩ thi≤ question«  ì
  142. Iµ YES¼ g∩ t∩ decisioε 3╗ iµ NO¼ g∩ t∩ questioε 2.
  143.  
  144.           2«á Yo⌡á arσá NO╘ goinτ t∩á includσá thσ ì
  145. standarΣ 1╦ overheaΣ iε you≥ ZCPR│ System«á  WhicΦ ì
  146. part≤á oµ thσ standarΣ overheaΣ arσ yo⌡á goinτá t∩ ì
  147. include?
  148.  
  149.                2a. External Stack                      YES   NO
  150.  
  151.                2b. Command Line Buffer                 YES   NO
  152.  
  153.                2c. Memory-Based Named Directory        YES   NO
  154.  
  155.                2d. External File Control Block         YES   NO
  156.  
  157.                2e. Message Buffers                     YES   NO
  158.  
  159.                2f. Shell Stack                         YES   NO
  160.  
  161.                2g. Environment Descriptor              YES   NO
  162.  
  163.           3«á WhicΦá oµ thσ followinτ package≤ arσ ì
  164. yo⌡ goinτ t∩ implemen⌠ iε you≥ ZCPR│á System?á  I⌠ ì
  165. i≤á suggesteΣ tha⌠ Flo≈ CommanΣ Package≤ arσá mos⌠ ì
  166. important¼á Residen⌠á CommanΣ Package≤ arσ second¼ ì
  167. anΣ Input/Outpu⌠ Package≤ arσ third.
  168.  
  169.                3a. Flow Command Packages               YES   NO
  170.  
  171.                3b. Resident Command Packages           YES   NO
  172.  
  173.                3c. Input/Output Packages               YES   NO
  174.  
  175. .paè
  176.           4«á WhicΦá oµ thσ othe≥ buffer≤ arσá yo⌡ ì
  177. goinτá t∩ provide┐á  Thσ Externa∞ PatΦá i≤á highl∙ ì
  178. recommended.
  179.  
  180.                4a. External Path                       YES   NO
  181.  
  182.                4b. Wheel Byte                          YES   NO
  183.  
  184.  
  185.  
  186.                  -- Blank Space for Comments --
  187.  
  188.  
  189. .paè
  190. Step 2: ZCPR3 Memory Structure
  191.  
  192.      Objective To plan the memory structure of your ZCPR3
  193.                System and to create your Z3BASE.LIB file
  194.  
  195.      Required_Files Z3BASE.LIB (ZCPR3 File)
  196.                     Z3LOC.COM (ZCPR3 File)
  197.                     MOVCPM.COM or equiv
  198.                     DDT.COM or equiv (ZDM and DSD)
  199.                     your favorite editor
  200.  
  201.      References
  202.           Installation Manual -- Chapter 3
  203.           ZCPR3: The Manual   -- Chapters 2 and 18
  204.  
  205.      Instructions
  206.      A« ReaΣ Chapte≥ │ oµ thσ Installatioε Manual.
  207.  
  208.      B« Yo⌡ arσ no≈ goinτ t∩ figurσ ou⌠ ho≈ mucΦ spacσ you≥ ZCPR│ ì
  209. Systeφ i≤ goinτ t∩ take«á  Fil∞ ou⌠ thσ followinτ tablσ baseΣá oε ì
  210. you≥ answer≤ iε Ste≡ 1«  
  211.  
  212.           1«á Iµá yo⌡ answereΣ YE╙ t∩ questioεá 1¼ ì
  213. ente≥ 1╦ anΣ g∩ oε t∩ thσ bottoφ oµ thσ page«á  Iµ ì
  214. yo⌡á answereΣ N╧ t∩ questioε 1¼á ente≥ ░ anΣ g∩ oε ì
  215. t∩ question 2.                                         _________
  216.  
  217.           2«á  Fo≥á eacΦ oµ thσ YE╙ answer≤á unde≥ ì
  218. questioε 2¼á ente≥ thσ indicateΣ value«á  Fo≥ eacΦ ì
  219. oµ thσ N╧ answers¼á ente≥ 0«  Item≤ 2b¼ 2c¼ anΣ 2µ ì
  220. may be adjusted if you want more or less space.
  221.  
  222.                2a. External Stack = 48                 _________
  223.  
  224.                2b. Command Line Buffer = 208
  225.                    (allows for 200 chars/line)         _________
  226.  
  227.                2c. Named Directory Buffer = 256
  228.                    (allow≤ fo≥ 1┤ 18-bytσ entries)     _________
  229.  
  230.                2d. External FCB = 48
  231.                                                        _________
  232.  
  233.                2e. Message Buffers = 80
  234.                                                        _________
  235.  
  236.                2f. Shell Stack = 128
  237.                    (allows for 4 32-byte shells)       _________
  238.  
  239.                2g. Environment Descriptor = 256
  240.                                                        _________
  241.  
  242.           Computσ thσ tota∞ oµ al∞ value≤ yo⌡ havσ ì
  243. entered in on this page.                               =========
  244. .paè
  245.           2h«á Ente≥á thσ tota∞ froφ thσ bottoφ oµ ì
  246. thσ previou≤ pagσ here.
  247.                                                        ==========
  248.  
  249.           3«á Ente≥ thσ followinτ value≤ fo≥á eacΦ ì
  250. oµ thσ package≤ yo⌡ selecteΣ iε questioε │ iε ste≡ ì
  251. 1«á  Iµ yo⌡ wisΦ t∩ modif∙ thesσ value≤ t∩ providσ ì
  252. morσá o≥á les≤ spacσ fo≥ eacΦ oµá thesσá packages¼ ì
  253. fee∞á freσ t∩ d∩ so«á  Thσ indicateΣ size≤ arσ thσ ì
  254. recommendeΣ values.
  255.  
  256.                3a. Flow Command Package = 0.5K         _________
  257.  
  258.                3b. Resident Command Package = 2K
  259.                                                        _________
  260.  
  261.                3c. Input/Output Package = 1.5K
  262.                                                        _________
  263.  
  264.  
  265.  
  266.                3d. Total of 3a-3c                      =========
  267.  
  268.           4«á  Item≤á 4ß anΣ 4Γ iε ste≡ ▒á requirσ ì
  269. virtuall∙ n∩ additiona∞ spacσ (oε thσ orde≥ oµ 10-ì
  270. 1╢ byte≤ total)¼á anΣ spacσ fo≥ thesσ entrie≤á caε ì
  271. usuall∙á bσ founΣ somewherσ iε fixeΣ memor∙á (dowε ì
  272. iεá thσá firs⌠ 25╢ byte≤ o≥ u≡ iε thσá BIOS)«á  N∩ ì
  273. spacσ entr∙ wil∞ bσ madσ fo≥ thesσ selections.
  274.  
  275.  
  276.      Computσ thσ tota∞ oµ thσ entrie≤ oε thi≤ pagσ ì
  277. anΣ rounΣ thσ numbe≥ u≡ t∩ thσ nex⌠ 1╦ iµ therσ i≤ ì
  278. any fraction.  Enter the total of 2h and 3d.           =========
  279.  
  280.  
  281.      C«á Figurσá ou⌠ thσ sizσ oµ you≥á BIOS«á  Thσ ì
  282. prograφ  Z3LO├ wil∞ givσ yo⌡ thσ startinτá addres≤ ì
  283. oµ you≥ BIO╙ iµ yo⌡ ruε i⌠ oε you≥ curren⌠ system«  ì
  284. A≤ aε alternative¼ thσ addres≤ a⌠ memor∙ location≤ ì
  285. ▒á anΣá ▓á caε bσ examineΣ witΦ DD╘á t∩á determinσ ì
  286. wherσá you≥ BIO╙ starts«á  Writσ dowε thσ sizσá oµ ì
  287. you≥ BIO╙ here.                                        _________
  288.  
  289. .paè
  290.      D«áá  Determinσá wherσá yo⌡á caεá placσá thσá ZCPR│á CommanΣ ì
  291. Processo≥á (ZCPR│á CP)«á  Thi≤á hinge≤ oε wherσ you≥á MOVCP═á (o≥ ì
  292. equivalent⌐á prograφá place≤á thσ systeφ wheε tolΣá t∩á movσá it«  ì
  293. MOVCP═á relocate≤ thσ BDO╙ fo≥ you¼á anΣ thi≤ i≤ thσ onσ par⌠á oµ ì
  294. you≥ olΣ CP/═ systeφ whicΦ wσ arσ retaining¼á s∩ wσ wil∞ havσá t∩ ì
  295. plaεá thσ memor∙ ma≡ oµ you≥ systeφ baseΣ oε wherσ yo⌡ caεá placσ ì
  296. thσ BDOS«  Iµ yo⌡ arσ goinτ t∩ usσ ZRDOS▒ o≥ ZRDOS▓ froφ Echelon¼ ì
  297. thi≤á become≤á mucΦá les≤ oµ ß probleφ sincσá yo⌡á havσá absolutσ ì
  298. contro∞ oµ wherσ yo⌡ caε placσ thσ ZRDOS«  Sincσ thσ installatioε ì
  299. manua∞á i≤á geareΣ fo≥ thosσ wh∩ wil∞ continuσ t∩á usσá thσá CP/═ ì
  300. BDOS¼á wσá wil∞á direc⌠ thσ discussioε t∩ thσ BDO╙ anΣ no⌠á cove≥ ì
  301. installation with ZRDOS at this time.
  302.  
  303.      T∩á assis⌠ yo⌡ furthe≥ iε determininτ thσ addresse≤ fo≥á thσ ì
  304. component≤á oµ you≥ ZCPR│ System¼á thσ followinτ tablσ show≤á thσ ì
  305. addresse≤á oµá thσ ZCPR│ CommanΣ Processor¼á BDOS¼á anΣ BIO╙á fo≥ ì
  306. variou≤á size≤ oµ TP┴ (b∙ "TPA"¼á ╔ aφ referrinτ t∩ thσá areßá oµ ì
  307. memor∙á belo≈ thσ ZCPR│ CommanΣ Processo≥ whicΦ doe≤ NO╘á includσ ì
  308. thσ ZCPR│ CommanΣ Processo≥ itself).
  309.  
  310.                  ------------ Locations ----------
  311. TPA Size         ZCPR3 CP           BDOS      BIOS
  312.  
  313.    44K              0B000          0B800     0C600
  314.    45K              0B400          0BC00     0CA00
  315.    46K              0B800          0C000     0CE00
  316.    47K              0BC00          0C400     0D200
  317.    48K              0C000          0C800     0D600
  318.    49K              0C400          0CC00     0DA00
  319.    50K              0C800          0D000     0DE00
  320.    51K              0CC00          0D400     0E200
  321.    52K              0D000          0D800     0E600
  322.    53K              0D400          0DC00     0EA00
  323.    54K              0D800          0E000     0EE00
  324.    55K              0DC00          0E400     0F200
  325.    56K              0E000          0E800     0F600
  326.  
  327.      Fo≥á example¼á iµá thσá amoun⌠ oµá additiona∞á overhead¼á a≤ ì
  328. indicateΣ b∙ you≥ answe≥ t∩ questioε B┤ oε thσ previou≤ page¼á i≤ ì
  329. 1K¼á anΣá you≥ BDO╙ currentl∙ reside≤ a⌠ E400¼á theε yo⌡ neeΣá t∩ ì
  330. movσ thσ BDO╙ dowε b∙ 1╦ (1╦ ╜ 400H⌐ t∩ E000«  Hence¼ yo⌡ neeΣ t∩ ì
  331. ruεá MOVCP═á witΦá thσá correc⌠ valuσ t∩ placσá you≥á BDO╙á a⌠á ß ì
  332. startinτ addres≤ n∩ highe≥ thaε E000.
  333.  
  334.      Find this value now.  Record the following values:
  335.  
  336.  
  337.           ZCPR3 CP Address  _____________
  338.  
  339.           BDOS Address      _____________
  340.  
  341.           BIOS Address      _____________
  342.  
  343. .paè
  344.      E«á Usinτá thσá memor∙ ma≡ iε Figurσ 3-▒ (pagσá 22⌐á oµá thσ ì
  345. Installatioεá Manua∞ anΣ thσ example≤ oε thσ followinτ tw∩á page≤ ì
  346. a≤ ß guide¼á fil∞ ou⌠ thσ followinτ tablσ a≤ ß memor∙ ma≡ fo≥ thσ ì
  347. systeφá yo⌡á arσá planning«á  Usσ thσ datß froφ Ste≡á ▒á anΣá thσ ì
  348. question≤á iεá thi≤á ste≡ (A-D⌐ t∩ hel≡ you«á  Thσá answer≤á froφ ì
  349. questioεá ─ (previou≤ page⌐ shoulΣ bσ copieΣ directl∙á int∩á thi≤ ì
  350. tablσ a≤ the∙ arσ (startinτ addresse≤ oµ thσ ZCPR│ CP¼á BDOS¼ anΣ ì
  351. BIOS)«  Leavσ blanδ thσ element≤ yo⌡ diΣ no⌠ select«  Iµ you≥ RO═ ì
  352. i≤ a⌠ aε odΣ location¼á adjus⌠ you≥ memor∙ usagσ accordingl∙ (yo⌡ ì
  353. ma∙ wan⌠ t∩ placσ somσ oµ thσ buffer≤ AFTE╥ thσ ROM).
  354.  
  355.                                                ADDRESS
  356. FUNCTION                        SIZE      STARTING  ENDING
  357.  
  358.  
  359. ZCPR3 Command Processor          2   K    ________  ________
  360.  
  361. BDOS                             3.5 K    ________  ________
  362.  
  363. Your BIOS                     _______     ________  ________
  364.  
  365. ROM (if not at top of memory) _______     ________  ________
  366.  
  367. Resident Command Package      _______     ________  ________
  368.  
  369. ROM (if not at top of memory) _______     ________  ________
  370.  
  371. Input/Output Package          _______     ________  ________
  372.  
  373. ROM (if not at top of memory) _______     ________  ________
  374.  
  375. Flow Command Package          _______     ________  ________
  376.  
  377. ROM (if not at top of memory) _______     ________  ________
  378.  
  379. Environment Descriptor        _______     ________  ________
  380.  
  381. Shell Stack                   _______     ________  ________
  382.  
  383. Message Buffers               _______     ________  ________
  384.  
  385. External FCB                  _______     ________  ________
  386.  
  387. Named Directory Buffer        _______     ________  ________
  388.  
  389. Command Line Buffer           _______     ________  ________
  390.  
  391. External Stack                _______     ________  ________
  392.  
  393. ROM (if at top of memory)     _______     ________  ________
  394.  
  395.      Seσá thσ followinτ tw∩ page≤ fo≥ example≤ oµ ho≈ t∩ fil∞á iε ì
  396. thi≤ table«  Refe≥ als∩ t∩ pagσ 2▓ oµ thσ Installatioε Manual.
  397. .paè.fo                                                           Page #
  398.  
  399.      Examplσá 1║á N∩ RO═ iε memor∙ anΣ n∩á Input/Outpu⌠á Package«  ì
  400. All other features selected.
  401.  
  402.  
  403.                                                ADDRESS
  404. FUNCTION                      SIZE      STARTING  ENDING
  405.  
  406.  
  407. ZCPR3 Command Processor          2   K    _ D600 _  _ DDFF _
  408.  
  409. BDOS                             3.5 K    _ DE00 _  _ EBFF _
  410.  
  411. Your BIOS                     __ 1.5 K    _ EC00 _  _ F1FF _
  412.  
  413. ROM (if not at top of memory) _______     ________  ________
  414.  
  415. Resident Command Package      __ 2.0 K    _ F200 _  _ F9FF _
  416.  
  417. ROM (if not at top of memory) _______     ________  ________
  418.  
  419. Input/Output Package          _______     ________  ________
  420.  
  421. ROM (if not at top of memory) _______     ________  ________
  422.  
  423. Flow Command Package          __ 0.5 K    _ FA00 _  _ FBFF _
  424.  
  425. ROM (if not at top of memory) _______     ________  ________
  426.  
  427. Environment Descriptor        _ 256 _     _ FC00 _  _ FCFF _
  428.  
  429. Shell Stack                   _ 128 _     _ FD00 _  _ FD7F _
  430.  
  431. Message Buffers               _  80 _     _ FD80 _  _ FDCF _
  432.  
  433. External FCB                  _  48 _     _ FDD0 _  _ FDFF _
  434.  
  435. Named Directory Buffer        _ 256 _     _ FE00 _  _ FEFF _
  436.  
  437. Command Line Buffer           _ 208 _     _ FF00 _  _ FFCF _
  438.  
  439. External Stack                _  48 _     _ FFD0 _  _ FFFF _
  440.  
  441. ROM (if at top of memory)     _______     ________  ________
  442.  
  443. .paè
  444.      Examplσ 2║á 1╦ RO═ froφ F800-FBF╞ anΣ n∩ Input/Outpu⌠á Packì
  445. age«  Al∞ othe≥ feature≤ selected.
  446.  
  447.  
  448.                                                ADDRESS
  449. FUNCTION                      SIZE      STARTING  ENDING
  450.  
  451.  
  452. ZCPR3 Command Processor          2   K    _ D200 _  _ D9FF _
  453.  
  454. BDOS                             3.5 K    _ DA00 _  _ E7FF _
  455.  
  456. Your BIOS                     __ 1.5 K    _ E800 _  _ EDFF _
  457.  
  458. ROM (if not at top of memory) _______     ________  ________
  459.  
  460. Resident Command Package      __ 2.0 K    _ EE00 _  _ F5FF _
  461.  
  462. ROM (if not at top of memory) _______     ________  ________
  463.  
  464. Input/Output Package          _______     ________  ________
  465.  
  466. ROM (if not at top of memory) _______     ________  ________
  467.  
  468. Flow Command Package          __ 0.5 K    _ F600 _  _ F7FF _
  469.  
  470. ROM (if not at top of memory) __ 1.0 K    _ F800 _  _ FBFF _
  471.  
  472. Environment Descriptor        _ 256 _     _ FC00 _  _ FCFF _
  473.  
  474. Shell Stack                   _ 128 _     _ FD00 _  _ FD7F _
  475.  
  476. Message Buffers               _  80 _     _ FD80 _  _ FDCF _
  477.  
  478. External FCB                  _  48 _     _ FDD0 _  _ FDFF _
  479.  
  480. Named Directory Buffer        _ 256 _     _ FE00 _  _ FEFF _
  481.  
  482. Command Line Buffer           _ 208 _     _ FF00 _  _ FFCF _
  483.  
  484. External Stack                _  48 _     _ FFD0 _  _ FFFF _
  485.  
  486. ROM (if at top of memory)     _______     ________  ________
  487.  
  488. .paè
  489.      F«á Yo⌡á no≈ havσ al∞ thσ datß requireΣ t∩ edi⌠á Z3BASE.LIB«  ì
  490. Run your favorite editor on Z3BASE.LIB:
  491.  
  492.           1«á Edi⌠á thσ commen⌠ heade≥ anΣ fil∞ iε thσ value≤ fo≥ ì
  493. you≥á systeφ a≤ presenteΣ iε thσ tablσ yo⌡ jus⌠ filleΣ iεá above«  ì
  494. Yo⌡ wil∞ finΣ thi≤ t∩ bσ ß tediou≤ proces≤ whicΦ reall∙ pay≤á ofµ ì
  495. iε thσ lonτ run.
  496.  
  497.           2«á Se⌠ al∞ oµ thσ equate≤ iε Z3BASE.LI┬ t∩ contaiε thσ ì
  498. prope≥ value≤ a≤ yo⌡ planneΣ oε thσ tablσ above«á  Follo≈ througΦ ì
  499. sectioε 3.│ oµ thσ Installatioε Manua∞ a≤ yo⌡ d∩ this.
  500.  
  501.  
  502.           -- Blank Space for Calculations and Notes --
  503.  
  504.  
  505. .paè
  506. Step 3: Modify the BIOS Cold Boot Routine
  507.  
  508.      Objective Modif∙ thσ ColΣ Boo⌠ routinσ iε you≥ BIO╙ to
  509.                initialize the buffers you selected above.
  510.  
  511.      Required_Files source to your BIOS
  512.                     your favorite editor
  513.                     an assembler that will assemble your
  514.                           BIOS and generate a HEX file
  515.  
  516.      References
  517.           Installation Manual -- Chapter 4, Section 4.1
  518.           ZCPR3: The Manual   -- Chapter 19
  519.  
  520.      Instructions
  521.      A«á Stud∙á sectioεá 4.▒á oµ Chapte≥ ┤á oµá thσá Installatioε ì
  522. Manual«  Refe≥ t∩ thσ samplσ sessioε iε sectioε 4.5«
  523.  
  524.      B«á Writσ codσ int∩ thσ ColΣ Boo⌠ routinσ t∩ initializσá thσ ì
  525. buffer≤á yo⌡ includeΣ iε you≥ ZCPR│ System«á  Yo⌡ ma∙ wan⌠ t∩ usσ ì
  526. thσá codσ iε sectioε 4.▒ afte≥ thσ labe∞ CBOOT║á a≤ ßá mode∞á fo≥ ì
  527. you≥ code.
  528.  
  529.      Thσ followinτ buffer≤ mus⌠ bσ initializeΣ t∩ zero:
  530.  
  531.           1. Resident Command Package
  532.           2. Flow Command Package
  533.           3. Environment Descriptor
  534.           4. Shell Stack
  535.           5. Message Buffers
  536.           6. Named Directory Buffer
  537.  
  538.      The following buffers must be initialized with data:
  539.  
  540.           1. External Path
  541.                Initialize the path
  542.           2. Wheel Byte
  543.                Clear it or set it
  544.           3. Input/Output Package
  545.                Place initial set of drivers
  546.           4« CommanΣ Linσ Buffer
  547.                Initializσ sizσ anΣ startu≡ command
  548.  
  549.      The following buffers do not need to be initialized:
  550.  
  551.           1. External Stack
  552.           2. External File Control Block
  553.  
  554.      C«á Assemblσá you≥ BIO╙ anΣ makσ surσ i⌠á assemble≤á withou⌠ ì
  555. error«á  Als∩á makσá surσ tha⌠ i⌠ i≤ smal∞ enougΦ t∩ fi⌠á oεá thσ ì
  556. Systeφ Track≤ fo≥ you≥ microcomputer«  Yo⌡ no≈ havσ ß HE╪ filσ oµ ì
  557. you≥ ne≈ BIOS.
  558.  
  559. .paè
  560. Step 4: Editing Z3HDR.LIB
  561.  
  562.      Objective To select the features of the ZCPR3
  563.                Command Processor
  564.  
  565.      Required_Files Z3HDR.LIB (ZCPR3 File)
  566.                     Z3BASE.LIB (ZCPR3 File)
  567.                     ZCPR3.ASM (ZCPR3 File)
  568.                     your favorite editor
  569.                     Digital Research MAC, Echelon ZAS,
  570.                           or equivalent assembler
  571.  
  572.      References
  573.           Installation Manual -- Chapter 4, Section 4.2
  574.           ZCPR3: The Manual   -- Chapters 2, 9, and 19
  575.  
  576.      Instructions
  577.      A«á ReaΣá sectioε 4.▓ oµ thσ Installatioε Manual«á  Refe≥ t∩ ì
  578. thσ samplσ sessioε iε sectioε 4.5.
  579.  
  580.      B« Edi⌠ Z3HDR.LI┬ anΣ se⌠ thσ equate≤ a≤ yo⌡ desire«  Follo≈ ì
  581. alonτ iε sectioε 4.▓ oµ thσ Installatioε Manua∞ sincσ i⌠ provide≤ ì
  582. ß runninτ dialoτ oµ you≥ basiπ tradeoffs.
  583.  
  584.      C«á Assemblσ ZCPR│ anΣ makσ surσ i⌠ assemble≤ withou⌠ error«  ì
  585. Thi≤á automaticall∙á check≤á t∩á ensurσ tha⌠á thσá ZCPR│á CommanΣ ì
  586. Processo≥ i≤ 2╦ o≥ les≤ iε sizσ (aε erro≥ i≤ raiseΣ iµ i⌠ i≤ ove≥ ì
  587. 2╦á iε size)«á  Yo⌡ havσ t∩ usσ aε assemble≥ likσá Echelon'≤á ZA╙ ì
  588. becausσá oµ thσ usσ oµ macros«á  Yo⌡ no≈ havσ ß HE╪ filσ oµá you≥ ì
  589. ZCPR3 Command Processor.
  590.  
  591. .paè
  592. Step 5: Overlaying the old BIOS and the CCP
  593.  
  594.      Objective Replace the CP/M CCP with ZCPR3 and your old
  595.                BIOS with the modified BIOS created above.
  596.  
  597.      Required_Files MOVCPM.COM
  598.                     SYSGEN.COM
  599.                     DDT.COM, SID.COM, or equivalent
  600.                     ZCPR3.HEX (from previous assembly)
  601.                     BIOS.HEX (from previous assembly)
  602.  
  603.      References
  604.           Installation Manual -- Chapter 4, Section 4.3
  605.           ZCPR3: The Manual   -- Chapter 19
  606.  
  607.      Instructions
  608.      A«á ReaΣá sectioε 4.│ oµ thσ Installatioε Manual«á  Refe≥ t∩ ì
  609. the sample session in section 4.5.
  610.  
  611.      B«á Yo⌡á ma∙ wan⌠ t∩ builΣ ß conventiona∞ CP/═ systeφá whicΦ ì
  612. contain≤ you≥ ne≈ BIO╙ anΣ run≤ a⌠ thσ addres≤ oµ you≥ ne≈á ZCPR│ ì
  613. system«á  Thi≤ i≤ aε additiona∞ ste≡ whicΦ i≤ no⌠ detaileΣ iε thσ ì
  614. Installatioεá Manua∞ a⌠ thi≤ point¼á anΣ i⌠ ma∙ savσ yo⌡ ß lo⌠ oµ ì
  615. frustratioε later«á  Amonτ othe≥ things¼ i⌠ assure≤ yo⌡ tha⌠ you≥ ì
  616. BIO╙ i≤ correc⌠ anΣ tha⌠ you≥ BOO╘ i≤ als∩ workinτ properly«á  T∩ ì
  617. d∩ this:
  618.  
  619.           1. Ruε MOVCP═ witΦ thσ prope≥ value
  620.           2« SAV┼ thσ memor∙ imagσ t∩ ß disδ filσ (CPM.BIN)
  621.           3. Run DDT on CPM.BIN to load it
  622.           4« LoaΣ thσ BIO╙ (sectioε 4.5.1▒ show≤ thσ procedure)
  623.           5. Correct the BOOT if necessary
  624.           6. Exit DDT and SAVE the result to disk
  625.           7. Run SYSGEN on the new image, place it on the
  626.                system tracks, and make sure it boots and runs
  627.                correctly
  628.  
  629.      Iµ yo⌡ d∩ thi≤ par⌠ oµ Ste≡ 5¼á yo⌡ no≈ havσ ß workinτá CP/═ ì
  630. systeφá whicΦá run≤á wherσá you≥ ZCPR│ wil∞á run¼á anΣá yo⌡á havσ ì
  631. confirmeΣ tha⌠ you≥ BIO╙ i≤ OK«á  Yo⌡ arσ als∩ iε ß gooΣ placσ t∩ ì
  632. follo≈ thσ Installatioε Manua∞ a⌠ ste≡ 4.5.10.
  633.  
  634.      C«á Iµá yo⌡ diΣ no⌠ d∩ ┬ above¼á ruε MOVCP═ oε you≥á curren⌠ ì
  635. CP/═ Systeφ t∩ locatσ thσ BDO╙ a⌠ thσ prope≥ location«á  Savσ thσ ì
  636. resultan⌠á systeφá imagσ oε disδ a≤ ß filσ viß thσ SAV┼á command«  ì
  637. Iµ yo⌡ diΣ ┬ above¼ thσ imagσ generateΣ i≤ read∙ fo≥ you.
  638.  
  639.      D«á Usσá DD╘á t∩ reaΣ iε thσ systeφ imagσ saveΣ iε ┬á o≥á C«  ì
  640. Examinσá thσ areß occupieΣ b∙ thσ CC╨ anΣ BDO╙ t∩ makσ surσá the∙ ì
  641. arσ wherσ the∙ shoulΣ be.
  642.  
  643. .paè
  644.      E« Stil∞ iε DDT║ Zer∩ ou⌠ thσ areß occupieΣ b∙ thσ CCP«  Usσ ì
  645. thσ ╔ anΣ ╥ command≤ t∩ reaΣ iε thσ HE╪ filσ oµ thσ ZCPR│ CommanΣ ì
  646. Processor«á  Follo≈á alonτ iε sectioε 4.5.1▒ oµ thσá Installatioε ì
  647. Manual if you need to.
  648.  
  649.      F«á  Stil∞ iε DDT║á Zer∩ ou⌠ thσ areß occupieΣ b∙ thσá BIOS«  ì
  650. Usσá thσá ╔ anΣ ╥ command≤ t∩ reaΣ iε thσ HE╪ filσ oµá thσá BIOS«  ì
  651. Follo≈á alonτ iε sectioε 4.5.1▒ oµ thσ Installatioε Manua∞ iµ yo⌡ ì
  652. need to.
  653.  
  654.      G«á  Exi⌠á DD╘á anΣ savσ thi≤ ne≈ systeφ imagσ oε disδ a≤á ß ì
  655. file«  ╔ wil∞ refe≥ t∩ thi≤ filσ a≤ ZCPR3.BIN.
  656.  
  657.  
  658.                -- Blank Space for Calculations --
  659.  
  660.  
  661. .paè
  662. Step 6: Implanting the Operating System Image
  663.  
  664.      Objective Place the image created above on the
  665.                operating system tracks of a scratch disk.
  666.  
  667.      Required_Files DDT.COM
  668.                     SYSGEN.COM
  669.                     ZCPR3.BIN
  670.  
  671.      References
  672.           Installation Manual -- Chapter 4, Section 4.4
  673.           ZCPR3: The Manual   -- Chapter 19
  674.  
  675.      Instructions
  676.      A«á ReaΣ sectioε 4.┤ oµ thσ Installatioε Manual«á  Refe≥á t∩ ì
  677. the sample session in section 4.5.
  678.  
  679.      B«á Usσ DD╘ (╔ anΣ ╥ commands⌐ t∩ loaΣ thσ systeφ imagσ filσ ì
  680. (ZCPR3.BIN⌐ int∩ memory«  Checδ i⌠ t∩ makσ surσ tha⌠ al∞ i≤ well«  ì
  681. A≤ ß minimum¼ makσ surσ thσ followinτ i≤ true:
  682.  
  683.           1« Thσ ZCPR│ CommanΣ Processo≥ i≤ iε placσ anΣ thσ 
  684.              addresse≤ withiε i⌠ arσ correct.
  685.  
  686.           2« Thσ BIO╙ i≤ iε placσ anΣ thσ addresse≤ withiε i⌠ 
  687.              arσ correct.
  688.  
  689.           3« Thσ BOO╘ i≤ correc⌠ fo≥ loadinτ thσ operatinτ 
  690.              systeφ a⌠ thσ correc⌠ memor∙ location.
  691.  
  692.      C«á Usσ SYSGE╬ t∩ placσ thi≤ memor∙ imagσ ont∩ thσ operatinτ ì
  693. systeφá track≤á oµá ßá scratcΦá disk«áá  Sectioεá 4.5.1▓á iεá thσ ì
  694. Installatioε Manua∞ give≤ yo⌡ aε examplσ oµ thi≤ step.
  695.  
  696.      D«á  Removσá al∞ disk≤ froφ you≥ system«á  Placσ thσ scratcΦ ì
  697. disδ iε you≥ ┴ drivσ anΣ tr∙ t∩ boo⌠ it.
  698.  
  699.      Iµá al∞ wen⌠ well¼á ZCPR│ shoulΣ havσ comσ u≡ anΣá presenteΣ ì
  700. yo⌡á witΦ ß prompt«á  Sincσ you≥ scratcΦ disδ i≤á blank¼á iµá yo⌡ ì
  701. loadeΣá thσá CommanΣ Linσ Buffe≥ witΦ ßá STARTU╨á command¼á ZCPR│ ì
  702. shoulΣá havσá echoeΣ thi≤ commanΣ followeΣ b∙ ß questioε marδá t∩ ì
  703. indicatσ tha⌠ i⌠ wa≤ no⌠ found.
  704.  
  705. .paè
  706. Step 7: System Segment Installation
  707.  
  708.      Objective Install the System Segments your selected.
  709.  
  710.      RequireΣ_Filesô LI┬ anΣ AS═ file≤ fo≥ thσ Systeφ Segments:
  711.                          SYSRCP.LIB and SYSRCP.ASM
  712.                          SYSFCP.LIB and SYSFCP.ASM
  713.                          SYSIOP.LIB and SYSIOP.ASM
  714.                          SYSNDR.LIB and SYSNDR.ASM
  715.                          SYSENV.LIB and SYSENV.ASM
  716.                     your favorite editor
  717.                     MAC.COM or equivalent
  718.                     MLOAD.COM or equivalent
  719.  
  720.      References
  721.           Installation Manual -- Chapter 5
  722.           ZCPR3: The Manual   -- Chapter 20
  723.  
  724.      Instructions
  725.      A. Read Chapter 5 of the Installation Manual.
  726.  
  727.      B« Edi⌠ thσ LI┬ file≤ t∩ selec⌠ thσ feature≤ fo≥ you≥ Systeφ ì
  728. Segments«á  Chapte≥á ╡á provide≤á ß runninτá commentar∙á oµá you≥ ì
  729. options¼á anΣá yo⌡á ma∙á finΣ i⌠ usefu∞ t∩ follo≈á alonτá iεá thσ ì
  730. appropriatσá sectioεá oµá Chapte≥ ╡ a≤ yo⌡ edi⌠á eacΦá LI┬á file«  ì
  731. The following sections of Chapter 5 cover the indicated segments:
  732.  
  733.           5.1 - Resident Command Packages
  734.           5.2 - Flow Command Packages
  735.           5.3 - Input/Output Packages
  736.           5.4 - Named Directory Files
  737.           5.5 - TCAP Files
  738.           5.6 - the Environment Descriptor
  739.  
  740.      C«á Assemblσ you≥ Systeφ Segments«á  Makσ surσ the∙ assemblσ ì
  741. withou⌠á error«á  Givσ thσ assembleΣ objec⌠ file≤ thσ prope≥ filσ ì
  742. types«  Section≤ 4.5.▒ t∩ 4.5.╖ providσ overview≤ oµ thi≤ proces≤ ì
  743. and may prove useful.
  744.  
  745.      Chapte≥á ╖ oµ thσ Installatioε Manua∞ goe≤ int∩ somσá detai∞ ì
  746. oεá thσá TCA╨á anΣ ho≈ t∩ creatσ you≥ owε iµ onσ i≤á no⌠á alread∙ ì
  747. available via the TCSELECT program.
  748.  
  749.      Als∩á notσ tha⌠ yo⌡ ma∙ late≥ wan⌠ t∩ ruε somσ oµ thσá ZCPR│ ì
  750. utilitie≤ t∩ edi⌠ anΣ creatσ ne≈ nameΣ director∙ files.
  751.  
  752. .paè
  753. Step 8: Utility Installation
  754.  
  755.      Objective Install the ZCPR3 Utilities for your system
  756.  
  757.      Required_Files Z3INS.COM
  758.                     an INS file naming the utilities
  759.                     your favorite editor
  760.                     the utilities (COM files) you want to install
  761.  
  762.      References
  763.           Installation Manual -- Chapter 6
  764.           ZCPR3: The Manual   -- Chapter 21
  765.  
  766.      Instructions
  767.      A«  ReaΣ Chapte≥ ╢ oµ thσ Installatioε Manual.
  768.  
  769.      B«  Usσ you≥ favoritσ edito≥ t∩ creatσ aε IN╙ filσ iµ yo⌡ d∩ ì
  770. no⌠á alread∙á havσá one«á  Placσ thσ name≤ oµá thσá file≤á t∩á bσ ì
  771. installed in this file, one file per line.
  772.  
  773.      C«á  Placσá al∞á file≤á t∩á bσá installed¼á Z3INS.COM¼á you≥ ì
  774. Environmen⌠á Descripto≥á file¼á anΣá you≥ IN╙ filσá iεá thσá samσ ì
  775. director∙á oεá disk«á  Ruεá Z3IN╙á oεá you≥á IN╙á filσá anΣá you≥ ì
  776. Environmen⌠ Descripto≥ file.
  777.  
  778.      D«á  Optionall∙á creatσ ß TCA╨ filσ iµ yo⌡ havσ no⌠á alread∙ ì
  779. donσ s∩ (seσ Chapte≥ ╖ oµ thσ Installatioε Manual).
  780.  
  781.      E«á  Placσá al∞ oµ you≥ systeφ file≤ iε thσ roo⌠á directory¼ ì
  782. creatσ thσ STARTU╨ alia≤ iµ yo⌡ neeΣ one¼ anΣ boo⌠ you≥ ne≈ ZCPR│ ì
  783. System.
  784.  
  785.  
  786.                         CONGRATULATIONS!
  787.  
  788.  
  789.  
  790.