***********************************************************
  *                                                         *
  *                     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