PACKAGE IV:  INSTALLATION

        17. THE ZCPR3 INSTALLATION GUIDE.............................361

        18. OVERVIEW of ZCPR3 INSTALLATION...........................362
            18.1. Introduction.......................................362
                  18.1.1. Operating System Memory Images.............362
                  18.1.2. System Segments............................363
                          18.1.2.1. Flow Command Packages............363
                          18.1.2.2. Input/Output Packages............364
                          18.1.2.3. Resident Command Packages........364
                          18.1.2.4. Environment Descriptor...........364
                          18.1.2.5. ZCPR3 Named Directories..........364
                  18.1.3. Utilities..................................365
                  18.1.4. Other Basic Concepts.......................365
                          18.1.4.1. Command Search Hierarchy.........365
                          18.1.4.2. Command Search Path..............366
            18.2. SYSGEN Memory Images...............................367
            18.3. System Segments....................................368
            18.4. Utilities..........................................368
            18.5. Installation Steps.................................370
            18.6. Operational ZCPR3 System...........................371
                  18.6.1. Memory Image...............................371
                  18.6.2. System Segments............................372
                  18.6.3. Utilities..................................373
            18.7. Software Required for Installation.................373
                  18.7.1. Commercial Software........................373
                  18.7.2. System Segment Software....................374
                  18.7.3. Other Useful Files.........................374
                  18.7.4. Files Required for Installing ZEX..........375
                  18.7.5. Required Distribution Files................375
                  18.7.6. Useful Distribution Files..................375
            18.8. Required Hardware..................................376
                  18.8.1. Hardware Required for Installation.........376
                  18.8.2. Hardware Required for Running ZCPR3........376

        19. STEP 1: SELECTING the FEATURES...........................377
            19.1. Features of ZCPR3..................................377
            19.2. Standard Overhead..................................377
                  19.2.1. External Stack.............................378
                  19.2.2. Command Line Buffer........................378
                  19.2.3. Memory-Based Named Directory...............379
                  19.2.4. External File Control Block................379
                  19.2.5. Message Buffers............................379
                  19.2.6. Shell Stack................................380
                  19.2.7. Environment Descriptor.....................380
            19.3. Flow Command Packages..............................380
            19.4. Input/Output Packages..............................381
            19.5. Resident Command Packages..........................381
            19.6. Other Buffers......................................381
                  19.6.1. External Path..............................381
                  19.6.2. Wheel Byte.................................382




                                                          CONTENTS








        20. STEP 2: ZCPR3 MEMORY STRUCTURE...........................383
            20.1. Z3BASE.LIB.........................................383
            20.2. Z3BASE Header......................................383
            20.3. Z3BASE Body........................................385
                  20.3.1. Version Numbers, Memory Size, and Base.....385
                  20.3.2. Processor Selection........................385
                  20.3.3. External Path..............................386
                  20.3.4. Wheel Byte.................................386
                  20.3.5. CCP Location...............................386
                  20.3.6. RCP Location...............................387
                  20.3.7. IOP Location...............................387
                  20.3.8. FCP Location...............................387
                  20.3.9. ENV Location...............................387
                  20.3.10. Shell Stack...............................388
                  20.3.11. ZCPR3 Messages............................388
                  20.3.12. External FCB..............................388
                  20.3.13. Named Directory Buffer....................388
                  20.3.14. Command Line Buffer.......................389
                  20.3.15. External Stack............................389
                  20.3.16. User Equates..............................389

        21. STEPS 3-6: INSTALLATION..................................390
            21.1. Step 3: Modifying the BIOS Cold Boot Routine.......390
                  21.1.1. CBIOSHDR.LIB -- BIOS Configuration File....390
                  21.1.2. CBIOSZ -- Selections from a ZCPR3 BIOS.....393
            21.2. Step 4: Editing Z3HDR.LIB..........................405
                  21.2.1. Basic System Definitions...................405
                  21.2.2. Default File Types.........................406
                  21.2.3. SUBMIT File Processing.....................406
                  21.2.4. Command Prefix.............................406
                  21.2.5. Command Attributes.........................406
                  21.2.6. ZCPR3 Resident Command Activation..........407
                  21.2.7. ZCPR3 Resident Command Table...............408
                  21.2.8. Controls on ZCPR3 Resident Commands........410
                  21.2.9. Path Definition............................412
                  21.2.10. DU and DIR Controls.......................414
                  21.2.11. Command Line Buffer Control...............416
                  21.2.12. CMDRUN -- Extended Command Processing.....417
                  21.2.13. Flow Command Facility.....................417
                  21.2.14. Miscellaneous Equates.....................418
            21.3. Step 5: Overlaying the old BIOS and the CCP........419
            21.4. Step 6: Implanting the Operating System Image......419
            21.5. Sample Session.....................................419
                  21.5.1. Assembling SYSENV..........................420
                  21.5.2. Assembling SYSNDR..........................421
                  21.5.3. Assembling SYSIOP..........................422
                  21.5.4. Assembling SYSRCP..........................423
                  21.5.5. Assembling SYSFCP..........................424
                  21.5.6. Creating MYTERM.Z3T via TCSELECT...........425
                  21.5.7. Recap......................................426
                  21.5.8. Assembling the CBIOS.......................426
                  21.5.9. Assembling the ZCPR3 CPR...................426
                  21.5.10. Obtaining the Operating System Image......427
                  21.5.11. Patching the CP/M System Image............428
                  21.5.12. Placing the Operating System Image........429


                                                          CONTENTS









        22. STEP 7: SYSTEM SEGMENTS..................................430
            22.1. Resident Command Packages..........................430
                  22.1.1. CP Command.................................431
                  22.1.2. DIR Command................................431
                  22.1.3. ERA Command................................432
                  22.1.4. LIST and TYPE Commands.....................433
                  22.1.5. PEEK and POKE Commands.....................434
                  22.1.6. PROT Command...............................435
                  22.1.7. REN Command................................435
                  22.1.8. REG Command................................436
                  22.1.9. WHL Command................................436
                  22.1.10. NOTE Command..............................438
                  22.1.11. ECHO Command..............................438
            22.2. Flow Command Packages..............................439
                  22.2.1. IF Negation................................439
                  22.2.2. IF:  T (True) or F (False).................440
                  22.2.3. IF:  EM (Empty)............................440
                  22.2.4. IF:  ER (Error)............................440
                  22.2.5. IF:  EX (Exist)............................441
                  22.2.6. IF:  IN (Input)............................441
                  22.2.7. IF:  NU (Null).............................441
                  22.2.8. IF:  n (Register Value)....................442
                  22.2.9. IF:  WH (Wheel)............................442
                  22.2.10. IF:  TC (TCAP)............................442
                  22.2.11. IF:  fcb1=fcb2............................443
                  22.2.12. COMIF - Run IF.COM........................443
                  22.2.13. NOISE - Have FCP Print IF Status..........443
            22.3. Input/Output Packages..............................444
            22.4. Named Directory Files..............................444
            22.5. TCAP Files.........................................446
            22.6. Environment Descriptor.............................446

        23. STEP 8: UTILITY INSTALLATION.............................451
            23.1. The Z3INS Utility..................................451
            23.2. Sample Session.....................................452
            23.3. Assembling Distribution Files......................453




















                                                          CONTENTS








        24. The Z3TCAP FACILITY......................................454
            24.1. ZCPR3 Terminal Capabilities (TCAP).................454
            24.2. Internal Structure of a Z3T File...................455
                  24.2.1. Terminal Name..............................456
                  24.2.2. Arrow Keys.................................456
                  24.2.3. Function Delays............................457
                  24.2.4. Clear Screen Sequence......................457
                  24.2.5. Cursor Motion (GOTOXY) Sequence............458
                  24.2.6. Clear to End of Line.......................461
                  24.2.7. Begin and End Highlighting.................461
                  24.2.8. Terminal Init and Deinit...................462
            24.3. Terminal Control Sequences 1 (General).............462
            24.4. Terminal Control Sequences 2 (Cursor Motion).......463
            24.5. Overview of VLIB...................................465
            24.6. Standard ZCPR3 TCAP File...........................465
            24.7. TCAP Check Program.................................465
            24.8. TCAP Entry Definition Program......................466
            24.9. TCAP Entry Selection Program.......................470