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