home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / arc_lbr / arcindx2.arc / ARCINDEX.DOC next >
Text File  |  1988-06-26  |  5KB  |  113 lines
  1.                         ARCINDEX.DOC
  2.                          Version 2.0
  3.                                                       06-26-88
  4. Introduction
  5.  
  6. Archived data files can be a mixed blessing.  They surely take up
  7. less disk space, but it is not always so easy to find files that
  8. have been archived.  Unless you keep detailed records of where
  9. your files are stored, they can become lost forever amongst all
  10. the other nameless files.  ARCINDEX combats this problem by helping
  11. to make the files more visible.  Using this program you extract
  12. relevant file information from the archive and save it in catalog
  13. form.  The catalog is really no more than an ASCII file that can be
  14. loaded by a database programs, like Reflex (R), where you have easy
  15. access to the file names and the archives in which the files are
  16. stored.  Once inside the database, any one of 8 file related
  17. categories can be searched using database commands.
  18.  
  19. Extracting ARCINDEX
  20.  
  21. ARCINDEX should contain this document and one EXE file with the
  22. same name.  Use any of the dearchiving programs to extract
  23. ARCINDEX.    Place the EXE file in the subdirectory where you
  24. normally place PKARC.COM.  It is most useful there because from
  25. there it can be called to any other subdirectory without having
  26. to reset your existing path. 
  27.  
  28. Things to know before using ARCINDEX
  29.  
  30. You really only need to know five things about ARCINDEX to use it
  31. effectively.  First, ARCINDEX expects to find the archive to be
  32. cataloged in drive a.  Both the drive and path specifiers can be
  33. reset.  Second, ARCINDEX saves its extracted information to a
  34. catalog file in its own directory unless otherwise specified. The
  35. file name is CATALOG.TXT and no provision has been made to change
  36. the name in the current version. Third, ARCINDEX creates two temporary
  37. files.  The default file names are:
  38.  
  39.                   TEMP0.$$$ and TEMP1.$$$
  40.  
  41. These names are also fixed.  You should make sure that these names do
  42. not conflict with existing files because no request will be made
  43. by ARCINDEX before writing to these files.  More importantly,
  44. both files are "killed" upon program completion.  If the
  45. temporary file names conflict with your application, I will be
  46. more than happy to alter them.  Fourth, the extracted data will
  47. be appended to the catalog file. Five, ARCINDEX utilizes PKXARC
  48. to extract file information.  Because the differing dearchiving
  49. programs use different command lines, ARCINDEX cannot be used
  50. with programs other than PKARC. 
  51.  
  52. The following information is saved:
  53.  
  54.  filespec, parent archive, disk label, original file size,
  55.     ... compacted file size, compaction ratio, date stamp, and
  56.     ... time stamp.
  57.  
  58. Catalog Procedure
  59.  
  60. Move to the subdirectory where the catalog to be appended to is
  61. located.  Place the diskette containing the archived data files
  62. in drive A.  Type ARCINDEX.  The rest is pretty much self
  63. explanatory. ARCINDEX uses a Lotus-like menu structure.  The original
  64. routines were written by Peter Traversly and modified to fit this
  65. particular application.  The menu is quick and provides options to
  66. change configuration and do directory listings using wildcard
  67. filespecs.
  68.  
  69. What to do with the catalog file 
  70.  
  71. I personally prefer REFLEX.  I translate the catalog then merge
  72. the result with a parent database.  REFLEX offers most of the
  73. more important search commands.  However, since the catalog is in
  74. ASCII, you can also use most word processors or editors.  Some offer sort
  75. routines that work much like the filter commands of the nicer
  76. databases.
  77.  
  78. Usage
  79.  
  80. ARCINDEX is not copyrighted.  You may use it freely in whatever
  81. application you so choose.  If you find it useful, spread it
  82. around.  I request that you keep the DOC file
  83. attached with the ARC file.  If you need help running this
  84. program, or find it has some bugs, write me.  I'm of course,
  85. interested.
  86.  
  87. Necessary information
  88.  
  89. In running this program you have agreed that you will not hold
  90. me responsible for any damages that may result.
  91.  
  92. ARCINDEX utilizes library routines extracted from Thomas Hanlins
  93. ADVBAS library, version 4.0 (Copyright (C) 1987, Thomas Hanlin III)
  94.  
  95. Lotus-like menu structure comes from Peter Traverslys' QBUTIL.BAS.  The
  96. routines were modified to fit this particular application.
  97.  
  98.  
  99.                                                         David A. Wilson
  100.                             37 Pikehall Pl
  101.                             Baltimore, MD 21236
  102.  
  103.  
  104.        ========================  Revisions  =========================
  105.  
  106.  06-18-88       initial release.  Original program contained only windowing
  107.                 routines and was difficult to setup.
  108.  
  109.  06-26-88       Lotus-like menu structure added.  Provisions for directory
  110.                 listings added.
  111.  
  112. 
  113.