home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / lambda / soundpot / f / index30.lbr / INDEX.DZC / INDEX.DOC
Encoding:
Text File  |  1993-10-26  |  11.0 KB  |  226 lines
  1. .MT0
  2. .PO2
  3. .OP
  4. 
  5.                                 INDEX PROGRAM
  6.                                  Version 3.0
  7.  
  8.                                       by
  9.                                  F. J. Greeb
  10.                                1915 S. Cape Way
  11.                            Denver, Colorado  80227
  12.                               Copyright (C) 1981
  13.  
  14.      INDEX is a CP/M (R) utility program combining the features of DIR and
  15. STAT.  It provides an alphabetical listing of the disk directory, spaced in
  16. columns across the screen, and may include the file size for each entry.  The
  17. total number of files, the total number of directory entries used, the disk
  18. space used, and the disk space remaining is also reported.
  19.  
  20.      The general form of the command is
  21.  
  22.             INDEX {/OPTIONS} {DRIVE:}{FILENAME}{.}{FILETYPE}
  23.  
  24. where all of the parameters in the braces are optional.  Wild card characters
  25. (* and ?) can be includet in the file name designations.  The following
  26. example commands, and their results, illustrate the wild character capability
  27. of the program.
  28.  
  29.  
  30.           INDEX                 Directory of all files on current drive
  31.           INDEX B:              Directory of all files on drive B
  32.           INDEX *.COM           Directory of all COM files on drive B
  33.           INDEX A??.*           Directory of all three letter or less
  34.                                 file names begining with the letter A
  35.                                 on the current drive
  36.           INDEX B:A*.*          Directory of all files on drive B which
  37.                                 begin with the letter A, regardless of
  38.                                 the file name length.
  39.  
  40.      OPTIONS - The options which are allowed are:
  41.  
  42.           /R          Resets the disk system before performing the
  43.                       directory search.  Use this option if you
  44.                       change disks without doing a Control C.
  45.  
  46.           /P          Directs the output to the printer rather than
  47.                       to the console.
  48.  
  49.           /F          Outputs a form feed character (Control L) before
  50.                       printing the directory (console or printer).
  51.  
  52.           /T          Allows a title to be input (immediately following
  53.                       the T) which will replace the DRIVE designator on
  54.                       the directory output.  The maximum title length is
  55.                       20 characters, and no spaces may be contained in
  56.                       the input title.  To include spaces in the output
  57.                       title, use the underline character.  The underline
  58.                       will be translated to a space before the title is
  59. .HE INDEX101.DOC PAGE #
  60. .OP
  61.                       printed.  If you are using the Master Catalog Program
  62.                       and your disks have a disk name file with a dash as
  63.                       the first character, the disk name may be used as the
  64.                       title by using a /T- option.  This form of the title
  65.                       option causes the INDEX program to read the disk name
  66.                       and substitute it for the normal title.
  67.  
  68.           /B          Sets the brief mode.  The size reporting for each
  69.                       individual file is suppressed.  The total disk space
  70.                       used is still reported.  This mode is useful for
  71.                       large directories, since more columns will fit on
  72.                       the screen.
  73.  
  74.           /Wn         Set the output width to n, where n is a number in the
  75.                       range of 32 to 255.  This command can be used to
  76.                       adjust the program for screens smaller than the
  77.                       nominal value of 80, or to set the width to a
  78.                       larger number for directories sent to the printer.
  79.                       The number of columns is automatically adjusted to
  80.                       fit the width you specify.
  81.  
  82.           /S          Include system files in the directory listing
  83.                       (CP/M Version 2 only).  System files are
  84.                       normally suppressed from the directory.  This
  85.                       option allows you to display them.
  86.  
  87.           /M          Modify the program to reset any of the above
  88.                       options to the default value.  For example,
  89.                       INDEX /B/M will modify the program so that the
  90.                       brief mode is the normal state.  Including the
  91.                       /B command will then cause the expanded output
  92.                       form to be used.  /T-/M will cause the title to
  93.                       default to the disk name.  If no disk name is
  94.                       found, the normal DRIVE A title will be used.
  95.                       You can not set up any other title as the
  96.                       default value.  See the note below concerning
  97.                       this option.
  98.  
  99.            /V         Reports the version number for the INDEX program
  100.                       you are using.  Please include this version number
  101.                       when reporting any bugs or suggested improvements
  102.                       to the program.
  103.  
  104.            /Un        Lists the directory for user number n, where n
  105.                       is a number in the range of 0 to 15
  106.                       (CP/M Version 2 only).
  107.  
  108.            /H         Print a short help message on the console, which
  109.                       lists all of the available options.
  110.  
  111.  
  112.      The options may be chained together by separating then with a slash,
  113. which is used as the option designator character.  Chained options may appear
  114. in any sequence and may also include a space as a separator if desired.  There
  115. must be at least one space following the last option and any drive or file
  116. designator which is included.
  117.  
  118.      For example, the command
  119.  
  120.           INDEX /R/P /F/TSYSTEM_FILES B:*.COM
  121.  
  122. will reset the disk system, use a title of SYSTEM FILES, and output the
  123. directory of all COM files on drive B to the printer, with a leading form
  124. feed.  A little experimentation with the options and file name wild card
  125. characters will give a better understanding of their operation.  Note that all
  126. inputs may be in either lower or upper case, and are translated internally to
  127. upper case only, in keeping with the CP/M format.  This does not include the
  128. titles, which may be output in upper or lower case.
  129.  
  130.  
  131.                                 Error Messages
  132.  
  133.      There are three error messages which may be output by the program.  These
  134. are:
  135.  
  136.           INVALID FILE NAME  - Indicates that the file name specified is not a
  137. valid CP/M file name.  This usually means that it is too long, although other
  138. problems can cause this error message to appear.
  139.  
  140.           UNRECOGNIZED OPTION IGNORED - Indicates that an option has been
  141. included in the command string that the program does not recognize.  The error
  142. is ignored and all other options are still in effect.
  143.  
  144.           FILE ERROR DURING MODIFY - Indicates that the modify option was not
  145. completed successfully.  This can occur if the file INDEX.COM is not found on
  146. the default disk, if the program and disk version numbers do not match, or if
  147. a disk write error occurs.
  148.  
  149.  
  150.                                 Modify Option
  151.  
  152.      A word of caution if you use the Modify option.  This option requires
  153. that the INDEX.COM program is on the default disk.  If you are logged on to
  154. Drive A, and you issue the command B:INDEX /B/M to set the default to the
  155. brief mode, the program will search for a program named INDEX.COM on Drive A.
  156. If you do not have a second copy of the program on Drive A, an error will be
  157. reported and no serious consequences will result.  However, if there is a file
  158. named INDEX.COM on Drive A, and it is not the same as the program on Drive B,
  159. or is a completely different program, it is possible that it will be
  160. destroyed.  The modify command performs a check for the correct version number
  161. and a partial contents comparison before allowing the modify operation to be
  162. completed, but this is not completely foolproof.  The modify command asks for
  163. confirmation before updating the program so if you input the modify option by
  164. mistake you can abort it before any harm is done.
  165.  
  166.      The modify command can be used to set up a default value for performance
  167. of a series of runs, and then be used again to restore the program to its
  168. original state.  For example, if you want to list a series of directories on
  169. the printer, with a leading form feed for each printout, the command
  170.  
  171.           INDEX /P/F/R/M
  172.  
  173. can be used to set up the desired default mode.  You can then list all of the
  174. disks, assuming you are logged on to Drive A, using the command
  175.  
  176.           INDEX B:
  177.  
  178. The new default values eliminate the need to list the options separately for
  179. each disk that you put in the B drive.  Including the reset option allows the
  180. disk space remaining to be reported correctly, without having to input a
  181. Control C after each disk change.
  182.  
  183.      After you have printed all of the desired directories, the program output
  184. can be restored to the console by using the command
  185.  
  186.           INDEX /P/M
  187.  
  188. The /P option toggles the printer flag, and since the current default was for
  189. printer output, this returns the default to the console.  Also, since the /F
  190. and /R options were not reset, they are still in effect as the default mode.
  191. Using this technique, you can set up any available options that you desire as
  192. the default mode.  Note that only options preceeding the /M option in the
  193. command line will be modified.  A command of the form
  194.  
  195.           INDEX /B/M/P
  196.  
  197. will send a brief mode directory to the printer, but only the brief mode will
  198. be reset as the default value.  Since the /P option is after the /M option,
  199. the printer will be used for this run only, rather than becoming the default
  200. mode.
  201.  
  202.  
  203.                             Operating Restrictions
  204.  
  205.      The program is configured in a general manner and should work with any
  206. version of CP/M, with mini-disks, 8 inch disks, or even hard disks.  The
  207. program has been tested with CP/M Version 1.4 and 2.2 using both single and
  208. double density 8 inch disks, and with Version 2.2 using mini disks and hard
  209. disks.  Please report any errors or bugs which are detected to the author at
  210. the address listed above, including the INDEX version number as reported by
  211. the /V option, and as much detail about the system configuration and disk
  212. status as possible.
  213.  
  214.      There is one known case where file sizes may not be reported correctly.
  215. If you use the random write capability of CP/M Version 2, and write a file
  216. with holes (such as initially writing only record 10 and record 2356), the
  217. file size reported may not be correct.  Since this type of file occurs only
  218. rarely (most random files are initially created sequentially) the extra code
  219. necessary to assure correct size reporting for them has not been included in
  220. the program.  If you have a file of this type, the CP/M STAT command can be
  221. used to verify the file size.
  222.  
  223.  
  224. CP/M is a registered trademark of Digital Research.
  225.  
  226.