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.