home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / VISBUILD / OASEARCH / README < prev    next >
Text File  |  1995-06-08  |  8KB  |  214 lines

  1. NAME: OASEARCH
  2.  
  3. DESCRIPTION:
  4.        A simple GUI application that serves recruiters 
  5.        for a fictitious services contractor called 
  6.        "Opportunities Abound".  When a customer calls 
  7.        looking for a particular skill, a recruiter can 
  8.        match that skill with a list of OA employees that 
  9.        have that skill.  Once a suitable match is made, 
  10.        the recruiter can open a contract with the 
  11.        customer. 
  12.  
  13. TASK:
  14.        A simple GUI application that matches 
  15.        requirements against a skills database and opens 
  16.        a contract when a match is found. 
  17.  
  18. CONCEPT/FEATURE:
  19.        How to build a simple GUI application using the 
  20.        Visual Builder 
  21.  
  22. PROJECT LOCATION:
  23.        Inside the VisBuild Sample folder (inside the 
  24.        VisualAge C++ Samples folder). 
  25.  
  26. SOURCE FILE LOCATION:
  27.        X:\ibmcpp\samples\visbuild\oasearch 
  28.  
  29.        where X: is the drive you installed the samples 
  30.        and document component of VisualAge C++. 
  31.  
  32.        Select Source Files for a list of the source files 
  33.        in this directory. 
  34.  
  35. HOW TO RUN THE SAMPLE:
  36.        
  37.        Note:  Before executing this application or 
  38.        editing its parts with the Visual Builder. you 
  39.        must add \ibmcpp\samples\visbuild\oasearch 
  40.        to the LIBPATH in your CONFIG.SYS.  This is so 
  41.        the sample can find the resource DLL, 
  42.        CPPOV33R, which contain the various bitmaps 
  43.        and icons used by this application. 
  44.  
  45.        From within the WorkFrame environment: 
  46.                  To run the prebuilt project, open the 
  47.                  Samples folder on your OS/2 desktop 
  48.                  then double-click on the project's icon 
  49.                  to open the project view of the 
  50.                  sample.  Click on the RUN button of 
  51.                  the project's toolbar. 
  52.  
  53.        From the command line: 
  54.                  Simply type the name of the .EXE file, 
  55.                  that is: 
  56.  
  57.                    OAMAIN
  58.                  
  59.  
  60. HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  61.  
  62.   Note:  CONTRACT.VBB is only for viewing within the 
  63.          example. It is not for code generation. 
  64.        
  65.        From within the WorkFrame environment: 
  66.                  Open the Samples folder on your OS/2 
  67.                  desktop then double-click on the 
  68.                  project's icon to open the project view 
  69.                  of the sample. In the upper half of the 
  70.                  project window you will see the icons 
  71.                  of the files associated with the sample. 
  72.  
  73.                  Start the Visual Builder component of 
  74.                  VisualAge C++ by selecting Visual from 
  75.                  the Project pulldown.  Then, from the 
  76.                  main Visual Builder Window: 
  77.  
  78.                    1. Select all the parts in the "Visual 
  79.                       Parts" list, except the 
  80.                       "ContractView" part, and then 
  81.                       select "Part->Generate->Part 
  82.                       source" from the Menubar. 
  83.                    2. Select only the "OAMain" part in 
  84.                       the "Visual Parts" list and then 
  85.                       select "Part->Generate->main() for 
  86.                       part" from the Menubar. 
  87.                    3. Deselect all the visual parts and 
  88.                       select all the parts in the 
  89.                       "Nonvisual Parts" list and then 
  90.                       select "Part->Generate->Part 
  91.                       source" from the Menubar. 
  92.                    4. Now invoke a Project Build Action. 
  93.  
  94.                  To run the sample project, see How to 
  95.                  run the sample project above. 
  96.  
  97.        From the command line: 
  98.                  Start the Visual Builder component of 
  99.                  VisualAge C++ by typing: 
  100.  
  101.                    icsvb
  102.                  
  103.                  From the main Visual Builder Window: 
  104.  
  105.                    1. Select all the parts in the "Visual 
  106.                       Parts" list, except the 
  107.                       "Contractview" part, and then 
  108.                       select "Part->Generate->Part 
  109.                       source" from the Menubar. 
  110.                    2. Select only the "OAMain" part in 
  111.                       the "Visual Parts" list and then 
  112.                       select "Part->Generate->main() for 
  113.                       part" from the Menubar. 
  114.                    3. Deselect all the visual parts and 
  115.                       select all the parts in the 
  116.                       "Nonvisual Parts" list and then 
  117.                       select "Part->Generate->Part 
  118.                       source" from the Menubar. 
  119.                    4. From an OS/2 command line, make 
  120.                       this sample's directory the current 
  121.                       directory and invoke the BUILD.CMD 
  122.                       program by typing: 
  123.  
  124.                         BUILD
  125.                       
  126.  
  127. HOW TO INSPECT THE VISUAL PARTS USING THE VISUAL BUILDER
  128.          
  129.            There are three "class files" that make up 
  130.             the application, CONTRACT.VBB, 
  131.             OANONVIS.VBB, and OAWIN.VBB. 
  132.               1. Start the Visual Builder Tool -- from 
  133.                  the command line, type: 
  134.  
  135.                     icsvb
  136.                  
  137.                  or from the project view of the 
  138.                  sample:select Visual from the Project 
  139.                  pulldown. 
  140.               2. When the Visual Builder Window 
  141.                  appears, select from the Menubar the 
  142.                  "File->Load" option. 
  143.               3. The Load Files dialog will appear with 
  144.                  a list of "class files" that may be 
  145.                  loaded.  Select from the list the files 
  146.                  listed in step number one (1) above 
  147.                  and press the "OK" button. 
  148.               4. Now that you have loaded the 
  149.                  necessary files, from the "Loaded Part 
  150.                  Files" list in the Visual Builder Window 
  151.                  select CONTRACT.VBB, OANONVIS.VBB, 
  152.                  and OAWIN.VBB . This will   cause the 
  153.                  application's visual parts to be 
  154.                  displayed in the "Visuals" list of this 
  155.                  Window. 
  156.               5. You may now select any or all of 
  157.                  these parts from the "Visual Parts" list 
  158.                  and then select "Part->Open" from the 
  159.                  Menubar to open these parts for 
  160.                  viewing and/or editting. 
  161.  
  162. SOFTWARE/HARDWARE PREREQUISITES:
  163.          
  164.            IBM VisualAge C++ 
  165.            OS/2 2.1 or Warp 
  166.            DB2/2 1.2 
  167.            IBM or compatible 486 and up. 
  168.  
  169. ADDITIONAL INFORMATION:
  170.          
  171.            For more information on the creation and 
  172.             use of projects in the WorkFrame 
  173.             environment, see the VisualAge C++ for 
  174.             OS/2 User's Guide. 
  175.            For more information on the the Visual 
  176.             Builder, see the VisualAge C++ for OS/2 
  177.             Visual Builder User's Guide. 
  178.  
  179.        Both books can be found online.  To access an 
  180.        online book, simply open the main VisualAge 
  181.        C++ desktop folder, then open the Information 
  182.        Folder inside.  To view a book, double-click on 
  183.        that book's icon. 
  184.   
  185.  
  186. REQUIRED FILES:
  187.  
  188.   README         
  189.   BUILD    CMD 
  190.   OAMAIN   EXE 
  191.   CONTRACT CPV 
  192.   CONTRACT HPV 
  193.   CONTRACT INI 
  194.   CONTRACT VBB 
  195.   CONTRCTR CPV 
  196.   CONTRCTR HPV 
  197.   CONTRCTR INI 
  198.   OAFWCLR  CPV 
  199.   OAFWCLR  HPV 
  200.   OANBCLR  CPV 
  201.   OANBCLR  HPV 
  202.   SKILL    CPV   
  203.   SKILL    HPV   
  204.   SKILL    INI   
  205.   SKILLB   CPV 
  206.   SKILLB   HPV 
  207.   CPPOV33  HLP 
  208.   CPPOV33  IPF 
  209.   OANONVIS VBB 
  210.   OAWIN    VBB 
  211.   CPPOV33R DLL 
  212.     
  213.  
  214.