How to use each menu item of the OpenLink ODBC Bench Utility
The New menu items launches a new benchmark configuration window. This window occupies the foreground of the benchmark utility. Previous benchmark windows move to the background.
The Open menu item launches the "Select file to open" dialog box. This box provides "Directories" and "Files" list boxes, which allow you to select and load pre-existing benchmark configuration files. Alternatively, you may type the full path to an existing benchmark configuration file in the "Selection:" text box.
The "Select file to open" dialog box also contains "Create Dir", "Delete File", "Rename File" buttons and an unlabeled, directory navigation button. You may use these tools to navigate and manage your computer's file system.
The Save menu item saves the current benchmark configuration information. This Save feature initiates an auto-save, if the current benchmark configuration was previously saved to a specified file. However, the Save feature launches the "Select output file" dialog box, if the benchmark configuration information has not been previously saved.
The "Select output file" dialog box provides "Directories" and "Files" list boxes, which allow you to navigate to a pre-existing configuration file. Alternatively, you may type the full path to a new or existing configuration file in the "Selection:" text box. OpenLink ODBC Bench will use the designated path and file to save the current benchmark configuration information.
The "Select output file" dialog box also contains "Create Dir", "Delete File", "Rename File" buttons and an unlabeled, directory navigation button. You may use these tools to navigate and manage your computer's file system.
The Save As... menu item launches the "Select output file" dialog box. This box provides "Directories" and "Files" list boxes, which allow you to navigate to a pre-existing benchmark configuration file. Alternatively, you may type the full path to a new or existing configuration file in the "Selection:" text box. OpenLink ODBC Bench will use the designated path and file to save the current benchmark configuration information.
The "Select output file" dialog box also contains "Create Dir", "Delete File", "Rename File" buttons and an unlabeled, directory navigation button. You may use these tools to navigate and manage your computer's file system.
The Close menu item closes the active bench test.
The Clear Log menu item clears the informational output and test results output, which appears in the bottom half of the bench test configuration window.
The Exit menu item closes the OpenLink ODBC Bench program.
The New Benchmark Item... menu item contains a radio button. This radio button allows you to select a TPC-A or TPC-C benchmark item. You must select at least one TPC-A or TPC-C test item, before you can configure other elements of the test. These TPC-A or TPC-C test items are the basic units of the bench test, and one item must be associated with each Data Source, which you intend to test.
The Delete selected items menu items allows you to delete one or more benchmark test items from your benchmark configuration screen. You must highlight the item or items before you invoke this feature.
The Save selected items as... menu item allows you to save one or more test items, which appear on your benchmark configuration screen. You must highlight the item or items before you invoke this feature.
Once clicked, the Save selected items as... menu item launches the "Select output file" dialog box. This box provides "Directories" and "Files" list boxes, which allow you to navigate to a pre-existing configuration file. Alternatively, you may type the full path to a new or existing configuration file in the "Selection:" text box. OpenLink ODBC Bench will use the designated path and file to save the current benchmark configuration information.
The "Select output file" dialog box also contains "Create Dir", "Delete File", "Rename File" buttons and an unlabeled, directory navigation button. You may use these tools to navigate and manage your computer's file system.
The Login details... menu item associates an ODBC Data Source with one or more TPC-A or TPC-C bench test items. To proceed, you must highlight the desired test item(s). Then, use the "Login details" dialog box to specify a Data Source, a Data Source user ID, and a Data Source password.
The Table details... menu item launches the "Table Details" dialog box. The "Table Details" dialog box displays table, index, procedure, and database schema configuration information per selected bench test item. Here is an overview of the configuration options, which you will encounter within "Table Details":
Option | Action |
---|---|
Create Tables | By default, the OpenLink ODBC Bench program writes four tables into the database associated with the login Data Source. These tables are Account, Branch, Teller, and History. You may use the "Create Tables" check boxes to select or deselect specific tables. |
Load Tables | The OpenLink ODBC Bench program loads initial test data into the Account, Branch, and Teller tables. You may use the "Load Tables" check boxes to enable or disable the initial insertion of data into specific tables. |
Indexes | The OpenLink ODBC Bench program creates unique indexes for the Account, Branch, and Teller tables. Moreover, the program creates stored procedures for each DBMS. You may uncheck the "Create Indexes" or "Create Procedures" check boxes to suppress the creation of indexes or procedures. |
Records to Insert | The "Records to Insert" text boxes specify the initial number of records, which OpenLink ODBC Bench will load into the Account, Branch, and Teller tables. You may type your own values into each field. |
Schema for DBMS | OpenLink ODBC Bench should auto-detect the DBMS schema, which corresponds to the benchmark item's login Data Source. (The schema selection dictates the SQL standards that OpenLink ODBC Bench will use, when it creates tables and procedures.) However, you may use the "Schema for DBMS" drop-down box to select a different schema. If you cannot find an appropriate schema, choose ANSI. |
Be advised - You should not attempt to customize your bench tests, if you are unfamiliar with OpenLink ODBC Bench. Improper configuration will result in errors and unexpected results.
The Run details... menu item launches the "Run Details" dialog box. The "Run Details" dialog box enables you to configure threading, SQL execution, test execution, transaction isolation levels, and cursors. Here is an overview of the features that you may configure within the "Run Details" dialog box:
Threading Options
You may use the Threading Options radio button to specify a Single-Threaded or Multi-Threaded bench test. If you specify a Multi-Threaded bench test, you must use the No Threads text box to input a specific number of threads.
SQL Options
The SQL Options radio button allows you to select the type of SQL API calls, which you want to make:
Execution Options
You may use the "Execution Options" check boxes to customize your bench test execution. Here are your available options:
Transaction Isolation Levels
You may use the "Transaction Isolation Levels" radio button to specify your transaction isolation level.
Scrollable Cursors
You may use the "Scrollable Cursors" radio button to specify the desired cursor modality. Likewise, use the Rowset size, Keyset size, and Traversal Count to further configure your cursor usage. Be advised - these scrollable cursors are only available, when the "Do 100 Row Query" execution option is selected.
The Insert file... menu item launches the "Select file to insert" dialog box. This dialog box provides "Directories" and "Files" list boxes, which allow you to navigate to a pre-existing, bench test configuration file. Alternatively, you may type the full path to an existing bench test configuration file in the "Selection:" text box. OpenLink ODBC Bench will use the designated path and file to load the specified benchmark configuration information into one or more highlighted bench test items.
The "Select output file" dialog box also contains "Create Dir", "Delete File", "Rename File" buttons and an unlabeled, directory navigation button. You may use these tools to navigate and manage your computer's file system.
The Create tables & procedures menu item creates OpenLink ODBC Bench's test tables and test procedures in the login Data Source. You may use the Edit menu Table Details... feature to control what tables are written. You may also use Table Details... to suppress the creation of stored procedures.
The Drop tables & procedures menu item drops the test tables and test procedures, which were created in the login Data Source.
The Run Selected menu item launches the "Run Duration" dialog box. This dialog box allows you to specify the duration of your bench test, the location of results output, and the number of tests, which you want to run.
First, use the "Test duration (mins)" text box to specify the number of minutes, which you want your bench test to execute. Next, use the "Output file name" text box to name the file, which will contain your test results. This file will appear in the root of your OpenLink ODBC Bench installation. Alternatively, you may use the "Select..." button to choose a new location.
The "Select..." button launches the "Select output file name" dialog box. This dialog box provides "Directories" and "Files" list boxes, which allow you to navigate to a pre-existing, xml results file. Alternatively, you may type the full path to a new or existing results file in the "Selection:" text box. OpenLink ODBC Bench will use the designated path and file to save benchmark results.
The "Select output file name" dialog box also contains "Create Dir", "Delete File", "Rename File" buttons and an unlabeled, directory navigation button. You may use these tools to navigate and manage your computer's file system.
Finally, use the "Start" button to run the specified bench test against selected bench test items. Alternatively, use the "Run All" button to run all possible bench test permutations against selected bench test items.
The Connect... menu item allows you to connect to an ODBC Data Source and store bench test results in that Data Source. The Connect... menu item launches a dialog box, which prompts for a Data Source name, user ID, and password.
The Disconnect menu item terminates the connection between OpenLink ODBC Bench and the results Data Source.
The Create the table menu item creates a results table in the results Data Source. The results table is comprised of the following fields:
Field | Meaning |
---|---|
RUNT | Timestamp indicating the start of the bench test |
URL | Data Source used by the bench test |
OPTIONS | SQL Options specified for the bench test |
TPS | Transactions run per second |
TOTTIME | Total transaction time |
NTRANS | Number of transactions completed by the bench test |
SUB1S | Percentage of transactions requiring less than 1 second to complete |
SUB2S | Percentage of transactions requiring between 1 and 2 seconds to complete |
TRNTIME | Average processing time for all transactions |
BTYPE | Benchmark Type (TPC-A or TPC-C) |
DRVRNAME | ODBC Driver Name |
DRVRVER | ODBC Driver Version |
The Drop the table menu item drops the results table, which resides in the results Data Source.
The Display refresh rate... menu item launches an "Enter option" dialog box. This dialog box allows you to specify the progress bar's refresh interval. You should specify larger millisecond intervals, to decrease strain on older graphics cards.
The Lock timeout... menu item launches an "Enter option" dialog box. This dialog box allows you to specify the lock timeout per thread. This lock timeout specifies the number of milliseconds that an OpenLink ODBC Bench process will wait, in the event that a deadlock occurs.
The Windows drop-down menu displays one radio button for each open bench test. You may click on individual radio buttons to toggle between the bench tests. Selected tests will occupy the OpenLink ODBC Bench foreground. Deselected tests will move to the background. These tests will remain hidden in the background until they are selected or closed.
The About menu item opens a dialog box. This dialog box displays the OpenLink ODBC Bench product name, version, and licensing scheme.