home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / ANIMALS / ANIMALS.REA < prev    next >
Text File  |  1995-06-07  |  5KB  |  122 lines
  1. PROJECT - Animals
  2.  
  3.    DESCRIPTION:
  4.         This program uses the default key bag class, IKeyBag, to create a
  5.         key bag for storing observations made on animals.  The key of the
  6.         class is the name of the animal. The program produces various
  7.         reports regarding the observations. Then it removes all the
  8.         extinct animals, which are stored in a sequence, from the key
  9.         bag.
  10.  
  11.    TASK:
  12.         This program creates and uses a key bag for storing observations
  13.         made on animals.
  14.  
  15.    CONCEPT/FEATURE:
  16.         This program is a sample to demonstrate the use of the default
  17.         key bag class, IKeyBag.
  18.  
  19.    PROJECT LOCATION:
  20.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  21.         folder). 
  22.  
  23.    SOURCE FILE LOCATION:
  24.         X:\ibmcpp\samples\ioc\animals
  25.  
  26.         where X: is the drive you installed the samples and document
  27.         component of VisualAge C++.
  28.  
  29.    HOW TO RUN THE SAMPLE:
  30.  
  31.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  32.              To run the prebuilt project, open the Samples folder on your
  33.              OS/2 desktop then double-click on the project's icon to open
  34.              the project view of the sample.  Click on the RUN button of
  35.              the project's toolbar.
  36.  
  37.         FROM THE COMMAND LINE:
  38.              Simply type the name of the .EXE file, that is:
  39.  
  40.                  ANIMALS
  41.  
  42.              If the sample fails to execute or abnormally ends, you can
  43.              get more information about the failure by turning on the
  44.              ICLUI trace.  This is done by setting the environment
  45.              variable ICLUI_TRACE as follows:
  46.  
  47.                    SET ICLUI_TRACE=ON
  48.                    SET ICLUI_TRACETO=STDERR
  49.  
  50.              The second export controls where the trace information is
  51.              reported.  With tracing turned on, ICLUI exception text will
  52.              be written to a standard error file. For example:
  53.  
  54.                    HELLO1 >HELLO1.OUT 2>&1
  55.  
  56.              The exception data is now in the file hello1.out.
  57.  
  58.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  59.  
  60.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  61.              Open the Samples folder on your OS/2 desktop then
  62.              double-click on the project's icon to open the project view
  63.              of the sample. In the upper half of the project window you
  64.              will see the icons of the files associated with the sample.
  65.              From the Project pulldown, select Build -> Rebuild All. To run
  66.              the sample project, see How to run the sample project above.
  67.  
  68.         FROM THE COMMAND LINE:
  69.            - A command file is provided to allow rebuilding of the
  70.              WorkFrame projects from the command line.  Simply type:
  71.  
  72.                  BUILD
  73.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT
  74.              above.
  75.  
  76.            - The sample application can also be built by entering:
  77.                  NMAKE
  78.              with no options while in the directory containing the
  79.              sample application files.  The makefile is named
  80.                  Makefile
  81.              To clean up the files generated from running make, enter:
  82.                  NMAKE CLEAN 
  83.              while in the directory containing the sample program files. 
  84.  
  85.    SOFTWARE/HARDWARE PREREQUISITES:
  86.  
  87.         o   IBM VisualAge C++
  88.         o   OS/2 2.1 or Warp
  89.         o   IBM or compatible 386 and up.
  90.  
  91.    ADDITIONAL INFORMATION:
  92.  
  93.         o   For a complete listing and description of samples provided with
  94.             the VisualAge C++ for OS/2 product, see the VisualAge C++ for OS/2 
  95.             Guide to Samples.
  96.         o   For more information on the creation and use of projects in
  97.             the WorkFrame environment, see the VisualAge C++ for OS/2
  98.             User's Guide.
  99.         o   For more information on the Collection Classes, see the
  100.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  101.  
  102.         All three books can be found online.  To access an online book, simply
  103.         open the main VisualAge C++ desktop folder, then open the
  104.         Information Folder inside.  To view a book, double-click on that
  105.         book's icon.
  106.  
  107.  
  108.    REQUIRED FILES - ANIMALS:
  109.     o   animals.rea
  110.         description and instructions for sample
  111.     o   animals.cpp
  112.         C++ source code
  113.     o   animal.h
  114.     o   animals.exe
  115.         sample's executable
  116.     o   animals.xpc 
  117.     o   build.cmd
  118.         command file to rebuild in project file from
  119.         the command line  
  120.  
  121.  
  122.