The Commands in SYSRCP

The Commands in SYSRCP
CP Copy a File
DIR Display Directory
ECHO Echo Command Tail
ERA Erase Files
LIST/TYPE Display a File on Printer/CRT
NOTE Comment
PEEK/POKE Display/Alter Memory
PROT Protect Files
REG ZCPR3 Register Display/Alter
REN Rename a File
WHL Set/Reset Wheel Byte
:The Commands in SYSRCP

Th� standar� ZCPR�� Syste� Residen� Comman� Packag� �
(RCP� distribute� wit� th� ZCPR� syste� contain� � numbe� o� �
command� whic� ma�� b� enable� a� th� discretio� o� th� �
installer. These commands are described in the HELP file.

Al� command� an� option� ar� installation-dependent� �
Th� SHOנ comman� ma� b� use� t� displa� th� name� o� th� �
available commands in the currently-loaded RCP.

:CP Command
Transient Counterpart: MCOPY

Th� CР comman� copie� on� fil� fro� on� Dՠ t� �
anothe� o� int� th� sam� D� unde� � differen� name�� Th� �
synta� is:

CP dir:ufn=dir:ufn

Examples:
CP f1.txt=f2.txt
CP a15:=f1.txt
CP a15:f2.txt=c5:f1.txt

:DIR Command
Transient Counterpart: DIR, XD, XDIR

Th� DI� comman� display� th� director� o� file� i� �
alphabetica� orde� acros� th� line� t� th� user� Th� synta� �
is:

DIR dir:afn o

Options are:
S - Display System Files Only
A - Display Both Non-System and System Files

Examples:
DIR b7:
DIR 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�� ECHϠ ca� sen� it� outpu� t� th� consol� (b� �
default� o� t� th� printe� (i� th� firs� non-blan� characte� �
i� � dolla� sign)�� I� use� BIO� calls�� s� al� contro� �
character� ar� passe� exactly�� Hence�� console-leve� �
programmin� o� suc� device� (CRT� an� Printers� i� possible.

Examples:

ECHO $this is a test
-- THIS IS A TEST is printed on printer

ECHO this is a test
-- THIS IS A TEST is printed on console

:ERA Command
Transient Counterpart: ERASE

Th� ER� comman� erase� files� Th� synta� is:

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

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

: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� Th� synta� is:

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

Option to TYPE:
P - Do NOT Page Output to CRT

Examples:
TYPE b7:*.asm
LIST text:*.txt

:NOTE Command
Transient Counterpart: NOTE

NOT� i� simpl� � NO� (d� nothing� comman� whic� ca� �
b� use� t� plac� comment� int� multipl� comman� lines�� Fo� �
instance� i� th� followin� line:

dir *.comnote this is a dir displayera *.bak �
th� DI� an� ER� command� perfor� normally�� an� NOT� simpl� �
doe� nothin� ver� efficiently.

:PEEK and POKE Commands
Transient Counterpart: None (Subset of DDT)

Th� PEE� comman� allow� th� use� t� examin� � chun� �
o� memory�� I� th� use� simpl� type� "P� wit� n� address� �
th� nex� 25� byte� o� memor� ar� displayed�� I� th� use� �
type� "Р address"�� 25�� byte� o� memor� startin� a� th� �
indicate� addres� ar� displayed� I� th� use� type� "� addr� �
addr2"�� memor�� i� thi� addres� rang� i� displayed�� Th� �
syntax:

P
or:
P address
or:
P addr1 addr2

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

:PROT Command
Transient Counterpart: PROTECT

Th� PRO� comman� set� th� fil� protectio� attribute� �
fo� � grou� o� files�� Th� R/� an� Syste� attribute� ma� b� �
se� wit� th� � an� � options�� resp�� give� i� an� orde� a� �
"RS� o� "SR"�� Omissio� o� on� o� thes� option� toggle� th� �
opposit� (ie�� omissio� o� � make� th� file� R/W)�� Th� �
syntax:

PROT dir:afn
or:
PROT dir:afn R
or:
PROT dir:afn S
or:
PROT dir:afn RS -or- PROT dir:afn SR

Examples:
PROT b7:*.com rs
PROT text:*.txt
:REG Command
Transient Counterpart: REG

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

� registe� i� � ZCPR� registe� buffer�� indicate� b� �
� digi� fro� � t� 9.

Examples:
REG S0 4 -- reg 0 = 4
REG S5 -- reg 5 = 0
REG P -- reg 0 = reg 0 + 1
REG P5 -- reg 5 = reg 5 + 1
REG M9 -- reg 9 = reg 9 - 1
REG D -- show values
REG -- show values
:REN Command
Transient Counterpart: RENAME

Th� REΠ comman� change� th� nam� o� on� fil� t� �
another� Th� syntax: �
REN dir:ufn1=ufn2

Examples:
REN newfile.txt=oldfile.txt
REN root:sys.rcp=sys1.rcp

:WHL Command
Transient Counterpart: WHEEL

Th� WH� comman� i� use� t� tur� of� th� Whee� Byt� �
(mak� th� use� non-priveleged� o� t� tur� o� th� Whee� Byt� �
(mak� th� use� priveleged)� Th� synta� is:

WHL -- make user non-priveleged
or:
WHL password -- make user priveleged

Also�� thi� equat� enable� th� WHL� command�� whic� �
display� th� stat� o� th� Whee� Byte� Th� synta� is:

WHLQ

The Wheel password is built into the RCP.

Examples:
WHL
WHL mypass
WHLQ