**********************************************************************
* DISCLAIMER OF WARRANTIES:                                          *
*                                                                    *
* The following enclosed code is sample code created by IBM          *
* Corporation.  This sample code is not part of any standard IBM     *
* product and is provided to you solely for the purpose of assisting *
* you in the development of your applications.  The code is provided *
* "AS IS", without warranty of any kind.  IBM shall not be liable    *
* for any damages arising out of your use of the sample code, even   *
* if they have been advised of the possibility of such damages.      *
*                                                                    *
**********************************************************************

OASEARCH

  DESCRIPTION:
       A simple GUI application that serves recruiters
       for a fictitious services contractor called
       "Opportunities Abound".  When a customer calls
       looking for a particular skill, a recruiter can
       match that skill with a list of OA employees that
       have that skill.  Once a suitable match is made,
       the recruiter can open a contract with the
       customer.

  CONCEPT/FEATURE:
       How to build a simple GUI application using the
       Visual Builder.

  HOW TO RUN THE SAMPLE:

       Note:  Before executing this application or
              editing its parts with the Visual Builder
              you should add
              \ibmcppw\samples\visbuild\oasearch
              to the PATH environment variable.  This is so
              the sample can find the resource DLL,
              CPPWV33R.DLL, which contains the various
              bitmaps and icons used by this application.

       Note:  When you run this application, data is primed into
              the following .ini files via the IProfile class:
                 skill.ini
                 contract.ini
                 contrctr.ini
              On Windows, .ini files are stored in the Windows
              registry as Software. If you want to delete this
              data, Microsoft provides a tool that allows you
              to modify its registry.


       From within the WorkFrame environment:
                 1. Open the VisualAge for C++ product object.
                 2. Open the Guide to Samples notebook.
                 3. Select "Visual Builder Samples" from the
                    Component drop down list.
                 4. Select "OASearch" from the List of Samples.
                 5. Click the "Open Project" button to open the
                    project view.
                 6. Click on the RUN button of the project's toolbar.

       From the command line:
                 1. Set the current drive as the drive where you
                    installed the VisualAge C++ samples.
                 2. Set the directory path for this sample
                    as follows:
                       cd ibmcppw\samples\visbuild\oasearch
                 3. Set the path environment variable as follows:
                       set path=.;%path%
                 4. Type the name of the .EXE file, OAMAIN.


  HOW TO BUILD THE SAMPLE PROJECT YOURSELF:

       Note:  CONTRACT.VBB, which contains the "ContractView" part,
              is only for viewing within the example. It is not for
              code generation and should not be confused with the
              "OAContractView" part.
              Likewise, the "OASearch" part in OANONVIS.VBB
              is for viewing only.

       From within the WorkFrame environment:
                 Open the sample project view as described
                 above. In the project window you will see
                 the icons of the files associated with the sample.

                 1. From the project view of this sample, select
                    "Visual" from the Project pulldown.
                 2. Select all the parts in the "Visual
                    Parts" list EXCEPT the
                    "ContractView" part, and then
                    select "Part->Generate->Part
                    source" from the Menubar.
                 3. Select only the "OAMain" part in
                    the "Visual Parts" list and then
                    select "Part->Generate->main() for
                    part" from the Menubar.
                 4. Deselect all the visual parts.
                    Select all the parts in the
                    "Nonvisual Parts" list except the
                    "OASearch" part, and then
                    select "Part->Generate->Part
                    source" from the Menubar.
                 5. Now invoke a Project Build Action.

                 To run the sample project, see How to
                 run the sample project above.

       From the command line:
                 1. Set the current drive as the drive where you
                    installed the VisualAge C++ samples.
                 2. Set the directory path for this sample
                    as follows:
                       cd ibmcppw\samples\visbuild\oasearch
                    This will allow Visual Builder to automatically
                    load all the Visual Builder "class files"
                    this samples uses.  These files are listed
                    in the file VBLOAD.DAT in this directory.
                 3. Start the Visual Builder Tool by typing the
                    following from the command line:
                       ivb
                 4. Select all the parts in the "Visual
                    Parts" list EXCEPTt the
                    "ContractView" part, and then
                    select "Part->Generate->Part
                    source" from the Menubar.
                 5. Select only the "OAMain" part in
                    the "Visual Parts" list and then
                    select "Part->Generate->main() for
                    part" from the Menubar.
                 6. Deselect all the visual parts.
                    Select all the parts in the
                    "Nonvisual Parts" list except
                    the "OASearch" part, and then
                    select "Part->Generate->Part
                    source" from the Menubar.
                 7. From the command line, make this
                    sample's directory the current directory
                    as described above.
                 8. Build the EXE by executing the MAKE as follows:
                       nmake oamain.mak


  HOW TO INSPECT THE VISUAL PARTS USING THE VISUAL BUILDER

            There are three "class files" that make up
            the application, CONTRACT.VBB,
            OANONVIS.VBB, and OAWIN.VBB.

              1. Start the Visual Builder Tool --
                 from the command line:
                 - Set the current drive as the drive where you
                   installed the VisualAge C++ samples.
                 - Set the directory path for this sample
                   as follows:
                      cd ibmcppw\samples\visbuild\oasearch
                 - Type:
                      ivb

                 or from the project view of the
                 sample, select Visual from the Project
                 pulldown.
              2. When the Visual Builder Window appears,
                 you may now select any or all of
                 these parts from the "Visual Parts" list
                 and then select "Part->Open" from the
                 Menubar to open these parts for
                 viewing and/or editting.


  ADDITIONAL INFORMATION:
       For additional information on this and other samples shipped
       with the VisualAge for C++ product, please see the Guide to Samples
       notebook.

       To access the notebook from Program Manager, open the
       VisualAge for C++ product object, then open the Guide to Samples
       notebook.
