home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.barnyard.co.uk
/
2015.02.ftp.barnyard.co.uk.tar
/
ftp.barnyard.co.uk
/
cpm
/
walnut-creek-CDROM
/
CPM
/
ZCPR33
/
Z3-33
/
Z34RCP10.LBR
/
Z34RCP10.HZP
/
Z34RCP10.HLP
Wrap
Text File
|
2000-06-30
|
12KB
|
369 lines
The RCP Commands
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
S Display Disk Space Remaining
WHL Alter or Query Wheel Byte
:The RCP 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.
: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 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:*.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 Counterpart: 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 Counterpart: 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: PROTECT
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
:S Command
Transient Counterpart: None (Subset of STAT)
Thσ á╙ ácommanΣ display≤ spacσ remaininτ oε thσ ácurren⌠ áo≥ ì
specifieΣ disk.
Examples:
S -- Display space on current disk
S 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
Q Alter or Query the Quiet Flag
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.