home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / cpmug / cpmug040.ark / CATALOG.DOC < prev    next >
Encoding:
Text File  |  1984-04-29  |  4.7 KB  |  157 lines
  1. This document describes a system for cataloging all of a users
  2. CP/M diskettes.  Written by Ward Christensen.
  3.  
  4. Pieces have been previously distributed.  All are included
  5. here for convenience.  Some changes have been made.
  6.  
  7. The master cataloging system consists of the following:
  8.  
  9.     MAST.CAT    The catalog itself 
  10.  
  11.     FMAP.COM    Used to create NAMES.SUB, the 
  12.             "transaction file" for catalog update 
  13.  
  14.     CAT.COM        Like DIR, i.e. the lookup program 
  15.  
  16.     CAT2.COM    Quick kludge program, lists entire
  17.             catalog, printing each filename only
  18.             once, & stringing disk names out after.
  19.  
  20.     UCAT.COM    The update program, merges NAMES.SUB 
  21.             into MAST.CAT 
  22.  
  23.     UCAT.COM   is   slightly   modified  from  the  version
  24. distributed in CP/M user's group disk 25: it  now  catalogs the
  25. "volume  serial"  (-name.nnn)  whereas  the version in vol.  25
  26. threw this name away.
  27.  
  28.     The format of MAST.CAT is:
  29.  
  30.     First, a list of names of files not to be cataloged, in
  31. parentheses.  The list supplied with the sample is:
  32.  
  33.     (ASM.COM
  34.     DDT.COM
  35.     LOAD.COM
  36.     PIP.COM
  37.     SID.COM
  38.     STAT.COM
  39.     SUB.COM        <-- I renamed SUBMIT on most disks
  40.     SUBMIT.COM)
  41.  
  42.     Then a list of all cataloged files, in the form:
  43.  
  44.     filename.type diskname.serial
  45.  
  46. For example: ALLOC.COM SYSRES.802
  47.  
  48.             --------
  49.     A disk must have a special filename on it, which is the
  50. volume indentifier: -diskname.serial,  such  as  "-SYSRES.801".
  51. This may be done via:
  52.  
  53.     save 0 b:-sysres.801
  54.  
  55.     NOTE  that  the  SAP  (sort and pack directory) program
  56. previously  distributed  by  the CP/M U.G. deletes all 0-length
  57. file entries, so  if  you  use this utility, do a save 1, not a
  58. save 0.
  59.  
  60.     To  update  the  catalog for a disk, use FMAP to create
  61. the NAMES.SUB file (which  contains  a  sorted  listing  of the
  62. files   on   the   particular   disk).    Filename   $$$.SUB is
  63. automatically skipped, as I recall.
  64.  
  65.     FMAP B: Q
  66.  
  67.     will write NAMES.SUB to the logged in disk.  Then  type
  68. UCAT  which  will  merge  NAMES.SUB  with  MAST.CAT,  and erase
  69. NAMES.SUB.
  70.     Note  that  UCAT  is  a  "belts  and  suspenders"  type
  71. program,  i. e.  it  creates NEW.CAT, and merges NAMES.SUB with
  72. MAST.CAT and puts it there.  It then does:
  73.  
  74.     era mast.bak
  75.     ren mast.bak=mast.cat
  76.     ren mast.cat=new.cat
  77.  
  78.     This means that unless you era mast.bak, there will  be
  79. 3  copies  of  the  master  catalog on the disk during the ucat
  80. execution. If you  don't  have  sufficient  space  for  it, era
  81. mast.bak first.
  82.             -------- 
  83.     CAT works just like DIR, i.e.  "*" and "?" are allowed.
  84. However,  it  takes  a second operand (after the filename/type)
  85. which is  the  disk  information,  in  the  form  NAME.SERIAL -
  86. without the dash.  Sample queries:
  87.  
  88.     CAT        <-- ALL FILES
  89.     CAT *.* WORK.*    <-- ALL FILES ON ANY "WORK" DISK
  90.     CAT *.ASM    <-- ALL .ASM FILES
  91.     CAT *.* *.8*    <-- ALL FILES ON DISKS WITH SERIAL
  92.                 NUMBERS 8xx
  93.  
  94.     Note that the "-diskname.serial" file is written to the
  95. disk  (it  wasn't  under  the  earlier  UCAT  in the CP/M users
  96. group). Thus you can get a list of all disk serials via:
  97.  
  98.     CAT -*.*
  99.  
  100.     but other than this one file entry, the "-"  characters
  101. are  eliminated  from  the  directory, i.e.  the disk names are
  102. stored as 7 characters (or less).
  103.             ------ 
  104.     FMAP has some additional options:
  105.  
  106.             FMAP 
  107. displays a sorted listing on the console 
  108.             FMAP specs 
  109. displays a selective listing.  Specs mean *.asm, etc just 
  110. like DIR. 
  111.             FMAP specs D 
  112. writes the names to NAMES.SUB with $1 $2 before the name, 
  113. and $3 after: 
  114.  
  115.     $1 $2FOO.COM $3 
  116.  
  117. Thus $1 may be substituted with a command name, $2 with 
  118. a disk name, and $3 if the program takes options (only 
  119. my programs do, as far as I know) 
  120.             FMAP specs Q 
  121. writes the sorted names, without any "$", to NAMES.SUB. 
  122.             FMAP specs M 
  123. writes the names to NAMES.SUB with $1 $2 $3  before the name, 
  124. and $4 after: 
  125.  
  126.     $1 $2 $3FOO.COM $4 
  127.  
  128. This is specifically for use with the modem program.  For 
  129. example, to send all .ASM files from the B: disk to another 
  130. person: 
  131.  
  132.     FMAP B: M        <-- MAKE NAMES.SUB 
  133.         MODEM SO.600 NAMES.SUB  <-- SEND THEM NAMES.SUB 
  134.         SUBMIT NAMES MODEM SO.600 B: <-- SUBMIT THE SEND 
  135.  
  136. MODEM gets substituted for $1, SO.600 for $2, and B: for $3.
  137.             FMAP specs UNN
  138. creates CP/M users group catalog volume "nn".  Not generally
  139. useful, but thought you might like to know how it was done.
  140.  
  141.     NOTE  that  I  have  found  the  FIND   program   (also
  142. distributed  on  this  users group disk) to be very useful when
  143. used  with  MAST.CAT  -  suppose  you  have  the   following in
  144. MAST.CAT:
  145.  
  146.     BIOS1.ASM 
  147.     BVIOS.ASM 
  148.     CBIOS.ASM 
  149.     M2BIOS.ASM 
  150.  
  151. It's ovbious that CAT cannot find all your BIOS related files -
  152. but if you type:
  153.  
  154.     FIND MAST.CAT IOS 
  155.  
  156. You will find them all
  157.