home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / database / car / caredit / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-22  |  7.4 KB  |  187 lines
  1.  
  2.  
  3. **********************************************************************
  4. * DISCLAIMER OF WARRANTIES:                                          *
  5. *                                                                    *
  6. * The following enclosed code is sample code created by IBM          *
  7. * Corporation.  This sample code is not part of any standard IBM     *
  8. * product and is provided to you solely for the purpose of assisting *
  9. * you in the development of your applications.  The code is provided *
  10. * "AS IS", without warranty of any kind.  IBM shall not be liable    *
  11. * for any damages arising out of your use of the sample code, even   *
  12. * if they have been advised of the possibility of such damages       *
  13. *                                                                    *
  14. **********************************************************************
  15.  
  16. NAME:  Data Access CarEdit Sample
  17. ---------------------------------
  18.  
  19. FEATURES/CONCEPTS :
  20.  
  21.    Using the Visual Builder to construct an application to browse and
  22.    modify information in a database.  The application makes use of a DLL
  23.    containing the classes generated by the Data Access Builder.
  24.  
  25. DESCRIPTION
  26.  
  27.    This sample shows an application that might be used as a salesmanager's
  28.    front end to inventory in a car lot.  The use of Data Access Builder
  29.    components is demonstrated, including use of the IDSConnectCanvasBase to
  30.    build a multiframe application.  The user of the application would be given
  31.    the ability to connect to different databases, examine, modify, add or
  32.    delete the database representations of cars in the lot inventory.
  33.    CarEdit would be used by the salesmanager to maintain the information
  34.    available to the salespersons using the CarEdit application.
  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\CAREDIT
  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 caredit workframe project by typing
  56.  
  57.              iwf caredit
  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.   caredit.exe.
  69.  
  70.   To rebuild caredit.exe use the following instructions:
  71.  
  72.  
  73. REBUILDING THE SAMPLE:
  74.  
  75.    1. Change directories to x:\ibmcppw\samples\database\car\caredit.
  76.  
  77.       To rebuild the sample from the command line, start the Visual Builder
  78.       from the x:\ibmcppw\samples\database\car\caredit directory by typing
  79.  
  80.           IVB
  81.  
  82.       If you are using workframe, first invoke the Workframe project by typing
  83.  
  84.          IWF Caredit
  85.  
  86.       Then select VISUAL from the Project menu item.
  87.  
  88.    2. Select LOAD from the FILE pull-down menu.
  89.       Load CAREDIT.VBB from (X:\IBMCPPW\SAMPLES\DATABASE\CAR\CAREDIT).
  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 CAREDIT.VBB and VBDAX.VBB from
  106.       the loaded parts files.
  107.       Select CarEdit, CarContainer, and ModifyCar 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 CarEdit 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. BEFORE RUNNING 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\caredit or to another directory
  134.       on your path.
  135.  
  136.       If you have run the sample before and made changes to the database,
  137.       you may choose to work with the database in its original or updated state.
  138.  
  139.       To work with the original database do the following.
  140.  
  141.       From the command line type
  142.  
  143.         RESETTBO
  144.  
  145.       From Workframe, double click on RESETTBO.BAT.
  146.  
  147. RUNNING THE SAMPLE:
  148.  
  149.       To invoke the application from the command line type
  150.  
  151.          Caredit
  152.  
  153.       From Workframe choose the RUN option from the PROJECT menu item.
  154.  
  155. NOTE: If you are accessing a remote server, you may be required to supply
  156.       a userid and password. They may be passed to RESETTBO and CLIENT.
  157.       If you are using CLI use RESETTBC and if you are using Embedded SQL
  158.       use RESETTBE.
  159.  
  160. FILE NAME(S)     DESCRIPTION
  161. ============     ===========
  162. RESETTBO.BAT     This file resets the Car table to its intial state.
  163.                  Use this file when using ODBC.
  164. RESETTBC.BAT     This file resets the Car table to its inital state.
  165.                  Use this file when using CLI.
  166. RESETTBE.BAT     This file resets the Car table to its intial state.
  167.                  Use this file when using Embedded SQL.
  168. MAKEFILE         This is the makefile used to build the sample application from
  169.                  the command line.
  170. CAREDIT.EXE      This is the executable.
  171. CRTDB.BAT        This file creates a local DB2 database called DAXSAMP.
  172.                  You must run RESETTBE after creating the local DB2 database to
  173.                  create and poplulate the database tables.
  174.                  NOTE: If you are accessing a remote DB2 server, the database
  175.                        must be created on the remote server and cataloged on the
  176.                        local client.
  177. CAREDIT.IWP      This file is used to invoke the workframe project associated
  178.                  with this sample.
  179. CAREDIT.IWO      This file is used to store the options associated with the
  180.                  workframe project.
  181. DAXSAMP.IWP      This file is the workframe child project used to recreate the
  182.                  Database access DLL.
  183. DAXSAMP.IWO      This file is used to invoke the workframe project associated
  184.                  with this sample.
  185. CAREDIT.VBB      This file is used when rebuilding the CarEdit application.
  186. README.TXT       This file.
  187.