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).