home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / IDXUTIL6.ZIP / IDX-UTIL.DOC < prev    next >
Text File  |  1994-11-01  |  35KB  |  685 lines
  1. IDX-UTIL.DOC - Release 6 - Nov 01, 1994 - Gary Meeker
  2.  
  3. This document contains information on how to use:
  4.    IDX-MAKE Version 1.00,
  5.    IDX-DUPS Version 2.30,
  6.    IDX-LIST Version 1.20,
  7.    IDX-SORT Version 1.10,
  8.    IDX-MERG Version 1.10,
  9.    IDX-DRIV Version 2.10,
  10.    IDX-RSET Version 1.40,
  11.    IDX-TEST Version 1.20,
  12.    IDX-EDIT Version 1.30 and
  13.    IDX-DIRS Version 1.10.
  14.  
  15.    These programs are released as FREEWARE to all REGISTERED PCBoard
  16. Version 14.5(a) or 15.x Sysops.  The Copyright is retained by Gary Meeker.
  17.  
  18.    What does this mean?  If you have purchased a license for PCBoard
  19. V14.5(a) or 15.x from Clark Development, then you are entitled to copy
  20. and use these utilities on as many computers as allowed by your license
  21. from Clark Development.  If you have an illegal copy of PCBoard V14.5(a)
  22. or 15.x these programs are not for YOU.
  23.  
  24.    License is also granted to any CD-ROM creator to use or include any
  25. of these files with your CD-ROM.
  26.  
  27. =========================================================================
  28. *DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*
  29.  
  30. Every effort has been made to avoid error and moderately extensive testing
  31. has been performed on these programs, however, I do not warrant them to be
  32. fit for any purpose or to be free from error and disclaims any liability
  33. for actual or any other damage arising from the use of these programs.
  34.  
  35. ENSURE YOU KEEP UP-TO-DATE BACKUPS OF ALL YOUR IMPORTANT FILES.
  36.  
  37. *DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*DISCLAIMER*
  38. =========================================================================
  39. IDX-Make Version 1.00   (07/01/94)
  40.    Creates a PCBoard .IDX File Index
  41.  
  42.       IDX-MAKE pathlist[.PTH] [indexname[.IDX]] [/S] [/D]
  43.  
  44. Where pathlist[.PTH] is an ASCII file (CR/LF delimited) listing paths that are
  45.    to be scanned for files (subdirectories of the paths are also scanned).
  46.  
  47. Where indexname[.IDX] is the name of the index file to be created based on the
  48.    files found in the paths specified by the pathlist file.
  49.  
  50. [/S] do not include subdirectories of the paths specified.
  51.  
  52. [/D] do not include the default exclusions.
  53.  
  54. This is a replacement for MAKEIDX.EXE for PCBoard. This allows it to be
  55. distributed to CD-ROM makers with no problem. It also offers features not
  56. found in MAKEIDX.
  57.  
  58. First, you only need specify the name of the .PTH/.IDX file once if they are
  59. the same. Next, IDX-MAKE will eliminate any duplicate path specifications
  60. before processing. If you accidentally specify a sub-directory that will be
  61. found within while traversing sub-directories, MAKEIDX will duplicate the files
  62. in that directory (and any further levels below it) which IDX-MAKE will avoid.
  63.  
  64. IDX-MAKE also allows specifying paths to exclude by placing a '-' in front
  65. of the path name. You may also specify filenames to exclude in the same
  66. manner. To be considered a filename and not a path, the filename MUST have
  67. a '.' in it and a path MUST NOT have one.
  68.  
  69. By default IDX-MAKE will include files in any sub-directory encountered in
  70. one of the specified paths. This allows a simple root directory to be
  71. specified to include all files on a CD-ROM. You may override this feature
  72. by including a /S on the command line.
  73.  
  74. Also by default IDX-MAKE will exclude files in the root directory itself
  75. and the filespecs FILES.BBS, SFFILES.BBS & *. (any file with no extension).
  76. You may override these defaults by including a /D on the command line.
  77.  
  78. A typical .PTH might look like this:
  79.  
  80. OWL12.PTH
  81. ---------
  82. S:\
  83. -S:\TEXT\
  84. -S:\PCBDIRS\
  85.  
  86. This would then create OWL12.IDX by typing:
  87.  
  88. IDX-MAKE OWL12
  89.  
  90. =========================================================================
  91. IDX-DUPS Version 2.30   (07/01/94)
  92.    List duplicate entries in a PCBoard File Index.  To use type:
  93.  
  94.       IDX-DUPS indexname[.IDX]  [indexname2.IDX]]  [/Q]  [/I]  [/Kn]
  95.  
  96. Where indexfile[.IDX] is the name of the index file to display.
  97. (The .IDX file extension is optional.  Do not include the '[' or ']'.)
  98.  
  99. Optionally you may include an indexname2[.IDX] which will be compared against
  100.  the first. Duplicates in the first will still be reported, but any files
  101.  found in the second which are also in the first will also be reported.
  102.  Duplicates in the second index will only be reported if they are also
  103.  in the first.
  104.  
  105.  [/Q] supresses the header info from the output.
  106.  
  107.  [/I] creates a file called COMMON.IDX containing the Index information
  108.   from the second Index when a file matches from the first index.
  109.   You can include a 3rd IndexfileName to override the default name.
  110.   Make sure you don't use the name of a file already on the disk or it
  111.   will be overwritten (unless that is what you want.) New with 2.00 is
  112.   the ability to use /I with a single IndexFile and get a COMMON.IDX
  113.   listing the Duplicates.
  114.  
  115.  [/Kn] Kill Duplicates. n:1=Prompt on all files (default)
  116.                           2=Prompt on different size files
  117.                           3=Don't prompt at all (Use with caution)
  118.  
  119.   This feature only works when two .IDX files are specified. The files from
  120.   the second .IDX files are the ones that will be deleted. If you have a
  121.   CD-ROM, you would want to specify it first and your Hard Disk(s) .IDX file
  122.   second, followed by /K (and 1, 2 or 3... If only /K is specified 1 is
  123.   assumed).
  124.  
  125.  [/C] Use Close Match instead of Exact Match. This helps find new versions
  126.   of the same file.  A close match is defined as a file in which the first
  127.   characters match follwed by Numeric characters ( '-'  and  '_'  are also
  128.   considered  Numeric characters  provided they  match in  both filenames.
  129.   There must be at least two Alpha character matches to be a close match.
  130.   Only the filnames are compared and extensions are ignored.
  131.  
  132.  
  133.   123TLK25.ZIP      These do not match because only 1 Alpha character matches.
  134.   123TXFRM.ZIP
  135.  
  136.   1ST_101A.ZIP      These match but may be part of 1 release and not dupes.
  137.   1ST_101B.ZIP
  138.  
  139.   AC214B.ZIP        These Match although they are probably unrelated.
  140.   AC2VIV.ZIP
  141.  
  142.   BNP120.ARJ        These match because extensions are ignored.
  143.   BNP120.ZIP
  144.  
  145. I setup a CD-Rom conference available to only those Users who contributed
  146. to making the purchase of the CD-Rom Drives & Disks possible. All the
  147. CD-Rom files are available from that conference but not the Main Board
  148. or other Conference Files (accept the Masterfile list Directory.)
  149. I used this to find all the files on my Hard Disks that were also on the
  150. new CD-Roms. I feed DLPATH.LST to MAKEIDX to create an Index for my Hard
  151. Drives. Then using this utility I created an Index of the Duplicates.  I
  152. added both of these (one for each CD-Rom) to the DLPATH.LST and deleted
  153. the files from the Hard Drives. This way I didn't loose any files from my
  154. board available to everyone but was able to free up the storage space they
  155. were taking up. My Users could not tell the difference and everyone was
  156. happy. Once IDX-Edit is finished I can add some of the files on the CD-Rom
  157. to these Indexes to help fill out some of the Conferences which are bare
  158. of files right now. I could copy the files from the CD-Rom to the Hard Drives
  159. and create another Index of the Dups to add them in, but it will be easier
  160. after the routine gets finished.
  161.  
  162.  
  163. V2.10 Fixed problem with display of <A: value on first .IDX file.
  164. V2.20 Added Close Match option
  165. V2.30 Fixed file count when no files of a particular letter
  166. =========================================================================
  167. IDX-List Version 1.20   (07/01/94)
  168.    List entries in a PCBoard File Index.  To use type:
  169.  
  170.       IDX-LIST indexname[.IDX]  [filemask]  [/Q]
  171.  
  172. Where indexname[.IDX] is the name of the index file to list.
  173. (The .IDX file extension is optional.)
  174.  
  175.  and [filemask] is the file or wildcard match to list.
  176.  
  177. [/Q] supresses the header info from the output.
  178.  
  179. V1.10 Fixed a problem with the filemask when it did not include a '.' in it
  180.        and a problem with display of <A: value on.
  181. V1.20 Fixed file count when no files of a particular letter
  182. =========================================================================
  183. IDX-Sort Version 1.10   (07/01/94)
  184.    Sort entries in a PCBoard File Index.  To use type:
  185.  
  186.       IDX-SORT indexname[.IDX]  [/Q]
  187.  
  188. Where indexname[.IDX] is the name of the index file to sort.
  189. (The .IDX file extension is optional.)
  190.  
  191. [/Q] supresses the header info from the output.
  192.  
  193. Provided there is enough memory to do the sort, this program will read the
  194. index file into memory and sort the index.
  195.  
  196.  
  197. V1.10 Fixed file count when no files of a particular letter
  198. =========================================================================
  199. IDX-MERG Version 1.10   (07/01/94)
  200.    Combine two PCBoard File Indexes into one
  201.  
  202.       IDX-MERG indexname1[.IDX]  indexname2[.IDX]  [indexname3[.IDX]]  [/Q]
  203.  
  204. Where indexname1[.IDX] and indexname2[.IDX] are the names of the index
  205.  files to merge.
  206.  
  207. Where [indexname3[.IDX]] is the name of the index file to be created.
  208.  this is optional, if omitted COMMON.IDX will be used
  209.  
  210. Note: The .IDX extension is optional. Do not include the '[' or ']'.
  211.  
  212. [/Q] supresses the header info from the output.
  213.  
  214. NOTE: DO NOT name the output file as either of the two input files or you
  215.       will destroy it!
  216.  
  217. IDX-MERG is designed to create a single IDX file from two IDX files. This
  218. allows creating 1 large IDX file to scan for duplicates or just to use
  219. with PCBoard rather than including several entries in your DLPATH.LST file.
  220. I created it to combine the NightOwl series IDX files into a single file
  221. to compare against other CD-ROMs and against my Hard Disk (using IDX-DUPS).
  222. You could just create a .PTH file containing multiple drive\paths and let
  223. MAKEIDX create the large IDX file if you have enough CD-ROM drives to hold
  224. all the CD-ROMS you are trying to index, but I only had a single drive at
  225. the time and wanted to combine several CD-ROMs into 1 file. IDX-DRIV (below)
  226. has also been changed to allow changing the paths on a single CD-ROM when
  227. they are combined in a single IDX file. Use IDX-EDIT to list the Range
  228. of path entries for each CD-ROM after combining (or do the math by hand).
  229.  
  230. V1.10 Fixed file count when no files of a particular letter
  231. =========================================================================
  232. IDX-DRIV Version 2.10   (07/01/94)
  233.    Set Drive Letter on all paths in a PCBoard File Index. To use type
  234.  
  235.       IDX-DRIV indexname[.IDX]  DriveLetter  [/Q] [/R:Start-End]
  236.  
  237. Where indexname[.IDX] is the name of the index file to set.
  238.  
  239. DriveLetter is the Drive Letter to assign to all paths
  240.  
  241. [/Q]            supresses the header info from the output.
  242. [/R:Start-End]  specifies the Starting and Ending Path numbers to change.
  243.                   Must include '-' and no spaces. Example /R:1-35
  244.  
  245. IDX-DRIV is designed to modify the Paths in an IDX file to whatever drive
  246. letter you desire (This is quicker than using MAKEIDX again just because
  247. you changed the drive letter).
  248.  
  249. Version 2.00 includes the abilty to specify the Starting and Ending Path
  250. numbers to change, allowing the changing of Drive letters when using a
  251. combined IDX file. (Created with MAKEIDX using a .PTH file containing
  252. multiple CD-ROM drive/paths or using IDX-MERG to combine multiple .IDX files.)
  253.  
  254.  
  255. V2.00 Added ability to specify Path range to change to allow using
  256.        combined IDX files.
  257. V2.10 Allowed for "." in Path
  258. =========================================================================
  259. IDX-RSET Version 1.40   (11/01/94)
  260.    Set Active CD-Roms and Drives in a PCBoard File Indexes. To use type
  261.  
  262.       IDX-RSET ConfigFile  [/Q]
  263.  
  264. Where: ConfigFile = Drive:Path to our configuration file.
  265.  
  266. [/Q] supresses the header info from the output.
  267.  
  268.  
  269. The ConfigFile contains 7 or more lines:
  270. Line 1: Loc/Name of the CDROM database File
  271. Line 2: Ignored by IDX-RSET
  272. Line 3: Ignored by IDX-RSET
  273. Line 4: Place CD-ROM Index Files at Beginning of DLPATH.LST files.
  274. Line 5: Loc/Name of AllFiles DLPATH.LST file to be checked/altered
  275. Line 6: Number of DLPATH.LST files to check
  276. Line 7+ Loc/Name of each DLPATH.LST file to be checked/altered
  277. Line N  Number of CD-ROM Drives (Conferences) to update
  278. Line N+ Loc/Name of each DIR file, Loc/Name of each DIR.LST file
  279.  
  280. The CDROM database File contains 3 or more lines
  281. Line 1: Number of CD-ROMS listed in database, List of Drives for CD-ROMS
  282. Line 2+ CDRom Name Label, Loc/Name of IndexFile, TestFile, DirFile, DirLstFile
  283.  
  284.  
  285. IDX-RSET is designed to assist in changing CD-ROMS if you have more CD-ROMS
  286. than drives. First create an Index file for each CD-ROM using MAKEIDX. Next
  287. create the CDROM DataBase file using a text editor. Line 1 defines how many
  288. CD-ROMS will be listed in the data base and a list of CD-ROM Drive letters
  289. with no spaces or seperators (ie. STU or STUVWX). The following lines include
  290. a label for identifying the CD-ROM (used only as output name for your use)
  291. (but NOTE: DO NOT include a comma in the label)), the Drive:\Path\Filename
  292. of the indexfile for this CD-ROM, and a test file unique to this CD-ROM to
  293. allow the program to identify the CD-ROM (DO NOT include a drive letter or
  294. leading :\ for the path.)
  295.  
  296. Example (I have 35 CD-ROMS and 4 Drives)
  297.  
  298. 35,STUV
  299. CD-Rom1, O:\ROM\IDX\ROM1.IDX, ROM01\159KEYS.ZIP, O:\ROM\ROM1\DIR, O:\ROM\ROM1\DIR.LST
  300. CD-Rom2, O:\ROM\IDX\ROM2.IDX, ROM201\1FINGER.ZIP, O:\ROM\ROM2\DIR, O:\ROM\ROM2\DIR.LST
  301. Pier_3, O:\ROM\IDX\PIER3.IDX, 001\ACIDFEAR.ZIP, O:\ROM\PIER3\DIR, O:\ROM\PIER3\DIR.LST
  302. Pier_4, O:\ROM\IDX\PIER4.IDX, 001\AASS204.ZIP, O:\ROM\PIER4\DIR, O:\ROM\PIER4\DIR.LST
  303. NightOwl_5, O:\ROM\IDX\OWL5.IDX, 001A\315MOUSE.ZIP, O:\ROM\OWL5\DIR, O:\ROM\OWL5\DIR.LST
  304. NightOwl_6, O:\ROM\IDX\OWL6.IDX, 001A\4QMODEM.ZIP, O:\ROM\OWL6\DIR, O:\ROM\OWL6\DIR.LST
  305. NightOwl_7, O:\ROM\IDX\OWL7.IDX, 001A\42BOOT.ZIP, O:\ROM\OWL7\DIR, O:\ROM\OWL7\DIR.LST
  306. NightOwl_8, O:\ROM\IDX\OWL8.IDX, 001A\APCAT193.ZIP, O:\ROM\OWL8\DIR, O:\ROM\OWL8\DIR.LST
  307. NightOwl_9, O:\ROM\IDX\OWL9.IDX, 001A\20BACKGR.ZIP, O:\ROM\OWL9\DIR, O:\ROM\OWL9\DIR.LST
  308. NightOwl_10, O:\ROM\IDX\OWL10.IDX, 001A\ADDPN32.ZIP, O:\ROM\OWL10\DIR, O:\ROM\OWL10\DIR.LST
  309. NightOwl_11, O:\ROM\IDX\OWL11.IDX, 001A\APLANR.ZIP, O:\ROM\OWL11\DIR, O:\ROM\OWL11\DIR.LST
  310. NightOwl_12, O:\ROM\IDX\OWL12.IDX, 001A\4D50D.ZIP, O:\ROM\OWL12\DIR, O:\ROM\OWL12\DIR.LST
  311. NightOwl_BBS, O:\ROM\IDX\OWLBBS.IDX, 001A\1MADV096.ZIP, O:\ROM\OWLBBS\DIR, O:\ROM\OWLBBS\DIR.LST
  312. NightOwl_WIN, O:\ROM\IDX\OWLWIN.IDX, 001A\4DOSNT10.ZIP, O:\ROM\OWLWIN\DIR, O:\ROM\OWLWIN\DIR.LST
  313. NightOwl_GAMES, O:\ROM\IDX\OWLGAMES.IDX, 001A\1AGENT.ZIP, O:\ROM\OWLG\DIR, O:\ROM\OWLG\DIR.LST
  314. ShareWare_Studio_I,O:\ROM\IDX\SS1.IDX, ANSI\A2A20.ZIP, O:\ROM\SS1\DIR, O:\ROM\SS1\DIR.LST
  315. ShareWare_Studio_II,O:\ROM\IDX\SS2.IDX, 4DOS\4D401D.ZIP, O:\ROM\SS2\DIR, O:\ROM\SS2\DIR.LST
  316. ShareWare_Studio_III,O:\ROM\IDX\SS3.IDX, 4DOS\4D24H20B.ZIP, O:\ROM\SS3\DIR, O:\ROM\SS3\DIR.LST
  317. Phoenix_2, O:\ROM\IDX\P2.IDX, 01A\132101BT.ZIP, O:\ROM\P2\DIR, O:\ROM\P2\DIR.LST
  318. Phoenix_3, O:\ROM\IDX\P3.IDX, TS\01A\ALPHA7.ZIP, O:\ROM\P3\DIR, O:\ROM\P3\DIR.LST
  319. Phoenix_4, O:\ROM\IDX\P4.IDX, TS\01A\256PBX.ZIP, O:\ROM\P4\DIR, O:\ROM\P4\DIR.LST
  320. So_Much_ShareWare_1, O:\ROM\IDX\SMS1.IDX, ASM\A86V322.ZIP, O:\ROM\SMS1\DIR, O:\ROM\SMS1\DIR.LST
  321. So_Much_ShareWare_2, O:\ROM\IDX\SMS2.IDX, BUDGET\ACHK361.ZIP, O:\ROM\SMS2\DIR, O:\ROM\SMS2\DIR.LST
  322. So_Much_ShareWare_3, O:\ROM\IDX\SMS3.IDX, BUDGET\ALI203.ZIP, O:\ROM\SMS3\DIR, O:\ROM\SMS3\DIR.LST
  323. So_Much_ShareWare_4, O:\ROM\IDX\SMS4.IDX, BBSDOORS\4SQ22.ZIP, O:\ROM\SMS4\DIR, O:\ROM\SMS4\DIR.LST
  324. Origional_ShareWare_92, O:\ROM\IDX\OS92.IDX, 1\0929REF.ZIP, O:\ROM\OS92\DIR, O:\ROM\ROM2\OS9.LST
  325. VGA-Spectrum_1, O:\ROM\IDX\VGASP1.IDX, ANIMATE\FLI\1988EGA.FLI, O:\ROM\VGA1\DIR, O:\ROM\VGA1\DIR.LST
  326. VGA_Spectrum_2, O:\ROM\IDX\VGASP2.IDX, ANIMATE\FLI1\1988EGA.FLI, O:\ROM\VGA2\DIR, O:\ROM\VGA2\DIR.LST
  327. ShareWare_Overload, O:\ROM\IDX\SO.IDX, BUSI\90TAXEST.ZIP, O:\ROM\SO\DIR, O:\ROM\SO\DIR.LST
  328. Super_CD_II, O:\ROM\IDX\SUPCD2.IDX, BBS_DOOR\2002HLP2.ZIP, O:\ROM\SUP_CD2\DIR, O:\ROM\SUP_CD2\DIR.LST
  329. Cream_of_the_Crop, O:\ROM\IDX\COTC.IDX, BATCH\ANSIMATE.ARJ, O:\ROM\COC\DIR, O:\ROM\COC\DIR.LST
  330. Calif_Collection, O:\ROM\IDX\CC.IDX, HIS001\BRAINX1.ZIP, O:\ROM\CC\DIR, O:\ROM\CC\DIR.LST
  331. ShareWare_DataBase1, O:\ROM\IDX\SD1.IDX, 4DOS\4BATCH10.ZIP, O:\ROM\SD1\DIR, O:\ROM\SD1\DIR.LST
  332. MonsterDisc_II, O:\ROM\IDX\MD2_1.IDX, 4DOS\42BOOT.ZIP, O:\ROM\MD2_1\DIR, O:\ROM\MD2_1\DIR.LST
  333. MonsterDisc_II, O:\ROM\IDX\MD2_2.IDX, GENE\AHNDES17.ZIP, O:\ROM\MD2_2\DIR, O:\ROM\MD2_2\DIR.LST
  334.  
  335. Next create the config file using a text editor.   The first line contains
  336. the Drive:\Path\Filename of the above database.  The forth line determines
  337. if the CD-ROM Index  files should be  listed at the beginning (YES) or the
  338. end (NO) of the DLPATH.LST files (NOTE: a special mode is available by the
  339. use of AUTO which causes the Index files to be listed after the end of the
  340. first occurances of INDEX files in the DLPATH.LST file).    The fifth line
  341. contains the Drive:\PATH\Filenames of the AllFiles DLPATH.LST file. The sixth
  342. Line contains the number of DLPATH.LST files to be checked.  The following
  343. lines contain the Drive:\PATH\Filenames of each of the DLPATH.LST files.
  344. This list is followed by the number of drives (or conferences) that need
  345. to be updated for DIR & DIR.LST files, and finally a list of DIR & DIR.LST
  346. files to update.
  347.  
  348. When run, IDX-RSET will Check each CD-ROM listed and determine which drive
  349. it is in. It will then modify the INDEX file so the PATHS will contain the
  350. proper Drive letter. Once each CD-ROM is located it will read each of the
  351. DLPATH.LST files listed and look for INDEX files. If the Index File is one
  352. of the files listed, it will be skipped. Any other INDEX file as well as any
  353. other line will be copied to the new DLPATH.LST file which will then be
  354. renamed to the origional file. The result will be a DLPATH.LST file which will
  355. contain the proper index files for the CD-ROMS that are found to be online
  356. and the index files modified so the paths contain the proper Drive letter.
  357.  
  358. Version 1.10 changed the config file to be compatible with the IDX-TEST,
  359. just insert a new line 2 and 3.
  360.  
  361. Version 1.20 added support for the AllFiles list in PCBoard 15. All the
  362. Indexes will be added to this file. Indexes which are offline will have
  363. the drive letter set to '@' allowing the use of the TSR program CD_CHECK.COM
  364. to be used. If this TSR is loaded, it will report any file to exist when
  365. DOS function 04Eh (Find First Matching File) is executed to locate a file
  366. on drive '@'. This will 'fool' PCBoard into reporting the file to already
  367. exist when a User attempts to upload a file found in an OffLine .IDX file.
  368.  
  369. Normally PCBoard would not detect the duplicate because it actually checks
  370. the drive for the file even though it was found in a .IDX file which requires
  371. the CD-ROM to be online. For those of us with more CD-ROM's than drives this
  372. will be very helpful in blocking files we already have. CD_CHECK should be
  373. loaded in your AUTOEXEC.BAT file.
  374.  
  375. Version 1.40 adds support for changing DIR & DIR.LST files automatically
  376. for CD-ROM's found in the drives. The format of the Configuration file &
  377. Database has changed to allow entering the filename (with Drive 7 path)
  378. for each CD-ROM's DIR & DIR.LST file.  The config file has also been
  379. changed to allow defining each CD-ROM conference DIR & DIR.LST file that
  380. needs to be changed.  You must have a line for each CD-ROM Drive you have.
  381.  
  382. Now when IDX-RSET is run, it will change the first conference's DIR & DIR.LST
  383. file to the first CD-ROM it finds, then the second conference to the next
  384. CD-ROM it finds, etc. This is mostly intended for Sysops with a single drive
  385. and several CD-ROM's wanting to change the CD-ROM's periodically.
  386.  
  387. V1.10 Changed configuration file to work with IDX-TEST.
  388. V1.20 Added support for the ALLFILES DLPATH.LST
  389. V1.30 Allowed for "." in Path
  390. V1.40 Changed format of CDROM Database File to change DIR & DIR.LST
  391. =========================================================================
  392. IDX-TEST Version 1.20   (11/01/94)
  393.    Test Active CD-Roms and Drives. To use type
  394.  
  395.       IDX-TEST ConfigFile OutputFile [CD-ROM] [/Q]
  396.  
  397. Where: ConfigFile = Drive:Path to our configuration file.
  398.        OutputFile = Drive:Path:Filename of the output text file
  399.        CD-ROM     = CD-ROM # to check for (0 = ALL Online CD-Rom's)
  400.  
  401. [/Q] supresses the header info from the output.
  402.  
  403.  
  404. The ConfigFile contains 3 or more lines:
  405. Line 1: Loc/Name of the CDROM database File
  406. Line 2: Loc/Name of the OnLine Report File
  407. Line 3: Loc/Name of the OffLine Report File
  408. Line 4: Ignored by IDX-TEST
  409. Line 5: Ignored by IDX-TEST
  410. Line 6: Ignored by IDX-TEST
  411. Line 7+ Ignored by IDX-TEST
  412. Line N  Ignored by IDX-TEST
  413. Line N+ Ignored by IDX-TEST
  414.  
  415. The CDROM database File contains 3 or more lines
  416. Line 1: Number of CD-ROMS listed in database, List of Drives for CD-ROMS
  417. Line 2+ CDRom Name Label, Loc/Name of IndexFile, TestFile, DirFile, DirLstFile
  418.  
  419.  
  420. IDX-TEST is designed to assist in informing the User which of your CD-ROMS
  421. is ONLINE/OFFLINE.  Create the CDROM DataBase file using a text editor.
  422. Line 1 defines how many CD-ROMS will be listed in the data base and a list
  423. of CD-ROM Drive letters with no spaces or seperators (ie. STU or STUVWX).
  424. The following lines include a label for identifying the CD-ROM (used only
  425. as output name for your use) (but NOTE: DO NOT include a comma in the label)),
  426. the Drive:\Path\Filename of the indexfile for this CD-ROM, and a test file
  427. unique to this CD-ROM to allow the program to identify the CD-ROM (DO NOT
  428. include a drive letter or leading :\ for the path.)
  429.  
  430. Example (I have 9 CD-ROMS and 3 Drives)
  431.  
  432. 9,STU
  433. Pier_4, O:\ROM\IDX\PIER4.IDX, 001\AASS204.ZIP, O:\ROM\PIER4\DIR, O:\ROM\PIER4\DIR.LST
  434. NightOwl_5, O:\ROM\IDX\OWL5.IDX, 001A\315MOUSE.ZIP, O:\ROM\OWL5\DIR, O:\ROM\OWL5\DIR.LST
  435. NightOwl_6, O:\ROM\IDX\OWL6.IDX, 001A\4QMODEM.ZIP, O:\ROM\OWL6\DIR, O:\ROM\OWL6\DIR.LST
  436. NightOwl_7, O:\ROM\IDX\OWL7.IDX, 001A\42BOOT.ZIP, O:\ROM\OWL7\DIR, O:\ROM\OWL7\DIR.LST
  437. NightOwl_8, O:\ROM\IDX\OWL8.IDX, 001A\APCAT193.ZIP, O:\ROM\OWL8\DIR, O:\ROM\OWL8\DIR.LST
  438. NightOwl_9, O:\ROM\IDX\OWL9.IDX, 001A\20BACKGR.ZIP, O:\ROM\OWL9\DIR, O:\ROM\OWL9\DIR.LST
  439. NightOwl_10, O:\ROM\IDX\OWL10.IDX, 001A\ADDPN32.ZIP, O:\ROM\OWL10\DIR, O:\ROM\OWL10\DIR.LST
  440. NightOwl_11, O:\ROM\IDX\OWL11.IDX, 001A\APLANR.ZIP, O:\ROM\OWL11\DIR, O:\ROM\OWL11\DIR.LST
  441. NightOwl_12, O:\ROM\IDX\OWL12.IDX, 001A\4D50D.ZIP, O:\ROM\OWL12\DIR, O:\ROM\OWL12\DIR.LST
  442.  
  443. Next create the config file using a text editor. The first line contains
  444. the Drive:\Path\Filename of the above database.     Additional lines are
  445. ignored by IDX-TEST allowing the same files to be used by IDX-RSET.
  446.  
  447. When run, IDX-TEST will check each CD-ROM listed and determine which drive
  448. it is in if no CD-ROM is specified on the command line.  If a command line
  449. is given containing the CD-ROM number to check, then only that CD-ROM will
  450. be tested for and the output file will report whether that CD-ROM is online
  451. or offline. If it is Online the Online Report File will be copied to the
  452. OutputFile, if Offline then the Offline Report File will be copied. During
  453. the copy @CDROM@ wil be translated to the name of the CD-ROM as listed in
  454. the CDROM database file. If 0 is specified then IDX-TEST will check each
  455. CD-ROM listed and list only those that are found ONLINE.
  456.  
  457. Example:
  458. IDX-TEST C:\PCB\IDX-RSET.CFG CDSTATUS /Q
  459.  
  460. This can be run from a PPE file and I have included SHELL.PPE with which
  461. you can run this program from the Conference INTRO file as follows:
  462.  
  463. !C:\PCB\PPE\SHELL.PPE C:\UTIL\IDX-TEST.EXE C:\PCB\IDX-RSET.CFG CDSTATUS /Q
  464. %CDSTATUS
  465.  
  466. If you have a conference for each CD-ROM and only some are online, then you
  467. could include the number of the CD-ROM on the command line in each INTRO
  468. file as follows:
  469.  
  470. !C:\PCB\PPE\SHELL.PPE C:\UTIL\IDX-TEST.EXE C:\PCB\IDX-RSET.CFG CDSTATUS 1 /Q
  471. %CDSTATUS
  472.  
  473. V1.10 Allowed for "." in Path
  474. V1.20 Changed format of CDROM Database File.
  475. =========================================================================
  476. IDX-Edit Version 1.30   (07/01/94)
  477.    Edit entries in a PCBoard File Index.  To use type:
  478.  
  479.       IDX-EDIT [indexname[.IDX]  [/F]  [/C]
  480.  
  481. Where indexname[.IDX] is the name of the index file to edit.
  482. (The .IDX file extension is optional.)
  483.  
  484. [/F] Tag first file also on duplicates.
  485.  
  486. [/C] Use Close Match instead of Exact Match.
  487.      See IDX-DUPS for details on a Close Match. When Close Match is ON,
  488.      Tag First is ignored and all files are tagged except the last match
  489.      as this is assumed to be the lastest version of a file.
  490.  
  491. If not given, the file name will be prompted for.
  492.  
  493. This will be the most powerful Utility of the batch once it is finished.
  494.  
  495. Currently it allows for complete editing of the data in the index file.
  496. You can TAG files based on Duplicates in the index file, Files found in
  497. another index file, a FileMask, by Path Number, Path/FileMask in a text
  498. file, Path/File in a text report from IDX-DUPS or manually.
  499.  
  500. Tagging files by reading a file for Paths\FileNames, this will be either a
  501. straight file of filenames  (with/without paths) or a text file  generated
  502. by redirecting the output of IDX-DUPS to a file is possible.  The straight
  503. file format is 1 filespec per line.  This may include wildcards and paths.
  504. The paths must match the path  text in the IDX file exactly  or it will be
  505. skipped. An entry such as S:\001A\C*.* or Z*.* is considered legal.    The
  506. report format  skips all lines that do  not have a  colon in column 13 and
  507. the name at the start of the line does not match the current IDX file. The
  508. full name and path are checked and tagged if found.
  509.  
  510. The Tagged files may then be deleted, written to another index file or can
  511. be untagged manually or all at once.
  512.  
  513. Editing of Paths is also be possible to allow easy changing of drive letters,
  514. etc.   Paths will be able to be added or deleted in a future version and the
  515. path of any file will be able to be changed. Version 1.20 now only writes
  516. the Paths out that are used when creating a New File from tagged entries.
  517. the paths are renumbered and the new number written out with each filename.
  518.  
  519. Other features will be available if I come up with any or requests are
  520. made, and I can work them in.
  521.  
  522. I also plan to add the ability to change the order of the files on duplicates.
  523. This will allow you to control which file PCBoard finds first (especially if
  524. you use IDX-MERG and combine several IDX files into one and want to place the
  525. more recent file first).
  526.  
  527. Currently only Displaying, Editing and Tagging are finished.
  528.  
  529. The program is pretty straight forward, so I will only mention some of the
  530. functions and keyboard commands available. From the Main Menu, either the
  531. Numeric key or Function key may be used to select a menu choice. Selections
  532. 4 & 5 will only function if there are files tagged. Selection 4 will prompt
  533. you for a file name and if the file exists, you will be prompted to confirm
  534. an overwrite. Selection 5 will prompt for confirmation of the deletion also.
  535.  
  536. When Displaying/Edit Filenames, The following functions are available:
  537.  
  538. Dn, Up       Move to Next/Prev FileName
  539. PgDn, PgUp   Move to Next/Prev Page
  540. Tab          Move to the Next Tagged Filename
  541. Shift-Tab    Move to the Prev Tagged Filename
  542. Alt-Key      Jump to first Filename starting with letter of Alt-Key pressed
  543.                (Alt-# jumps to Beginning,  Alt-= jumps to End)
  544. F2           Tag/UnTag current FileName (Cursor moves Down one line)
  545. F3           Jump to a Line (FileName) Number
  546. F5           Decrements Path Number
  547. F6           Increments Path Number
  548. F7           Flip All Tags
  549. F8           Clear All Tags
  550. F10          Special Tagging Menu
  551. Ctrl-D       Undo Edit of Current FileName (Restore Default Input)
  552. Ctrl-X       Clear Current FileName (Erase Field)
  553. Home, End    Go to Beginning/End of Field
  554. Left, Right  Move Cursor Left/Right
  555. Ctrl-Left,
  556.  Ctrl-Right  Move Cursor Left/Right one word
  557. Ins          Toggle Insert Mode (Starts in OFF on EACH new line)
  558. Del          Del Character at Cursor
  559. BS           Del Character Left of Cursor
  560. ESC          Exit (Current line edited will be aborted)
  561.  
  562. Once the Cursor has been moved to another line, the edited data has been
  563. written to the disk. MAKE BACKUPS of the files (although they are easily
  564. regenerated.)
  565.  
  566. When editing the actual Filename data,  keep in mind that PCBoard does a
  567. binary search on the file,  so if you change the name,  it may cause the
  568. search to fail. I recommend changing the last character to - or _ so the
  569. sorted order of the list is not affected.  If there are no duplicates of
  570. the file or you are changing the last filename of a duplicate,  use _ as
  571. the character.  If it is the first filename of a duplicate, use - as the
  572. character.  Changing the name shouldn't really be necessary now that you
  573. can delete a file from the index file by tagging it and using the delete
  574. function. A sort feature is planned for a future version to allow you to
  575. actually change a  name completely  (especially if you rename a  file on
  576. the hard disk itself and want to change the Index file instead of running
  577. MAKEIDX again.) Currently an external sort utility is provided (IDX-SORT)
  578. and if you change any filenames, I would recommend sorting the index just
  579. to be safe.
  580.  
  581. This has been a slow project as I have been writing them as I needed them
  582. and haven't spent much time on this one as my need for it has been low. If
  583. you have a need for it, let me know and I will spend more time on it.
  584.  
  585.  
  586. V1.10 Added Close Match option
  587. V1.20 Added range of paths to tagging by path
  588.        Only Paths used are written out to New File.
  589. V1.30 Fixed file count when no files of a particular letter
  590. =========================================================================
  591. IDX-DIRS Version 1.10   (07/01/94)
  592.    Strip files not found in an .IDX from a DIR listing. To use type:
  593.  
  594.       IDX-DIRS [@]indexname[.IDX]  [@]dirfile.ext [/Q] [/M] [/B]
  595.  
  596. Where indexname[.IDX] is the name of the index file to check.
  597.  and [dirfile.ext] is the text file to strip.
  598.  Either may be a file containing a list of files if preceeded by '@'
  599.  
  600. [/Q] supresses the header info from the output.
  601.  
  602. [/M] write missing files to seperate file (with extension .DEL).
  603.  
  604. [/B] rename origional file as .BAK istead of deleting it.
  605.  
  606. This utility will strip out and files not found in an .IDX file (or a list
  607. of .IDX files) from a DIR listing file (or a list of DIR files).  The DIR
  608. file will be opened along with a TEMP file and each file will be checked to
  609. see if it is in the specified .IDX file(s). If not it will be skipped (or
  610. optionally written to a seperate file). This allows stripping the files
  611. from a DIR after removing Duplicates with IDX-EDIT. If you have combined
  612. several CD-ROM DIR files you can use a text file to list both .IDX files
  613. so both .IDX file will be checked before deleting the file listing. It will
  614. be faster, however, if you can first create a combined .IDX listing using
  615. IDX-MERG. When only a single .IDX file is used, IDX-DIRS will open it and
  616. read the header immediately, and then leave it open while scanning the DIR
  617. files. Otherwise, each .IDX file is opened and checked, then closed for
  618. every file in the DIR list. Leaving it open all the time runs 33% faster.
  619. Creating a text file listing all the DIR files to be processed allows you
  620. to walk away while IDX-DIRS does the whole job for you.
  621.  
  622. After stripping files from the listing, the origional file is either deleted
  623. (or renamed to .BAK if /B is used) and the TEMP file is renamed to the
  624. origional. Using /M will also create a file with a .DEL extension to write
  625. files that were striiped into allowing you to review the missing files.
  626.  
  627. V1.10 Fixed file count when no files of a particular letter
  628. =========================================================================
  629. BBS CD-ROM Authors: Please feel free to include these Utilities with your
  630.    CD-ROM.   You may also include any  number of the files extracted from
  631.    the .ZIP file without my DOCS.  This will allow you to include an .IDX
  632.    file for your CD-ROM and include  IDX-DRIV.EXE  on the disk along with
  633.    a batch file (ROM.BAT for example) that allows the  User to change the
  634.    drive of the Index to fit their  needs without having to  regenerate a
  635.    new index file. An example of the batch file would be:
  636.  
  637.    IDX-DRIV YourFile %1 %2 /Q
  638.  
  639.    and the User would simply type ROM X to set the drive letter to X: after
  640.    copying the Index File and batch file to their hard drive.
  641. =========================================================================
  642. Note:  I haven't received much feedback on this project so I don't know if
  643. anyone is finding any use for the utilities or not.   If you are using the
  644. programs let me know and I will keep updating them and developing additonal
  645. programs.
  646. =========================================================================
  647.  
  648. CONTACTING THE AUTHOR
  649.  
  650. There are a number of ways to contact the author:
  651.  
  652.    1.  Call the support BBS, SHARP Technical Support Line BBS (404) 962-1788.
  653.  
  654.    2.  Fax: (404) 995-0613
  655.  
  656.    3.  Send net mail message through one of the mail networks addressed to
  657. 'Gary Meeker'. I carry ProgNet Network on my BBS so will see any mail in
  658. any conference. I also call SaltAir at least once a week so this is a
  659. perfect place to contact me also through the Utilities Conference.
  660.  
  661.    4.  Send letter through regular post to the following address:
  662.  
  663.          ATTN: Gary Meeker
  664.          SHARP Technical Support Line BBS
  665.          725-C Old Norcross Road
  666.          Lawrenceville, GA 30245
  667.  
  668. =========================================================================
  669. Source Code:
  670.  
  671. All programs are written in QuickBasic 4.5 and compiled using P.D.Q.
  672. from Crescent Software. This results in very small code. Also several
  673. routines from Crescent's QuickPack Professional Library and some of myown
  674. Library routines were used.
  675.  
  676. For those who would like source code, it can be obtained by sending $10
  677. to the address above, made payable to Gary Meeker. Specify 3.5" or 5.25" &
  678. DD or HD format disks. You will receive the QB4.5 source code and the
  679. assembly code and Library for myown routines. To compile the code you will
  680. need P.D.Q. & QuickPack Professional from Crescent Software or replace the
  681. Library calls by uncommenting the internal routines which accomplish the
  682. same functions but result in larger code. Compiling then can be done under
  683. QB4.5 just fine. (although the files will be 2 to 4 times as large.)
  684. =========================================================================
  685.