home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1608 / database.txt < prev    next >
Encoding:
Text File  |  1991-10-20  |  4.4 KB  |  116 lines
  1. Database functions - Bench 6.0
  2.  
  3.      Hidden underneath Bench 6.0 is a dBASE-compatible
  4. database engine (Codebase ++ from Sequiter Software). This
  5. database engine is responsible not only for keeping track of
  6. the tests, but also for keeping track of the results. In
  7. order for you to get the most out of Bench 6.0, it is
  8. important for you to understand how Bench 6.0 keeps track of
  9. the results it generates from the tests.
  10.  
  11.      In the Bench subdirectory, you will find four .DBF
  12. files and four .MDX files. These files are called:
  13.  
  14.           TEST.DBF       TEST.MDX
  15.           TSTGROUP.DBF   TSTGROUP.MDX
  16.           MACHINE.DBF    MACHINE.MDX
  17.           RESULT.DBF     RESULT.MDX
  18.  
  19.      The .DBF files are dBASE-compatible data files and the
  20. .MDX files are dBASE IV compatible index files. For purposes
  21. of recording results, the MACHINE and RESULT files are where
  22. the information for the test machines are kept.
  23.  
  24.      The MACHINE file is where entered information about a
  25. machine is stored. The information in this file is as
  26. follows:
  27.  
  28.           Machine ID          :    8 characters
  29.           Variant             :    1 character
  30.           Machine Name        :    12 characters
  31.           Machine Description :    225 characters
  32.  
  33.      The Machine ID and Variant are used to uniquely
  34. identify a machine and configuration. For example:
  35.  
  36.           Machine ID: ibm70        Variant: 0
  37.  
  38. could be used to identify an IBM PS/2 Model 70 configured to
  39. run without a disk cache while:
  40.  
  41.           Machine ID: ibm70        Variant: 1
  42.  
  43. could be used to identify the same machine with disk caching
  44. enabled.
  45.      It is important to use meaningful Machine IDs when
  46. recording results of tests. In addition to being used in the
  47. database, the Machine ID is used in generating the output
  48. file name for the results from MicroScope in the form of:
  49.  
  50.                     [MachineID].MSC
  51.  
  52.      Also, when printing test results to a file, the output
  53. file name will take the form of:
  54.  
  55.                     [MachineID].PR[V]
  56.  
  57.      where [V] is the Variant ID used for that unit's test
  58. run.
  59.  
  60.      Machine Name is used by Bench 6.0 as identifiers for
  61. column headings for all the test windows
  62.  
  63.      Machine Description is a long description which can
  64. include notes about the system's components, any special
  65. configuration notes, or any special observations about the
  66. system's behavior while under test.
  67.  
  68.      The RESULT file is where all the results from the tests
  69. are stored. Along with Bench 6.0 are result files from the
  70. following machines:
  71.  
  72.      IBM XT                        IBM AT
  73.      Compaq Deskpro 386N           IBM Model 70-A21
  74.      Compaq Deskpro 38625e         IBM Model 90 (486-33)
  75.  
  76.      Every time a test is run, the result is immediately
  77. written to the database. This ensures that if there is a
  78. problem with any one test hanging the system or aborting the
  79. tests, the results from the rest of the test run aren't
  80. lost. Upon exiting the program, the exit dialog box asks you
  81. if you want to commit results to the database. Checking this
  82. box means that the results that are currently in the
  83. database will be permanently time-stamped with a date and
  84. time. This will permit these results to be recalled later on
  85. for comparison purposes.
  86.  
  87.      If you choose not to commit the results to the
  88. database, the next time you run the program, the first thing
  89. that will appear is a dialog that will say that there are
  90. uncommitted results in the database. You will be given four
  91. options at that time:
  92.  
  93.      use - which will use the results and bring them back
  94. for modifications/additions
  95.  
  96.      delete - which will delete the results from the
  97. database and then prompt you for new machine information
  98.  
  99.      commit - which will date- and time-stamp the results
  100. and then prompt you for new machine information
  101.  
  102.      exit - which will exit the program
  103.  
  104. You should make backups of your database periodically.  In
  105. the event that your database becomes corrupt or gets
  106. destroyed there are backup files containing only the PC
  107. Magazine default comparison machine results.  When making
  108. your own backups do not use the extensions .BKD or .BKX as
  109. they will conflict with the prestored backups.
  110.  
  111. TO RESTORE THE DATABASE TO ITS ORIGINAL CONTENTS:
  112. Run the REINITDB batch file.  You will be warned that your
  113. data is about to be destroyed.  To cancel the procedure hold
  114. down the Ctrl key and hit the Break key.  (The word "Break"
  115. may appear on the front of this key on some keyboards.)
  116.