VFILER    VFILER Overview, Revision 3
Install   Installing VFILER
Commands  VFILER Command Summary
DIR       The DIR Form
User      User Functions:           0-9   #
Tagging   Tagging Commands:         T  U  GT GU
Display   File Display Commands:    P  V
Ops       File Operations Commands: C  D  F  GC GD GF R
Movement  Movement Commands:        Arrows   +  -  J  Q
Misc      Miscellaneous Commands:   A  H  N  S  Z  ^C ?
:VFILER 3.x Overview
       VFILEҠ (fo� Vide� FILER)�� derive� fro� FILER�� wa�    Overview�
create䠠 t� giv� th� ZCPR�� use� ᠠ specialize䠠 fil� �
manipulatio� utilit�� whic� coul� tak� advantag� o� th� �
specia� feature� o� ZCPR3��  I� perform� th� sam� basi� �
function� a� DISK7�� CLEANUP�� WASH� an� SWEEP� bu� i� take� �
th� ZCPR�� environmen� 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� ZCPR3-specifi� feature� 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.
                                                               Overview
       VFILE� i� invoke� b� � comman� lin� o� th� followin� �
form:
               VFILER dir:filename.typ

wher� al� parameter� ar� optional��  "DIR� i� th� director� �
t� initiall�� lo� th� use� into�� an� i� ma� b� an�� ZCPR� �
director� reference�� suc� a� � mnemoni� (lik� "ROOT:"� o� � �
Dՠ for� (lik� "B7:�� o� "12:")��  "filename.typ�� i� a� �
ambiguou� fil� nam� whic� i� use� t� perfor� a� initia� �
selectio� o� th� file� t� b� displaye� b� VFILER.

    Th� referenc� fo� th� ambiguou� fil� nam� i� store� i� �
Syste� Fil� 4�� and�� a� such� ca� b� dynamicall� change� b� �
usin� th� SETFIL� comman� durin� th� executio� o� VFILER�  �
I� � ZCPR� comman� lik� "SETFIL� � afn� i� execute� whil� �
VFILEҠ i� running�� the� th� definitio� o� thi� ambiguou� �
fil� referenc� i� changed� an� th� nex� tim� VFILE� restart� �
executio� th� ne� ambiguou� fil� referenc� i� i� effect� an� �
th� file� ar� selecte� accordingly.
                                                               Overview
    Thi� HL� Fil� applie� t� VFILE� 3.0��  VFILE� 3.�� wil� �
onl�� ru� unde� ZCPR� unles� th� Environmen� Descripto� i� �
mad� interna� t� VFILER�� i� whic� cas� VFILE� wil� b� 1/4� �
larger.

    Ther� ar� som� customizatio� equate� a� th� fron� o� �
th� VFILER.MA� sourc� file��  Th� use� wil� generall�� no� �
car� abou� touchin� these�� bu� the� ar� availabl� i� h� s� �
desires��  Fee� fre� t� examin� them��  On� suc� equat� �
enable� o� disable� th� built-i� documentatio� (help� �
feature��  I� thi� featur� i� disabled�� an� hel� referenc� �
wil� chai� t� thi� HL� fil� (VFILER.HLP� an� VFILER.CO� wil� �
b� abou� 1� shorter��  I� enabled� th� convenienc� o� onlin� �
hel� whic� i� acces�ed quickl� i� available.

    Enjoy using VFILER!

         Rick Conn

:Installing VFILER
                                                               Install
    Installatio o� VFILEҠ i� quit� simple��� a� i� �
installatio� o� th� variou� utilitie� unde� ZCPR3��  Al� �
VFILE� require� i� th� wa� o� installatio� i� tha� � pointe� �
t� th� ZCPR�� Environmen� Descripto� b� provide� t� i� �
(unles� VFILE� ha� bee� assemble� t� contai� a� Environmen� �
Descriptor�� i� whic� cas� th� entir� Environmen� Descripto� �
is necessary).

    Z3INӠ ca� b� use� t� instal� VFILER��  T� d� this� �
creat� a� IN� fil� (cal� i� VF.INS� containin� th� nam� o� �
th� VFILER.CO� fil� o� on� line��  Assumin� tha� you� syste� �
Environmen� Descripto� fil� i� name� SYS.ENV�� issu� th� �
command:

         Z3INS SYS.ENV VF.INS

    VFILER is now installed.

:VFILER Command Summary
                                                               Summary


-- Tagging Commands --    --------- File Operations -----------
� - Ta� Fil�              � - Cop� Fil�       � - Delet� File
U - Untag File            F - File Size       R - Rename File
                         G - Group Copy/Delete/FSize/Tag/Untag

                 -- File Print & View --   --- User  Functions ---
 -- Cursor --    P - Print      V - View   0-9 - Execute  # - Help
      ^E
       ^         -- Movement Commands --   ---- Miscellaneous ----
  ^S <-+-> ^D     <SP> - File Forward       A - Toggle Alpha Sort
       v          <BS> - File Backward      H - Help File �       ^X           +   - Screen Forward     N - New DIR
                   -   - Screen Backward    S - Disk Status
 -- Screen --      J   - Jump t� � Fil�     Z - ZCPR3 Command
   ^A  Left        Q   - Refresh Screen    ^C - Exit
   ^F  Right

                                                               Summary
    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� user'� Z3TCA� entr� ma� defin� fou� 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� mov� betwee� them.
:The DIR Form
                                                               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� accepte� ZCPR� DI� for� i� respons� t� this.

    Th� ZCPR�� DIҠ for� ma� b� eithe� � Dՠ (Disk/User� �
specificatio� o� � director� nam� (mnemonic)��  Example� o� �
DI� form� 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��  I� � DI� for� i� reference� i� th� VFILE� �
command line, it MUST be followed by a colon.

:User Functions
                                                               User Fcts
    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�  Th� basi� ide� i� this:

         1� th� use� create� � fil� calle� VFILER.CMD� thi� �
fil� contain� hi� extende� comman� set

         2�� VFILER.CM� i� place� alon� th� user'� comman� �
searc� path

         3�� whe� th� use� i� i� VFILE� an� h� strike� � �
digi� o� � poun� sig� (#� fo� help�� VFILE� searche� alon� ��th� pat� fo� th� firs� VFILER.CM� fil� i� find� an� extract� �
th� informatio� fro� it

                                                               User Fcts
    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��  Fo� instance� A� coul� contai� 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� hi� �
syste� command� i� 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� Comman� Lin� Buffe� �
feature�� execute� th� comman� lin� generated�� an� returns�  �
VFILER is a true shell under ZCPR3.
                                                               User Fcts
    Th� structur� o� VFILER.CM� i� quit� simple�  I� ca� b� �
create� b�� an� CP/� tex� editor�� an� i� consist� o� th� �
followin� type� o� lines:

         1� � comman� line� whic� begin� wit� � digi� (0-9� �
an� contain� th� tex� o� th� comman� t� b� execute� shoul� �
tha� digi� b� type� b� th� user

         2�� � hel� block�� whic� i� printe� wheneve� th� �
use� type� � poun� sig� (#)� thi� bloc� i� denote� b� � lin� �
whic� begin� wit� � poun� sign� an� i� extend� t� th� en� o� �
th� file

         3�� � commen� line��� whic� i� use� t� embe� �
explanator� comments�� whic� ar� fo� referenc� purpose� onl� �
an� no� see� b� th� VFILE� user

COMMAND LINE                                                    User Fcts

    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.
                                                               User Fcts
    1 copy 'Source File? ' 'Destination Dir? '

I� th� use� respond� wit� "myfile.txt� an� "C0:"�� the� th� �
comman� line

         copy myfile.txt C0:

i� built�  Not� tha� space� an� othe� character� betwee� th� �
prompt� ar� significant.

    1 mcopy 'Dest Dir? '='Source File? '

will generate (to the same inputs)

         mcopy C0:=myfile.txt

PASSED PARAMETERS                                               User Fcts

    Thre� parameter� ma� b� passe� fro� VFILEҠ int� th� �
comman� lin� bein� generated��  Thes� parameter� an� thei� �
symbol� 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� lin� h� i� building�� '%%� place� on� '%� int� th� �
line�  Example:

         echo Disk is %d, User is %u, File is %f

print� (i� th� use� i� i� A1� an� ptin� t� MYFILE.TXT):

         Disk is A, User is 15, File is MYFILE.TXT
HELP BLOCK                                                      User Fcts

    Th� Hel� Bloc� i� th� VFILER.CM� fil� i� simpl� � bloc� �
o� tex� whic� extend� fro� th� poun� sig� (#� 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� lin� th� asteris� i� on�� doe� no� �
excee� 2� lines�  Example:

#  Help for Word Processing

    1 - Run WordStar
    2 - Run WordMaster
    3 - Run ROFF4

COMMENT LINE                                                    User Fcts

    �� commen� lin� i� an� lin� whic� doe� no� begi� wit� � �
digi� o� � poun� sign��  Th� tex� o� tha� lin� i� th� �
comment�  I� i� no� displaye� t� th� VFILE� use� an� i� use� �
onl�� fo� referenc� t� th� perso� wh� wrot� th� VFILER.CM� �
file�  Example:

! This is a comment
This is also a comment

RUNNING ZEX                                                    User Fcts

    Lik� al� standar� ZCPR� Shells�� VFILEҠ i� abl� t� �
suppor� th� executio� o� th� th� ZE� comman� fil� processo� �
o� to� o� itself��  I� ZE� i� running�� VFILE� wil� simpl� �
promp� ZE� fo� inpu� rathe� tha� enterin� it� norma� screen-�
oriente� displa� mode�  I� thi� way� � comman� execute� fro� �
th� VFILER.CMĠ fil� ma� invok� ZEX�� an� al� o� th� ZE� �
comman� fil� processin� wil� b� performe� befor� VFILEҠ i� �
reentered.

SAMPLE VFILER.CMD                                               User Fcts

!  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
                                                               Tagging
    � - 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��  � 't� marke� i� place� �
b� th� tagge� filenam� a� � reminde� th� fil� i� tagge� fo� �
mas� cop� o� mas� delete.

    ՠ - 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� 'N� als� untag� al� �
files.

    � � o� � - Grou� (Mass� Ta� o� Untag�  Use� i� prompte� �
fo� th� operation�� an� tw� o� hi� option� ar� � an� U��  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� � � �
(Grou� Fil� Size� comman� ma� b� issued.

:File Display Commands
                                                               Display
    � - Prin� tex� fil� t� CP/� 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.

    Detail� o� CR� an� Printe� size� (numbe� o� line� o� �
screen�� numbe� o� line� o� printer�� etc� ar� derive� fro� �
th� ZCPR� Environmen� Descripto� an� nee� no� b� o� concer� �
t� th� user��  Th� comman� CPSE� ca� b� use� t� selec� th� �
CRԠ� o� Printe� characteristic� fro� th堠 Environmen� �
Descripto� a� desired. �
:File Operations Commands
                                                               Operations
    à - 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� t
h� destinatio� dis� �
befor� attemptin� � copy.

    � - Delet� fil� fro� disk� prompt� fo� certainty.

    Ơ - Fil� siz� i� kilobytes�� rounde� u� t� nex� dis� �
allocatio� block.

                                                               Operations
    � - Invok� Grou� (Mass� command��  Th� thre� option� o� �
interes� her� ar� � (Cop� al� Tagge� Files)�� � (Delet� al� �
Tagge� Files)� an� � (Fil� Siz� o� al� Tagge� Files).

         Ǡ à - Grou� 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� command�  Grou� cop� �
functio� ca� b� repeate� withou� re-taggin� files.

         �  � - Grou� 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.

         Ǡ � - Grou� fil� siz� summary��  Add� u� th� fil� �
sizes of all tagged files and displays this sum.

                                                               Operations
    � - Renam� fil� o� curren� drive�  Onl� CP/� conventio� �
name� permitted��  Wil� card� ar� no� permitted��  Use� i� �
prompte� fo� ne� fil� name.

:Movement Commands
                                                               Movement
    <SP� - Advanc� t� nex� fil� name�  Wraparoun� fro� las� �
t� firs� ma� occur��  Th� Wor� Sta� ^� characte� o� you� �
righ� arro�� ke� (i� availabl� i� th� Z3TCAP�� perfor� th� �
same function.

    <BS�� - Bac� u� t� las� fil� name��  Wraparoun� fro� �
firs� t� las� ma� occur�  Th� Wor� Sta� ^� characte� o� you� �
lef� arro� ke� (i� availabl� i� th� Z3TCAP� perfor� th� sam� �
function.

    � - Jum� 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.

    Ѡ - Refres� th� screen��  Th� curren� scree� wil� b� �
redisplayed.

                                                               Movement
    �� - 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� t� Nex� Scree� (i� any)��  I� ther� i� mor� �
tha� on� scree� o� files�� th� use� i� advance� t� th� nex� �
screen��  I� a� th� las� screen�� wraparoun� occur� t� th� �
first��  ^� als� perform� thi� functio� i� no� overridde� b� �
arro� keys.

    - - Jum� t� Las� Scree� (i� any)��  Simila� t� � bu� i� �
th� opposit� direction��  Wraparoun� t� las� scree� ma� �
occur��  ^� als� perform� thi� functio� i� no� overridde� b� �
arro� keys.

    Wor� Sta� arro� ke� movemen� (i� no� override� b� arro� �
keys in Z3TCAP):
                            ^E
                             ^
                        ^S <-+-> ^D
                             v
                            ^X

:Miscellaneous Commands
                                                               Misc
    � - 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� i� don� b� fil� nam� an� typ� o� b� fil� typ� an� �
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.

                                                               Misc
    Ӡ - Statu� o� requeste� drive�� show� remainin� dis� �
storag堠 i� kilobyte� an� numbe� o� file� i� curren� �
directory.

    � - 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 as indicated by the prompt.

    ^C - Exit to Operating System.

    �� o� �� - Prin� Comman� Summar�� (Shor� Hel� Info)�  �
VFILEҠ ma� b� assemble� t� omi� built-i� help�� creatin� � �
VFILEҠ whic� i� abou� 1� shorte� tha� � VFILEҠ wit� th� �
built-i� help��  I� th� built-i� hel� i� omitted�� thes� �
command� chai� t� th� VFILER.HL� fil� instead.