home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / DATABASE / STOCK / CSETPP / README < prev    next >
Text File  |  1995-06-11  |  8KB  |  186 lines
  1. NAME:
  2.        Data Access C++ Stock Sample
  3.  
  4. FEATURES/CONCEPTS:
  5.        This sample illustrates how to use the Data Access Builder Class Library and the code generated by the
  6.        Data Access Builder Tool to access DB2/2 database table in a C++ program. It shows how to connect to a 
  7.        database, manipulate data, make transactions, and disconnect from a database. It also shows how users 
  8.        can build their own customized classes derived from the Data Access Builder Classes.
  9.  
  10. TASK:
  11.        A simple C++ program that updates stock inventory and received order information that
  12.        are kept in two DB2/2 database tables and generates a price list from it.
  13.  
  14. DESCRIPTION:
  15.        This sample program generates a price list from the initial data. It then adds more rows to the 
  16.        inventory and receivedorder tables, calculates the new values and updates the tables. It then
  17.        generates an updated price list.
  18.  
  19. PROJECT LOCATION:
  20.        To locate the CSETPP folder: open the SAMPLE folder, then the DATABASE folder, then the STOCK folder. 
  21.  
  22. SOURCE FILE LOCATION:
  23.  
  24.        X:\ibmcpp\samples\database\stock\csetpp 
  25.  
  26.        where 'X:' is the drive you installed the samples and document component
  27.        of VisualAge C++.
  28.  
  29.  
  30. HOW TO RUN THE SAMPLE PROJECT
  31.  
  32. You must have started the DB2/2 database manager and logged on before you can run the
  33. sample.  
  34.  
  35.   From the WorkFrame environment&colon.
  36.   - Double-click on the project's icon to open the project view of the sample. If you have 
  37.     not already done so, install the database -- double-click on the SETUPDB.CMD to install the 
  38.     database for the first time, otherwise double-click on RESETDB.cmd to re-initialize the database.    
  39.     Click on the RUN button of the project's toolbar.
  40.  
  41.   From the command line&colon.
  42.   - from the X:\ibmcpp\samples\database\stock\csetpp directory, if you are installing the
  43.     database for the first time, type:
  44.  
  45.        SETUPDB.CMD
  46.  
  47.     otherwise, type:
  48.  
  49.        RESETDB.CMD
  50.       
  51.     where 'X:' is the drive you installed the samples and document component of VisualAge C++.
  52.  
  53.  
  54.   - then type the name of the executable file&colon.
  55.     
  56.        CLIENT
  57.  
  58.  
  59. HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  60.  
  61. NOTE: You must have started the DB2/2 database manager and logged on before you can build the
  62.       sample.
  63.  
  64.    FROM WITHIN THE WORKFRAME ENVIRONMENT:
  65.  
  66.    1) Double-click on the project's icon to open the project view of the sample. You will
  67.       see the icons of the files associated with the sample.  Double-click on the SETUPDB.cmd icon
  68.       if you are installing the database of this sample for the first time, otherwise double-click on the 
  69.       RESETDB.cmd icon. 
  70.  
  71.    2) Start the Data Access Builder clicking Mouse Button 2 on brchone.dax. Select Database on the pop-up menu. 
  72.       brchone.dax is a prebuilt file which contains the mappings between the database tables and the classes.
  73.  
  74.    3) Select :hp2.Create Classes:ehp2. for brchone.dax, a prebuilt file which contains the mappings between 
  75.       the database tables and the classes.
  76.  
  77.       Click Mouse Button 2 on each of the class icons (blue balls) in turn, selecting GENERATE -> PARTS
  78.       for each from the pop-up menu.  Close the Data Access Builder session.
  79.    
  80.    4) From the PROJECT pulldown, select BUILD - REBUILD ALL.
  81.  
  82.       To run the sample project, click on the RUN button of the Project toolbar.
  83.  
  84.   
  85.   FROM THE COMMAND LINE:
  86.  
  87.   1) Change to the X:\ibmcpp\samples\database\stock\csetpp directory -- where 'X:' is 
  88.      the drive you installed the samples and document component of VisualAge C++.
  89.     
  90.  
  91.      If you are installing the database of this sample for the first time, type:
  92.  
  93.        SETUPDB
  94.  
  95.      otherwise, type:
  96.  
  97.        RESETDB
  98.  
  99.   2) Start the Data Access Builder by typing:
  100.  
  101.        ICSDATA BRCHONE.DAX
  102.  
  103.      brchone.dax is a prebuilt file* which contains the mapping between the database tables and the classes.
  104.   
  105.   3) Click Mouse Button 2 on each of the class icons (blue balls) in turn, select GENERATE -> PARTS 
  106.      for each from the pop-up menu.  Close the Data Access Builder session.
  107.  
  108.   4) To build the executable**, type:
  109.  
  110.        BUILD
  111.  
  112.   5) To run the application, type:
  113.  
  114.        CLIENT
  115.  
  116.  
  117. *     If you want to create the mappings yourself, here are the steps:
  118.        a. invoke Data Access Builder without a .DAX file.
  119.        b. Select Data Access and click on Create Classes.
  120.        c. Select BRCHONE database and click on Connect. Two tables are
  121.          now shown in the table list box.
  122.        d. Click on Select all and then Create classes. The table class
  123.           mappings are now shown.
  124.        e. Click on the inventory table icon and select Create class.
  125.        f. Double click on the Inventory1 class icon. The class notebook
  126.           is shown.
  127.        g. On the Names page, change the class name Inventory2 to
  128.           PriceList and change the file name Invent1 to prclist.
  129.        h. The mapping is done. You can save this mapping by clicking on
  130.           Save under Data access.
  131.  
  132.  
  133. **       There is an alternative way to build the sample program. When
  134.          Data Access Builder is invoked from the command line, the make
  135.          file for the generated files is created also. You can build the
  136.          parts individually by invoking the nmake for it.
  137.  
  138.          nmake -f prclistv.mak
  139.          nmake -f receivev.mak
  140.          nmake -f inventov.mak
  141.  
  142.         Invoke the nmake on the supplied makefile, client.mak to build
  143.         the sample program.
  144.  
  145.          nmake -f client.mak
  146.  
  147.  
  148.  
  149. SOFTWARE/HARDWARE PREREQUISITES:
  150.  
  151. - IBM VisualAge C++3.0, including the Visual Builder and the Data Access Builder
  152. - OS/2 2.1 or Warp
  153. - DB2/2 1.2
  154. - Minimum       : IBM or compatible 386 
  155.   Recommended   : IBM or compatible 486 and up
  156.  
  157.  
  158.    FILE NAME(S)     DESCRIPTION
  159.    ============     ===========
  160.    SETUPDB.CMD      This file creates the BrchOne database and populates
  161.                     inventory and receivedorder tables.
  162.    RESETDB.CMD      This file re-initializes the two tables back to the
  163.                     initial setting (intended for use after running the
  164.                     sample application).
  165.    BUILD.CMD        This file builds the sample application.
  166.    STORE.HPP        This header declares a class called Store that uses
  167.                     the Data Access Builder Class Library and the code
  168.                     that is generated by the Data Access Builder Tool.
  169.                     This Store class takes care of connect, disconnect,
  170.                     transact, and all the data manipulation of database
  171.                     tables for this sample.
  172.    STORE.CPP        This source file is the implementation of the Store Class.
  173.    CLIENT.CPP       The file is the client application that uses the BRCHONE.DAX     
  174.                     This is the saved session from the generations of the
  175.                     BrchOne classes using the Data Access Builder Tool. It
  176.                     contains the mapping between the two database tables and
  177.                     the generated classes. User can use the mapping in this
  178.                     file to regenerate the database classes.
  179.    README           This file.
  180.    CLIENT.EXE       The application.
  181.    INVENTOV.BND     Bind files produced by SQLPREP when CLIENT.EXE was built.
  182.    PRCLISTV.BND     They are used to bind the CLIENT.EXE application to the
  183.    RECEIVEV.BND     database built with SETUPDB.CMD.
  184.  
  185.  
  186.