Alternates to the ZCPR2 Resident Commands
The XDIR Command
Help File for XDIR
The ERASE Command
The RENAME Command
The PAGE Command
The PRINT Command
The PHELP Command
The PROTECT Command
The PATH Command
The WHEEL Command
The SAK Command
The COMMENT Command
:Alternates to the ZCPR2 Resident Commands
A� th� reade� ca� se� b� reviewin� th� hel� fil� name� �
Z2RES�� th� residen� command� o� ZCPR� ar� logica� extension� o� �
th� residen� command� o� th� CP/� 2.� CCP� Wit� th� ZCPR� Syste� �
o� Programs�� however�� come� � se� o� transien� program� whic� �
provid� th� sam� type� o� function� a� th� ZCPR�� residen� �
commands but with many more options and much more flexibility.
Als� i� man� cases�� th� DI� for� ma� b� prefixe� t� eac� �
fil� name�� Th� DI� for� ma� b� th� nam� o� � name� director� o� �
it may be a simple DU form.
:The XDIR Command
Th� XDIҠ Comman� (XDIR� program� i� a� extende� director� �
display utility. It has the general form of:
XDIR dir:filename.typ ooo...
where:
"dir:� i� � DI� prefix� i� ma� b� � name� directory�
like ROOT, a DU form, like A5, or omitted
"filename.typ" is an ambiguous file name reference,
and it may be omitted
"o" is an option character, and, if "filename.typ" is
omitted, the first option must be proceeded by
a slash
Valid options under XDIR are:
Aa -- Set File Attributes
AA = Select System and Non-System Files
AN = Select Non-System Files
AS = Select System Files
D -- Send Output to Disk File XDIR.DIR as well as
to the Console
Ff -- Enable a Disk-Based File Scanner Function
FL = Log Names to FNAMES.DIR
FP = Print Names Stored in FNAMES.DIR
FS = Scan Disk and Compare to FNAMES.DIR
G -- Toggle Grouping (by filename/type or type/name)
H -- Toggle Display (Horizontal/Vertical)
I -- Inspect Logged Files (for FL option only)
N -- Negate Selection (File NOT Matching Wildcard)
P -- Send Output to Printer as well as Console
Us� o� al� o� thes� option� i� rathe� involved�� an� XDIR� �
ha� � Hel� Fil� dedicate� t� it�� Th� nex� informatio� sectio� �
chains to that Help File.
S -- Include System Files; if S is not present, then
ERASE does not "see" System Files
R -- Erase Read/Only Files without asking the user for
permission; if ERASE encounters a Read/Only
fil� whil� i� i� performin� it� functio�
without the R option enabled, it will ask
the user if he wants to erase the file before
it does so; with the R option, it simply goes
ahead and erases the file
I -- Inspect; ERASE can be instructed to display each
file to the user and ask permission before
it erases it; if the user gives permission
and ERASE discovers that the file is R/O with
the R option off, it will ask a second time
before going ahead
Examples:
ERASE A4:*.TXT Erase all Non-System files of type
TXT in directory A4; if a file is R/O,
ERASE will ask for permission before
proceeding
ERASE *.TXT,TXT:*.TXT RI
Erase all Non-System files of type TXT
in the current directory and in the
directory named TXT; if a file is R/O,
go ahead and erase it; allow the user to
see the name of the file and approve its
erasure before it is erased
ERASE SCRATCH: SR Erase all System and Non-System files
i� th� director� name� SCRATCH� i� �
file is R/O, erase it without asking;
this erases absolutely every file in
that directory
:The RENAME Command
. RENAM� allow� ambiguou� fil� name� t� th� used
. RENAM� supports an Inspect Mode, where the user is
presented with each name change and allowed to
approve of it before it is done
. RENAME supports a Control Mode, where the user is
presented with each file to be RENAMEd and allowed
to manually enter the new name or not rename the
file
. RENAME accepts a list of files
. RENAME does not "see" System files unless told to
. RENAME can rename Read/Only files
. RENAME sets the attibutes (R/O and SYS) of the
new file names to be the same as those on the
old file names
. RENAME supports Named Directories
The RENAME command is of the general form:
RENAME dir:f1.typ,dir:f2.typ,... o...
The options to RENAME are:
S -- Include System Files
I -- Allow user to Inspect the file before performing
the rename
C -- (Control Mode) Allow the user to manually name
each of the selected files or to skip it
I� � ne� fil� nam� i� th� sam� a� a� existin� file� th� use� �
wil� b� aske� i� h� wishe� t� delet� th� existin� fil� i� orde� �
for the rename function to be performed.
Examples:
RENAME A4:MYFILE.TXT=HISFILE.TXT
Rename HISFILE.TXT in A4 to MYFILE.TXT
RENAME A4:*.MAC=*.ASM,*.TXT=*.TEX IS
Rename all files of type ASM in A4 to type MAC; also
rename all files of type TEX in the current directory
to type TXT; include System files and Inspect (approve)
each file before the rename is done
RENAME TXT: C
Rename all Non-System files in directory TXT; the user
is presented with the name of the file and manually
enters a new name for it
RENAME 1:*.TXT CS
Rename all Non-System and System files in User 1 of the
current disk whose file type is TXT and allow the user
to manually enter each new name
RENAME S*.TXT=*.TXT
Rename all Non-System files in the current directory
whos� fil� typ� i� TX� s� tha� th� firs� lette� o�
their names is an S and the rest of the letters are
unchanged
PAGE is invoked by a command line of the following form:
PAGE dir:f1.typ,dir:f2.typ,... o...
wher� "dir:fn.typ� i� a� ambiguou� fil� spe� (wil� card� ma�� b� �
used�� wit� � DI� prefi� (name� directorie� o� D� for� allowed� �
and "o" is one or more of the following options:
0-9 Set Character Print Speed (0=fastest=default)
I Inspect Files
The user is allowed to approve each file to
b� printe� befor� th� printin� begins�
default is NO Inspection
L Toggle Line Numbering
Each line may be numbered; default is NO Line
Numbers
P Toggle Screen Paging
Tur� of� th� facilit� o� pausin� onc� �
screen is filled; default is Paging Enabled
Snn Skip to Specified Page
Skip to indicated page (size of page on
printer) before beginning; default is NO Skip
E - Exact Print (Expand Tabs, Form Feed, No Line or
Page Numbers, No Heading)
F - Toggle default of file name display on page header
(defaul� i� ON� so � turn� of� name display)
H<delim>text<delim> - Define Heading text to appear
at the top of each page
I - Inspect Files (allow user to select files before
printing begins)
L - Enable numbering of each line
M - Disable Multiple Run Flag
(if multiple run is ON, then no "Set Top of Form"
message appears for each file and PRINT moves
from one file to another unattended); default is
with Multiple Run ON
N - Disable numbering of each page
Sn - Start printing on page n
T - Toggle date/time stamp in the header of each page
(a TIME subroutine must be assembled into PRINT
to enable the date/time stamp feature)
Examples:
PROTECT A4:*.COM,ROOT:*.COM RSI
Set the Attributes of all COM files in directories A4
and ROOT to Read/Only and System. Turn off the Archive
attribute and all tag bits. Allow the user to inspect
each file before the operation is performed.
PROTECT ROOT:*.TXT
Clear all attributes and all tag bits of all files of
type TXT in the directory named ROOT
PROTECT A: C
Allow the user to manually set all attributes and tag
bits of all files on Disk A in the current user
PATH // <-- Print Help
PATH <-- Display Path
PATH path-expression <-- Set Path
Actua� scree� display� illustratin� th� us� o� PAT� follow� �
Comments are denoted at the size by being prefixed with "<<".
B7>path // << Print Help
PATH Version 1.0
PATH allows the user to display his current path
and set a new path. It is invoked by one of the forms:
PATH <-- Display Path
PATH path-expression <-- Set Path
PATH // <-- Print Help
B7>path << Print Current Path
PATH Version 1.0
Current Path in Symbolic Form --
A$: --> A 15:
Current Path in Absolute Form --
A 7: --> A 15:
Current Path in Named Directory Form --
R-WS: --> ROOT:
B7>path $0 a$ base root: << Set a Path
PATH Version 1.0 << Note: a named dir may have a : suffix
Current Path in Symbolic Form --
$ 0: --> A$: --> A 0: --> A 15:
Current Path in Absolute Form --
B 0: --> A 7: --> A 0: --> A 15:
Current Path in Named Directory Form --
DEV-BASE: --> R-WS: --> BASE: --> ROOT:
B7>path 0 base root help << Set a Path with an Error in It
PATH Version 1.0
Invalid Path Expression Element -- Error Flagged at:
-->0 BASE ROOT HELP
This may be an invalid DU: form (disk or user out of range)
or an undefined named direcory.
Aborting to CP/M
B7>path a$ << I kept ROOT in the path before
PATH Version 1.0 << This is where my commands are
Current Path in Symbolic Form --
A$:
Current Path in Absolute Form --
A 7:
Current Path in Named Directory Form --
R-WS:
B7>path << Path Can't be found without ROOT being
PATH? << in the path expression
B7>a15:path a$ root << ... UNLESS the DU: prefix is used
PATH Version 1.0 << (DU: can be disabled by the ZCPR2 installer)
Current Path in Symbolic Form --
A$: --> A 15:
Current Path in Absolute Form --
A 7: --> A 15:
Current Path in Named Directory Form --
R-WS: --> ROOT:
COMMEN� i� � simpl� routin� whic� allow� th� use� t� typ� a� �
man�� line� a� h� wishe� withou� the� bein� processe� b�� ZCPR2� �
It has no arguments.
COMMENT has two main applications in the ZCPR2 environment:
1. when the console displays are being recorded,
COMMENT allows the user to easily type notes
to the future reader without having to begin
lines with a semicolon (;); all of these lines
are clearly shown to be comments since they begin
with the prompt "COMMENT>"
2� whe� consol� I/� i� redirecte� t� tw� differen�
users, such as CRT and MODEM I/O in parallel,
then COMMENT may be used to provide a simple
mechanism for them to communicate; both users
can type to each other without having any effect
on the system (such as command processing)
COMMENԠ i� aborte� b� strikin� � ^� a� th� firs� characte� �
o� � line� Backspac� an� Delet� bot� serv� t� ech� a� Backspace� �
space, backspace, and ^X and ^U both erase the current line.
COMMENT> Hi, Charlie, how's it going? o
COMMENT> Hi, Rick, fine ... and you? o
COMMENT> Fine, Charlie
COMMENT> Here is how I use XDIR -- let me do the typing
COMMENT> from now on ... just watch, and I'll reenter COMMENT
COMMENT> when done ... here goes o+o