home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / dbfclean.zip / DBFCLEAN.DOC next >
Text File  |  1990-11-23  |  7KB  |  301 lines

  1.  
  2.  
  3.                              DBTCNVT DOC - June 1990
  4.  
  5.  
  6.  
  7.         DBFCLEAN
  8.         Erik A McBeth
  9.              
  10.                                      INTRODUCTION
  11.              
  12.              
  13.              DBFCLEAN is designed to help in the diagnosis and cleaning
  14.         of DBF files which are giving problems for the user.  Because it
  15.         works on live data you should always MAKE A BACKUP OF YOUR DATA
  16.         before you begin.  Neither  Ashton-Tate nor its author assumes
  17.         ANY responsibility for damages incurred as a result of using
  18.         DBFCLEAN.  
  19.              
  20.              DBFCLEAN's option can correct such problems as bad record
  21.         counts, corrupt headers, End-Of-File markers, and NULLs in the
  22.         data.  Its functionality combines the features of two other
  23.         utilities, HEADFIX and XLATE, into one stand alone package. 
  24.         Severe DBF corruption should be relegated to such products as
  25.         dBASE File Recovery from Ashton-Tate (authored by Keith Mund). 
  26.         Please read the instructions regarding DBFCLEAN syntax and
  27.         possible error messages for a better understanding of how to use
  28.         the program.
  29.               
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                  DBFCLEAN INTRO
  59.  
  60.  
  61.  
  62.  
  63.                           DBFCLEAN DOC - December 1990
  64.  
  65.  
  66.  
  67.                                  DBFCLEAN SYNTAX
  68.  
  69.  
  70.         DBFCLEAN file name  [/C /O /H /2 /3 /4 /X /Jx /Vx /Rx]
  71.         where:
  72.  
  73.         file name   = the dBASE file you want converted/packed
  74.  
  75.         /C          = Perform the cleaning, also use to make the /H, /V,
  76.                       and /R parameters permanent (say if you used the /R
  77.                       parameter with a value of 5 then the resulting file
  78.                       would have a record count of 5).  You must use this
  79.                       parameter if you want data errors in the database
  80.                       file to be corrected.
  81.  
  82.         /O          = Output file name, use this if you want to create a
  83.                       second file that looks like the original but with
  84.                       the fixes added.  Hint: if you use this option with
  85.                       a /R0 you will create an output file with just the
  86.                       structure of the original.  Similar to COPY
  87.                       STRUCTURE TO <output file> in dBASE.
  88.  
  89.         /H          = Specify an alternate file to be read in and used as
  90.                       the structure of the database.  Do this when the
  91.                       field lengths, types, etc. have become corrupted in
  92.                       the original file.  Use with /C to copy good header
  93.                       on top of bad one.
  94.  
  95.         /2          = Make the resulting file (used with /O) have a dBASE
  96.                       II format.  Handy for quick data conversion from
  97.                       dBASE III/IV to dBASE II .
  98.  
  99.         /3          = Make the resulting file (used with /O) have a dBASE
  100.                       III format.  Handy for quick data conversion from
  101.                       dBASE II to dBASE III/IV.
  102.  
  103.         /4          = Make the resulting file (used with /O) have a dBASE
  104.                       IV format.  Handy for quick data conversion from
  105.                       dBASE II to IV.  Only useful when memo fields are
  106.                       in the structure.
  107.  
  108.         /X          = Check for extended ASCII characters with value 127
  109.                       and above.  Handy if garbage is found in data.
  110.  
  111.         /Jx         = Jump to record x, use when data file is huge and
  112.                       you just need to look toward the end of the file.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                  DBFCLEAN SYNTAX
  119.  
  120.  
  121.  
  122.  
  123.                           DBFCLEAN DOC - December 1990
  124.  
  125.  
  126.  
  127.         /Vx         = Read file as version x dBASE file (x=2,3,4). 
  128.                       Helpful when getting "Not a dBASE database" error
  129.                       message.  Use with /C to make permanent.      
  130.  
  131.         /Rx         = Set record count to x.  Useful when the record
  132.                       count does not seem to reflect the size of the
  133.                       file.  If you do /R? then DBFCLEAN will guess the
  134.                       number of records based on file size.  Use /C to
  135.                       make permanent. 
  136.  
  137.         Examples:
  138.  
  139.                                DBFCLEAN test /C   
  140.         Analyze and clean-up data like NULLs and EOF markers in the data.
  141.  
  142.                           DBFCLEAN test /C /Hnewhead /R?
  143.         Read the good header 'newhead' and overwrite the bad header for
  144.         this file, check for data problems, and set the record count
  145.         based on file size. 
  146.                             
  147.                           DBFCLEAN test /C /Onewfile /R0
  148.         Create a new file called 'newfile' with the same structure as
  149.         test but don't copy over any records.
  150.  
  151.         PLEASE NOTE: For speed of processing DBFCLEAN will only show
  152.         every 50th record as it is analyzing, unless of course an error
  153.         occurs before then.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                  DBFCLEAN SYNTAX
  179.  
  180.  
  181.  
  182.  
  183.                           DBFCLEAN DOC - December 1990
  184.  
  185.  
  186.  
  187.                              DBFCLEAN ERROR MESSAGES
  188.  
  189.         DBFCLEAN will show an error count for each record in finds with
  190.         problems.  If an End-Of-File (EOF) marker is found then a 'Y'
  191.         will appear under 'EOF Marker?'.
  192.  
  193.         Error in closing file
  194.                 Had some trouble closing the file.
  195.  
  196.         Error in creating file
  197.                 Had some trouble creating a fresh file, check for files
  198.                 with the same name that may be READ-ONLY.  
  199.  
  200.         Error in deleting file
  201.                 Had some trouble deleting the file.
  202.  
  203.         Error in finding size of file
  204.                 Couldn't figure out how big a file was.
  205.  
  206.         Error in memory allocation of
  207.                 Ran out of memory to allocate memory for this object.
  208.  
  209.         Error in opening file
  210.                 Had some trouble opening the file, check for files that
  211.                 may be READ-ONLY.
  212.  
  213.         Error in parameter passed
  214.                 You specified an unknown or incorrect parameter.
  215.  
  216.         Error in reading from file
  217.                 Trouble reading from file, may be sign of file
  218.                 corruption.
  219.  
  220.         Error in seeking in file
  221.                 Trouble moving around in file, may be corruption or bad
  222.                 disk.
  223.  
  224.         Error in value of parameter passed
  225.                 The value passed may be too high or low.
  226.  
  227.         Error in writing to file
  228.                 Trouble writing to file, may be corruption or bad disk.
  229.  
  230.         Error file exists
  231.                 Unable to create a new file since a file already exists
  232.                 with this name.
  233.  
  234.         Error must stop
  235.  
  236.  
  237.  
  238.                              DBFCLEAN ERROR MESSAGES
  239.  
  240.  
  241.  
  242.  
  243.                           DBFCLEAN DOC - December 1990
  244.  
  245.  
  246.  
  247.                 Some fatal error occurred and the program cannot
  248.                 continue.
  249.                       
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.                              DBFCLEAN ERROR MESSAGES
  299.  
  300.  
  301.