home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / database / car / carbrws / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-22  |  7.1 KB  |  182 lines
  1.  
  2.  **********************************************************************
  3.  * DISCLAIMER OF WARRANTIES:                                          *
  4.  *                                                                    *
  5.  * The following enclosed code is sample code created by IBM          *
  6.  * Corporation.  This sample code is not part of any standard IBM     *
  7.  * product and is provided to you solely for the purpose of assisting *
  8.  * you in the development of your applications.  The code is provided *
  9.  * "AS IS", without warranty of any kind.  IBM shall not be liable    *
  10.  * for any damages arising out of your use of the sample code, even   *
  11.  * if they have been advised of the possibility of such damages       *
  12.  *                                                                    *
  13.  **********************************************************************
  14.  
  15. NAME:  Data Access CarBrws Sample
  16. ---------------------------------
  17.  
  18. FEATURES/CONCEPTS :
  19.  
  20.    Using the Visual Builder to construct an application that browses
  21.    information in a supplied dBase database named DAXSAMP.
  22.    The application makes use of a DLL containing the classes
  23.    generated by the Data Access Builder.
  24.  
  25.    This sample creates a simple application (a salesperson's front end to
  26.    a car lot inventory) to browse data in a database.
  27.    The use of Data Access Builder components is demonstrated,
  28.    including the use of IDatastoreBase settings to provide a connection
  29.    to the database without input from the user of the application.
  30.  
  31. DESCRIPTION
  32.  
  33.    This sample uses a DLL and an application which has been constructed
  34.    using Data Access Builder and the Visual Builder.
  35.  
  36.    NOTE:  You may run the sample without rebuilding the sample.
  37.           If you wish to rebuild the sample before running, follow the
  38.           instructions below.
  39.  
  40. PROJECT/SOURCE FILE LOCATION
  41.  
  42.    X:\IBMCPPW\SAMPLES\DATABASE\CAR\CARBRWS
  43.  
  44.    where X: is the drive on which you installed the samples and document
  45.    component of VisualAge C++.
  46.  
  47. HOW TO BUILD THE SAMPLE:
  48.  
  49.   If you have not already done so, build the access DLL used by this
  50.   application. Please refer to the readme in
  51.   x:\ibmcppw\samples\database\car\daxsamp for a description on how to rebuild
  52.   the access DLL.
  53.  
  54.   NOTE: If you are using workframe to rebuild the access DLL. You should bring
  55.         up the carbrws workframe project by typing
  56.  
  57.              iwf carbrws
  58.  
  59.         You may then invoke the DAXSAMP child project by double-clicking on the
  60.         DAXSAMP project.
  61.  
  62.         From this point, follow the instructions for rebuilding the access DLL
  63.         from within workframe in the x:\ibmcppw\samples\database\car\daxsamp
  64.         readme.
  65.  
  66.  
  67.   After optionally rebuilding the access DLL, you may optionally rebuild
  68.   carbrws.exe.
  69.  
  70.   To rebuild carbrws.exe use the following instructions:
  71.  
  72.  
  73. REBUILDING THE SAMPLE:
  74.  
  75.    1. Change directories to x:\ibmcppw\samples\database\car\carbrws.
  76.  
  77.       To rebuild the sample from the command line, start the Visual Builder
  78.       from the x:\ibmcppw\samples\database\car\carbrws directory by typing
  79.  
  80.           IVB
  81.  
  82.       If you are using workframe, first invoke the Workframe project by typing
  83.  
  84.          IWF Carbrws
  85.  
  86.       Then select VISUAL from the Project menu item.
  87.  
  88.    2. Select LOAD from the FILE pull-down menu.
  89.       Load CARBRWS.VBB from (X:\IBMCPPW\SAMPLES\DATABASE\CAR\CARBRWS).
  90.  
  91.    3. Select SHOW FULL FILENAMES from the OPTIONS pulldown menu to see
  92.       the pathname of the VBBASE.VBB file. This file is automatically
  93.       loaded by the Visual Builder.
  94.  
  95.    4. Select LOAD from the FILE pull-down menu.
  96.  
  97.    5. Load VBDAX.VBB from the directory that contains VBBASE.VBB.
  98.       Loading this file returns you to the main Visual Builder screen.
  99.  
  100.    7. Select IMPORT PART INFORMATION from the FILE pull-down menu of the
  101.       main Visual Builder screen.
  102.       Import CAR.VBE from the X:\IBMCPPW\SAMPLES\DATABASE\CAR\DAXSAMP directory.
  103.       Close the screen.
  104.  
  105.    8. On the main Visual Builder screen, select CARBRWS.VBB and VBDAX.VBB from
  106.       the loaded parts files.
  107.       Select CarBrws in the VISUAL PARTS list.
  108.       Click mouse button 2 on the VISUAL PARTS list.
  109.       Select GENERATE -> PART SOURCE from the pop-up window.
  110.       Select CarBrws in the the VISUAL PARTS List.
  111.       Click mouse button 2 on the VISUAL PARTS list.
  112.       Select GENERATE -> MAIN() FOR PART from the pop-up window.
  113.  
  114.    9. Exit the Visual Builder.
  115.  
  116.   10. To build the sample from the command line, first copy car.lib and car.hpp
  117.       from x:\ibmcppw\samples\database\car\daxsamp by typing
  118.  
  119.          copy ..\daxsamp\car.lib
  120.          copy ..\daxsamp\car.hpp
  121.  
  122.       then type
  123.  
  124.          nmake.
  125.  
  126.       To rebuild the sample using Workframe select BUILD normal from the
  127.       PROJECT menu item.
  128.  
  129. HOW TO RUN THE SAMPLE:
  130.  
  131.       Before running the application from the command line first copy
  132.       car.dll from x:\ibmcppw\samples\database\car\daxsamp to
  133.       x:\ibmcppw\samples\database\car\carbrws or to another directory
  134.       on your path.
  135.  
  136.       You may reset to contents of the database. To reset the contents from
  137.       the command line type
  138.  
  139.         RESETTBO
  140.  
  141.  
  142.     - NOTE: If you are accessing a remote server, you may be required to supply
  143.             a userid and password. They may be passed to RESETTBO and CLIENT.
  144.             If you are using CLI use RESETTBC and if you are using Embedded SQL
  145.             use RESETTBE.
  146.  
  147.       To invoke the application from the command line type
  148.  
  149.          Carbrws
  150.  
  151.       To invoke the application from workframe, choose the RUN option
  152.       from the PROJECT menu item.
  153.  
  154.  
  155. FILE NAME(S)     DESCRIPTION
  156. ============     ===========
  157. RESETTBO.BAT     This file resets the Car table to its intial state.
  158.                  Use this file when using ODBC.
  159. RESETTBC.BAT     This file resets the Car table to its inital state.
  160.                  Use this file when using CLI.
  161. RESETTBE.BAT     This file resets the Car table to its intial state.
  162.                  Use this file when using Embedded SQL.
  163. MAKEFILE         This is the makefile used to build the sample application from
  164.                  the command line.
  165. CARBRWS.EXE      This is the executable.
  166. CRTDB.BAT        This file creates a local DB2 database called DAXSAMP.
  167.                  You must run RESETTBE after creating the local DB2 database
  168.                  to create and poplulate the database tables.
  169.                  NOTE: If you are accessing a remote DB2 server, the database
  170.                        must be created on the remote server and cataloged on
  171.                        the local client.
  172. CARBRWS.IWP      This file is used to invoke the workframe project associated
  173.                  with this sample.
  174. CARBRWS.IWO      This file is used to store the options associated with the
  175.                  workframe project.
  176. DAXSAMP.IWP      This file is the workframe child project used to recreate the
  177.                  Database access DLL.
  178. DAXSAMP.IWO      This file is used to invoke the workframe project associated
  179.                  with this sample.
  180. CARBRWS.VBB      This file is used when rebuilding the Carbrws application.
  181. README.TXT       This file.
  182.