Oakland CPM Archive/oakcpm.iso/sigm/vol250/mdcs.tut

Text File | 1986-02-11 | 25.8 KB | 473 lines

..áááá----!---!---!---!---!---!---!---!---!---!---!---!---!---!---!---!---!-


.po 0
.he                     --- MASTER DISK CATALOGUING SYSTEM ---
.FO     5 January 1985                                                 Page #
                                 INTRODUCTION

áááá    Thσá Maste≥á Disδ Cataloguinτ Systeφ writteε b∙á WarΣá Christenseε ì
áááágreatl∙á simplifie≤á thσ tasδ oµ findinτ specifiπ file≤á withiεá largσ ì
áááálibrarie≤á containinτ eveε hundred≤ oµ diskettes«á Iε additioε t∩ it'≤ ì
áááánorma∞ use¼á man∙ option≤ havσ beeε incorporateΣ allowinτ creatioεá oµ ì
áááásubmi⌠á file≤á fo≥ pe≥forminτ task≤ upoε all¼á specific¼á o≥á specifiπ ì
áááácategorie≤á oµ files«á  Thσ cataloguinτ systeφ i≤ availablσá froφá thσ ì
ááááSIG/═á anΣ CMU╟ use≥ domaiε librarie≤ wherσ thσ onl∙ charge≤ arσ miniì
ááááma∞ maintenancσ fees.


                                   OVERVIEW

áááá    Thi≤á tutoria∞á begin≤á b∙ listinτ thσá file≤á whicΦá comprisσá thσ ì
áááácataloguinτá systeφ witΦ referencσ t∩ thσ use≥ domaiε librar∙á volume≤ ì
áááácontaininτá them«á  Next¼á ß ste≡ b∙ ste≡ procedurσ fo≥á creatinτá anΣ ì
ááááusinτá ßá cataloτ oµ diskette≤ i≤ presented«á  Becausσ thi≤á procedurσ ì
áááágive≤á thσá minimuφ fo≥ basiπ usσ oµ thσ systeφ i⌠ i≤á followeΣá b∙á ß ì
áááádetaileΣá descriptioε oµ eacΦ filσ anΣ it'≤ options«á  Thσ tutoria∞á i≤ ì
áááátheεá concludeΣ witΦ ß summar∙ oµ othe≥ program≤ which¼á althougΦá no⌠ ì
áááápar⌠á oµ thσ cataloguinτ system¼á havσ proveε t∩ bσ oµ valuσ wheε useΣ ì
ááááwitΦ thσ system.


                                 SYSTEM FILES

áááá    Thσ file≤ listeΣ herσ arσ thσ mos⌠ curren⌠ version≤ a≤ oµ thσ timσ ì
ááááoµá thi≤á printing«á  Thesσá file≤ havσ gonσá througΦá man∙á revision≤ ì
áááácausinτá variou≤á version≤á t∩á appea≥ throughou⌠á thσá publiπá domaiε ì
áááálibrarie≤ anΣ wa≤ oncσ distributeΣ commerciall∙ b∙ Elliaφá Associates«  ì
ááááThσá commercia∞á versioε wa≤ throwε togethe≥ poorl∙ resultinτá iεá thσ ì
áááásysteφá functioninτ improperly«á  I⌠ is¼á therefore¼á no⌠ recommended«  ì
ááááThσ variou≤ version≤ availablσ froφ thσ publiπ domaiε librarie≤á offe≥ ì
áááádifferen⌠á option≤á bu⌠ ma∙ no⌠ bσ compatiblσ witΦá onσá another«á  B∙ ì
ááááusinτá thσ version≤ listeΣ hereiε compatibilit∙ caε bσ ensureΣ witΦá ß ì
ááááricΦ assortmen⌠ oµ options«  Thσ file≤ listeΣ belo≈ arσ thosσ requireΣ ì
ááááfor minimal use of the cataloguing system.

áááá    Filename        Version         Source      Notes
áááá    FMAP.CO═á       2.3(12/07/81⌐á SIG/═.07▓    ;multiple drive system
áááá    NEWQCAT.ASM        (02/04/81)  SIG/M.070    ;single drive system
áááá    CAT.COM            (02/02/80)  SIG/M.052
áááá    UCAT.COM                       SIG/M.052

áááá    NEWQCAT¼ oncσ assembleΣ usinτ MAC¼á perform≤ thσ samσ functioεá a≤ ì
ááááFMA╨á oε system≤ havinτ onl∙ onσ disδ drivσ bu⌠ doe≤ no⌠ allo≈ an∙á oµ ì
ááááthe options that FMAP does.  Only one of the two files is required.
    Iεá additioεá t∩á thσ file≤á abovσ ßá tex⌠á edito≥á o≥áworΣ processor,ì
áááái.e. ED or WORDSTAR, is required.
.paè                               CONVENTIONS USED

áááá    The following conventions are used throughout this document:

ááá     Symbol      Meaning
áá      d:          disk drive (any drive A: through P:)
ááá     fn.ft       filename.filetype (like CP/M)
ááá     dn.d#       diskname.disknumber (like filename.filetype)
áá      opt         option (a single letter)
ááá     .sopt       suboption (. followed by a single letter)
áá      nn          two digit number (nnn = three digit number)
        #           numbers generated by the system


                    CREATING AND USING A DISKETTE CATALOG

áááá    Onl∙á basiπá usσ oµ thσ cataloguinτ systeφ i≤á giveεá here«á  Thi≤ ì
ááááinclude≤á creatioεá oµá thσ cataloτ itselµ anΣ usσ oµ i⌠ t∩á vie≈á thσ ì
ááááentirσ cataloτ iε sequencσ o≥ looδ u≡ ß specifiπ file«á  Othe≥ option≤ ì
ááááexis⌠á whicΦá wil∞ bσ covereΣ late≥ wheε dealinτ witΦá thσá individua∞ ì
ááááprograms in detail.
áááá    T∩ usσ thσ systeφ eacΦ diskette¼á fo≥ identificatioε purposes¼á i≤ ì
ááááassigneΣá ßá uniquσ namσ (u≡ t∩ ß maximuφ oµ seveε characters⌐á anΣá ß ì
ááááthreσ digi⌠ number«á  Thσ diskettσ namσ i≤ precedeΣ b∙ ß - anΣ storeΣ ì
ááááa≤á ßá filenamσ oε thσ diskettσ usinτ thσ forma⌠á -dn.d#«á  ┴á prograφ ì
áááánameΣá FMAP¼á o≥á NEWQCA╘ fo≥ singlσ drivσá systems¼á wil∞á reaΣá thi≤ ì
áááádiskettσ name/number¼á alonτ witΦ al∞ filename≤ oε thσ diskette¼á froφ ì
ááááthσá director∙á anΣá storσá theφá iεá ßá temporar∙á ASCI╔á filσá nameΣ ì
ááááNAMES.SUB«  ┴ seconΣ program¼ UCAT¼ wil∞ theε mergσ NAMES.SU┬ int∩ thσ ì
áááácataloτ filσ calleΣ MAST.CA╘ anΣ deletσ NAMES.SUB«  Thσ thirΣ program¼ ì
ááááCAT¼á ma∙ theε acces≤ datß withiε thσ cataloτ file«á T∩ creatσ anΣ usσ ì
ááááthe catalog proceed as follows:

ááá     NOTE║á Wheε ß ste≡ i≤ divideΣ int∩ tw∩ parts¼á (A⌐ anΣ (B)¼ follo≈ ì
ááááááááthσ direction≤ listeΣ unde≥ (A⌐ fo≥ singlσ drivσ system≤ o≥á thosσ ì
ááááááááunde≥  (B⌐ fo≥ multiplσ drivσ systems.

áááááááá1«á EstablisΦ ß disδ namσ anΣ numbe≥ fo≥ eacΦ diskettσ t∩ bσ cataì
áááááááálogueΣá anΣá storσ theφ a≤ ß zer∩ lengtΦ filσ oεá thσá appropriatσ ì
áááááááádisδá iεá thσá forma⌠ -dn.dú (don'⌠ forge⌠ thσ -)«á  Thi≤á caεá bσ ì
ááááááááaccomplisheΣ usinτ thσ CP/═ residen⌠ commanΣ SAV┼ ░ -dn.d#.

áááááááá2«á Oε ß blanδ diskette¼ hereafte≥ referreΣ t∩ a≤ thσ cataloτ disk¼ ì
áááááááápu⌠ aε operatinτ systeφ anΣ storσ thσ followinτ programs:
áááááááááá  A. a text editor or word processor
áááááááááá  B. CAT.COM
áááááááááá  C. UCAT.COM
áááááááááá  D«áFMAP.CO═á (fo≥á multiplσ drivσ systems⌐ o≥á NEWQCAT.CO═ ì
ááááááááááá     (for single drive systems)
.paè                   CREATING AND USING A CATALOG (CONTINUED)

áááááááá3«á Usinτá thσ tex⌠ edito≥ o≥ worΣ processo≥ creatσ ß filσ oεá thσ ì
áááááááácataloτá disδ nameΣ MAST.CA╘ containinτ ß lis⌠ oµá filenames¼á enì
áááááááácloseΣ withiε parenthesi≤ anΣ separateΣ b∙ carriagσ returns¼á whicΦ ì
ááááááááyo⌡ wisΦ t∩ havσ thσ systeφ ignore«  Thi≤ i≤ useful¼ fo≥ instance¼ ì
ááááááááwheε yo⌡ havσ ß cop∙ oµ PI╨ anΣ STA╘ oε ever∙ disδ anΣ don'⌠á wan⌠ ì
á  ááááát∩ clutte≥ thσ cataloτ b∙ listinτ al∞ oµ them«
áááááááá    EXAMPLE║
áááááááá        (PIP.COM
                DDT.COM
ááááááá         STAT.COM)
ááááááááááááNOTE║á Iµ yo⌡ don'⌠ wan⌠ an∙ file≤ t∩ bσ ignoreΣ pu⌠ (⌐ iε thσ ì
ááááááááááááfilσ (Don'⌠ forge⌠ t∩ pu⌠ ß carriagσ returε afte≥ it)«á Thi≤ i≤ ì
áááááááááááárequireΣ fo≥ thσ systeφ t∩ worδ properly.

áááááááá4«á WitΦá thσ diskette≤ t∩ bσ catalogueΣ iε ß hand∙ placσ anΣá al∞ ì
ááááááááothe≥ disδ drive≤ empty¼á inser⌠ thσ cataloτ disδ int∩ drivσ ┴ anΣ ì
ááááááááperforφá ß colΣ boot«á  Iε thσ nex⌠ ste≡ yo⌡ wil∞ begin¼á disδá b∙ ì
áááááááádisk¼ loadinτ thσ catalog.

áááááááá5.á (A⌐á Ente≥á thσ commanΣ NEWQCAT«á  Thσ prograφ wil∞ loaΣá theε ì
áááááááááááádirec⌠ yo⌡ t∩ removσ thσ cataloτ disδ anΣ inser⌠ thσá diskettσ ì
áááááááááááát∩á bσ catalogued«á  B∙ followinτ thσ direction≤ giveε b∙á thσ ì
ááááááááááááprograφ yo⌡ wil∞ switcΦ diskette≤ bacδ anΣ forth¼á hittinτ thσ ì
áááááááááááácarriagσ returε ke∙ eacΦ time¼á unti∞ yo⌡ enΣ u≡ witΦ thσ cataì
ááááááááááááloτá disδ iε thσ drivσ anΣ thσ temporar∙ file¼á NAMES.SUB¼á oε ì
ááááááááááááit.
áááááááááááá(B⌐á Pu⌠á thσ firs⌠ diskettσ t∩ bσ catalogueΣ iε drive  B  and ì
ááááááááááááenter the command FMA╨ B║ F (t∩ seσ thσ result≤ oε thσ screen⌐ ì
ááááááááááááo≥ FMA╨ B║á ╤ (t∩ d∩ thσ joΓ slightl∙ quicke≥ withou⌠ anythinτ ì
ááááááááááááprinteΣá oε thσ screen)«á  Wheε thσ prograφ finishes yo⌡á wil∞ ì
ááááááááááááhavσ thσ temporar∙ file¼ NAMES.SUB¼ oε thσ cataloτ disk.

áááááááá6« Ente≥ thσ commanΣ UCA╘ whicΦ wil∞ mergσ thσ datß froφ NAMES.SU┬ ì
ááááááááint∩ thσ cataloτ file¼ MAST.CAT¼ anΣ deletσ NAMES.SUB.

áááááááá7« Repea⌠ step≤ ╡ anΣ ╢ fo≥ eacΦ diskettσ yo⌡ wisΦ t∩ catalog«  Iµ ì
ááááááááthσá commanΣá NEWQCA╘ result≤ iε thσ messagσ +++NO╘á FOUN─á repea⌠ ì
áááááááástep≤ 1¼á 5¼ anΣ 6« Thi≤ messagσ mean≤ tha⌠ n∩ diskettσ namσ starì
áááááááátinτá witΦ ß - wa≤ founΣ oε thσ diskettσ beinτá catalogued«á  Somσ ì
áááááááápreviou≤ version≤ oµ FMA╨ wil∞ als∩ producσ thi≤ erro≥ messagσ bu⌠ ì
ááááááááthσ onσ specifieΣ hereiε wil∞ not.

áááááááá8« Thσ cataloτ ha≤ no≈ beeε loadeΣ anΣ i≤ read∙ fo≥ use« T∩ obtaiε ì
ááááááááinformatioεá froφ thσ cataloτ ente≥ thσ commanΣ CA╘á fn.f⌠á dn.d#« ì
ááááááááWildcard≤ (┐ o≥ *⌐ arσ alloweΣ anΣ dn.dú i≤ optional.
ááááááááááááEXAMPLES:
áááááááááááá á  Command                 Purpose
ááááááááááááá   CAT WS.COM              find all copies of WS.COM within
ááááááááááááá                           entire catalog

áááááááááááááá  CAT WS.COM WORK.*       find all copies of WS.COM on any
áááááááááááááá                          WORK disk
è
                   CREATING AND USING A CATALOG (CONTINUED)

ááááááááááááááááCommand                 Purpose
ááááááááááááááááCAT WS.COM WORK.001     see if WS.COM is on disk WORK.001

ááááááááááááááááCAT *.ASM               list all ASM type files in the
áááááááááááááááá                        catalog

ááááááááááááááááCAT J*.HEX WORK.*       list all HEX type files beginning
áááááááááááááááá                        with J on any WORK disk

ááááááááááááááááCAT *.* LIB.135         list all files on disk LIB.135

                         UPDATING AN EXISTING CATALOG

áááá    Thσá threσá occasion≤ whicΦ necessitatσ updatinτ thσá cataloτá arσ ì
ááááadditioε oµ ß diskette¼á deletioε oµ ß diskette¼áand addition/deletioε ì
ááááoµ file≤ oε ß previousl∙ catalogueΣ diskette«á  Thσ requireΣ operatioε ì
ááááiε al∞ threσ occasion≤ i≤ essentiall∙ thσ samσ iε tha⌠ thσ diskettσ i≤ ì
áááájus⌠á catalogueΣ a≤ donσ wheε initiall∙ loadinτ thσ cataloτá (seσá thσ ì
áááálas⌠á section)«á  Showεá belo≈á i≤á thσ requireΣá operatioεá fo≥á eacΦ ì
ááááoccasion:

áááá    NOTE║á Thσá ste≡á number≤á belo≈ refe≥ t∩ step≤á withiεá thσá las⌠ ì
áááá    section.

áááá    Adding a diskette
áááá        To add a diskette to the catalog perform steps 1, 5, and 6.

áááá    Addition/deletion of files on a previously catalogued diskette
áááá        T∩á updatσá thσ cataloτ fo≥ ß diskettσá whosσá filename≤á havσ ì
áááá    changeΣá sincσ i⌠ wa≤ las⌠ catalogueΣ perforφ step≤ ╡ anΣ 6«á  An∙ ì
áááá    filename≤á whicΦá havσ beeε deleteΣ froφ thσ diskettσ wil∞ bσá reì
áááááááámoveΣá froφ thσ cataloτ whilσ filename≤ whicΦ havσ beeε addeΣ wil∞ ì
áááááááábσ inserteΣ int∩ thσ catalog.

ááááááááDeletion of a diskette
áááááááá    Deletinτá ß diskettσ froφ thσ cataloτ require≤á slightl∙á morσ ì
ááááááááworδá thaεá thσ othe≥ tw∩ updatinτ operations«á  First¼á forma⌠á ß ì
áááááááádiskettσ t∩ ensurσ i⌠ i≤ empty«á  Oε thi≤ empt∙ diskettσ storσ thσ ì
áááááááádiskname.disknumbe≥á correspondinτ t∩ thσ diskname.disknumbe≥á yo⌡ ì
ááááááááwisΦ t∩ deletσ (usσ thσ CP/═ commanΣ SAV┼ ░ -dn.dú    DON'╘ FORGE╘ ì
ááááááááTH┼ -)«  No≈ perforφ step≤ ╡ anΣ ╢ usinτ thi≤ diskette«  Thi≤ wil∞ ì
áááááááácausσá al∞á filename≤á fo≥ tha⌠ diskettσ t∩ bσá removeΣá f≥oφá thσ ì
áááááááácatalog.
.paè                          DETAILED FILE DESCRIPTIONS

ááááMAST.CAT
áááá    MAST.CA╘ i≤ aε ASCI╔ tex⌠ filσ whicΦ contain≤ ß lis⌠ oµá filename≤ ì
áááát∩ bσ ignoreΣ b∙ thσ systeφ (no⌠ includeΣ withiε thσ catalog⌐ followeΣ ì
ááááb∙ thσ cataloτ data«á  Thσ filename≤ t∩ bσ ignoreΣ arσ encloseΣ withiε ì
ááááparenthesi≤á anΣ separateΣ b∙ carriagσ return-linefeeΣ sequences«á  Thσ ì
áááálas⌠ parenthesi≤ i≤ followeΣ b∙ ß carriagσ return-linefeeΣ s∩ tha⌠á thσ ì
áááácataloτá datßá begin≤ oε ß ne≈ line«á  Thσ cataloτ datß consist≤ oµá ß ì
áááális⌠á oµ line≤ (separateΣ b∙ carriagσ return-linefeeΣá sequences⌐á eacΦ ì
áááácontaininτá onσ filenamσ anΣ correspondinτ diskname.disknumbe≥ iεá thσ ì
ááááforma⌠áá fn.ft,dn.d#«áá  Thσáá line≤á arσá alphabeticall∙á sorteΣáá b∙ ì
ááááfilename.filetypσ ignorinτ thσ diskname.disktype«á  ┴ typical MAST.CA╘ ì
ááááfile would look as follows:
áááá    (PIP.COM
áááá    STAT.COM
áááá    DDT.COM)
áááá    FORMAT.COM,LIB.003
áááá    INDEX.ASM,LIB.015
áááá    INDEX.COM,LIB.015
áááá    LU.COM,LIB.001

ááááMAST.BAK
áááá    MAST.BA╦ i≤ ß backu≡ cop∙ oµ MAST.CAT«á  EacΦ timσ thσ cataloτá i≤ ì
ááááupdateΣ thσ previou≤ cop∙ of MAST.CA╘ i≤ renameΣ t∩ MAST.BA╦ s∩ iµ yo⌡ ì
ááááeve≥á destro∙á MAST.CA╘ iε erro≥ jus⌠ renamσ MAST.BA╦ t∩ MAST.CA╘á anΣ ì
ááááre-catalog the last diskette catalogued.

ááááNAMES.SUB
áááá    NAMES.SU┬ i≤ aε ASCI╔ filσ createΣ b∙ FMA╨ whicΦ i≤ normall∙á useΣ ì
ááááa≤ ß temporar∙ mergσ filσ b∙ thσ cataloguinτ systeφ bu⌠ ma∙ havσ othe≥ ì
ááááuse≤ dependinτ upoε thσ optioε anΣ suboptioε specifieΣ withiε thσ FMA╨ ì
áááácommanΣá line«á  Possibilitie≤ includσ usσ a≤ ß cataloτ filσ fo≥á eacΦ ì
áááádisδ containinτ ß lis⌠ oµ filename≤ witΦ comment≤ abou⌠ eacΦ file¼ usσ ì
ááááwitΦ thσ CP/═ SUBMI╘ utility¼ usσ a≤ ß sorteΣ diskettσ director∙ file¼ ì
ááááanΣ othe≥ use≤ a≤ determineΣ b∙ you≥ ingenuity«á  NAMES.SU┬ contain≤ ß ì
áááális⌠ oµ filenames¼á filetypes¼á anΣ possibl∙ othe≥ datß dependinτ upoε ì
ááááwhicΦ option≤ arσ useΣ witΦ FMAP«  Thσ lis⌠ containeΣ withiε NAMES.SU┬ ì
ááááis alphabetically sorted by filename and filetype.

ááááNEW.CAT
áááá    NEW.CA╘á i≤á ßá temporar∙ ASCI╔ filσ createΣ b∙á UCA╘á durinτá thσ ì
áááácataloτá updatinτá process«á  I⌠ i≤ eraseΣ b∙ UCA╘ s∩ thσá use≥á woulΣ ì
áááánormall∙ no⌠ bσ awarσ tha⌠ i⌠ eve≥ existed«á  However¼á i⌠ i≤ possiblσ ì
ááááfo≥á thσá systeφ t∩ crasΦ durinτ executioε oµ UCA╘ leavinτ NEW.CA╘á oε ì
ááááthσ disk«  ShoulΣ thi≤ happeε simpl∙ erasσ NEW.CAT¼ renamσ MAST.BA╦ t∩ ì
ááááMAST.CA╘ iµ MAST.CA╘ wa≤ eraseΣ b∙ UCAT¼á anΣ tr∙ thσ updatinτá proceì
áááádurσ again.

.paè                    DETAILED FILE DESCRIPTIONS (CONTINUED)
ááá
  ááFMAP
áááá    FMA╨á read≤á ßá diskettσá director∙ obtaininτá ßá sorteΣá lis⌠á oµ ì
ááááfilename≤á anΣ disδ allocatioε informatioε whicΦ ma∙ bσ sen⌠ t∩ ß filσ ì
áááá¼ NAMES.SUB¼ oε thσ currentl∙ selecteΣ disk¼ t∩ thσ console¼ o≥ t∩ thσ ì
ááááprinter«  FMA╨ allow≤ teε option≤ anΣ threσ suboption≤ makinτ i⌠ quitσ ì
ááááversatilσ anΣ givinτ i⌠ ß variet∙ oµ application≤ asidσ froφ usσá witΦ ì
ááááthσá cataloguinτ system«á  Thσ commanΣ forma⌠ i≤ FMA╨ d:fn.f⌠ opt.sop⌠ ì
ááááanΣ wildcard≤ (¬ anΣ ?⌐ arσ alloweΣ withiε thσ filenamσ anΣá filetype«  ì
ááááThσ d║ i≤ useΣ t∩ specif∙ whicΦ drivσ contain≤ thσ diskettσ t∩ bσ reaΣ ì
ááááwitΦá thσ currentl∙ selecteΣ drivσ beinτ useΣ iµ d║á i≤ omitted.á  Thσ ì
ááááfilenamσá anΣá filetypσ arσ useΣ t∩ specif∙ selectioεá criterißá whicΦ ì
ááááeacΦá filenamσ anΣ filetypσ mus⌠ mee⌠ iε orde≥ t∩ bσ includeΣá iεá thσ ì
áááálist obtained (e.g. *.ASM for all .ASM type files).
áááá    ThrougΦá usσá oµ thσ option≤ anΣ suboption≤ thσ use≥á caεá contro∞ ì
ááááwhicΦ use≥ areß (oε thσ disk⌐ i≤ scanned¼ thσ destinatioε oµ thσ data¼ ì
ááááanΣ thσ forma⌠ oµ thσ datß generated«  BotΦ option≤ anΣ suboption≤ arσ ì
ááááoptionalá witΦá thσá restrictioεá tha⌠ ß suboptioε ma∙á onl∙á bσá used ì
ááááfollowinτá aε option«á  Iε addition¼á ß maximuφ oµ onσ optioε anΣá onσ ì
áááásuboptioεá ma∙á bσ used withiε ß commanΣá line«á  Thσá suboption≤á arσ ì
ááááspecifieΣ witΦ ß lette≥ precedeΣ b∙ ß «á whilσ thσ option≤ onl∙ usσ ß ì
áááásinglσ lette≥ o≥ character«á  Fo≥ example¼ usinτ thσ commanΣ FMA╨ B║ ╞ ì
ááááwoulΣ obtaiε ß lis⌠ oµ al∞ file≤ oε thσ disδ iε drivσ B║á usinτ thσá ╞ ì
ááááoptioε whilσ thσ commanΣ FMA╨ B║á F.╙ woulΣ obtaiε ß lis⌠ oµ al∞ file≤ ì
ááááoεá thσá disδá iε drivσ B║á usinτ thσ ╞ optioε anΣ thσá .╙á suboption«  ì
ááááNoticσá tha⌠ fn.f⌠ arσ optiona∞ anΣ tha⌠ FMA╨ B║á F.╙ i≤á functionall∙ ì
ááááequivalen⌠ t∩ FMA╨ B:*.¬ F.S«á  EacΦ optioε anΣ suboptioε i≤ explained ì
ááááin detail below:

ááááááááOption  Explanation

áááá    noneá       Thσ FMA╨ commanΣ witΦ n∩ option≤ i≤ useΣ t∩ lis⌠á disδ ì
ááááááááááááááááallocatioεá informatioεá t∩ thσ console«á  I⌠á show≤á eacΦ ì
ááááááááááááááááfilenamσ anΣ type¼á it'≤ sizσ iε K¼ it'≤ recorΣ count¼ anΣ ì
ááááááááááááááááextent≤ useΣ b∙ it«  Thσ forma⌠ useΣ i≤ fn.f⌠ E° R├ #╦ Ex«  ì
ááááááááááááááááN∩ NAMES.SU┬ filσ i≤ created.

áááááááá/ááááááá    Thσ » optioε i≤ simila≥ t∩ n∩ option«  Difference≤ arσ ì
áááááááááááááááátha⌠á n∩ informatioε abou⌠ extent≤ useΣ i≤ listeΣ anΣá thσ ì
áááááááááááááááádatß i≤ showε iε tw∩ column≤ usinτ thσ forma⌠ fn.f⌠ R├ #K«  ì
ááááááááááááááááNo NAMES.SUB file is created.

áááá    Bá           Thσá ┬á optioεá i≤ identica∞ t∩ n∩á optioεá witΦá thσ ì
ááááááááááááááááadditioε oµ ß bi⌠ ma≡ followinτ thσ list.á  Withiε thσ bi⌠ ì
ááááááááááááááááma≡ ß ▒ indicate≤ tha⌠ thσ blocδ ha≤ beeε allocateΣá whilσ ì
ááááááááááááááááa 0 means that it hasn't.

        D           Thi≤á optioεá create≤á ß NAMES.SU┬ filσ fo≥á usσá witΦ ì
ááááááááááááááááSUBMIT«á  NAMES.SU┬ wil∞ contaiε ß lis⌠ oµ filename≤á witΦ ì
ááááááááááááááááSUBMI╘ typσ parameter≤ iε thσ forma⌠ $▒ $2fn.f⌠ $│ (noticσ ì
ááááááááááááááááthσá spacσá betweeε thσ f⌠ anΣ $3)«á  Thσ ╨ optioε i≤á thσ ì
áááááááááááááááásame without the space.  No output is sent to the console.
.paè                    DETAILED FILE DESCRIPTIONS (CONTINUED)

ááááFMAP (CONTINUED)

ááááááááOption  Explanation

        F           Thi≤á optioεá i≤ useΣ fo≥ updatinτá thσá catalog«á  I⌠ ì
áááááááááááááááácreate≤ ß NAMES.SU┬ filσ containinτ ß lis⌠ oµ filename≤ iε ì
ááááááááááááááááthσ forma⌠ fn.ft«á  Outpu⌠ t∩ thσ consolσ i≤ identica∞á t∩ ì
ááááááááááááááááthat of no option.

        K           Thσá ╦á optioε create≤ ß NAMES.SU┬ filσá containinτá ß ì
áááááááááááááááális⌠ oµ filename≤ anΣ filσ size≤ iε thσ forma⌠ fn.ft,nnnk«  ì
ááááááááááááááááN∩á outpu⌠á i≤ sen⌠ t∩ thσ console«á  Thi≤ optioε make≤á ß ì
áááááááááááááááágood sorted directory file.

        L           Thσá ╠ optioε create≤ ß lis⌠ oµ filename≤á witΦá thei≥ ì
áááááááááááááááásizσá iε K¼á ß volumσ number¼á anΣ ß filσ numbe≥ fo≥ each«  ì
ááááááááááááááááUsinτ thσ commanΣ FMA╨ B║á Lnnn.╨ woulΣ creatσ ß lis⌠ witΦ ì
ááááááááááááááááeacΦá linσá havinτ thσ forma⌠ nnn.ú #╦ fε f⌠á sendinτá thσ ì
áááááááááááááááádatß t∩ botΦ thσ consolσ anΣ printe≥ (noticσ thσ suboptioε ì
áááááááááááááááá.P).  No NAMES.SUB file is created.

        M           Thi≤ optioε create≤ ß NAMES.SU┬ filσ fo≥ usσ witΦá thσ ì
ááááááááááááááááCP/═ SUBMI╘ utility«  EacΦ linσ iε thσ filσ ha≤ thσ forma⌠ ì
áááááááááááááááá$1 $2 $3fn.ft.  No output is sent to the console.

        Q           Thi≤á optioεá i≤á identica∞ t∩ thσá ╞á optioεá withou⌠ ì
ááááááááááááááááconsole output.

        P           Thi≤á optioε i≤ identica∞ t∩ thσ ─ optioε excep⌠á tha⌠ ì
áááááááááááááááán∩á spacσá i≤ inserteΣ betweeε f⌠ anΣ $│ resultinτ iεá thσ ì
ááááááááááááááááforma⌠ $▒ $2fn.ft$3«á  Thi≤ forma⌠ i≤ compatiblσ witΦ somσ ì
ááááááááááááááááutilities such as PEP.  There is no console output.

        Unnn        Thi≤ optioε create≤ ß SIG/═ cataloτ filσ whosσ namσ i≤  ì
áááááááááááááááá-CATALOG.nnn«á  Thi≤á filσ i≤ theε completeΣ usinτ ßá tex⌠ ì
ááááááááááááááááedito≥á o≥á worΣ processo≥ t∩ ente≥ ß cataloτá descriptioε ì
ááááááááááááááááand comments about each filename.  The file's format is:
áááááááááááááááá    Volume nnn
áááááááááááááááá    Description:--to be filled in--
áááááááááááááááá    Number  Size    Name         Comments
áááááááááááááááá                    CATALOG.nnεááContent≤áoµ CP/═ Vol.nnn
áááááááááááááááá    nnn.#   #K      fn.ft        --to be filled in--
áááááááááááááááá    nnn.#   #K      fn.ft        --to be filled in--
áááááááááááááááá    etc...

        .P          Thσá .╨ suboptioε i≤ identica∞ t∩ thσ CP/═ ^╨á contro∞ ì
áááááááááááááááácharacter«  I⌠ cause≤ al∞ outpu⌠ beinτ sen⌠ t∩ thσ consolσ ì
ááááááááááááááááto be echoed at the printer.
.paè                    DETAILED FILE DESCRIPTIONS (CONTINUED)

ááááFMAP (CONTINUED)

ááááááááOption  Explanation

        .S          Thσá .╙ suboptioε cause≤ FMA╨ t∩ promp⌠ thσ use≥á witΦ ì
ááááááááááááááááeacΦá filenamσá iε thσ director∙ s∩ eacΦ ma∙á bσá manuall∙ ì
ááááááááááááááááselecteΣ fo≥ inclusioε withiε thσ lis⌠á created«á  Consolσ ì
ááááááááááááááááoutpu⌠ i≤ iε thσ forφ fn.ft┐á wherσ thσ use≥ respond≤ witΦ ì
ááááááááááááááááY or N.

        .Unn        Normall∙ FMA╨ accesse≤ al∞ use≥ area≤ oε thσ diskette¼ ì
ááááááááááááááááhowever¼á thσá .Unε suboptioε allow≤ selectioε oµ onσ use≥ ì
ááááááááááááááááarea to be accessed with all others being ignored.

ááááUCAT
áááá    UCA╘á i≤á thσ maste≥ cataloτ updatinτá program«á  Effectively¼á i⌠ ì
áááámerge≤ NAMES.SU┬ (createΣ b∙ FMAP⌐ int∩ thσ existinτ MAST.CAT¼á addinτ ì
ááááanΣ deletinτ entrie≤ a≤ required«á  Actually¼á i⌠ work≤ b∙á performinτ ì
ááááthe following list of operations in sequence:

áááá    1. create NEW.CAT (empty ASCII file)
áááá    2. merge old MAST.CAT with NAMES.SUB placing result in NEW.CAT
áááá    3. erase MAST.BAK (MAST.CAT backup file) and NAMES.SUB
áááá    4. rename old MAST.CAT to MAST.BAK
áááá    5. rename NEW.CAT to MAST.CAT

áááá    Normally¼á eacΦá diskettσá t∩á bσ catalogueΣ wil∞ contaiεá ßá zer∩ ì
áááálengtΦá filσ whosσ namσ i≤ useΣ fo≥ thσ diskname«á  Thσ namσá oµá thi≤ ì
ááááfilσá wil∞á havσ thσ forma⌠ -dn.d#«á  ShoulΣ yo⌡ wisΦ no⌠ t∩ savσá thσ ì
áááádisknamσá oεá eacΦá diskettσ UCA╘ allow≤ aε optioεá t∩á precludσá thi≤ ì
áááárequirement«á  T∩ usσ i⌠ creatσ NAMES.SUB¼á containinτ n∩ -dn.dúá (usσ ì
ááááFMA╨á withou⌠ previousl∙ creatinτ ß zer∩ lengtΦ file)¼á theε ente≥ thσ ì
áááácommanΣ UCA╘ -dn.dú usinτ an∙ disknamσ anΣ numbe≥ yo⌡ wish«  Thi≤ wil∞ ì
ááááupdatσá MAST.CA╘ usinτ thσ -dn.dú specifieΣ rathe≥ thaε requirinτá onσ ì
ááááto be within NAMES.SUB (obtained from the diskette directory).

ááááCAT
áááá    CA╘á i≤ thσ cataloguinτ systeφ querr∙ program«á  I⌠á accesse≤á thσ ì
ááááMAST.CA╘á datß filσ findinτ entrie≤ whicΦ matcΦ thσ selectioε criteriß ì
ááááspecified«á  Thσ entrie≤ founΣ arσ theε sen⌠ t∩ thσ console«á  Useá oµ ì
ááááthe CP/M ^P  will cause the data to be echoed at the printer as  well.
áááá    Thσá commanΣá forma⌠ i≤ CA╘ fn.f⌠ dn.dú wherσ fn.f⌠ anΣ dn.dúá arσ ì
ááááoptiona∞á witΦá thσ stipulatioε tha⌠ fn.f⌠ mus⌠ bσ useΣá iεá orde≥á t∩ ì
ááááspecif∙á dn.d#«á  Wildcard≤á (¬á anΣ ?⌐ arσ allowed withiεá fn.f⌠á anΣ ì
áááádn.d#«  Omittinτ fn.f⌠ o≥ fn.dú i≤ functionall∙ equivalen⌠ t∩ enterinτ ì
áááá*.¬ s∩ thσ commanΣ CA╘ wil∞ producσ thσ samσ resul⌠ a≤ CA╘ *.¬ *.¬ anΣ ì
ááááCAT *.COM will yield the same output as CAT *.COM *.*.
.paè                        SUMMARY OF ADDITIONAL PROGRAMS

         ListeΣá belo≈ arσ somσ program≤ whicΦ aren'⌠ actuall∙ par⌠ oµ thσ ì
áááácataloguinτá systeφ bu⌠ havσ proveε useful«á  ┴ shor⌠ summar∙á oµá thσ ì
ááááadvantage≤á offereΣ b∙ eacΦ i≤ given«á  Fo≥ informatioε oε ho≈ t∩á usσ ì
ááááthesσá program≤ yo⌡ caε reaΣ thσ documentatioε supplieΣ witΦ somσá bu⌠ ì
ááááyo⌡ arσ  oε you≥ owε witΦ others«á  Tr∙ theφ ou⌠ oε ß dumm∙ cataloτ s∩ ì
ááááyo⌡ won'⌠ loosσ an∙ datß whilσ playing«á  ╔ furthe≥ sugges⌠ yo⌡ becomσ ì
ááááquitσá familia≥ witΦ operatioε oµ thσ basiπ cataloguinτ systeφá beforσ ì
áááágettinτ to∩ venturous.

ááááCATXRF11
áááá    Thi≤á i≤ ß utilit∙ fo≥ producinτ printout≤ oµ thσ maste≥á catalog«  ì
ááááI⌠ provide≤ choicσ oµ sequencinτ b∙ disknumber¼ filename¼ o≥ filetype«  ì
ááááThσá prograφá sourcσá (iε BASIC⌐ alonτ witΦ ß full∙á compileΣá versioε ì
áááá(whicΦ ma∙ o≥ ma∙ no⌠ worδ oε you≥ system⌐ i≤ availablσ froφ SIG/═á oε ì
áááávolume 117.

ááááNCAT
áááá    Thi≤ i≤ ß reall∙ nicσ enhancemen⌠ t∩ thσ system«  I⌠ replace≤ FMA╨ ì
ááááanΣá UCA╘ witΦ onσ prograφ simplifyinτ thσ creatioε anΣ maintenancσ oµ ì
ááááthσ catalog«á  Becausσ NCA╘ use≤ maiε storagσ fo≥ merging¼ rathe≥ thaε ì
áááácreatinτ anΣ deletinτ additiona∞ files¼ i⌠ operate≤ quicker«  Thσ use≥ ì
ááááneeΣ onl∙ ente≥ NCA╘ t∩ updatσ ß cataloτ iε onσ ste≡ anΣ NCA╘ respond≤ ì
ááááwitΦá amplσ message≤ oε thσ screeε t∩ changσ disk≤á a≤á required«á  Aε ì
ááááintroductioεá i≤á als∩á availablσá b∙ enterinτá thσá commanΣá NCA╘á ?«  ì
ááááBecausσá NCA╘ doesn'⌠ creatσ additiona∞ file≤ nonσ oµ thσ FMA╨ option≤ ì
ááááare available.  This is a user friendly, speedy little program.

ááááCAT2
áááá    CAT▓á i≤á ß replacemen⌠ fo≥ CA╘ whicΦ provide≤ datßá iεá ßá singlσ ì
áááácolumε rathe≥ thaε iε two«á  Thi≤ make≤ readinτ easie≥ bu⌠ thσ prograφ ì
ááááisn'⌠á ver∙á smart«á  Thσ onl∙ commanΣ forma⌠ alloweΣ i≤á simpl∙á CAT▓ ì
ááááwhicΦá provide≤á ßá listinτ oµ thσ entirσ cataloτ (yo⌡á havσá t∩á looδ ì
ááááthrougΦá i⌠á t∩ finΣ ß filename)«á  Thi≤ ma∙ no⌠ sounΣ likσ mucΦ oµá ß ì
ááááprobleφá a⌠á firs⌠ bu⌠ thinδ abou⌠ usinτ you≥ termina∞ t∩ looδá fo≥á ß ì
ááááfilσ nameΣ ZZ┌ iε ß cataloτ oµ 500░ filenames«  CAT▓ i≤ availablσ froφ ì
ááááSIG/M.

ááááFIND
áááá    Thi≤ i≤ ß genera∞ purposσ ASCI╔ filσ searcΦ utilit∙ availablσ froφ ì
ááááSIG/M«á  Somσ likσ i⌠ bette≥ thaε cat«á  Yo⌡ migh⌠ givσ i⌠ ß tr∙.

ááááSUPERSORT
áááá    SUPERSOR╘á i≤á ßá genera∞á purposσ ASCI╔á sor⌠á utilit∙á availablσ ì
áááácommerciall∙á froφá Micropro«á  Thi≤á prograφ wil∞ creatσá ßá cop∙á oµ ì
ááááMAST.CA╘ reformatteΣ anΣ sorteΣ an∙ wa∙ yo⌡ like«á  I⌠ als∩ allow≤ yo⌡ ì
áááát∩ creatσ commanΣ file≤ fo≥ i⌠ t∩ reaΣ fo≥ instructions«á  Thi≤ allow≤ ì
ááááyo⌡ t∩ havσ ß commanΣ filσ fo≥ ever∙ format/sor⌠ combinatioε eve≥ useΣ ì
áááás∩ the∙ caε al∞ bσ easil∙ updateΣ ever∙ timσ thσ origina∞ MAST.CA╘á i≤ ì
ááááupdated«á  Yo⌡ caε usσ thσ FIN─ utilit∙ t∩ searcΦ thσ file≤ createΣ o≥ ì
ááááßá prin⌠á utilit∙ (Wordsta≥ works⌐ t∩ producσ ß booδ oµá you≥á cataloτ ì
áááácros≤á referenceΣ anΣ formatteΣ an∙ wa∙ yo⌡ caε imagine«á  Thi≤á i≤á ß ì
áááásmar⌠ prograφ wel∞ wortΦ checkinτ out.
è                                   CLOSING

áááá    Oµá al∞ thσ softwarσ ╔ owε thσ Maste≥ Cataloguinτ Systeφ i≤ onσ oµ ì
ááááthσ mos⌠ useΣ utilities«á  I⌠ ha≤ evolveΣ int∩ aε extremel∙á versatilσ ì
áááátool¼á anΣ wheε yo⌡ adΣ ß fe≈ additiona∞ program≤ anΣ somσ imaginatioε ì
áááái⌠á become≤á ß ver∙ powerfu∞ necessit∙ t∩ an∙ seriou≤á compute≥á user«  ì
ááááWithou⌠á i⌠á I¼á fo≥á one¼á woulΣ bσ los⌠ iε aε oceaεá lookinτá fo≥á ß ì
ááááparticula≥ ouncσ oµ water«  I'φ certaiε ╔ woulΣ no⌠ bσ alone«  ╔ extenΣ ì
áááám∙á thank≤á t∩ WarΣ fo≥ ß joΓ wel∞ donσ (b∙ thσ wa∙ Ward¼á ╔ likσá RE┌ ì
áááátoo).
                                   Jerald E. Bass
                                   Computeration Developments