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 / CPM / CATLOG / XCAT43.LBR / XCAT43.DQC / XCAT43.DOC
Text File  |  2000-06-30  |  4KB  |  108 lines
  1. FILE  :  XCAT43
  2.  
  3. DATE  :  20 NOV 85
  4.  
  5. TOPIC :  HOW TO USE
  6.  
  7.  
  8.      XCAT uses the CP/M catalog file called MAST.CAT.  It makes a new
  9. cross-reference file which it can then immediately print in paginated
  10. format, or can put the new file directly to disk.  It can handle files
  11. of any length, even if longer than available memory.  MAST.CAT files
  12. with thousands of programs can be properly handled by XCAT.
  13.  
  14.      It loads in as much of MAST.CAT as available memory permits, then
  15. rearranges the file in a cross-reference manner so duplicate copies of
  16. the same program show what disks they are on.  Here is a small sample
  17. which is obtained with the USER equate set NO:
  18.  
  19.  
  20.      CAT     .ASM  -  106
  21.      CAT     .COM  -  033  034    092  093  106  123  147
  22.      CAT     .DOC  -  033  034    106
  23.      CAT2    .COM  -  033  034
  24.      CATALOG .HLP  -  051
  25.      CBAS2   .COM  -  031  032    040
  26.      CCP     .ASM  -  059
  27.      CCP     .DOC  -  059
  28.      CHECKERS.BAS  -  082
  29.  
  30.  
  31. An "USER" equate may be set, to display not only the disk but the user
  32. area the program is on.  (The comparable USER equate in MCAT should be
  33. set YES.)
  34.  
  35.  
  36.      CAT     .ASM  -  106/05
  37.      CAT     .COM  -  033/05  034/12  092/01  093/10  106/07  123/08
  38.               147/13
  39.      CAT     .DOC  -  033/05  034/12  106/06
  40.      CAT2    .COM  -  033/05  034/12
  41.      CATALOG .HLP  -  051/00
  42.      CBAS2   .COM  -  031/03  032/11  040/15
  43.      CCP     .ASM  -  059/05
  44.      CCP     .DOC  -  059/05
  45.      CHECKERS.BAS  -  082/02
  46.  
  47.      Among other things, this allows you to quickly determine how many
  48. copies of each file you have, and delete unneeded extra copies.  Up to
  49. ten disk ID numbers are shown per line.  (Seven when also displaying the
  50. user number.)  If more exist, a new line is started to continue the
  51. numbering.
  52.  
  53.      XCAT uses only disk volume numbers and discards any disk volume
  54. names that might be on the same line.  This can affect the sequence in
  55. which the volume numbers are displayed.  There is a simple remedy for
  56. this -- do not put volume names on the same line as the volume number.
  57. Here is an alternate possibility:
  58.  
  59.      A>SAVE 0 B:-.023
  60.      A>SAVE 0 B:-08AUG82
  61.      A>SAVE 0 B:-EDITORS
  62.  
  63.      All three of these examples may be placed on the same disk to give
  64. additional information.  They use no disk space at all, but do use disk
  65. file names (slightly reducing the number of available remaining names.)
  66.  
  67.      XCAT paginates when printing to the list device.  It asks several
  68. questions for the operator to answer:
  69.  
  70.  
  71.      Do you want to include the '.FRE' space? (Y/N):    (1)
  72.      Do you want hard copy instead of a file? (Y/N):    (2)
  73.      Do you want tear tabs to use roll paper? (Y/N):    (3)
  74.      Current date is:                    (5)
  75.      Start on page  :                    (6)
  76.      Stop  on page  :                    (7)
  77.  
  78.      1) User option of including 'space remaining' lines added by MCAT
  79.      2) Any key other than 'Y' makes a disk file instead of printing
  80.      3) A 'Y' puts tear tabs for roll paper every 11 inches, any other
  81.           key defaults to fanfold paper with no tear tabs
  82.      4) A RET leaves the date area blank
  83.      5) A RET starts on page 1
  84.      6) A RET prints all remaining pages
  85.  
  86.  
  87.      Not all printers have adjustable left margins.  You can readily
  88. insert up to 9 extra spaces, faking an adjustable left margin.
  89.  
  90.      Any number of file names may be handled by XCAT.  With a 64k com-
  91. puter having a typical size BIOS, around 3200 names may be handled
  92. each pass.  It can handle up to 999 pages on the pagination before it
  93. starts over.  This should handle at least 50,000 file names.  It takes
  94. about one minute to handle a file with 3000 names.
  95.  
  96.      XCAT also shows the total number of files handled as well as the
  97. number of "unique file names", since a great many of the total number
  98. are duplicates.  This information gives the true count of different
  99. files in the catalog.
  100.  
  101.      You can abort XCAT with a Control-X at any time (unless it says:
  102. "Now writing to disk").
  103.  
  104.  
  105.                       Irvin M. Hoff
  106.                       Los Altos Hills, CA  94022
  107.  
  108.