Oakland CPM Archive

home *** CD-ROM | disk | FTP | other *** search

/ Oakland CPM Archive / oakcpm.iso / sigm / vol105 / z2ug.wsh < prev next >

Wrap

Text File | 1985-02-10 | 15.3 KB | 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