ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/CPM/ZCPR2/Z2UG.WQH/Z2UG.WSH

Text File | 2000-06-30 | 16KB | 372 lines

   ***********************************************************
   *                                                         *
   *                      USER'S GUIDE                       *
   *                                                         *
   *                           for                           *
   *                                                         *
   *  ZCPR2 -- Z80 Command Processor Replacement, Version 2  *
   *                                                         *
   ***********************************************************


                               by

                          Richard Conn



                        Manual Revision 0
                         4 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¼á 198▓ anΣ 1983¼á b∙ RicharΣ ì
Conn«á  Refe≥á t∩ Appendi° ┴ fo≥ ß completσ listinτ oµ thσá ZCPR▓ ì
distributioε files.



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





                     User's Guide for ZCPR2

                        Table of Contents


          Section                                      Page

          Index to ZCPR2 Utility Programs and Resident
               Commands                                Index-1

          Foreword                                     Foreword-1

          0.0  Introduction                               1
               0.1  Overview of the ZCPR2 Help Files      2
               0.2  A Note on File References             3
               0.3  Line Editing and Output Control       3

          1.0  Input/Output                               5
               1.1  Redirectable I/O Under ZCPR2          5
               1.2  Loading Redirectable I/O Drivers      6
               1.3  Displaying and Selecting Redirectable
                         I/O Drivers                      6
               1.4  Controlling the Disk Output Facility  9
               1.5  Redirectable I/O and the ZCPR2 Sys   11
               1.6  On the Programming of Terminals      11

          2.0  Directory Utility                         12
               2.1  Overview of XDIR3                    12
               2.2  Basic Use of XDIR3 Under ZCPR2       13
               2.3  XDIR3 Output Control Options         15
               2.4  XDIR3 File Selection Options         16
               2.5  XDIR3 File Name Buffer Facility      18
               2.6  Use of XDIR3 on Secure Systems       20
               2.7  Installation of XDIR3                21

          3.0  Disk Utility                              24
               3.1  Invoking DU2 and DU2 Installation    24
               3.2  DU2 Command Summary                  25
               3.3  Commands for Logging and Viewing
                         Disk Parameters                 26
               3.4  Commands for Positioning and Reading 29
               3.5  Commands for Searching for Data      32
               3.6  Commands for Saving and Restoring    33
               3.7  Commands for Viewing Data            36
               3.8  Commands for Altering Data           37
               3.9  Commands for Manipulating Macros
                         and the @ Command               40
               3.10 Miscellanea                          43
               3.11 Examples                             44
               3.12 Interpretation of Directory Data
                         Presented by DU2                46
           (Table of Contents Continued on Next Page)è
                     User's Guide for ZCPR2

                        Table of Contents


          Section                                      Page

          4.0  Library Utilities                         47
               4.1  Author Credits and Introduction      47
               4.2  Why Use Libraries?                   48
               4.3  Why Not Use Libraries?               48
               4.4  How to Use the Library Utility LU    49
               4.5  Summary of Operators                 50
               4.6  LU Command Line Forms                53
               4.7  CAUTIONS                             54
               4.8  LRUNZ Command                        55
               4.9  LDIRZ Command                        57
               4.10 LRUNZ as an Extended Command
                         Processor Under ZCPR2           57

          5.0  Menu                                      59
               5.1  Overview of MENU                     59
               5.2  Summary of MENU Commands             63
               5.3  Programming MENU.CPR Files           64
               5.4  MENU.CPR Commands                    67
               5.5  MENU Programming Command Summary     69
               5.6  MENU's Relationship to the ZCPR2 Sys 70
               5.7  MENU Error Messages                  71
               5.8  MCHECK -- MENU.CPR Syntax Checker    71

          6.0  File Compare Utilities                    74
               6.1  File Comparision Utilities Under
                         ZCPR2                           74
               6.2  CRC Check Utility Under ZCPR2        74
               6.3  Examples                             75

          7.0  File Copy Utility                         78
               7.1  MCOPY Overview                       78
               7.2  MCOPY Command Line Options           79
               7.3  MCOPY Interactive Mode               80
               7.4  Sample MCOPY Sessions                81

          8.0  Command Files                             84
               8.1  Command File Processing              84
               8.2  Disk-Based Command Files -- SUB2     85
               8.3  SUB2 Error Messages                  86
               8.4  SUB2 Command Summary                 87
               8.5  Memory-Based Command Files -- ZEX    87
               8.6  ZEX Control Commands                 88
               8.7  Restrictions on Command Files        93
               8.8  SUB2 and ZEX as ECPs Under ZCPR2     94

           (Table of Contents Continued on Next Page)

                     User's Guide for ZCPR2

                        Table of Contents


          Section                                      Page

          9.0  Named Directories                         95
               9.1  Overview of the Named Directory
                         Concept                         95
               9.2  Creating Named Directory Files with
                         MKDIR                           96
               9.3  Disk-Based and Memory-Based Named
                         Directories                     99
               9.4  Loading Named Directory Files       101
               9.5  Printing Named Directory Files      101
               9.6  Moving About with CD                102
               9.7  Poor Little ECHO and CD             103
               9.8  System Directories                  103
               9.9  Sample Sessions                     104

         10.0  ZCPR2 Resident and Alternate Commands    114
               10.01 The DIR Command                    114
               10.02 The ERA Command                    115
               10.03 The REN Command                    115
               10.04 The TYPE and LIST Commands         115
               10.05 The SAVE Command                   116
               10.06 The GET Command                    116
               10.07 The GO Command                     116
               10.08 The JUMP Command                   117
               10.09 The DU Form for Changing Disk and
                         User                           117
               10.10 Alternates to the ZCPR2 Residents  118
               10.11 The XDIR Command                   119
               10.12 The ERASE Command                  120
               10.13 The RENAME Command                 122
               10.14 The PAGE Command                   123
               10.15 The PRINT Command                  124
               10.16 The PROTECT Command                125
               10.17 The PATH Command                   126
               10.18 The WHEEL Command                  128

          11.0 Help System                              129
               11.1 The HELP2 Subsystem for Online
                         Documentation                  129
               11.2 Welcome to the HELP Command         129
               11.3 How to Use the HELP Command         130
               11.4 Moving Around Within the HELP Cmnd  131
               11.5 HELP Command Prompts                133
               11.6 HELP Error Messages                 134
               11.7 How to Write HELP Files             135
               11.8 The Tree Structure of HELP          137
               11.9 Sample HELP Files Illustrating Use
                         of Tree Structure              137è.he                ZCPR2 User's Guide -- Program Index
.fo                                               Page Index-#
.pn 1

                     User's Guide for ZCPR2
      Index to ZCPR2 Utility Programs and Resident Commands

Program Name   Version   Built-In Help  References

CD               2.3          Yes       70, 96, 102
COMPARE          1.4          Yes       74
CONFIG           1.2          Yes       11
CRC              2.0          Yes       74

DEVICE           1.3          Yes       6
DIFF             1.6          Yes       74
DIR*             ---          No        114
DU2              1.0          Yes       24

ECHO             1.1          Yes       115
ERA*             ---          No        115
ERASE            4.0          Yes       118, 120

GO*              ---          No        116
GENINS           2.2          No        6, 11, 19, 21, 70
GET*             ---          No        116

HELP or HELP2    4.0          Yes(1)    129

IOLOADER         1.3          Yes       6

JUMP*            ---          No        117

LD               1.1          Yes       96, 101
LDIRZ            2.0          Yes       47, 57
LIST*            ---          No        115
LRUNZ            1.0          Yes(2)    47, 55
LU               1.10         No        47

MCHECK           1.1          Yes       71
MCOPY            3.0          Yes       78
MENU             1.4          No        59
MKDIR            1.2          Yes       96

PAGE             1.0          Yes       118, 123
PATH             1.0          Yes       118, 126
PRINT or PRINT3  1.0          Yes       118, 124
PROTECT          2.0          Yes       118, 125
PWD              1.1          Yes       96, 101

RECORD           1.4          No        6, 9
REN*             ---          No        115
RENAME           2.0          Yes       118, 122

* Denotes a ZCPR2 Resident Command
(1) HELP, HELP HELP, or HELP HELP2 invokes Help on HELP
(2) LRUNZ without any arguments invokes a Help Message


                     User's Guide for ZCPR2
      Index to ZCPR2 Utility Programs and Resident Commands
                      Continuation of Index

Program Name   Version   Built-In Help  References

SAVE*            ---          No        116
ST or STARTUP    1.4          Yes       6, 70, 102
SUB or SUB2      2.3          Yes       84, 85
SYSIO            N/A          No        5

TINIT            2.0          Yes       11
TYPE*            ---          No        115

WHEEL            1.1          Yes       118, 128

XDIR3            1.5          Yes       12, 118, 119

ZEX              1.3          Yes       84, 87

* Denotes a ZCPR2 Resident Command


Other Notes:

     1«á  Thesσ arσ thσ versioε number≤ oµ thσ ZCPR▓ Utilitie≤ a⌠ ì
distribution time.

     2«  B∙ Built-Iε Help¼ ╔ refe≥ t∩ thσ "standardó ╔ adopteΣ iε ì
tha⌠á ßá commanΣ oµ thσ forφ "CMN─ //ó cause≤ ß hel≡á messagσá oε ì
tha⌠ commanΣ t∩ bσ displayed«á  A≤ yo⌡ caε see¼á tha⌠á "standardó ì
applie≤ iε man∙ cases¼ bu⌠ no⌠ al∞ cases.

     3«á  Documentatioεá oε thesσ ZCPR▓ command≤ caε bσ founΣá iε ì
three places:
          A.  The command itself (CMND // form)
          B.  The User's Guide for ZCPR2
          C«  Thσ Onlinσ Documentatioε Systeφ (HELP/HL╨ Files)

     4«á  Thσ example≤ iε thσ manual≤ werσ createΣ ove≥ ßá perioΣ ì
oµá time¼á and¼á a≤á ß consequence¼á thσ versioε number≤á oµá thσ ì
program≤á ma∙ no⌠ bσ thσ samσ a≤ thσ versioε number≤ oµ thσ file≤ ì
iε thσ distribution«á  D∩ no⌠ bσ alarmeΣ a⌠ this«á  Thσá example≤ ì
arσ stil∞ correc⌠ anΣ stil∞ ge⌠ thσ ideß acros≤ (╔ hope)¼ anΣ thσ ì
versioεá number≤ referenceΣ iε thi≤ lis⌠ anΣ iε thσá distributioε ì
files themselves are what count.

.he                  ZCPR2 User's Guide -- Foreword
.fo                                               Page Foreword-#
.pn 1

                            Foreword

     Welcomσá t∩ thσ worlΣ oµ ZCPR2«á  Thi≤ i≤ onσ oµ fou≥á ZCPR▓ ì
manuals¼ namel∙ thσ User'≤ Guide«  It≤ purposσ i≤ t∩ tel∞ yo⌡ ho≈ ì
t∩ usσ ZCPR▓ anΣ it≤ utilities¼á anΣ i⌠ i≤ mainl∙ ß tutoria∞á anΣ ì
referencσá oεá thσ utilitie≤ distributeΣ a≤ ß par⌠ oµá thσá ZCPR▓ ì
System«á  Therσá arσá threσá othe≥ manual≤ iεá thσá ZCPR▓á manua∞ ì
series:

          o the Concepts Manual
          o the Installation Manual
          o the Rationale

     Thσá 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∩ perforφ thσ installation¼ ì
thσ 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ε ß compute≥ cluΓ caε reall∙ bσ lot≤ oµ fuε anΣ educaì
tional¼ anΣ informatioε anΣ programs¼ likσ ZCPR2¼ caε bσ shared.

     Thσá purposσá oµ thσ Concept≤ Manua∞ 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

     Finally¼á thσ las⌠ 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