home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / DATABASE / CAR / CAREDIT / README < prev   
Text File  |  1995-06-11  |  7KB  |  167 lines
  1.   NAME: Data Access CarEdit Sample
  2.  
  3.   DESCRIPTION:
  4.  
  5.   This sample shows an application that might be used as a salesmanager's front end to inventory in a car 
  6.   lot. The use of Data Access builder components is demonstrated, including use of the IDSConnectCanvas 
  7.   to build a multiframe application. The user of the application would be given the ability to connect to 
  8.   different databases, examine, modify, add or delete the database representations of cars in the lot 
  9.   inventory.  CarEdit would be used by the salesmanager to maintain the information available to 
  10.   the salespersons using the CarBrws application. 
  11.  
  12.   TASK:
  13.        Construct a DLL and two applications using the Data Access Builder and the Visual Builder. 
  14.  
  15.   CONCEPT/FEATURE:
  16.        Use the Visual Builder to construct an application to browse and modify information in a database.  
  17.        The application makes use of a DLL containing the classes generated using the Data Access 
  18.        Builder. 
  19.  
  20.   PROJECT LOCATION:
  21.        Inside the Database Sample folder (inside the VisualAge C++ Samples folder). 
  22.  
  23.   SOURCE FILE LOCATION:
  24.        X:\ibmcpp\samples\database\car\caredit 
  25.  
  26.        where X: is the drive you installed the samples and document component of VisualAge C++. 
  27.  
  28. HOW TO RUN THE SAMPLE PROJECT
  29.  
  30. 1) In order to run this sample, you must have created the DAXSAMP database and have the CARV.DLL
  31.     (either the pre-built version or one you have built yourself) in a directory in your LIBPATH.  If you have not
  32.     performed these preliminary steps, see the DAXSAMP Sample for full instructions or refer to the abbreviated
  33.     instructions below under HOW TO BUILD THIS SAMPLE.
  34.  
  35. 2) If you have not already done so, start the DB2/2 database manager and log on.  You can do this on 
  36.     an OS/2 command line by typing:
  37.  
  38.       STARTDBM
  39.  
  40.     and then:
  41.  
  42.       LOGON /L
  43.  
  44.    This will bring up the DB2/2 logon screen.  Complete the logon process.
  45.  
  46. 3) The final step may be performed from either within the WorkFrame environment or from the 
  47.      command line.
  48.  
  49.     Within the WorkFrame environment:
  50.  
  51.     Open the CAREDIT project by double-clicking on the project's icon in the CAR sample folder.
  52.     Click on the RUN button of the project's toolbar.
  53.  
  54.     From the command line, inside the X:\ibmcpp\samples\database\car\caredit directory,
  55.     simply type:
  56.  
  57.       CAREDIT
  58.  
  59.     where X: is the drive you installed the samples and document component of VisualAge C++. 
  60.  
  61. HOW TO BUILD THIS SAMPLE YOURSELF
  62.  
  63. 1) If you have not already done so, build the DAXSAMP database.  Building the database is the first part of 
  64.     the DAXSAMP sample.  Full instructions for that sample can be found in the readme file of the
  65.     ibmcpp\samples\database\daxsamp directory or inside the DAXSAMP project of the CAR Sample folder. 
  66.     Abbreviated instructions are provided here for your convenience.
  67.  
  68.     From within the WorkFrame environment:
  69.     - Open the DAXSAMP Sample folder in the DATABASE Samples folder. Double-click on the DAXSAMP.CMD icon.   
  70.  
  71.     From the command line:
  72.     - While in the ibmcpp\samples\database\car\daxsamp directory, build the database by typing: 
  73.  
  74.       DAXSAMP
  75.  
  76.     In either case, the process will ask you what drive you wish the database to be created on,
  77.     enter a drive name (letter only, do not include a colon or backslash).
  78.  
  79. 2) Start the DB2/2 database manager and logon.  You can do this on an OS/2 command line by typing:
  80.  
  81.       STARTDBM
  82.  
  83.     and then:
  84.  
  85.      LOGON /L
  86.  
  87.    This will bring up the DB2/2 logon screen.
  88.  
  89. 3) Start the Visual Builder.
  90.  
  91.     Within the WorkFrame environment, select VISUAL from the PROJECT pulldown menu.
  92.  
  93.     From the command line by typing:
  94.  
  95.       ICSVB
  96.  
  97.     Once in the Visual Builder, select LOAD from the FILE pulldown menu.
  98.  
  99.     On the LOAD FILES screen you will see that Visual Builder has automatically 
  100.     loaded the VBBase.vbb file.  Select SHOW FULL FILENAMES from the OPTIONS pulldown menu to 
  101.     see the pathname of that file.
  102.  
  103.     From the same directory as VBBase.vbb, load VBDAX.vbb.  Loading the file returns you to the main 
  104.     Visual Builder screen.
  105.  
  106.     Select LOAD  from the FILE pulldown menu.  On the LOAD FILES screen, load CarEdit.vbb from the same 
  107.     directory as this README -- X:\ibmcpp\samples\database\daxsamp\car\caredit, where X: is the drive 
  108.      you installed the samples and document component of VisualAge C++. 
  109.  
  110.     Select IMPORT PART INFORMATION from the FILE pulldown menu of the main Visual Builder screen.  
  111.     On the IMPORTED FROM screen, load CarV.vbe from the X:\ibmcpp\samples\database\daxsamp directory.  
  112.     Close the screen.
  113.  
  114.     On the main Visual Builder screen, select CarEdit.vbb from the loaded parts files.  Select all parts 
  115.     in the VISUAL PARTS list.  Click Mouse Button 2 on the VISUAL PARTS, select 
  116.     GENERATE -> PART SOURCE from the pop-up window.  Select only CarEdit in the VISUAL PARTS list.  
  117.     Click Mouse Button 2 on the VISUAL PARTS list, select GENERATE -> MAIN().
  118.  
  119.     Exit the Visual Builder.
  120.  
  121. 4) Now build the executable file.
  122.  
  123.     From within the WorkFrame environment by clicking on the Build button of the project's toolbar.
  124.  
  125.     From the command line, in the X:\ibmcpp\samples\database\car\caredit directory, by typing:
  126.  
  127.        BUILD
  128.  
  129.    where X: is the drive you installed the samples and document component of VisualAge C++. 
  130.  
  131. 5) Now you can run the application.
  132.  
  133.    From within the WorkFrame environment, by clicking on the Run button on the project's toolbar.
  134.  
  135.    From the command line, in the X:\ibmcpp\samples\database\car\caredit directory, by typing:
  136.  
  137.        CAREDIT
  138.  
  139.    where X: is the drive you installed the samples and document component of VisualAge C++. 
  140.  
  141.  
  142.  
  143.   SOFTWARE/HARDWARE PREREQUISITES:
  144.          
  145.            IBM VisualAge C++3.0, including the Visual 
  146.             Builder and the Data Access Builder 
  147.            OS/2 2.1 or Warp 
  148.            DB2/2 1.2 
  149.            Minimum         : IBM or compatible 386
  150.              Recommended: IBM or compatible 486 and up
  151.     
  152.  
  153.  
  154.  REQUIRED FILES:
  155.  
  156.   readme       Description and instructions for this sample. 
  157.  
  158.   build.cmd    Once the CARV.DLL and application code has been 
  159.                    generated, will build CAREDIT.EXE. 
  160.  
  161.   caredit.vbb The application definition coded using the Visual 
  162.                    Builder. 
  163.  
  164.   caredit.exe The application program ready to run. 
  165.   
  166.  
  167.