dbgen and dbgenm Tcl Applications

The dbgen and dbgenm Tcl applications are random data generators that use the Bbuuzzb database engine or server. Note that the dbgenm client/server application has not yet been written.

The dbgen application is designed for a single user. The Bbuuzzb database engine is sourceed into this program. Before you can run the dbgen application, you must set up a database configuration file called dbeng.cfg with a minimum of the tmp_path and log entries (the catalog entry is optional but recommended in single user mode).

The dbgenm application is designed for client/server environments and uses TCP sockets as the IPC method.

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

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

# Program Syntax

dbgen and dbgenm both have the same program syntax:

       dbgen[m] -v -s -rnn -fnn rec_num table_name

Where:

- v - generate variable length numbers (default=no, fixed at 3 digits)
- s - generate a random number of subfields/subsubfields (default=off)
- r - maximum number generated (default=999, cannot exceed three digits)
- f - number of fields to generate in each record (default=random,max=25)
- rec_num - number of records to generate
- table_name - name of table

The table_name must be given in accordance with the new.table guidelines. This program will attempt to create a new table. It is an error if the table already exists.

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

Copyright © 2006 Future Lab, Last Updated Jun 30, 2006