Oakland CPM Archive/oakcpm.iso/cpm/zcpr2/z2con.wqh/Z2CON.WSH

Text File | 1985-02-09 | 8KB | 189 lines

   ***********************************************************
   *                                                         *
   *                     CONCEPTS MANUAL                     *
   *                                                         *
   *                           for                           *
   *                                                         *
   *  ZCPR2 -- Z80 Command Processor Replacement, Version 2  *
   *                                                         *
   ***********************************************************


                               by

                          Richard Conn


                        Manual Revision 0
                         3 February 1983






                          ZCPR2 Version
                               2.0

            Copyright (c) 1982, 1983 by Richard Conn
                       All Rights Reserved


     ZCPR2¼á it≤ utilitie≤ a≤ distributed¼á anΣ it≤ documentatioε ì
file≤á a≤ distributeΣ arσ copyrighted¼á 1982¼á b∙á RicharΣá Conn«  ì





     CP/═ i≤ ß registereΣ trademarδ oµ Digita∞ Research.



                    Concepts Manual for ZCPR2

                        Table of Contents


          Section                                      Page

               Foreword                                F-1

          1.0  Introduction                              1
               1.1  Another Look at CP/M 2.2             2
               1.2  Where ZCPR2 Fits In                  5

          2.0  ZCPR2 Overview                            6
               2.1  Directories under ZCPR2              6
               2.2  ZCPR2 Resident Commands              8
               2.3  ZCPR2 Standard Transient Commands   10
               2.4  Multiple Command Lines              11
               2.5  Paths                               11
               2.6  Overview and Putting the Basic
                         Concepts Together              12

          3.0  ZCPR2 Directories and Files              17

          4.0  ZCPR2 Commands                           33
               4.1  ZCPR2 Resident Commands             33
                    4.1.1 The DIR Command               33
                    4.1.2 The ERA Command               33
                    4.1.3 The REN Command               33
                    4.1.4 The TYPE and LIST Commands    34
                    4.1.5 The SAVE Command              34
                    4.1.6 The GET Command               34
                    4.1.7 The GO Command                34
                    4.1.8 The JUMP Command              35
                    4.1.9 The DU Form for Changing
                              Disk and User             35
               4.2  ZCPR2 Standard Transient Commands   35

          5.0  Multiple Command Lines                   42

          6.0  Paths, Command Processing, and Extended
                    Command Processors                  47
               6.1  Paths                               47
               6.2  Command Processing                  51
               6.3  Extended Command Processors         51

          7.0  Redirectable I/O                         55
               7.1  The Concept                         55
               7.2  A More Flexible Redirectable I/O
                         System                         56
               7.3  What the Redirectable I/O System
                         Buys You                       57
               7.4  Loading Redirectable I/O Drivers    64
è.he                 ZCPR2 Concepts Manual -- Foreword
.fo                                                    Page F-#
.pn 1



                            Foreword

     Welcomσá t∩ thσ worlΣ oµ ZCPR2«á  Thi≤ i≤ onσ oµ fou≥á ZCPR▓ ì
manuals¼ namel∙ thσ Concept≤ Manual«  It≤ purposσ i≤ t∩ introducσ ì
yo⌡ t∩ thσ basic¼á underlyinτ principle≤ behinΣ ZCPR▓ anΣ t∩ givσ ì
yo⌡ ß workinτ knowledgσ oµ thσ followinτ things:

          o What ZCPR2 Is
          o What ZCPR2 is Capable of Doing
          o How to Use ZCPR2
          o How to Adapt ZCPR2 to Your Particular Desires

     Thσá manua∞á i≤á writteε fo≥ everyone¼á anΣ writinτá sucΦá ß ì
manua∞ i≤ quitσ ß task«  B∙ addressinτ everyone¼ thσ scopσ oµ thσ ì
audiencσá range≤á froφ thσ basiπ CP/═ use≥ (╔á assumσá ßá workinτ ì
knowledgσá oµá CP/M⌐ wh∩ neve≥ hearΣ oµ ZCPR▓ beforσ t∩ thσá comì
pute≥á professiona∞ witΦ seveε year≤ oµ CP/═á programminτá experì
iencσá anΣ somσ knowledgσ oµ ZCPR▓ unde≥ hi≤ belt«á  WitΦ sucΦ aε ì
audience¼ i⌠ wil∞ bσ impossiblσ t∩ pleasσ everyone.

     Hence¼á wha⌠ ╔ havσ trieΣ t∩ d∩ i≤ t∩ writσ thi≤ manua∞ iε ß ì
redundan⌠ anΣ persona∞ style«  Iε redundancy¼ thσ basiπ CP/═ use≥ ì
wil∞ seσ thσ samσ point≤ covereΣ morσ thaε oncσ anΣ morσ informaì
tioε wil∞ hopefull∙ sinδ in«á  Iε thσ persona∞ style¼á I'vσ trieΣ ì
t∩ no⌠ makσ thσ manua∞ dr∙ anΣ totall∙ technical«  Therσ arσ lot≤ ì
oµá examples¼á usuall∙ afte≥ ß particula≥ poin⌠ i≤á covered¼á anΣ ì
actua∞ ZCPR▓ termina∞ session≤ (a≤ yo⌡ woulΣ seσ theφ iµ yo⌡á sa⌠ ì
dowε a⌠ thσ termina∞ anΣ raε thσ program≤ unde≥ ZCPR▓ itself⌐ arσ ì
included.

     Iµá yo⌡á arσ ß basiπ CP/═ user¼á d∩ no⌠ expec⌠ t∩ comσá awa∙ ì
knowinτ al∞ therσ i≤ t∩ kno≈ abou⌠ ZCPR2«á  ╔ caε ge⌠ quitσ techì
nica∞á a⌠ times¼á anΣ somσ example≤ resor⌠ t∩á assembl∙á languagσ ì
program≤á anΣ heav∙ usσ oµ ZCPR▓ utilit∙ program≤ yo⌡ ma∙ no⌠ ye⌠ ì
bσ familia≥ with«á  Iµ yo⌡ comσ t∩ ß sectioε likσ this¼á reaΣ on¼ ì
tr∙ t∩ ge⌠ wha⌠ yo⌡ caε ou⌠ oµ it¼ anΣ takσ heart¼ becausσ ╔ wil∞ ì
probabl∙ fal∞ bacδ t∩ les≤ oµ ß technica∞ leve∞ later«á  Thσ samσ ì
more-or-les≤ applie≤ t∩ thσ intermediatσ CP/═ user¼á dependinτ oε ì
you≥ background«  T∩ thσ advanceΣ CP/═ user¼ wh∩ ha≤ knowledgσ oµ ì
thσá system≤ programminτ leve∞ oµ CP/M¼á yo⌡ wil∞á probabl∙á finΣ ì
mos⌠á oµá thσ manua∞ boring«á  ╔ d∩ delvσ int∩ ßá ver∙á technica∞ ì
leve∞ froφ timσ t∩ time¼á however¼á anΣ yo⌡ ma∙ enjo∙ this«á  Fo≥ ì
thσá advanceΣ CP/═ user¼á yo⌡ shoulΣ expec⌠ t∩ obtaiε ßá thorougΦ ì
workinτ knowledgσ oµ thσ systeφ anΣ somσ oµ it≤ utilities.


     Thi≤á Concept≤ Manua∞ i≤ ß gooΣ manua∞ t∩ reaΣ first«á  Oncσ ì
completed¼á thσ intermediatσ o≥ advanceΣ use≥ shoulΣ bσ read∙á t∩ ì
instal∞ ZCPR▓ oε hi≤ microcomputer«á  T∩ d∩ this¼ aε Installatioε ì
Manua∞ i≤ provided«á  Thi≤ i≤ ver∙ technica∞ anΣ assume≤ intimatσ ì
knowledgσá oµá 808░ anΣ Z8░ assembl∙ languagσá programming«á  Fo≥ ì
reader≤á withou⌠ sucΦ knowledge¼á ╔ recommenΣ tha⌠ yo⌡ finΣá you≥ ì
neares⌠ compute≥ cluΓ (anΣ therσ arσ TON╙ oµ them⌐ anΣ seeδ help«  ì
Compute≥ Club≤ arσ ver∙ nicσ fo≥ tha⌠ sor⌠ oµ thing«  ╔ myselµ aφ ì
ßá membe≥ oµ thσ Amateu≥ Compute≥ Grou≡ oµ Ne≈á Jerse∙á (ACG-NJ)¼ ì
whicΦá i≤ ove≥ 110░ member≤ strong«á  Gettinτ involveΣ iε ßá comì
pute≥ cluΓ caε reall∙ bσ lot≤ oµ fuε anΣ educational¼á anΣ inforì
matioε anΣ programs¼ likσ ZCPR2¼ caε bσ shared.

     Thσá thirΣá ZCPR▓ manua∞ i≤ thσ User'≤ Guide«á  Al∞á oµá thσ ì
ZCPR▓á utilitie≤á (referenceΣá b∙ namσ anΣá versioεá number⌐á arσ ì
describeΣ iε thσ User'≤ Guide¼á anΣ man∙ samplσ termina∞ session≤ ì
whicΦ illustratσ thei≥ usσ arσ included.

     Finally¼á thσá fourtΦ ZCPR▓ manua∞ i≤ thσá Rationale«á  Thi≤ ì
manua∞á i≤ aε exposeº oµ wh∙ ╔ diΣ thing≤ likσ ╔ diΣ witΦá ZCPR2¼ ì
wha⌠á thσá tradσá off≤ were¼á wha⌠ direction≤ werσ takeεá iεá thσ ì
desigε anΣ why¼ anΣ othe≥ sucΦ technica∞ ditties«  Thi≤ manua∞ i≤ ì
quitσá technica∞á anΣ i≤ provideΣ t∩ givσá thσá intermediatσá anΣ ì
advanceΣá CP/═á use≥ ß bette≥ feelinτ anΣ understandinτ oµá ZCPR▓ ì
internal≤ anΣ concepts.

     ╔á sincerel∙á hopσ yo⌡ enjo∙ usinτ ZCPR2«á  I⌠á ha≤á beeεá ß ì
pleasurσ creatinτ it¼á anΣ i⌠ i≤ als∩ ß lo⌠ oµ fuε t∩ usσ it«  M∙ ì
opinion¼ oµ course«  Takσ care¼ anΣ gooΣ luck.

                                        Richard Conn