home *** CD-ROM | disk | FTP | other *** search
/ Jason Aller Floppy Collection / 99.img / PDOX3-15.ZIP / UTIL / TUTILITY.DOC < prev    next >
Text File  |  1989-09-15  |  7KB  |  196 lines
  1.     Paradox Table Utility Program                Page 1
  2.     Release 2.04
  3.  
  4.  
  5.     Overview
  6.  
  7.     This document describes the program "tutility" which contains features
  8.     that allow the user to check a Paradox table for internal consistency
  9.     and then reconstruct it if necessary.  Damaged Paradox tables can
  10.     result from many sources including power failures, hardware failures,
  11.     removing a floppy disk that Paradox is accessing, or rebooting the
  12.     system while Paradox is active in memory.
  13.  
  14.     This version of tutility has been enhanced to include verification
  15.     and reconstruction of password-protected tables and the ability to
  16.     rebuild tables in batch mode.  Gone is the 32,000 block limit which
  17.     occasionally prevented some large tables from being rebuilt.  If you
  18.     have free disk space equal to 110 percent of the space taken by the
  19.     damaged table, you can rebuild it.
  20.  
  21.  
  22.     Method of Execution
  23.  
  24.     To execute tutility, enter the following command at the DOS prompt:
  25.  
  26.         tutility
  27.  
  28.     This form invokes the interactive program mode where you select
  29.     various options from Paradox-like menus and provide table names    to
  30.     verify and/or rebuild.  By pressing the function key "F1" anywhere
  31.     in the program, you can    instantly view helpful hints about tutility.
  32.     You may also run tutility in a batch mode which is described later
  33.     in this document.
  34.  
  35.  
  36.     The Menu
  37.  
  38.     The first thing to appear on the screen when tutility is invoked is
  39.     the menu.  Using the right and left cursor keys, simply    highlight the
  40.     task you wish to perform and press <Enter> to execute that task.  The
  41.     following describes each of the menu selections and how they operate.
  42.  
  43.         The Verify Option
  44.  
  45.     The "Verify" option allows you to check a given table to see if the
  46.     table descriptor is valid and that the internal links between each
  47.     record are unbroken.  When the verification is complete, you will be
  48.     notified as to the table's condition.  If the table is corrupted,
  49.     you will then have the option to rebuild it.
  50.  
  51.     Paradox Table Utility Program                Page 2
  52.     Release 2.04
  53.  
  54.  
  55.         The Rebuild Option
  56.  
  57.     To reconstruct a table whose record links have been severed, select
  58.     the "Rebuild" option.  If the table has not been corrupted beyond
  59.     repair, the records will be linked back    together.  Please note that
  60.     some records may be lost in this process due to the nature of
  61.     relinking.  Also note that any primary or secondary index files
  62.     associated with the table will be deleted and the table rebuilt
  63.     without any keys.  You should use Paradox to restore any of these
  64.     deleted files.
  65.  
  66.     If a table has been damaged beyond the point of recovery, you will see
  67.     a message indicating that the rebuild has been unsuccessful.
  68.  
  69.         The Directory Option
  70.  
  71.     The "Directory" option allows you to change your working directory
  72.     to any directory on your system.  Since tutility does not support
  73.     path names when specifying which table to use, you should first use
  74.     the "Directory" option to connect to the desired directory.
  75.  
  76.         The Monitor Option
  77.  
  78.     If you have a color graphics adapter and a black and white monitor,
  79.     as many Compaq computers have, the tutility screen will appear with
  80.     a light background when you start the program.  To change the screen
  81.     and make it more readable, select the "Monitor" option to see a menu
  82.     of monitor types and then select "B&W" to tell tutility that you wish
  83.     to see the screen in black and white mode.  This option also works for
  84.     color monitors but has no effect on monochrome video adapters.
  85.  
  86.         The Exit Option
  87.  
  88.     When you have completed all your tasks in tutility, select "Exit"
  89.     from the main menu to return to DOS.
  90.  
  91.  
  92.  
  93.     The File Name Prompt
  94.  
  95.     When you select the "Verify" or "Rebuild" option, you will be prompted
  96.     to enter the name of the file on which the desired task will operate.
  97.     The name must be a valid Paradox table name without the ".DB" suffix
  98.     and must specify a table that resides in the current directory.
  99.  
  100.     If you are not sure which tables reside in the current directory,
  101.     you may push the "Enter" key to see a list of available table names.
  102.     Use the cursor control keys to highlight the desired table name and
  103.     then press "Enter" to begin operating on the highlighted file.
  104.  
  105.     Paradox Table Utility Program                Page 3
  106.     Release 2.04
  107.  
  108.  
  109.     Cancelling an Operation
  110.  
  111.     Should you decide to cancel an operation once it has begun, press the
  112.     "Ctrl" key and the "Break" (^Break) key simultaneously.  This will
  113.     signal tutility to quit what it was doing and return to DOS.  Please
  114.     note that cancelling the rebuild of a table could itself lead to a
  115.     damaged table.
  116.  
  117.  
  118.     Batch Mode
  119.  
  120.     The batch mode of tutility supports both the "Verify" and "Rebuild"
  121.     options described earlier.  However, in batch mode, you may specify
  122.     one or more tables to be verified or rebuilt.
  123.  
  124.     To invoke the batch verify mode, type the following command at the
  125.     DOS prompt:
  126.  
  127.         tutility tablename
  128.  
  129.     "Tablename" above represents either one or more table names or a
  130.     single table name argument containing the DOS wild card substitution
  131.     characters "?" and "*".  The example below represents the simplest
  132.     form of the program and    illustrates how to verify a single table:
  133.  
  134.         tutility price.db
  135.  
  136.     To verify three tables named "table1", "table2", and "table3", you
  137.     could use either of the following:
  138.  
  139.         tutility table1.db table2.db table3.db
  140.  
  141.                 or
  142.  
  143.         tutility table?.db
  144.  
  145.     To verify all tables in the current directory, you would use the
  146.     following command:
  147.  
  148.         tutility -all
  149.  
  150.     Tutility will examine each of the specified tables and report the
  151.     state of each one on the screen.  After all tables have been checked,
  152.     you will also see a count of the number of tables examined and the
  153.     number of tables found to be inconsistent.  All messages generated
  154.     by tutility may be redirected to a file or the printer for later
  155.     examination.  For example, to print tutility output for all files
  156.     in the current directory, you could enter:
  157.  
  158.         tutility *.db >prn
  159.  
  160.     Paradox Table Utility Program                Page 4
  161.     Release 2.04
  162.  
  163.  
  164.     If you want the output stored in a file, substitute a file name for
  165.     the word "prn" above.
  166.  
  167.     To invoke the batch rebuild mode of Tutility, type the following
  168.     command at the DOS prompt:
  169.  
  170.         tutility -rebuild tablename
  171.  
  172.     The "-rebuild" parameter tells tutility that all files specified
  173.     by the "tablename" parameter are to be rebuilt if they are found to
  174.     be inconsistent during verification.  Tables found to be valid will
  175.     not be rebuilt.
  176.  
  177.     Please note that the rebuild option is very powerful in that it will
  178.     delete all the primary and secondary index files associated with a
  179.     rebuilt    table.  These files may be recreated but you must be in
  180.     Paradox to do so.
  181.  
  182.     ----------------------------------------------------------------------
  183.  
  184.     Control Key Summary
  185.  
  186.     F1        display help screen
  187.     RightArrow    move to next file name in list
  188.     LeftArrow    move to previous file name in list
  189.     UpArrow        move to file name above current one
  190.     DownArrow    move to file name below current one
  191.     Home        move to first file name in list
  192.     End        move to last file name in list
  193.     BackSpace    erase previous character
  194.     ^BackSpace    erase entire field
  195.     ^Break        cancel current operation
  196.