dbstress and dbstresm Tcl Applications

dbstress and dbstresm are database stress test applications. They are used to verify the Bbuuzzb database engine/server. Note that the dbstresm client/server application has not yet been written. dbstress is a single user application with the Bbuuzzb database engine sourced into the program and dbstresm is a client/server application that expects to connect to dbsrv which is the Bbuuzzb database server.

When either of these programs are executed, they will enter an infinite loop of picking a operation code and attempting to carry it out. These applications use the same operation codes as the db and dbm applications which are defined in the definition file dbcomm.tcl.

Before you can run the dbstress application, you must set up a database engine configuration file called dbeng.cfg with a minimum of the tmp_path, log and catalog entries.

The dbstresm application communicates with the Bbuuzzb database server through TCP sockets. The Bbuuzzb server and the dbstresm application use the socloc interface to manage TCP configuration information.

In order to get dbstresm to successfully connect to the Bbuuzzb database server, the server must already be running and there must also be at least one socloc server and possibly one system log server (if used for logging) running within the environment. A socloc startup file must also be composed. The database configuration file is not required for the dbstresm application.

All configuration files must be located in the same directory as the main source program. The dbstress and dbstresm applications must be executed within their current directory so the program can locate the configuration files.

Both of these programs will output detail on each command operation. The output will, go to the screen and to a log file which is defined in the program code. These stress programs also require two Bbuuzzb test tables. The primary table will be opened when the program is executed and a secondary table will be opened and closed upon demand. Both the dbstress and dbstresm applications require the database catalog feature of the database to be active and uses the logical table names to open the tables. The primary table is called test.primary and the secondary table is called test.alternate.

Command Line Syntax

Both the dbstress and dbstresm applications have the same command line syntax, which is:

dbstress|dbstresm [-p primt] [-a altt] [-l logf]

Where primt is the primary table/file name, altt is the alternate table/file name and logf is the output log file name. Note that all parameters are optional. Any parameter that is missing will have its value loaded from the program default. Also note that the switch character (a dash/hyphen [-] is shown here) depends on the platform the application is running on.

Goto Top | Tcl Applications | Tcl Software Overview | Tcl Library Overview
| Future Lab Home | Contact Webmaster | Feedback

Copyright © 2006 Future Lab, Last Updated Jul 01, 2006