--------------------------------------------------------------------------------
--
-- COPYRIGHT:
--   IBM WorkFrame - Project Smarts
--   (C) Copyright International Business Machines Corporation 1996
--   Licensed Material - Program-Property of IBM - All Rights Reserved.
--   US Government Users Restricted Rights - Use, duplication, or disclosure
--   restricted by GSA ADP Schedule Contract with IBM Corp.
--
--------------------------------------------------------------------------------
<if ($LANGUAGE$ == SOM)>

README for Data Access Builder SOM Application
==============================================

<if ($EXECUTABLE$ == DLLOnly)>
Project Smarts has generated a single project that builds a SOM DLL.
You will use the Data Access Builder tool to generate SOM data access
methods for your database.
</if>
<if ($EXECUTABLE$ == EXEOnly)>
Project Smarts has generated a single project that builds a SOM EXE.
The $FILE_NAME:tolower$.cpp file contains client code that uses
SOM data access methods that you will generate using the Data Access
Builder tool.
</if>
<if ($EXECUTABLE$ == EXEandDLL)>
Project Smarts has generated two projects that build a SOM DLL and
a EXE.  The Data Access DLL project is nested in the EXE project to
express the dependencies between the EXE and DLL targets.

The $FILE_NAME:tolower$.cpp file in the main project contains client
code that uses the SOM data access methods that you will generate
using the Data Access Builder tool.  These data access methods are
built into a DLL in the nested Data Access DLL project.
</if>

<else>

<if ($LANGUAGE$ == C++)>

README for Data Access Builder C++ Application
==============================================

<if ($EXECUTABLE$ == DLLOnly)>
Project Smarts has generated a single project that builds a C++ DLL.
You will use the Data Access Builder tool to generate C++ data access
methods for your database.
</if>
<if ($EXECUTABLE$ == EXEOnly)>
Project Smarts has generated a single project that builds an EXE.
The $FILE_NAME:tolower$.cpp file contains client code that uses
C++ data access methods that you will generate using the Data Access
Builder tool.
</if>
<if ($EXECUTABLE$ == EXEandDLL)>
Project Smarts has generated two projects that build a data access DLL
and a EXE.  The Data Access DLL project is nested in the EXE project to
express the dependencies between the EXE and DLL targets.

The $FILE_NAME:tolower$.cpp file in the main project contains client
code that uses the data access methods that you will generate
using the Data Access Builder tool.  These data access methods are
built into a DLL in the nested Data Access DLL project.
</if>
-- else if language = C++
</if>
-- if language = SOM
</if>

-- These are common instructions on how to build the projects.
Building the Project
____________________

  +---------------------------------------------------------------+
  | NOTE: You cannot build this project until you perform the     |
  |       following steps.                                        |
  +---------------------------------------------------------------+

First, ensure that the database you wish to access is setup properly
before starting the Data Access Builder.

<if ($EXECUTABLE$ == EXEandDLL)>
Open the nested Data Access DLL Project.
</if>

Select "Database" from the "Project" menu.  Start the Data Access Builder
so you can generate the source files that contain the access methods
for your table.

<if (($EXECUTABLE$ == EXEOnly) | ($EXECUTABLE$ == EXEandDLL))>
In the Data Access Builder tool, select the following values:

---------------------------------------------------------Â------------------
Database name selected for creating classes:             | $DATABASE$
---------------------------------------------------------Á------------------
Class Name used in the Names page of the class notebook: | $CLASS_NAME$
---------------------------------------------------------Á------------------
File stem used in the Names page of the class notebook:  | $SOURCE_FILE$
---------------------------------------------------------Á------------------
The generate option should be:                           | $LANGUAGE$
---------------------------------------------------------Á------------------
</if>

Now, proceed to generate the data access $LANGUAGE$ source files
After the files have been generated, exit the Data Access Builder
tool.
<if ($LANGUAGE$ == SOM)>

Note:
You'll also need to generate the .xh files for the Data Access
SOM Class Library, if you have not already done so.
</if>

<if ($EXECUTABLE$ == EXEandDLL)>
Return to the parent (EXE) project, and build it by selecting
"Build Normal" under the "Project" menu.
<else>
Build the project by selecting "Build Normal" under the "Project" menu.
</if>

<if (($EXECUTABLE$ == EXEOnly) | ($EXECUTABLE$ == EXEandDLL))>
You can double click on $FILE_NAME$.EXE to run the application.

</if>
<if ($LANGUAGE$ == SOM)>
A note on the SOM Compile action
________________________________

  A hand-coded make file is provided with the SOM Data Access Builder
  application.  This is because there is no actions support available
  for the SOM Compiler to work with the MakeMake makefile generator.
  As a result, make files generated by MakeMake that include the SOM
  Compile action have incorrect dependency listings.

  This make file is called by the "SOM Compile Make" action in a makefile
  that MakeMake generates for this project.  Other actions included in
  this project's Build are Compile and Link.
</if>

