Oakland CPM Archive/oakcpm.iso/sigm/vol242/fip.lbr/FIP.DC3

Text File | 1986-02-10 | 14.3 KB | 358 lines


.PA
è.PO 6
..PA 2
.PN 2
.HE                                              SYSTEM REQUIREMENTS
.FO                                                                #











                       SYSTEM REQUIREMENTS
                       ______ ____________



FI╨á  versioεá 1.░á  run≤ oε ß Z8░ processo≥á unde≥á thσá Digita∞ ì
ResearcΦ CP/═ 2.▓ Operatinτ System«á  FI╨ versioε 1.░ i≤ designeΣ ì
fo≥á aεá 8░á columε consolσ devicσ anΣ a⌠ leas⌠ onσá disδá drive«  ì
Whilσá programminτ consideration≤ werσ madσ fo≥ CP/═á 2.x¼á therσ ì
may be User Number limitations for versions earlier than 2.2  .


.PA
è.HE                                                     INTRODUCTION
.FO                                                                #
..PA 3



                       INTRODUCTION TO FIP
                       ____________ __ ___



FI╨á i≤á ß use≥ orienteΣ disδ filσ handle≥ designeΣ fo≥ botΦá thσ ì
CP/═á beginne≥ anΣ thσ systeφ expert«á  FI╨ allow≤ thσá beginninτ ì
CP/═á use≥ t∩ cop∙ anΣ examinσ file≤ anΣ t∩á examinσá directorie≤ ì
easil∙á withou⌠á havinτ t∩ memorizσ operations«á  FI╨á give≤á thσ ì
systeφá exper⌠á thσ capabilit∙ t∩ perforφ higΦ speeΣá batcΦá filσ ì
transfer≤á automaticall∙ anΣ t∩ completel∙ examinσ disδá directoì
ries«á  FI╨ prompt≤ fo≥ al∞ use≥ responses¼ alway≤ show≤ yo⌡ wha⌠ ì
userúá anΣá wha⌠á drive≤á wil∞ bσá accessed¼á supplie≤á thσá use≥ ì
responsσ default≤ (whicΦ arσ invokeΣ b∙ typinτ <cr╛ t∩á prompts)¼ ì
anΣá ha≤á buil⌠ iε safet∙ featurσ -n∩ actioε oε file≤á wil∞á eve≥ ì
takσ placσ b∙ respondinτ t∩ an∙ promp⌠ witΦ ß <cr>.


Some of FIP's features:

*    allows file transfers across user# boundaries.
*áááádesigneΣá t∩á makσá backup≤ oµ harΣá disk≤á o≥á othe≥á largσ ì
ááááástoragσá device≤á usinτ smalle≥ storagσ device≤ automatiπá -ì
ááááá(wil∞á transfe≥ specifieΣ file≤ t∩ 'backupº flopp∙ unti∞á i⌠ ì
ááááái≤ ful∞ -theε wil∞ promp⌠ use≥ t∩ inser⌠ nex⌠ backu≡ floppy¼ ì
áááááetc.).
*    provides detailed disk(s) characteristic summaries.
*ááááprovide≤á ß detaileΣ disδ filσ summar∙ oµ an∙ file(s⌐ oε an∙ ì
áááááor all user#'s and the remaining free storage.
*ááááallow≤ an∙ tw∩ file≤ oε systeφ t∩ bσ compareΣ anΣ optionall∙ ì
áááááshows differences in hexadecimal-ascii format with location.
*ááááallow≤ an∙ filσ t∩ bσ inspecteΣ iε eithe≥á hexadecimal-asciΘ ì
áááááformat or ascii format.
*ááááaccept≤ wildcarΣ character≤ iε al∞ filename≤.
*ááááallow≤ changinτ filσ attribute≤ oε ß prompteΣ 'file-by-fileº ì
ááááánature or any specified set of files automatically.
*    allows printer logging of all file operations.
*    allows deleted directory entries to be displayed.
*áááámaximize≤ thσ availablσ memor∙ spacσ b∙ dynamicall∙ dividinτ ì
áááááal∞á oµ thσ availablσ memor∙ betweeε director∙á entrie≤á anΣ ì
áááááfilσ buffe≥ area≤ thereb∙ enablinτ higΦ speeΣ filσ transfer≤ ì
áááááanΣ compares.
*ááááFI╨á i≤ writteε iε ver∙ optimizeΣ Z8░ codσ allowinτá highes⌠ ì
áááááoperating speed and only requires 8 Kbytes storage.
*ááááallows wildcard inputs on file renaming -saving you time.
.PA
è..PA 4






*ááááfile transfer operations allow:
ááááá-ááááconfirmatioεá prompt≤á an∙ timσ ß filσ transfe≥á woulΣ ì
ááááááááááoverwritσáá aεáá existinτá filσáá anΣáá theεáá allowinτ ì
ááááááááááabort, skip, and renaming options.
ááááá-áááábulδ filσ transfers¼ witΦ o≥ withou⌠ prompting¼ witΦ o≥ ì
ááááááááááwithout verification.
ááááá-ááááalway≤á show≤á thσá amoun⌠ oµ spacσá eacΦá sourcσá filσ ì
áááááááááárequire≤á (usinτá destinatioε disδ blocksize⌐á anΣá thσ ì
ááááááááááamount of free space remaining on destination disk.
ááááá-ááááallow≤á changinτá destinatioε flopp∙ a⌠ an∙ timσá (eveε ì
ááááááááááduring bulk file transfers).
ááááá-ááááallow≤á changinτá destinatioε drivσ a⌠ an∙á timσá (eveε ì
ááááááááááduring bulk file transfers).
ááááá-ááááallow≤á filenamσ t∩ bσ changeΣ fo≥ destinatioε cop∙á a⌠ ì
ááááááááááany time.
.PA
è..PA 5
.HE                                        DEFINITIONS & TERMINOLOGY
.FO                                                                #


                    DEFINITIONS & TERMINOLOGY
                    ___________ _ ___________



[]   indicates that the enclosed entry is optional.
<>   indicates data that is entered by user.
{}   indicates that the user has a choice between two or more
     entries (entries will be separated with a vertical bar).
     At least one of the entries enclosed in braces must be
     chosen unless the entries are also enclosed in square
     brackets.
|    separates choices within braces. At least one of the entries
     mus⌠á bσá choseεá unles≤ thσ entrie≤ arσá als∩á encloseΣá iε
     square brackets.



d:   represents drive spec, range A through P, lowercase and
     uppercase are accepted.
fn   represents the primary filename (1 to 8 alphanumeric characters).
ft   represents optional filetype (0 to 3 alphanumeric characters
     separated from the filename by a period.
¬á    wildcarΣá -replace≤á al∞á o≥á par⌠á oµá ßá filenamσá and/o≥
      filetype.
┐    wildcarΣá -replace≤á an∙á singlσá characte≥á iεá thσá samσ
     position.

fn[.ft]        filename
[d:]fn[.ft]    filespec

ambiguou≤á filespeπ -contain≤ onσ o≥ morσ wildcarΣ character≤ iε ì
     the filename and/or filetype.
unambiguous filespec -contains no wildcard characters.

 fεá anΣá f⌠á ma∙á no⌠á contaiε an∙á oµá thσá special characters
<>.,;:=[]



R/W  means Read-Write.
R/O  means Read-Only.
SYS  means System attribute.
DIR  means Directory attribute.



<cr> indicates a carriage return keystroke.
^S   control-S will halt display output until ^Q is typed.
^Q   control-Q will cause display output to continue.

.PA
è..PA 6
.HE                                                     INVOKING FIP
.FO                                                                #


                          INVOKING FIP
                          ________ ___



There are 2 methods in which to invoke FIP:


METHOD #1:     FIP {< >|<d:>}<cr>
     examples:      FIP  <cr>  áFI╨á wil∞ returε thσ statu≤ oµá al∞
                    _____ì
ááááááááááááááááááááááááá  áááááfiles on currently logged in drive.
                    FIP C:<cr>  FI╨  wil∞ returε thσ statu≤ oµá al∞
                    ______ì
áááááááááááááááááááááááááá  ááááfile≤ oε drivσ C:

áááááThσá statu≤ oµ al∞ file≤ oε specifieΣ disδ wil∞ bσ displayeΣ ì
áááááanΣ THE╬ FI╨ WIL╠ RETUR╬ T╧ SYSTE═ COMMAN─ LEVEL.

áááááThσ use≥ number¼á recorΣ count¼á byte≤ used¼á thσ numbe≥á oµ ì
áááááextents¼áá thσá R/╫á status¼áá drivσá spec¼áá filename¼á anΣ ì
áááááindicatioε oµ SY╙ attributσ wil∞ bσ displayeΣ fo≥ eacΦ file¼ ì
áááááanΣ thσ numbe≥ oµ byte≤ remaininτ oε specifieΣ drivσ wil∞ bσ ì
áááááshown.
áááááThi≤á i≤á thσ samσ displa∙ a≤ woulΣ bσ generateΣ unde≥á Men⌡ ì
áááááSelectioε #3¼á witΦ filespeπ se⌠ t∩ *.*¼á witΦ suΓ selectioε ì
áááááoµá ┴ -excep⌠ tha⌠ use≥ wil∞ bσ returneΣ t∩á Systeφá CommanΣ ì
áááááLeve∞ a⌠ enΣ oµ displa∙ insteaΣ oµ stayinτ withiε FIP.

                       -------------------

METHOD #2:ááááááááááFIP<cr>ááwith no command line arguments.
                    ___

áááááThσ copyrigh⌠ noticσ anΣ Maiε Men⌡ wil∞ bσá displayed¼á theε ì
áááááFI╨ wil∞ wai⌠ fo≥ you≥ optioε selection.

     Thσá men⌡ choice≤ arσ showε belo≈ anΣ arσ explaineΣá iεá thσ ì
áááááfollowing pages:


      1> Directory List        7> Compare Files
      2> Transfer File(s)      8> Rename File(s)
      3> Status -File(s)       9> Delete File(s)
      4> Status -Disk(s)      10> Change File Attributes
      5> Type File            11> Change User(s)
      6> Dump File            12> Printer Echo
                13> Exit to CP/M
     Choose ->_

     Thσ curso≥ i≤ representeΣ witΦ aε underscore«á Responsσ mus⌠ ì
ááááábσ [n]<cr╛ wherσ ε i≤ ß valiΣ onσ o≥ tw∩ digi⌠ optioε numbe≥ ì
áááááentereΣá witΦ n∩ space≤ anΣ followeΣ witΦ <cr>«á ┴ non-valiΣ ì
áááááresponsσá wil∞ returε yo⌡ t∩ thσ Maiε Menu«á  N╧ actioε wil∞ ì
áááááeve≥ takσ placσ oε you≥ file≤ if¼ afte≥ choosinτ an∙ option¼ ì
áááááyo⌡ theε responΣ t∩ al∞ prompt≤ witΦ <cr╛ only.
.PA
è..PA 7
.HE                                                  OPERATING NOTES
.FO                                                                #


                         OPERATING NOTES
                         _________ _____


NOTE #1 **á underlineΣá tex⌠á iεá thσ example≤á i≤á thσá datßá a≤ ì
áááááentereΣá b∙ thσ use≥ anΣ italicizeΣ tex⌠ i≤ datß printeΣá b∙ ì
áááááFIP«á  Thσ underscorσ characte≥ ▀ useΣ alonσ wil∞á represen⌠ ì
áááááthσ positioε oµ thσ cursor.

NOTE #▓ *¬  Yo⌡ ma∙ returε t∩ thσ Maiε Men⌡ a⌠ an∙ timσ b∙ typinτ ì
ááááá╤ afte≥ an∙ promp⌠ excep⌠ wherσ ß filenamσ i≤ expecteΣ (╤ i≤ ì
áááááß valiΣ filename).

NOTE #3 **  You may respond to prompts using uppercase or lowercase.

NOTE #┤ *¬  á Yo⌡á ma∙á abor⌠á FI╨ a⌠ an∙á timσá b∙á enterinτá ^├ ì
ááááá(control-C⌐á a≤ thσ firs⌠ characte≥ oµ an∙ response«á Iµ yo⌡ ì
áááááusσá optioε #13¼á FI╨ wil∞ returε yo⌡ t∩ thσ CP/═ systeφá iε ì
áááááthσ statσ tha⌠ yo⌡ existeΣ a⌠ thσ timσ yo⌡ invokeΣ FIP.

NOTE #╡á*¬á Unles≤á otherwisσ noted¼á wheε FI╨ promp⌠s:

áááááFile ? _       enter [[d:][fn][.ft]]<cr>     default is *.*

áááááThi≤á entr∙ wil∞ tel∞ FI╨ wha⌠ file(s⌐ o≥ rangσ oµ file≤á t∩ ì
ááááálooδá for«á  You≥ responsσ ma∙ takσ an∙ forφ a≤ showεá afte≥ ì
áááááente≥á above«á  Iµ onl∙ <cr╛ i≤ entereΣ thσ defaul⌠ [source▌ ì
ááááádrivσ a≤ listeΣ wil∞ bσ useΣ anΣ thσ filenamσ accepteΣá wil∞ ì
ááááábσá *.¬á (ßá reques⌠ fo≥ al∞ file≤ oε thσá defaul⌠á [source▌ ì
ááááádrive)«á  Iµ ß drivσ speπ i≤ entereΣ i⌠ wil∞ becomσ thσá ne≈ ì
ááááádefaul⌠á sourcσ disδ fo≥ FIP«á  Iµ thσ drivσ speπ i≤ omitteΣ ì
áááááthσá listeΣá defaul⌠á [source▌á drivσá wil∞á bσá used«á  Thσ ì
áááááfilespeπá ma∙á bσ ambiguou≤ o≥ unambiguous«á  Iµ aεá illega∞ ì
áááááfilespeπ i≤ entered¼á FI╨ wil∞ responΣ witΦ ß questioεá marδ ì
áááááoε thσ nex⌠ linσ anΣ theε repromp⌠ witΦ Filσ ┐ ▀ Æ .
Examples:

File ? B:<cr>            equivalent to B:*.*<cr>.
       ______
Fileá?áC:A*.B*<cr>      áwoulΣ returε al∞ file≤ oε drivσ C║á tha⌠
       ___________ì
ááááááááááááááááááááááááábegaεá witΦá ┴ fo≥ thσ primar∙á filenamσ ì
áááááááááááááááááááááááááanΣ begaε witΦ ┬ fo≥ thσ filetype.
Fileá?áAB??C*.<cr>     ááwoulΣ returε al∞ file≤ oε defaul⌠ drivσ
       ___________ì
áááááááááááááááááááááááááwhoosσá 1s⌠ tw∩ letter≤ werσ A┬ anΣá thσ ì
ááááááááááááááááááááááááá5tΦá lette≥á ß ├ anΣ witΦ filetypσ oµá │ ì
áááááááááááááááááááááááááblanks.

NOTE #6 **  Wheεá processinτ oµ ß Men⌡ Optioε ha≤ beeε completed¼  ì
áááááFI╨ wil∞ prompt:

áááááDone _              on options 1,3, & 4
áááááNo more files _     on options 2,8,9, & 10
ááááá_                   on options 5,6, & 7

ááááá          enter [{n|M}]<cr>   default is Main Menu
è..PA 8

áááááYou≥ responsσ ma∙ takσ onσ oµ thσ form≤ a≤ showε afte≥ ente≥ ì
áááááabove«á  ε represent≤ ß valiΣ onσ o≥ tw∩ digi⌠ optioε numbe≥ ì
áááááentereΣ witΦ n∩ space≤ anΣ followeΣ witΦ <cr>«  ═ mean≤ Morσ ì
áááááoµá thσ samσ option«á  Thesσ arσ allowablσ response≤ a⌠á thσ ì
áááááenΣ oµ mos⌠ ever∙ option«á Iµ ═ i≤ entereΣ anΣ followeΣ witΦ ì
ááááá<cr╛á thσ Maiε Men⌡ wil∞ bσ bypasseΣ anΣ yo⌡ wil∞á star⌠á a⌠ ì
áááááthσá beginninτá oµá thσ curren⌠ optioεá yo⌡á arσá using«á Iµ ì
áááááanothe≥ optioε numbe≥ i≤ entereΣ yo⌡ wil∞ immmediatel∙ ente≥ ì
ááááátha⌠á option¼á bypassinτá thσ Maiε Menu«á  Iµ onl∙á <cr╛á i≤ ì
áááááentereΣá yo⌡ wil∞ bσ returneΣ t∩ thσ Maiε Menu«á  Aε invaliΣ  ì
áááááresponsσ wil∞ returε yo⌡ t∩ thσ Maiε Menu.
Examples:
Done 9<cr>               would send you to option #9
     _____
ááááááááááááááááááááááááábypassing the Main Menu.
DONE <cr>           áááááwould send you to the Main Menu.
     ____
Done M<cr>               woulΣá senΣá yo⌡á t∩á thσá beginninτá oµ
     _____áááááááááááááááááááááááááì
ááááááááááááááááááááááááácurren⌠ optioε (restar⌠ option)«

NOTE #╖ *¬  Iµ thσ listinτ proces≤ i≤ stoppeΣ b∙ depressinτ ß ke∙ ì
ááááá(othe≥ thaε ^S)¼ FI╨ wil∞ takσ thσ nex⌠ inpu⌠ a≤ showε abovσ ì
áááááafte≥ áááááDonσ _Æ,
áááááabortinτ thσ curren⌠ operatioε anΣ allowinτ thσ Maiε Men⌡ t∩ ì
ááááábσ bypassed«

NOTE #╕ *¬   Wheε invoked¼á  FI╨ wil∞ se⌠ thσ defaul⌠ Sourcσ Disδ ì
ááááá[Drive▌á (als∩á referreΣá t∩ a≤ Drivσá 1⌐á anΣá thσá defaul⌠ ì
áááááDestinatioεá Disδ [Drive▌ (als∩ referrreΣ t∩ a≤ Drivσ 2⌐á t∩ ì
áááááthσá currentl∙á loggeΣ drivσ iε effec⌠ a⌠ thσ timσá FI╨á wa≤ ì
áááááinvoked«á  Wheε invoked¼á  FI╨ wil∞ als∩ se⌠ thσ Sourcσ Use≥ ì
ááááánumbe≥á anΣá thσ Destinatioε Use≥ numbe≥ equa∞ t∩á thσá use≥ ì
ááááánumbe≥ tha⌠ wa≤ iε effec⌠ a⌠ thσ timσ FI╨ wa≤ invokeΣ makinτ ì
áááááthσá use≥á numbe≥á consideratioε iε option≤ ▒ througΦá 1░á ß ì
ááááátransparent concern until option 11 is selected«

NOTE #╣ *¬  Wheε iε doub⌠ oε an∙ response¼á ente≥ onl∙ <cr>«á  N╧ ì
áááááactioε wil∞ eve≥ takσ placσ oε you≥ file≤ if¼ afte≥ choosinτ ì
áááááan∙ option¼ yo⌡ theε responΣ t∩ al∞ prompt≤ witΦ <cr╛ only.

.PA
è..PA 8
.HE                                        OPTION 1 - DIRECTORY LIST
.FO                                                                #






                    OPTION #1 - DIRECTORY LIST
                    ______ __   _________ ____




Thi≤á optioεá wil∞ givσ yo⌡ ß director∙ listinτ unde≥ thσá Sourcσ ì
Use≥ (seσ optioε #11⌐ anΣ oε specifieΣ o≥ defaul⌠ drivσ oµ speciì
fieΣá o≥ defaul⌠ (all⌐ file≤ iε alphabetica∞ order«á Thσá file(s⌐ ì
wil∞á bσá listeΣ whethe≥ o≥ no⌠ the∙ havσá thσá systeφá attributσ ì
attacheΣ t∩ them«  Aε asterisδ wil∞ bσ printeΣ afte≥ thσ filetypσ ì
iµ thσ filσ ha≤ thσ systeφ attributσ attacheΣ t∩ it.

Upon entry to this option FIP will print:

                   ** Directory **
User║  ε                                       Defaul⌠ Drivσ = d:

Thσá curren⌠ sourcσ use≥ numbe≥ (░ t∩ 31⌐ i≤ wherσ thσá director∙ ì
wil∞á bσ takeε froφ (thi≤ ma∙ bσ changeΣ usinτ optioεá #11)«á Thσ ì
prompt for the filespec will then appear:

File ? _       enter [[d:][fn][.ft]]<cr>     default is *.*

a≤ describeΣ iε Operatinτ Notσ #5«á  Thσ drivσ speπ tha⌠ wa≤ useΣ ì
t∩ finΣ thσ file≤ wil∞ bσ printeΣ iε thσ beginninτ oµ eacΦ ro≈ oµ ì
thσ director∙ listing.

If no file could be found FIP will print:

d:  NO FILE

and you will be returned to the Main Menu.

After the files are listed FIP will print:

Done _         enter [{n|M}]<cr>   default is Main Menu

as described in Operating Note #6.