ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/BEEHIVE/ZSUS/Z3HELP-6.LBR/ZA.LBR/Z34RCP.HZP/Z34RCP11.HLP

Text File | 2000-06-30 | 13KB | 390 lines

                    The RCP Commands
     CLED/SPOP      
Command Line Editor          
     CLS            
Clear the CRT screen         
     CP             
Copy a File                  
     D              
Display Directory            
     ECHO           
Echo Command Tail            
     ERA            
Erase Files                  
     H              
Display Available Commands   
     LIST/TYPE      
Display a File on Printer/CRT
     NOTE           
Comment                      
     P/POKE         
Display/Alter Memory         
     PORT           
Input/Output to system ports 
     PROT           
Protect Files                
     Q              
Alter or Query the Quiet Flag
     R              
Reset Disk                   
     REG            
ZCPR3 Register Display/Alter 
     REN            
Rename a File                
     SP             
Display Disk Space Remaining 
     WHL            
Alter or Query Wheel Byte    ì
:Thσ RC╨ Commands


     Thσ á standarΣ ZCPR│ Systeφ Residen⌠ CommanΣ áPackagσ á(RCP⌐ ì
distributeΣ áwitΦ thσ ZCPR│ systeφ contain≤ ß numbe≥ oµ áresiden⌠ ì
command≤ áwhicΦ áma∙ bσ enableΣ (dependinτ oε systeφ ámemor∙ áanΣ ì
securit∙ ácharacteristics⌐ áa⌠ thσ discretioε oµ áthσ áinstaller«  ì
Usagσ oµ thσ RC╨ command≤ i≤ describeΣ iε thi≤ HEL╨ file.

     Thσ áRC╨ command≤ residσ iε memor∙ rathe≥ thaε beinτ áloadeΣ ì
froφ ádisk¼ anΣ thereforσ operatσ ver∙ efficientl∙ anΣ arσ ádisδ¡ ì
independent« á Oε thσ othe≥ hand¼ duσ t∩ memor∙ constraints¼ áthσ ì
RC╨ command≤ arσ ofteε les≤ powerfu∞ thaε thei≥ transien⌠ prograφ ì
counterparts«



     Iµ aε erro≥ occurs¼ thσ RC╨ command≤ generall∙ chaiε t∩ áthσ ì
installeΣ erro≥ handler¼ providinτ ß detaileΣ repor⌠ oµ thσ erro≥ ì
anΣ áallowinτ thσ commanΣ t∩ bσ editeΣ o≥ aborted«  Iµ án∩ áerro≥ ì
handle≥ ái≤ áinstalled¼ áthσ commanΣ whicΦ causeΣ áthσ áerro≥ ái≤ ì
echoeΣ t∩ thσ screen¼ followeΣ b∙ ß questioε mark.

     Al∞ RC╨ command≤ arσ installatioε-dependent¼ anΣ man∙ ma∙ bσ ì
configureΣ áa⌠ áassembl∙ timσ t∩ perforφ áiε áslightl∙ ádifferen⌠ ì
ways« á Thσ áexample≤ giveε iε thi≤ HEL╨ filσ arσ ábaseΣ áoε áthσ ì
distributeΣ se⌠ oµ options«  Seσ sourcσ codσ filσ Z34RCP.LI┬ áfo≥ ì
morσ detail≤ oε commanΣ anΣ optioε selection.

:CLED anΣ SPO╨
 Commands
     
Transient Counterparts: LS╚ anΣ SPOP

     Thσ áCLE─ commanΣ invoke≤ ß specia∞ prograφ áwhicΦ áprovide≤ ì
WordSta≥-likσ editinτ oµ command≤ a⌠ thσ systeφ prompt«  I⌠ áals∩ ì
allow≤ yo⌡ t∩ recal∞ thσ las⌠ severa∞ command≤ invokeΣ witΦ áonl∙ ì
onσ keystroke«  Finally¼ iµ available¼ CLE─ display≤ thσ ácurren⌠ ì
systeφ timσ t∩ thσ lef⌠ oµ you≥ prompt«  Thσ synta° is:

        CLED    - invoke as shell
        CLED /    - invoke for next command only



     Thσ SPO╨ commanΣ "popsó thσ to≡ shel∞ froφ thσ shel∞ ástack¼ ì
s∩ tha⌠    i⌠ n∩ longe≥ load≤ afte≥ ever∙ command«  Thi≤ commanΣ ái≤ ì
rarel∙ áneeded¼ áanΣ i≤ includeΣ onl∙ witΦ version≤ áoµ áthσ áRC╨ ì
includinτ CLE─ (seσ above)«  Thσ synta° i≤ simply:

        SPOP
:CLS 
Command
     
Transient Counterpart: None

     Thσ áCL╙ ácommanΣ áclear≤ áthσ átermina∞ áscreen¼ ááremovinτ ì
display≤ áwhicΦ ámigh⌠ áhavσ beeε lef⌠ b∙ ápreviou≤ ácommand≤ áo≥ ì
programs«  Thσ synta° is:

        CLS

:CP 
Command
     
Transient Counterpart: MCOPY

     Thσ áC╨ ácommanΣ copie≤ onσ filσ froφ onσ D╒ t∩ áanothe≥ áo≥ ì
int∩ áthσ samσ D╒ unde≥ ß differen⌠ name«  Iµ function≤ 10▓ á(ge⌠ ì
stamp⌐ áanΣ 10│ (se⌠ stamp⌐ arσ supporteΣ b∙ aε RS╪ o≥ DOS¼ áfilσ ì
datestamp≤ arσ preserveΣ acros≤ copies«  Thσ synta° is:

        CP dir:ufn1 dir:ufn2    -- ufn1 to ufn2
        CP dir:ufn1            -- ufn1 to current dir:
        CP dir:ufn2=dir:ufn1    -- ufn1 to ufn2

    
Examples:

        CP f1.txt f2.txt
        CP b0:f1.txt a15:
        CP root:f1.txt

:D 
Command
     
Transient Counterpart: DIR, XD, XDIR

     Thσ áá─ áácommanΣ ádisplay≤ áthσ ádirector∙ áoµ ááfile≤ ááiε ì
alphabetica∞ orde≥ acros≤ thσ line≤ t∩ thσ user«  Thσ synta° is:

        D dir:afn.aft o
        D .aft o
        D /o

        Options (wheel only) are:

          S - Display System Files Only
          A - Display Both Non-System and System Files

    
Examples:

        D /a
        D root:myfile.txtè        D .com

:ECHO 
Command
     
Transient Counterpart: ECHO

     ECH╧ á i≤  usefu∞ iε issuinτ botΦ  message≤  (t∩  thσ áuser¼ ì
sa∙ withiε ß commanΣ filσ durinτ execution⌐ anΣ escapσ sequences« ì
B∙ áusσ oµ thσ %╛ anΣ %╝ parameters¼ ECH╧ caε senΣ it≤ outpu⌠ áiε ì
combination≤ áoµ uppe≥ anΣ lowe≥ case«  B∙ usσ oµ thσ %╨ áanΣ á%├ ì
parameters¼ áECH╧ áoutpu⌠ ácaε ábσ átoggleΣ ábetweeε áscreeε áanΣ ì
printer« á ECH╧ áuse≤ áBIO╙ ácalls¼ ás∩ áal∞ ácontro∞ ácharacter≤ ì
(entereΣ a≤ ^character⌐ arσ passeΣ exactly«  Hence¼ consolσ-leve∞ ì
programminτ oµ sucΦ device≤ (CRT≤ anΣ printers⌐ i≤ possible.

        
Examples:
               ECHO %Pthis is a test%Cof echo%P
                    -- "THIS IS A TEST" goes to the printer
            "OF ECHO" goes to the console
            (trailing %P flushes printer buffer)

               ECHO t%>his is a %<test^j
                    -- "This is a TEST", followed by Control-J,
                        goes to the consoleì
:ERA 
Command
     
Transient Counterpart: ERASE

     Thσ áER┴ commanΣ erase≤ files«  Iµ an∙ characte≥ i≤ áentereΣ ì
afte≥ áthσ áfilespec¼ thσ use≥ i≤ prompteΣ beforσ áeacΦ áerasure«  ì
Thσ synta° is:

        ERA dir:afn
    or:
        ERA dir:afn o    -- Inspect files first

    
Examples:

        ERA b7:*.bak
        ERA text:*.tmp i

:H 
Command
     
Transient Counterpart: SHOW

     Thσ á╚ á(help⌐ commanΣ display≤ t∩ thσ consolσ áal∞ áoµ áthσ ì
buil⌠-iε ácommand≤ currentl∙ availablσ oε thσ ásystem¼ áincludinτ ì
RCP¼ FCP¼ anΣ CC╨ commands«  Iµ ß commanΣ i≤ whee∞-protected¼ ái⌠ ì
i≤ no⌠ displayeΣ whilσ thσ whee∞ bytσ i≤ off.

The syntax is simply:

        H

:LIST and TYPE 
Commands
     
Transient Counterparts: PRINT and PAGE

     Thσ TYP┼ commanΣ display≤ ß grou≡ oµ file≤ oε thσ CR╘ áwhilσ ìèthσ áLIS╘ commanΣ print≤ ß grou≡ oµ file≤ oε thσ printer« á Whilσ ì
thσ áfile≤ arσ beinτ displayeΣ o≥ printed¼ contro∞-╪ áentereΣ áa⌠ ì
thσ consolσ skip≤ t∩ thσ nex⌠ filσ anΣ contro∞-├ cancels« á Whilσ ì
TYPEinτ ß filσ o≥ files¼ paginτ ma∙ bσ switcheΣ ofµ witΦ contro∞¡ ì
Z« á Iµ LIS╘ i≤ giveε withou⌠ parameters¼ ß forφ feeΣ i≤ sen⌠ át∩ ì
thσ printer«  Thσ synta° is:

        TYPE dir:afn o  -or-  LIST dir:afn  -or-  LIST

        Option to TYPE:

        P - Do NOT Page Output to CRT

    
Examples:

        TYPE b7:*.asm p
        LIST text:*.txtì
:NOTE 
Command
     
Transient Counterpart: NOTE

     NOT┼ ái≤ simpl∙ ß "d∩ nothingó commanΣ whicΦ caε bσ useΣ át∩ ì
placσ comment≤ int∩ multiplσ commanΣ lines«  Fo≥ instance¼ iε thσ ì
followinτ line:

        d *.com;note this is a dir display;era *.bak

thσ á─ áanΣ ER┴ command≤ perforφ normally¼ anΣ thσ áNOT┼ ácommanΣ ì
simpl∙ doe≤ nothinτ ver∙ efficiently.

:P and POKE 
Commands
     
Transient Counterparts: None (Subset of DDT)

     Thσ ╨ commanΣ allow≤ thσ use≥ t∩ examinσ ß chunδ oµ ámemory«  ì
Iµ thσ use≥ simpl∙ type≤ "Pó witΦ n∩ address¼ thσ nex⌠ 12╕ ábyte≤ ì
oµ ámemor∙ áarσ displayed«  Iµ thσ use≥ type≤ á"╨ áaddress"¼ á12╕ ì
byte≤ oµ memor∙ startinτ a⌠ thσ indicateΣ addres≤ arσ ádisplayed«  ì
Iµ áthσ use≥ type≤ "╨ address▒ address2"¼ memor∙ iε thi≤ áaddres≤ ì
rangσ i≤ displayed«  Thσ syntax:

        P
     or:
        P address
     or:
        P address1 address2ì



     Thσ áPOK┼ commanΣ allow≤ thσ use≥ t∩ changσ thσ áconten⌠ áoµ ì
memory«  Thσ use≥ mus⌠ specif∙ aε addres≤ t∩ POKE¼ anΣ tw∩ ábasiπ ì
form≤ arσ allowed:

        POKE address val1 val2 ... valn
     and:
        POKE address "character string

     Thσ átw∩ form≤ ma∙ bσ intermixeΣ witΦ leadinτ value≤ áanΣ áß ì
trailinτ characte≥ string:

        POKE address val1 val2 ... valn "character stringì



    
Examples:
        P
        P f400
        P f400 f425
        POKE f400 0 1 2
        POKE f400 "this is a test
        POKE f400 1 2 3 "hello, world

:PORT 
Command
     
Transient Counterpart: None

     Thσ POR╘ commanΣ allow≤ thσ use≥ t∩ inpu⌠ anΣ outpu⌠ ávalue≤ ì
t∩ thσ computer'≤ input/outpu⌠ ports«  Thσ synta° is:

        PORT addr    -- Read and display value
        PORT addr value    -- Send value to port

    
Examples:

        PORT fc
        PORT fd 21

:PROT 
Command
     
Transient Counterpart: PROTEC╘

     Thσ áPRO╘ commanΣ set≤ thσ filσ protectioε attribute≤ fo≥ áß ì
grou≡ áoµ files«  Thσ R/O¼ System¼ anΣ Archivσ attribute≤ ma∙ ábσ ì
se⌠ áwitΦ áthσ R¼ S¼ anΣ ┴ options¼ respectively¼ ágiveε áiε áan∙ ì
orde≥ áa≤ á"RSAó áo≥ "ASR"«  Omissioε oµ áonσ áoµ áthesσ áoption≤ ì
toggle≤ áthσ áoppositσ (ie¼ omissioε oµ ╥ make≤ thσ áfile≤ áR/W)«  ì
Thσ á╔ optioε allow≤ onσ t∩ inspec⌠ eacΦ filenamσ beforσ ásettinτ ì
it≤ filσ attributes« Thσ syntax:

     PROT dir:afn        - set to read write, directory, modified
     PROT dir:afn R      - set to read only,  directory, modified
     PROT dir:afn RA     - set to read only,  directory, archived
     PROT dir:afn RASI   - set to read only,  system,    archived,
                           with inspection
    
Examples:
        PROT b7:*.com rai
        PROT this.docì
:Q 
Command
     
Transient Counterpart: QUIET

     Thσ á╤ ácommanΣ turn≤ thσ ZCP╥ quie⌠ flaτ oε áo≥ áoff« á Thσ ì
quie⌠ áflaτ i≤ useΣ b∙ somσ program≤ anΣ part≤ oµ áthσ áoperatinτ ì
systeφ át∩ determinσ ho≈ mucΦ informatioε the∙ shoulΣ displa∙ át∩ ì
thσ áscreen« á A≤ áß rule¼ wheε thσ quie⌠ flaτ ái≤ áon¼ áprogram≤ ì
displa∙ onl∙ erro≥ message≤ t∩ thσ screen«  Thσ synta° is:

        "Q"   or "Q Dis"    -- display quiet flag
                "Q S" or "Q Set"    -- turn quiet flag ONè                "Q R" or "Q Reset"  -- turn quiet flag OFF

:R 
Command
     
Transient Counterpart: None

     Thσ ╥ (reset⌐ commanΣ reset≤ ß flopp∙ disδ anΣ display≤ áthσ ì
amoun⌠ áoµ spacσ remaining«  ZSDO╙ doe≤ no⌠ requirσ disk≤ át∩ ábσ ì
rese⌠ áwitΦ ácontro∞-C¼ ábu⌠ áprogram≤ áwil∞ árepor⌠ ádisδ áspacσ ì
properl∙ áunti∞ áß disδ i≤ reset¼ anΣ i⌠ i≤ ß gooΣ ápractice« á ╥ ì
als∩ áforce≤ áß árese⌠ oµ al∞ disk≤ usinτ thσ á"fas⌠ áfixeΣ ádisδ ì
relogó featurσ oµ ZSDOS.

    
Examples:

        R    -- Reset current disk
        R b:    -- Reset disk B


:REG 
Command
     
Transient Counterpart: REG

     ┴ registe≥ i≤ ß ZCPR│ buffer¼ indicateΣ b∙ ß digi⌠ froφ ░ t∩ ì
31¼ áo≥ thσ lette≥ ┼ fo≥ prograφ Erro≥ byte«  Thσ áregister≤ áarσ ì
useΣ át∩ ápas≤ informatioε betweeε program≤ o≥ áportion≤ áoµ áthσ ì
operatinτ system.

     The REG command forms are:
    REG D or REG    = display values of first 10 registers
    REG Mreg    = subtract 1 from a register (Minus)
    REG Preg    = add 1 to a register (Plus)
    REG Sreg value    = set value of indicated register
        REG reg     = display a single register valueì



    
Examples:
        REG S0 4    -- reg 0 = 4
        REG S12        -- reg 12 = 0
        REG P        -- reg 0 = reg 0 + 1
        REG P5        -- reg 5 = reg 5 + 1
        REG M9        -- reg 9 = reg 9 - 1
        REG        -- show first ten values
        REG SE 0    -- zero program error byte

:REN 
Command
     
Transient Counterpart: RENAME

     Thσ áRE╬ ácommanΣ change≤ thσ namσ oµ onσ filσ át∩ áanother«  ì
Thσ áfilσ nameΣ oε thσ lef⌠ wil∞ bσ renameΣ witΦ thσ namσ t∩ áthσ ì
right«  Iµ aε equa∞ sigε ("="⌐ i≤ used¼ thσ olde≥ CP/═ synta° ái≤ ì
used¼ áanΣ thσ filσ nameΣ oε thσ righ⌠ i≤ renameΣ t∩ thσ namσ áoε ì
thσ áleft« á Iµ anothe≥ filσ alread∙ ha≤ thi≤ name¼ thσ áuse≥ ái≤ ì
askeΣ whethe≥ o≥ no⌠ t∩ erasσ thσ olΣ file«  Thσ synta° is:

        REN dir:ufn1 ufn2
        REN ufn1 dir:ufn2
        REN ufn2=ufn1

    
Examples:

        REN oldfile.txt newfile.txt
        REN root:sys.rcp sys1.rcp
        REN oldname work:newname
        REN work:newname=oldnameì
:SP 
Command
     
Transient Counterpart: None (Subset of STAT)

     Thσ á╙ ácommanΣ display≤ spacσ remaininτ oε thσ ácurren⌠ áo≥ ì
specifieΣ disk.

    
Examples:

        SP    -- Display space on current disk
        SP a:    -- Display space on disk A
:WHL 
Command
     
Transient Counterpart: WHEEL

     Thσ á WH╠ commanΣ i≤ useΣ t∩ turε ofµ thσ Whee∞  Bytσ á(makσ ì
thσ áuse≥ ánoε-privileged)¼ t∩ turε oε thσ Whee∞ Bytσ á(makσ áthσ ì
use≥ privileged)¼ o≥ t∩ displa∙ thσ Whee∞ state«  Thσ synta° is:

        WHL password     - Turn wheel ON if password correct,
                                  turn wheel OFF if not.

        WHL        - Display wheel state

    
Examples:è
        WHL
        WHL mypassì



     B∙ ádefault¼ áthσ followinτ RC╨ command≤ arσ áno⌠ áavailablσ ì
whilσ thσ whee∞ bytσ i≤ off:

     CP             
Copy a File                  
     ERA            
Erase Files                  
     LIST/TYPE      
Display a File on Printer/CRT
     P/POKE         
Display/Alter Memory         
     PORT           
Input/Output to system ports 
     PROT           
Protect Files                
     SPOP           
Pop Shell Stack              
     REG            
ZCPR3 Register Display/Alter 
     REN            
Rename a File                

     Thσ ácommand≤ ád∩ no⌠ appea≥ iε thσ ╚ á(help⌐ ádisplay¼ áanΣ ì
attempt≤ át∩ áusσ theφ invokσ thσ erro≥ handle≥ (iµ ápresent⌐ áo≥ ì
ech∩ áthσ baΣ commanΣ bacδ t∩ thσ screeε followeΣ b∙ áß áquestioε ì
mark«