home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / c128 / util / dcatalog.sda / CAT128.DOCS < prev    next >
Text File  |  1992-09-28  |  6KB  |  127 lines
  1.  
  2.                              ├AT 128 - ╔NSTRUCTIONS
  3.  
  4.  
  5.   ╘HIS PROGRAM ALLOWS YOU TO FORM CATALOGS OF UP TO 1500 FILE NAMES AND/OR 450
  6. DISKS IN SIZE. ╘HE AVAILABLE COMMANDS IN THIS PROGRAM ARE AS FOLLOWS:
  7.  
  8. ├ATALOG ─ISK:
  9.  ┼NTERS THE CURRENT DISK IN THE DRIVE INTO THE CATALOG AFTER ASKING YOU FOR THE
  10.  NAME OF THE DISK IF ┴UTO ╘OGGLE IS ╧╞╞. ╔F ╧╬, WILL READ DISK NAME/ID FROM DISK AND USE THOSE FOR DISK NAME.
  11.  
  12. ╠OAD ├ATALOG:
  13.  ╠OADS A PREVIOUSLY SAVED CATALOG FROM THE DISK DRIVE INTO THE COMPUTER. ┘OU
  14.  ARE PROMPTED FOR THE NAME OF THE CATALOG.
  15.  
  16. ╙AVE ├ATALOG:
  17.  ╙AVES THE CURRENT CATALOG IN THE COMPUTER TO THE DISK USING THE CURRENT
  18.  CATALOG NAME. ╨LACES THREE FILES ON THE DISK:
  19.  
  20.    'CATALOG NAME.DSK' - DISK NAMES AND BLOCKS FREE. ╞IRST THREE STRINGS IN THE
  21.                         FILE ARE CATALOG NAME, TOTAL NUMBER DISKS IN CATALOG,
  22.                         AND NUMBER OF ACTIVE DISKS IN THE CATALOG.
  23.    'CATALOG NAME.FLS' - FILE NAMES, TYPES, AND SIZES. ╞IRST STRING IN THE FILE
  24.                         IS TOTAL NUMBER OF FILES NAMES IN THE CATALOG.
  25.    'CATALOG NAME.IFS' - SORT INDEX FOR FILE NAMES. ╬UMERICAL DATA ONLY.
  26.  
  27.  ╔F A CATALOG WITH THE SAME NAME IS ALREADY ON THE DISK, YOU WILL BE PROMPTED
  28.  IF YOU WISH TO REPLACE IT OR NOT.
  29.  
  30. ─ISK ╞UNCTIONS:
  31.  ┴LLOWS ACCESS TO DISK COMMANDS. ╥ENAME FILE, ╙CRATCH FILE, AND ─ISK ─IRECTORY
  32.  ARE SUPPORTED VIA MENU OPTIONS. ┴LSO ALLOWS 'FREE HAND' COMMANDS TO BE ENTERED
  33.  USING WEDGE TYPE FORMAT (I.E. 'S0:FILE NAME' = SCRATCH FILE, ETC.).
  34.  
  35. ┼DIT ├ATALOG:
  36.  ┴LLOWS DELETING ENTIRE DISK OR SINGLE FILES FROM CURRENT CATALOG.
  37.  
  38. ╨RINT ├ATALOG:
  39.  ┴LLOWS PRINTER OUTPUT OF CURRENT CATALOG CONTENTS IN ONE OF EIGHT DIFFERENT
  40.  FORMATS. ┘OU ARE PROMPTED FOR UPPER/LOWER CASE OUTPUT AND FORMAT TYPE:
  41.  
  42.   ╬ORMAL ╞ORMAT - ─ISKS ╧NLY:
  43.     ╨RINTS A LISTING OF DISK NAMES AND BLOCKS FREE IN SINGLE COLUMN IN CENTER
  44.     OF PAGE. ╬╧╘┼: ─ISK NAMES ARE NEVER SORTED.
  45.   ╬ORMAL ╞ORMAT - ╞ILES ╧NLY:
  46.     ╨RINTS A LISTING OF ALL FILE NAMES, FILE TYPES, AND FILE SIZES (IN BLOCKS)
  47.     IN SORTED ORDER IN SINGLE COLUMN IN CENTER OF PAPER.
  48.   ╬ORMAL ╞ORMAT - ┬OTH:
  49.     ╨RINTS A LISTING OF ALL DISK NAMES AND BLOCKS FREE, PLUS ALL FILES NAMES,
  50.     TYPES, AND SIZES (IN BLOCKS) ON EACH DISK IN UNSORTED ORDER IN SINGLE
  51.     COLUMN IN CENTER OF PAPER. ╬╧╘┼: ╙IMILAR TO ─IRECTORY COMMAND.
  52.   ╬ORMAL ╞ORMAT - ╙INGLE ─ISK:
  53.     ╙IMILAR TO ┬OTH ABOVE, EXCEPT YOU ARE PROMPTED FOR SPECIFIC DISK NAME YOU
  54.     WANT PRINTED, AND IS PRINTED IN SORTED ORDER.
  55.   ╥EPORT ╞ORMAT - ─ISKS ╧NLY:  ╬╧╘┼: ╥EPORT FORMAT USES ENTIRE PAGE WIDTH.
  56.     ╨RINTS A LISTING OF ALL DISK NAMES, BLOCKS FREE, AND NUMBER OF FILES ON ALL
  57.     DISKS IN CURRENT CATALOG.
  58.   ╥EPORT ╞ORMAT - ╞ILES ╧NLY:
  59.     ╨RINTS A LISTING OF FILE NAMES, FILE TYPES, FILE SIZES (IN BLOCKS), NAME OF
  60.     DISK FILE IS ON, AND BLOCKS FREE ON THAT DISK IN SORTED ORDER.
  61.   ╥EPORT ╞ORMAT - ┬OTH:
  62.     ╨RINTS A LISTING OF DISK NAME, BLOCKS FREE, FILE NAME, FILE TYPE, AND FILE
  63.     SIZE (IN BLOCKS) OF ALL FILES IN CURRENT CATALOG IN UNSORTED ORDER.
  64.   ╥EPORT ╞ORMAT - ╙INGLE ─ISK:
  65.     ╙IMILAR TO ┬OTH ABOVE EXCEPT YOU ARE PROMPTED FOR SPECIFIC DISK NAME YOU
  66.     WANT PRINTED, AND IS PRINTED IN SORTED ORDER.
  67.  
  68. ╙ORT ├ATALOG:
  69.  ╙ORTS FILE NAMES IN CURRENT CATALOG.
  70.  
  71. ╙EARCH ├ATALOG:
  72.  ┴LLOWS YOU TO SEARCH THE CURRENT CATALOG FOR ONE OF SEVERAL THINGS:
  73.  
  74.    ┬LOCKS ╞REE:
  75.      ┴LLOWS YOU TO SEARCH THE CATALOG FOR A DISK WITH A SPECIFIED NUMBER OF
  76.      BLOCKS FREE. ╨ROMPTS YOU FOR THE MINIMUM AND MAXIMUM NUMBER OF BLOCKS YOU
  77.      WANT.
  78.    ╞ILE ╙IZE:
  79.      ┴LLOWS YOU TO SEARCH THE CURRENT CATALOG FOR A FILE OF A SPECIFIC LENGTH
  80.      (IN BLOCKS). ╨ROMPTS YOU FOR MINIMUM AND MAXIMUM NUMBER OF BLOCKS DESIRED.
  81.    ─ISK ╬AME:
  82.      ┴LLOWS YOU TO SEARCH FOR A SPECIFIC DISK NAME WITH A WILD CARD OPTION.
  83.      (I.E. '*EST' = ALL DISK NAMES WHICH END WITH 'EST'   OR   'TES*' = ALL
  84.      DISK NAMES WHICH START WITH 'TES') ╔F FOUND, DISPLAYS A DIRECTORY OF THE
  85.      DISK AND FILES ON IT.
  86.    ╞ILE ╬AME:
  87.      ╙IMILAR TO ─ISK ╬AME ABOVE WITH WILD CARD OPTION, EXCEPT DISPLAYS THE DISK
  88.      THE FILE IS ON, AND THE FILE NAME, TYPE, ETC.
  89.  
  90. ┼XIT ╨ROGRAM:
  91.  ┼XITS THE PROGRAM. ╫┴╥╬╔╬╟: ┴LL DATA WILL BE LOST IF IT IS NOT SAVED TO DISK!
  92.  
  93. ╙TART ╬EW ├ATALOG:
  94.  ╨ROMPTS YOU FOR NEW CATALOG NAME. ╫┴╥╬╔╬╟: ┴LL CURRENT CATALOG DATA WILL BE
  95.  LOST IF NOT SAVED TO DISK FIRST!
  96.  
  97. ┴UTO ╘OGGLE:
  98.  ╘OGGLES ON/OFF THE DISK READING FUNCTION. ╫HEN ╧╞╞, THE PROGRAM WILL PROMPT
  99.  YOU FOR THE DISK NAME. ╫HEN ╧╬, THE PROGRAM WILL AUTOMATICALLY READ IN THE
  100.  DISK NAME AND ╔─. ╔F YOU'RE LIKE ME AND A LOT OF YOUR DISKS HAVE THE SAME
  101.  NAME, THE ╧╞╞ FEATURE WILL ALLOW YOU TO GIVE THE DISKS A DIFFERENT NAME FROM
  102.  WHAT IS ACTUALLY ON THE DISK.
  103.  
  104.  
  105. ╬╧╘┼╙: ╫HEN SORTING FILE NAMES IN THIS PROGRAM, THE ACTUAL NAMES THEMSELVES ARE
  106.        NOT SORTED. ╔NSTEAD, AN INDEX IS SET UP TO STORE THE SORTED ORDER OF THE
  107.        FILE NAMES.
  108.  
  109.        ╔T IS RECOMMENDED THAT YOU SET UP SEVERAL DIFFERENT CATALOGS. ┴S AN
  110.        EXAMPLE, ONE FOR GAMES, ONE FOR UTILITIES, ETC. ╔N THIS WAY, YOU SHOULD
  111.        NOT EXCEED THE CAPACITY OF A SINGLE CATALOG (I.E. 1500 FILES). ┴LSO,
  112.        ALTHOUGH THE SORT ROUTINE IN THIS PROGRAM IS FAST (2 SECONDS FOR 200+
  113.        FILE NAMES), IT WOULD STILL TAKE AN APPRECIABLE AMOUNT OF TIME FOR A
  114.        SINGLE CATALOG WITH OVER 1,000 FILE NAMES IN IT.
  115.  
  116.        ╔F A CATALOG IS ┼DITED, OR ADDITIONAL DISKS/FILES ARE ADDED TO IT, YOU
  117.        SHOULD ╙ORT THE CATALOG AGAIN. ┴LL OTHER OPTIONS INCLUDING SAVING THE
  118.        CATALOG, AND LOADING IT AGAIN LATER, WILL NOT AFFECT THE SORTED ORDER.
  119.  
  120.        ╫HEN ╠OADING A CATALOG, USE THE CATALOG NAME, AND IGNORE THE ADDITIONS
  121.        TO THE FILE NAMES ON THE DISK. (I.E. TO LOAD A CATALOG THAT IS LISTED ON
  122.        THE DISK AS 'GAMES.DSK', SIMPLY ENTER 'GAMES' AS THE CATALOG NAME)
  123.  
  124.        ╔F YOU HAVE ANY QUESTIONS, YOU CAN CONTACT ME ON ╨LAY╬ET AS ╥ICK ╙4, OR
  125.        ON ╤-╠INK AS ╥ICK ╞┬.
  126.  
  127.