home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DATABASE / HEADFIX.ZIP / HEADXTRK.DOC < prev    next >
Text File  |  1990-02-15  |  4KB  |  134 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         HEADXTRK
  8.         December 1989
  9.         Erik A McBeth
  10.  
  11.                             DOCUMENTATION FOR HEADXTRK
  12.  
  13.         What is it?
  14.              HEADXTRK is a utility for extracting a header record from a
  15.              dBase file (dBase II/III or IV).  The header record contains
  16.              the structure of the database, i.e. the names, lengths, and
  17.              types of fields in the database.           
  18.  
  19.         When would I use it?
  20.              HEADXTRK is used in connection with such utilities as
  21.              HEADFIX and dBase File Recovery which help to rebuild
  22.              damaged header records and/or files.  The utility HEADFIX
  23.              requires a clean header record in order to repair damaged
  24.              header records (it writes the clean over the bad).  But what
  25.              if you don't know the structure of a damaged header and
  26.              dBase won't let you look at the file?  This is where
  27.              HEADXTRK comes in.  HEADXTRK will help you extract some form
  28.              of a header from a file (which you can then bring into dBase
  29.              and further clean up).
  30.              
  31.         How do I use it?
  32.              DUE TO THE NATURE OF FILE CORRUPTION, CHKDSK /F SHOULD BE
  33.              RUN PRIOR TO THE RUNNING OF EITHER HEADXTRK OR HEADFIX.
  34.              
  35.              SYNTAX:
  36.                      HEADXTRK  badheader  goodheader  file type  [?]
  37.              
  38.              You need to tell HEADXTRK the name of the file which
  39.              contains the header you want, a file to write the header to,
  40.              the type of dBase file (2 for dBase II, 3 for III, etc.),
  41.              and (optional) a '?' to tell HEADXTRK that it should guess
  42.              at which fields belong in the header.  
  43.              EX:     
  44.              
  45.                      HEADXTRK badfile.dbf good.dbf 3 
  46.              
  47.              This will extract a dBase III header from 'badfile.dbf' and
  48.              place it in 'good.dbf.'  HEADXTRK will ask you (if you have
  49.              a dBase II file HEADXTRK will extract the first 32 fields it
  50.              finds) if the fields you see are valid fields that you want
  51.              in the header.  Simply press RETURN and the field will be
  52.              added to the structure.  Press 'N' and a RETURN when you
  53.              reach the first non-valid field (you may see garbage or
  54.              parts of your data if not valid).  We could of course just
  55.              type a '?' after the '3' and HEADXTRK would have found the
  56.              fields on its own (except its guessing ability is not the
  57.              same as a humans).  
  58.              You would then want to go into dBase and use 'good.dbf' and
  59.              clean up any further problems (bad field type, length, etc.)
  60.              with the header.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                              HEADXTRK ERROR MESSAGES
  74.  
  75.  
  76.         Unable to open -> 
  77.              Couldn't find or open a file.  Make sure you give the full
  78.              path name and extension to the good and bad file.  Also make
  79.              sure that the output file is not READ ONLY.
  80.              
  81.         Unable to seek BOF in -> 
  82.              Couldn't find the beginning of the file.
  83.  
  84.         Unable to seek field location in -> 
  85.              Couldn't find the place where the field info starts in the
  86.              file.
  87.  
  88.         Unable to write EOF marker to ->
  89.         Unable to write field info to ->
  90.         Unable to write header intro to -> 
  91.              Either the output file is read-only or some other read/write
  92.              error occurred.
  93.  
  94.         WARNING - Found xxx fields, number of fields may be incorrect
  95.              Some form of corruption may have caused HEADXTRK to extract
  96.              too many or too few fields.  Examine the output file to
  97.              determine if all fields were found.
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.