5.3 Running the Setup Program

After you build the tutorials, you need to run the tutsetup program. The path to tutsetup is:

<rw_root>\workspaces\<OS+ver>\<COMPILER+ver>\<buildtype>\examples\
dbt<ver><osfam>\tutsetup

For example, if your root directory is c:\rwav, you have DBTools.h++ 4.0.1, and you are using Microsoft Visual C++ 6.0 compiler on Windows NT 4.0 with a 7s build type, the path is:

c:\rwav\workspaces\WINNT4\MSVC60\7s\examples\dbt0401w\tutsetup

This program creates and populates the tables needed by the tutorial programs. It runs "silently," neither producing output on "standard out," nor opening any windows. Should any errors occur during execution, they will be reported to a file called setuperr.txt.

NOTE: It is possible that the tables created by the tutorial setup program may conflict with existing tables. A list of the tables is available in "The Tutorial Model" section of the DBTools.h++ User's Guide and Tutorials. Check whether there will be conflicts with these tables before running the tutorials.

To run the tutorial setup program with default arguments:

Change directory to the workspace:

<rw_root>\workspaces\<OS+ver>\<COMPILER+ver>\<buildtype>

Change directory to the DBTools.h++ examples:

\examples\dbt<ver><osfam>

Type the following:

tutsetup

Check the contents of setuperr.txt to determine if an error occurred during execution. If the file does not contain a fatal error, the program ran successfully. The file may contain messages from the database servers, as is the case for Sybase SQL servers.