VFILER Overview, Revision 2
Installing VFILER
VFILER Command Summary
The DIR Form
User Functions
Tagging Commands
File Display Commands
File Operations Commands
Movement Commands
Miscellaneous Commands
:VFILER 2.x Overview
VFILE� (fo� Vide� FILER)� derive� fro� FILER� wa� create� �
t� giv� th� ZCPR� use� � specialize� fil� manipulatio� utilit� �
whic� coul� tak� advantag� o� th� specia� feature� o� ZCPR2�� I� �
perform� th� sam� basi� function� a� DISK7�� CLEANUP�� WASH�� an� �
SWEEP�� bu� i� take� th� ZCPR� enviro� int� accoun� an� add� �
command� an� feature� whic� mak� VFILE� mor� comfortabl� fo� th� �
ZCPR� user� VFILE� contain� essentiall� th� sam� feature� a� th� �
othe� tool� bu� add� mor� feature� (whic� ar� mad� availabl� �
unde� th� ZCPR� environment� an� i� totall�� screen-oriented� �
bein� designe� t� ru� o� � conventiona� CR� whic� support� curso� �
address� clea� screen� an� (optionally� eras� t� en� o� line.
VFILEҠ significantl� simplifie� th� use� interface�� Unde� �
VFILER� a� alphabetize� listin� o� file� i� presente� t� th� use� �
alon� wit� � pointer� Th� use� employ� pointe� movemen� command� �
t� mov� th� pointe� up� down� right� an� lef� a� desire� unti� i� �
i� pointin� t� � fil� o� interest� Onc� pointin� t� suc� � file� �
th� use� ma� the� perfor� � numbe� o� operation� o� th� file.
VFILEҠ i� invoke� b� � comman� lin� o� th� followin� �
form:
VFILER [du] [w]
wher� "du� an� "w� ar� optiona� parameters�� "DU� i� th� direct-�
or�� t� initiall� lo� th� use� into�� "W� i� � paramete� i� th� �
2n� FC� (i� won'� wor� unles� � D� i� als� present� whic� tell� �
VFILE� t� promp� th� use� fo� � dela� befor� continuing.
Th� D� for� use� abov� consist� o� a� mos� � dis� lette� an� �
� use� number�� eithe� on� o� whic� i� optional�� "A� refer� t� �
dis� A�� curren� user�� "7� refer� t� th� curren� disk�� use� 7� �
"B4�� refer� t� dis� B�� use� 4�� Th� D� for� i� � logica� �
extension to the D form used in CP/M.
SPECIA̠ NOTE�� I� th� VFILE� comman� line�� th� Dՠ for� �
shoul� NO� b� followe� b� � colo� (:)�� Thi� i� t� preven� th� �
operating system from trying to interpret it.
This HLP File applies to VFILER 2.x.
VFILEҠ ha� prove� t� b� � usefu� too� wit� � ver�� user-�
friendl�� interface�� Pleas� fee� fre� t� sen� suggestion� fo� �
improvements to:
Richard Conn
93 Wedgewood Circle
Eatontown, NJ 07724
I� yo�� wan� � reply�� enclos� � self-addresse� stampe� �
envelope.
Enjoy using VFILER!
Rick
:Installing VFILER
Installatio� o� VFILE� i� � multi-ste� process�� requirin� �
som� knowledg� o� assembl� languag� an� th� capabilitie� o� you� �
CR� terminal.
The needed files and programs are:
ASM.COM <-- CP/M 2.2 Assembler
DDT.COM <-- CP/M 2.2 DDT
VFILER.COM <-- Uninstalled VFILER
VFILERSC.ASM <-- Source to Patch
ED.COM <-- Or your favorite editor
GENINS.COM <-- For ZCPR2/CPM Installation
Ther� ar� tw� version� o� VFILE� -- on� usin� Z8�� cod� t� �
mak� i� � littl� smalle� (an� faster� an� th� othe� usin� 808� �
code. VFILERZ is the Z80 version, VFILER8 is the 8080 version.
The installation procedure is as follows:
1�� Edi� VFILERSC.AS� an� follo� th� direction� i� th� �
code�� Yo�� hav� t� writ� routine� whic� clea� you� terminal'� �
screen�� positio� it� cursor� an� eras� t� en� o� lin� (o� outpu� �
s� man� space� i� suc� � functio� i� no� available).
2. Assemble VFILERSC.ASM into VFILERSC.HEX:
D>ASM VFILERSC
3. Run DDT on the desired VFILER (VFILER8 or VFILERZ):
D>DDT VFILER8.COM or D>DDT VFILERZ.COM
4. Read in VFILERSC.HEX:
*IVFILERSC.HEX
*R
*^C
5. Save the memory image as VFILER.COM:
D>SAVE 32 VFILER.COM for VFILERZ or
D>SAVE 33 VFILER.COM for VFILER8
6� Instal� VFILE� fo� you� syste� vi� GENINS� Se� th� �
ZCPR2 Installation Manual for details:
D>GENINS VFILER
NOTE�� I� orde� fo� th� ZCPR� comman� executio� facilit� t� �
wor� fro� withi� VFILER�� th� nam� o� VFILE� MUS� b� VFILER.COM� �
Thi� i� becaus� VFILE� build� � comman� lin� o� th� form:
commands;VFILER
so that control will return to VFILER when done.
:VFILER Command Summary
-- Tagging Commands -- --------- File Operations ---------
T - Tag File C - Copy File M - Mass Copy
U - Untag File D - Delete File R - Rename File
W - Mass Tag/Untag F - File Size Y - Mass Delete
-- File Print & View -- --- User Functions ---
P - Print V - View 0-9 - Execute * - Help
-- Movement Commands -- ---- Miscellaneous ----
<SP> - File Forward A - Toggle Alpha Sort
N - File Forward H - Help File
<BS> - File Backward L - Login DIR
B - File Backward Q - Refresh Screen
� - G� T� � Fil� S - Disk Status
+ - Screen Forward X - Exit
- - Screen Backward Z - ZCPR2 Command
-- Screen Movement --
File: ^S - LEFT ^D - RIGHT ^E - UP ^X - DOWN
Screen: ^A - LEFT ^F - RIGHT
Movement Commands --
^E - Move Up (Wrap to Bottom)
^X - Move Down (Wrap to Top)
^D - Move Right (Wrap to First File of Next Line)
^S - Move Left (Wrap to Last File of Previous Line)
^F - Move Screen Right (Wrap to First Screen)
^A - Move Screen Left (Wrap to Last Screen)
Th� use� ma� defin� si� othe� single-characte� command� t� �
confor� t� th� arro� key� o� hi� specifi� terminal�� Thes� �
command� wil� overrid� th� se� describe� abov� i� an�� conflict� �
exis� (tha� is�� i� you� down-arro� ke� generate� � ^E�� ^� wil� �
no� mea� Mov� Dow� i� al� cases).
Scree� Lef� an� Righ� mak� sens� whe� ther� ar� to� man� �
file� t� fi� o� on� screen�� I� thi� case�� th� file� ar� broke� �
int� scree� directories�� an� Scree� Lef� an� Righ� ar� use� t� �
move between them.
:The DIR Form
Th� Copy�� Mas� Copy� an� Logi� command� promp� th� use� fo� �
th� director�� t� cop� o� lo� into�� Th� use� ma�� specif�� an� �
accepted ZCPR2 DIR form in response to this.
Th堠 ZCPR�� DIҠ for� ma�� b� eithe� � Dՠ� (Disk/User� �
specificatio� o� � director� nam� (mnemonic)�� Example� o� DI� �
forms include:
B <-- Disk B, Current User
7 <-- Current Disk, User 7
B7 <-- Disk B, User 7
wordstar <-- DU associated with the name WORDSTAR
I� VFILER�� thes� entrie� ma� b� optionall� suffixe� b�� � �
colo� (:�� a� th� use� desires�� "B7:� an� "B7� mea� th� sam� �
thing.
:User Functions
Th� VFILEҠ use� i� give� adde� flexibilit� i� hi� comman� �
invocatio� capabilit�� b�� th� us� o� � se� o� user-definabl� �
functions�� whic� ar� execute� b� strikin� � digi� fro� � t� 9� �
The basic idea is this:
1� th� use� create� � fil� calle� VFILER.CMD� thi� fil� �
contains his extended command set
2� VFILER.CM� i� place� alon� th� user'� comman� searc� �
path
3� whe� th� use� i� i� VFILE� an� h� strike� � digi� o� �
a� asteris� (*� fo� help�� VFILE� searche� alon� th� pat� fo� th� �
firs� VFILER.CM� fil� i� find� an� extract� th� informatio� fro� ��it
Sinc� VFILE� searche� fo� VFILER.CM� alon� th� path� severa� �
VFILER.CM� file� ma� b� availabl� fo� th� user� Fo� instance� i� �
th� pat� i� $� -� A� -� A15� the� VFILE� wil� loo� i� th� curren� �
directory��� dis렠 A/curren� user��� an� dis� A/use� 1�� fo� �
VFILER.CMD�� � general-purpos� VFILER.CM� fil� ma� b� place� i� �
A15�� an� special-purpos� VFILER.CM� file� (suc� a� fo� assemble� �
languag� development� � development� wor� processing� etc� ma� b� �
place� i� selecte� use� area� o� A�� Sa� tha� A� contain� Wor� �
Sta� an� i� use� fo� wor� processin� an� tha� B� i� th� scratc� �
are� fo� tex� files. Wit� thi� path�� � use� editin� file� i� B� �
wil� fin� W� i� A7�� VFILER.CM� (fo� wor� processing� i� A7�� an� �
his system commands in A15.
An� option� require� fo� th� command� ar� prompte� for�� an� �
whe� th� use� input� value� fo� al� options� VFILE� chain� t� th� �
ne� comman� vi� th� ZCPR� Multipl� Comman� Lin� feature� execute� �
the command line generated, and returns.
Th� structur� o� VFILER.CM� i� quit� simple�� I� ca� b� �
create� b� an� CP/� tex� editor� an� i� consist� o� th� followin� �
types of lines:
1� � comman� line�� whic� begin� wit� � digi� (0-9� an� �
contain� th� tex� o� th� comman� t� b� execute� shoul� tha� digi� �
be typed by the user
2�� � hel� block�� whic� i� printe� wheneve� th� use� �
type� a� asteris� (*)�� thi� bloc� i� denote� b� � lin� whic� �
begins with an asterist, and it extends to the end of the file
3� � commen� line�� whic� i� use� t� embe� explanator� �
comments�� whic� ar� fo� referenc� purpose� onl� an� no� see� b� �
the VFILER user
COMMAND LINE
Th� comman� lin� consist� o� � digit�� zer� o� mor� space� �
(whic� ar� ignored)�� an� th� tex� o� th� comman� wit� embedde� �
prompt� fo� use� input�� Thes� prompt� ar� denote� b�� bein� �
enclose� i� single- o� double-quote� (� o� ")�� Whe� VFILE� �
execute� thes� comman� lines�� i� print� th� promp� containe� �
withi� th� quote� a� the� ar� encountere� an� wait� fo� th� use� �
t� inpu� � lin� o� tex� (terminate� b� � RETURN)�� a� whic� poin� �
th� tex� i� substitute� i� th� comman� lin� wher� th� promp� is� �
I� � promp� extend� t� th� en� o� � comman� line�� i� nee� no� b� �
terminated. Example:
1 copy 'Source File? ' 'Destination Dir? '
wil� defin� use� functio� 1�� Th� use� i� prompte� wit� "Sourc� �
File�� "�� h� enter� hi� text�� i� i� substitute� i� th� comman� �
line�� h� i� prompte� fo� "Destinatio� Dir�� "� h� agai� enter� � �
response�� i� i� substituted�� an� th� resultin� comman� lin� i� �
chaine� to.
1 copy 'Source File? ' 'Destination Dir? '
I� th� use� respond� wit� "myfile.txt�� an� "C0:"�� the� th� �
command line
copy myfile.txt C0:
i� built�� Not� tha� space� an� othe� character� betwee� th� �
prompts are significant.
1 mcopy 'Dest Dir? '='Source File? '
will generate (to the same inputs)
mcopy C0:=myfile.txt
Passed Parameters
Thre� parameter� ma� b� passe� fro� VFILE� int� th� comman� �
line being generated. These parameters and their symbols are:
Symbol Parameter
%D Current Disk Letter
%U Current User Number (1 or 2 digits)
%F Current File Name (pted to by arrow)
%$ DU:FILENAME for Current File
I� th� use� mus� inser� � '%� characte� int� th� comman� �
line he is building, '%%' places one '%' into the line. Example:
echo Disk is %d, User is %u, File is %f
prints (assuming the user is in A15 and pting to MYFILE.TXT):
Disk is A, User is 15, File is MYFILE.TXT
HELP BLOCK
Th� Hel� Bloc� i� th� VFILER.CM� fil� i� simpl� � bloc� o� �
tex� whic� extend� fro� th� asteris� (*� i� th� fil� t� th� en� �
o� th� file�� Thi� hel� informatio� i� displaye� t� th� use� a� �
on� screen� an� i� i� th� responsibilit� o� th� perso� wh� write� �
th� VFILER.CM� fil� t� se� tha� thi� bod� o� tex� (includin� th� �
line the asterisk is on) does not exceed 22 lines. Example:
* Help for Word Processing
1 - Run WordStar
2 - Run WordMaster
3 - Run ROFF4
4 - Run TFS
COMMENT LINE
� commen� lin� i� an� lin� whic� doe� no� begi� wit� � digi� �
o� a� asterisk� Th� tex� o� tha� lin� i� th� comment� I� i� no� �
displaye� t� th� VFILE� use� an� i� use� onl� fo� referenc� t� �
the person who wrote the VFILER.CMD file. Example:
! This is a comment
This is also a comment
Sample VFILER.CMD
! VFILER Command File for Richard Conn
1 xdir 'XDIR Options? '
2 protect %D%U:%F 'PROTECT Attributes? '
3 wm %$
4 t2a
5 echo Disk=%d User=%u File=%f DU:FILENAME = %$
*VFILER Command File for Richard Conn
The following VFILER Macros are provided --
1 - XDIR with Options
2 - PROTECT Current File
3 - Edit Current File
4 - TERM III
5 - Echo Current File and Text
:Tagging Commands
Ԡ - Ta� fil� fo� inclusio� fo� mas� cop�� t� anothe� D� �
(disk/user� area�� Fil� remain� tagge� unti� eithe� � dis� log-�
i� o� 'U� i� use� t� unta� it�� � '*� marke� i� place� b�� th� �
tagge� filenam� a� � reminde� th� fil� i� tagge� fo� mas� cop� o� �
mas� delete�� Tagge� fil� siz� i� show� an� total� accumulate� �
an� presented.
� - Unta� fil� previousl� tagge� fo� mas� copy�� 'U� ca� b� �
use� t� mov� curso� 'forward� fo� quic� untaggin� o� files� �
Logging-i� driv� agai� wit� 'L� als� quickl� untag� al� files.
נ - Mas� Ta� o� Untag�� Use� i� prompte� fo� th� Ta� �
operatio� o� th� Unta� operatio� (� o� U)�� An� othe� characte� �
aborts�� I� eithe� operatio� i� selected�� taggin� o� untaggin� �
occur� automaticall� fro� th� curso� positio� t� th� en� o� th� �
scree� o� al� file� i� thi� area� I� th� use� wishe� t� the� se� �
th� accumulate� size� o� th� tagge� files�� th� Ơ (Fil� Size� �
command may be issued.
:File Display Commands
Р- Prin� tex� fil� t� CP/M lis� devic� (printer)�� An� �
keypres� cancels.
� - Vie� tex� fil� o� console�� wit� paginatio� an� single-�
lin� turn-up�� <CTRL-C� cancel� function�� <SPACE� advance� t� �
nex� line�� an� an� othe� characte� advance� th� screen�� Onl� �
ASCI� character� ar� processed.
:File Operations Commands
� - Cop� fil� t� anothe� DI� are� wit� automati� 'CRC� veri-�
fication�� Th� standar� ZCPR� DI� for� i� allowed�� an� � colo� �
afte� th� specificatio� i� optional�� Se� th� sectio� o� th� DI� �
for� fo� mor� details�� Syste� rese� occur� fo� dis� change� ��Prompt� t� eras� alread� existin� fil� o� othe� driv� o� i� othe� �
use� area�� Th� use� shoul� b� sur� tha� ther� i� enoug� roo� o� �
the destination disk before attempting a copy.
� - Delet� fil� fro� disk� prompt� fo� certainty.
� - Fil� siz� i� kilobytes�� rounde� u� t� nex� dis� alloca-�
tio� block.
͠ - Mas� cop� o� tagge� file� t� anothe� Dՠ area�� Auto-�
eras� occur� i� file(s� alread� exist(s)� Prompt� fo� desire� D� �
are� a� wit� 'C� an� 'L'�� Mas� cop� functio� ca� b� repeate� �
withou� re-taggin� files�� Simpl� ente� 'M� agai� t� cop�� pre-�
viousl�� tagge� file� t� anothe� D� area�� Enterin� 'M�� withou� �
an� file� tagge� cause� curso� t� mov� t� director� beginning.
Ҡ - Renam� fil� o� curren� drive�� Onl�� CP/͠ conventio� �
name� permitted� Wil� card� ar� no� permitted� Use� i� prompte� �
fo� ne� fil� name.
� - Mas� delet� o� tagge� files�� Prompt� fo� approval� an� �
� o� � approv� deletio� whil� an� othe� characte� aborts�� I� Y� �
deletio� occur� withou� use� intervention�� I� V�� use� i� aske� �
t� approv� eac� deletio� befor� i� i� made.
:Movement Commands
<SP�� - Advanc� t� nex� fil� name�� Wraparoun� fro� las� t� �
firs� ma� occur.
� - Advanc� t� nex� fil� name� Sam� a� <SP>.
<BS� - Bac� u� t� las� fil� name�� Wraparoun� fro� firs� t� �
las� ma� occur.
� - Bac� u� t� las� fil� name� Sam� a� <BS>.
� - G� t� � file�� Use� t� quickl� jum� t� � specifi� file� �
Use� i� prompte� fo� � fil� name� an� wil� card� (� an� *� ma� b� �
used�� Use� i� positione� a� firs� fil� whic� matche� wil� card� �
i� found� use� i� positione� a� firs� fil� i� rin� i� no� found.
� - Jum� t� Nex� Scree� (i� any)� I� ther� i� mor� tha� on� �
scree� o� files�� th� use� i� advance� t� th� nex� screen� I� a� �
the last screen, wraparound occurs to the first.
- - Jum� t�
Las� Scree� (i� any)�� Simila� t� � bu� i� th� �
opposite direction. Wraparound to last screen may occur.
^Р- Mov� UP�� Mov� th� curso� t� th� fil� nam� directl� �
abov� th� curren� fil� name�� I� th� use� issue� thi� fro� th� �
firs� lin� o� th� screen�� th� curso� i� wrappe� aroun� t� th� �
botto� lin� o� th� screen.
^X� - Mov� DOWN�� Mov� th� curso� t� th� fil� nam� directl� �
belo�� th� curren� fil� name�� I� th� use� issue� thi� fro� th� �
botto� lin� o� th� screen�� th� curso� i� wrappe� aroun� t� th� �
firs� lin� o� th� screen.
^� - Mov� RIGHT�� Mov� th� curso� t� th� fil� nam� righ� o� �
th� curren� fil� name�� I� th� use� issue� thi� fro� th� right-�
mos� colum� o� th� screen�� th� curso� i� wrappe� aroun� t� th� �
left-most column and the NEXT line.
^Ӡ - Mov� LEFT�� Mov� th� curso� t� th� fil� nam� lef� o� �
th� curren� fil� name�� Wraparoun� simila� t� ^� bu� i� th� �
opposite direction.
Recommendations
Th� use� ha� th� abilit� t� specif� si�� othe� code� fo� �
movemen� (Fil� UP� DOWN� RIGHT� LEFT� an� Scree� RIGH� an� LEFT)� �
I� i� recommende� tha� th� Wor� Sta� conventio� b� use� fo� �
Scree� RIGHԠ an� LEF� fo� consistanc� (^A=LEFT�� ^F=RIGHT�� an� �
tha� th� arro� keys�� i� any� o� th� user'� termina� ar� use� fo� �
the other functions.
:Miscellaneous Commands
� - Toggl� Alph� Sort�� Thi� comman� reverse� th� sens� o� �
th� sor� o� th� curren� directory�� reload� th� directory�� an� �
refreshe� th� screen� havin� sorte� i� i� th� ne� sense� Sortin� �
is done by file name and type or by file type and name.
� - Invoke� externa� HEL� Information� VFILE� wil� chai� t� �
HEL� an� displa� th� informatio� i� VFILER.HLP� VFILE� check� t� �
se� i� HELР ca� b� foun� alon� pat� (externa� i� available� �
interna� i� externa� pat� i� no� available� an� doe� no� attemp� �
t� chai� i� HELP.CO� canno� b� found.
̠ - Logi� ne� D� are� fo� displa� an� rese� syste� fo� dis� �
changes� Forma� o� D� for� i� sam� a� 'C� fo� copy.
Ѡ - Refres� th� screen��� Th� curren� scree� wil� b� �
redisplayed.
� - Sta� o� requeste� drive� show� remainin� dis� storag� i� �
kilobytes and number of files in current directory.
� - Exi� t� Operatin� System.
� - Ru� an� ZCPR� Comman� Line�� Use� wil� b� prompte� fo� �
comman� line�� an� VFILE� wil� b� reentere� i� sam� D� are� a� �
whe� comman� wa� executed�� Comman� wil� execut� i� th� origina� �
D� area.
� o� � - Prin� Comman� Summar� (Shor� Hel� Information).