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 accesed 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 - File Forward A - Toggle Alpha Sort v - 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 ^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.