OpenLink ODBC Bench Menus

Abstract

How to use each menu item of the OpenLink ODBC Bench Utility

Table of Contents

File Menu Options
New CTL+N
Open... CTL+O
Save CTL+S
Save As... CTL+A
Close
Clear Log
Exit CTL+X
Edit Menu Options
New Benchmark Item... CTL+Insert
Delete selected items
Save selected items as...
Login details... CTL+L
Table details... CTL+T
Run details... CTL+U
Insert file...
Action Menu Options
Create tables & procedures
Drop tables & procedures
Run Selected
Results Menu Options
Connect...
Disconnect
Create the table
Drop the table
Preferences menu
Display refresh rate...
Lock timeout...
Window Menu Options
Help Menu Options
About CTL+F1

File Menu Options

New CTL+N

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.

Open... CTL+O

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.

Save CTL+S

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.

Save As... CTL+A

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.

Close

The Close menu item closes the active bench test.

Clear Log

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.

Exit CTL+X

The Exit menu item closes the OpenLink ODBC Bench program.


Edit Menu Options

New Benchmark Item... CTL+Insert

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.

Delete selected items

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.

Save selected items as...

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.

Login details... CTL+L

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.

Table details... CTL+T

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":

Table Details
OptionAction
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.

Run details... CTL+U

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:

Insert file...

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.


Action Menu Options

Create tables & procedures

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.

Drop tables & procedures

The Drop tables & procedures menu item drops the test tables and test procedures, which were created in the login Data Source.

Run Selected

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.


Results Menu Options

Connect...

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.

Disconnect

The Disconnect menu item terminates the connection between OpenLink ODBC Bench and the results Data Source.

Create the table

The Create the table menu item creates a results table in the results Data Source. The results table is comprised of the following fields:

Results Table Details
FieldMeaning
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

Drop the table

The Drop the table menu item drops the results table, which resides in the results Data Source.


Preferences menu

Display refresh rate...

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.

Lock timeout...

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.


Window Menu Options

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.


Help Menu Options

About CTL+F1

The About menu item opens a dialog box. This dialog box displays the OpenLink ODBC Bench product name, version, and licensing scheme.


- Copyright 2002, OpenLink Software -