home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / visbuild / oasearch / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-22  |  8.0 KB  |  179 lines
  1. **********************************************************************
  2. * DISCLAIMER OF WARRANTIES:                                          *
  3. *                                                                    *
  4. * The following enclosed code is sample code created by IBM          *
  5. * Corporation.  This sample code is not part of any standard IBM     *
  6. * product and is provided to you solely for the purpose of assisting *
  7. * you in the development of your applications.  The code is provided *
  8. * "AS IS", without warranty of any kind.  IBM shall not be liable    *
  9. * for any damages arising out of your use of the sample code, even   *
  10. * if they have been advised of the possibility of such damages.      *
  11. *                                                                    *
  12. **********************************************************************
  13.  
  14. OASEARCH
  15.  
  16.   DESCRIPTION:
  17.        A simple GUI application that serves recruiters
  18.        for a fictitious services contractor called
  19.        "Opportunities Abound".  When a customer calls
  20.        looking for a particular skill, a recruiter can
  21.        match that skill with a list of OA employees that
  22.        have that skill.  Once a suitable match is made,
  23.        the recruiter can open a contract with the
  24.        customer.
  25.  
  26.   CONCEPT/FEATURE:
  27.        How to build a simple GUI application using the
  28.        Visual Builder.
  29.  
  30.   HOW TO RUN THE SAMPLE:
  31.  
  32.        Note:  Before executing this application or
  33.               editing its parts with the Visual Builder
  34.               you should add
  35.               \ibmcppw\samples\visbuild\oasearch
  36.               to the PATH environment variable.  This is so
  37.               the sample can find the resource DLL,
  38.               CPPWV33R.DLL, which contains the various
  39.               bitmaps and icons used by this application.
  40.  
  41.        Note:  When you run this application, data is primed into
  42.               the following .ini files via the IProfile class:
  43.                  skill.ini
  44.                  contract.ini
  45.                  contrctr.ini
  46.               On Windows, .ini files are stored in the Windows
  47.               registry as Software. If you want to delete this
  48.               data, Microsoft provides a tool that allows you
  49.               to modify its registry.
  50.  
  51.  
  52.        From within the WorkFrame environment:
  53.                  1. Open the VisualAge for C++ product object.
  54.                  2. Open the Guide to Samples notebook.
  55.                  3. Select "Visual Builder Samples" from the
  56.                     Component drop down list.
  57.                  4. Select "OASearch" from the List of Samples.
  58.                  5. Click the "Open Project" button to open the
  59.                     project view.
  60.                  6. Click on the RUN button of the project's toolbar.
  61.  
  62.        From the command line:
  63.                  1. Set the current drive as the drive where you
  64.                     installed the VisualAge C++ samples.
  65.                  2. Set the directory path for this sample
  66.                     as follows:
  67.                        cd ibmcppw\samples\visbuild\oasearch
  68.                  3. Set the path environment variable as follows:
  69.                        set path=.;%path%
  70.                  4. Type the name of the .EXE file, OAMAIN.
  71.  
  72.  
  73.   HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  74.  
  75.        Note:  CONTRACT.VBB, which contains the "ContractView" part,
  76.               is only for viewing within the example. It is not for
  77.               code generation and should not be confused with the
  78.               "OAContractView" part.
  79.               Likewise, the "OASearch" part in OANONVIS.VBB
  80.               is for viewing only.
  81.  
  82.        From within the WorkFrame environment:
  83.                  Open the sample project view as described
  84.                  above. In the project window you will see
  85.                  the icons of the files associated with the sample.
  86.  
  87.                  1. From the project view of this sample, select
  88.                     "Visual" from the Project pulldown.
  89.                  2. Select all the parts in the "Visual
  90.                     Parts" list EXCEPT the
  91.                     "ContractView" part, and then
  92.                     select "Part->Generate->Part
  93.                     source" from the Menubar.
  94.                  3. Select only the "OAMain" part in
  95.                     the "Visual Parts" list and then
  96.                     select "Part->Generate->main() for
  97.                     part" from the Menubar.
  98.                  4. Deselect all the visual parts.
  99.                     Select all the parts in the
  100.                     "Nonvisual Parts" list except the
  101.                     "OASearch" part, and then
  102.                     select "Part->Generate->Part
  103.                     source" from the Menubar.
  104.                  5. Now invoke a Project Build Action.
  105.  
  106.                  To run the sample project, see How to
  107.                  run the sample project above.
  108.  
  109.        From the command line:
  110.                  1. Set the current drive as the drive where you
  111.                     installed the VisualAge C++ samples.
  112.                  2. Set the directory path for this sample
  113.                     as follows:
  114.                        cd ibmcppw\samples\visbuild\oasearch
  115.                     This will allow Visual Builder to automatically
  116.                     load all the Visual Builder "class files"
  117.                     this samples uses.  These files are listed
  118.                     in the file VBLOAD.DAT in this directory.
  119.                  3. Start the Visual Builder Tool by typing the
  120.                     following from the command line:
  121.                        ivb
  122.                  4. Select all the parts in the "Visual
  123.                     Parts" list EXCEPTt the
  124.                     "ContractView" part, and then
  125.                     select "Part->Generate->Part
  126.                     source" from the Menubar.
  127.                  5. Select only the "OAMain" part in
  128.                     the "Visual Parts" list and then
  129.                     select "Part->Generate->main() for
  130.                     part" from the Menubar.
  131.                  6. Deselect all the visual parts.
  132.                     Select all the parts in the
  133.                     "Nonvisual Parts" list except
  134.                     the "OASearch" part, and then
  135.                     select "Part->Generate->Part
  136.                     source" from the Menubar.
  137.                  7. From the command line, make this
  138.                     sample's directory the current directory
  139.                     as described above.
  140.                  8. Build the EXE by executing the MAKE as follows:
  141.                        nmake oamain.mak
  142.  
  143.  
  144.   HOW TO INSPECT THE VISUAL PARTS USING THE VISUAL BUILDER
  145.  
  146.             There are three "class files" that make up
  147.             the application, CONTRACT.VBB,
  148.             OANONVIS.VBB, and OAWIN.VBB.
  149.  
  150.               1. Start the Visual Builder Tool --
  151.                  from the command line:
  152.                  - Set the current drive as the drive where you
  153.                    installed the VisualAge C++ samples.
  154.                  - Set the directory path for this sample
  155.                    as follows:
  156.                       cd ibmcppw\samples\visbuild\oasearch
  157.                  - Type:
  158.                       ivb
  159.  
  160.                  or from the project view of the
  161.                  sample, select Visual from the Project
  162.                  pulldown.
  163.               2. When the Visual Builder Window appears,
  164.                  you may now select any or all of
  165.                  these parts from the "Visual Parts" list
  166.                  and then select "Part->Open" from the
  167.                  Menubar to open these parts for
  168.                  viewing and/or editting.
  169.  
  170.  
  171.   ADDITIONAL INFORMATION:
  172.        For additional information on this and other samples shipped
  173.        with the VisualAge for C++ product, please see the Guide to Samples
  174.        notebook.
  175.  
  176.        To access the notebook from Program Manager, open the
  177.        VisualAge for C++ product object, then open the Guide to Samples
  178.        notebook.
  179.