**********************************************************************
* 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.      *
*                                                                    *
**********************************************************************

POLICE RAP SHEET

  DESCRIPTION:
       This application retrieves information about
       suspects and displays the list of the
       suspects in a container.  A notebook is used to
       display detailed information about a suspect.

       This application consists of a set of visual and
       nonvisual parts.  The code for the nonvisual
       parts is already written, compiled, and linked
       into a DLL named CPPWV23.DLL.

       The visual parts were built and connected into
       an application with the nonvisual parts using
       the C++ Visual Builder Tool.  The set of visual
       parts that comprise this application are
       represented by the Visual Builder "class file"
       VBRPSHTV.VBB.  This file also contains handler
       classes as class interface parts.

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

       Refer to VBRAPSHT.SPC for the specifications of
       this application.


  HOW TO RUN THE SAMPLE:

       Note:  When you run this application, data is primed into
              the following .ini files:
                 isuspect.ini
                 ialias.ini
                 iarrest.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 "RapSheet" 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.
             7. Click on the Witness Identification graphic push
                button (NOTE: the other 2 graphic buttons do not
                do anything).

       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\rapsheet
             3. Set the path environment variable as follows:
                   set path=.;.\cppwv23;%path%
                This enables the resource DLL, CPPWV23R.DLL,
                and the code DLL for the nonvisual parts,
                CPPWV23.DLL, to be loaded.
             4. Type the name of the .EXE file, RPMNVIEW.
             5. Click on the Witness Identification graphic push
                button (NOTE: the other 2 graphic buttons do not
                do anything).


  HOW TO BUILD THE SAMPLE PROJECT YOURSELF:

       To regenerate this application's source, do the
       following from the main Visual Builder window:

          1. Load all the "class files" used by this sample
             application by following the steps outlined in the
             "HOW TO INSPECT THE SAMPLE PARTS USING THE VISUAL
             BUILDER" section.
          2. Select all the parts in the "Visual Parts" list
             and then select "Part->Generate->Part source"
             from the menu bar.
          3. Select only the "IRapMainView" part in the
             "Visual Parts" list and then select
             "Part->Generate->main() for part" from the
             menu bar.

             NOTE: if you plan on building the
             application from the command line, be sure
             the "Generate make files" selection is checked
             for the Options choice on the main Visual
             Builder window before you generate main()
             for the IRapMainView part.

       To build the application from within this WorkFrame
       sample project:
             1. Invoke a Project Build Action.

       To build the application 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\rapsheet
             3. Set the include environment variable as follows:
                   set include=.;.\cppwv23;%include%
                This enables the header files for the nonvisual
                parts to be included.
             4. Set the lib environment variable as follows:
                   set lib=.;.\cppwv23;%lib%
                This enables the import library for the nonvisual
                parts, CPPWV23.LIB, to be linked.
             5. Build the EXE by typing the following from the
                command line:
                   nmake -f rpmnview.mak

       To run the sample application, see the section, "HOW TO RUN
       THE SAMPLE".


  HOW TO INSPECT THE SAMPLE PARTS USING THE VISUAL BUILDER

       There are two "class files" that make up this sample
       application, VBRPSHTV.VBB and VBRPSHTN.VBB.  VBRPSHTV.VBB
       contains all the visual parts built using the Visual Builder.
       It also contains class interface parts that represent handler
       classes.  These parts are used by some of the visual parts.
       VBRPSHTN.VBB contains all the nonvisual parts.  For a
       description of the parts these "class files" contain,
       see the specifications file, VBRAPSHT.SPC.

       The VBRPSHTV.VBB file also requires the Visual Builder
       "class file", VBSAMPLE.VBB, to be loaded.

       From within the WorkFrame environment:
             1. Open the sample project view as described
                above. In the project window you will see
                the icons of the files associated with the sample.
             2. From the project view of this sample, select
                "Visual" from the Project pulldown.

       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\rapsheet
                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.

                This also allows Visual Builder to find the
                resource DLL, CPPWV23R.DLL, this sample uses.
                This resource DLL contains the various bitmaps
                and icons used by this application.
             3. Start the Visual Builder Tool by typing the
                following from the command line:
                   ivb


  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.
