home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / NOTIFY / README < prev   
Text File  |  1995-06-09  |  6KB  |  158 lines
  1. ********************************************************************************
  2. * Notify Sample Program - Readme file                                        *
  3. *                                                                              *
  4. * COPYRIGHT:                                                                   *
  5. *   IBM Open Class Library                                                     *
  6. *   (C) Copyright International Business Machines Corporation 1992, 1995       *
  7. *   Licensed Material - Program-Property of IBM - All Rights Reserved.         *
  8. *   US Government Users Restricted Rights - Use, duplication, or disclosure    *
  9. *   restricted by GSA ADP Schedule Contract with IBM Corp.                     *
  10. *                                                                              *
  11. * DISCLAIMER OF WARRANTIES:                                                    *
  12. *   The following [enclosed] code is sample code created by IBM                *
  13. *   Corporation.  This sample code is not part of any standard IBM product     *
  14. *   and is provided to you solely for the purpose of assisting you in the      *
  15. *   development of your applications.  The code is provided "AS IS",           *
  16. *   without warranty of any kind.  IBM shall not be liable for any damages     *
  17. *   arising out of your use of the sample code, even if they have been         *
  18. *   advised of the possibility of such damages.                                *
  19. ********************************************************************************
  20.  
  21. NOTIFY
  22.  
  23.    DESCRIPTION:
  24.  
  25.         The Notify sample demonstrates notifications.  An entryfield is
  26.         displayed that will only accept characters between 'a' and 'z'.
  27.         If data is entered that does not match this criteria, a message
  28.         warning is displayed.  Classes used include IObserver,
  29.         INotificationEvent, and IEntryField.
  30.  
  31.  
  32.    PROJECT LOCATION:
  33.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  34.         folder).
  35.  
  36.    SOURCE FILE LOCATION:
  37.         X:\ibmcpp\samples\ioc\notify
  38.  
  39.         where X: is the drive you installed the samples and document
  40.         component of VisualAge C++.
  41.  
  42.    HOW TO RUN THE SAMPLE:
  43.  
  44.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  45.              To run the prebuilt project, open the Samples folder on your
  46.              OS/2 desktop then double-click on the project's icon to open
  47.              the project view of the sample.  Click on the RUN button of
  48.              the project's toolbar.
  49.  
  50.         FROM THE COMMAND LINE:
  51.              Simply type the name of the .EXE file, that is:
  52.  
  53.                  NOTIFY
  54.  
  55.              If the sample fails to execute or abnormally ends, you can
  56.              get more information about the failure by turning on the
  57.              ICLUI trace.  This is done by setting the environment
  58.              variable ICLUI_TRACE as follows:
  59.  
  60.                    set ICLUI_TRACE=ON
  61.                    set ICLUI_TRACETO=STDERR
  62.  
  63.              The second export controls where the trace information is
  64.              reported.  With tracing turned on, ICLUI exception text will
  65.              be written to a standard error file. For example:
  66.  
  67.                    hello1 >hello1.out 2>&1
  68.  
  69.              The exception data is now in the file hello1.out.
  70.  
  71.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  72.  
  73.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  74.              Open the Samples folder on your OS/2 desktop then
  75.              double-click on the project's icon to open the project view
  76.              of the sample. In the upper half of the project window you
  77.              will see the icons of the files associated with the sample.
  78.              From the Project pulldown, select Build -> Rebuild All. To run
  79.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  80.  
  81.         FROM THE COMMAND LINE:
  82.            - A command file is provided to allow rebuilding of the
  83.              WorkFrame projects from the command line.  Simply type:
  84.  
  85.                  BUILD
  86.  
  87.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  88.              above.
  89.  
  90.            - The sample application can also be built by entering:
  91.                  NMAKE
  92.              with no options while in the directory containing the
  93.              sample application files.  The makefile is named
  94.                  Makefile
  95.              To clean up the files generated from running make, enter:
  96.                  NMAKE CLEAN 
  97.              while in the directory containing the sample program files. 
  98.  
  99.    SOFTWARE/HARDWARE PREREQUISITES:
  100.  
  101.         o   IBM VisualAge C++
  102.         o   OS/2 2.1 or Warp
  103.         o   IBM or compatible 386 and up.
  104.  
  105.    ADDITIONAL INFORMATION:
  106.  
  107.         o   For more information on the creation and use of projects in
  108.             the WorkFrame environment, see the VisualAge C++ for OS/2
  109.             User's Guide.
  110.         o   For more information on the User Interface Classes, see the
  111.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  112.  
  113.         Both books can be found online.  To access an online book, simply
  114.         open the main VisualAge C++ desktop folder, then open the
  115.         Information Folder inside.  To view a book, double-click on that
  116.         book's icon.
  117.  
  118.  
  119.   REQUIRED FILES - NOTIFY
  120.  
  121.    README
  122.         description and instructions for sample
  123.  
  124.    BUILD.CMD
  125.         command file for building in project form from the command line
  126.  
  127.    NOTIFY.EXE
  128.         sample's executable
  129.  
  130.    NOTIFY.CPP
  131.         C++ source code for NOTIFY 
  132.  
  133.    NOTIFY.HPP
  134.         class definitions for NOTIFY
  135.  
  136.    NOTIFY.H
  137.         symbolic definition file
  138.  
  139.    NOTIFY.RC
  140.         resource file
  141.  
  142.    NOTIFY.ICO
  143.         icon file
  144.  
  145.    MONUMENT.BMP
  146.         bitmap
  147.  
  148.    CHEETAH.BMP
  149.         bitmap
  150.  
  151.    TAJMAHAL.BMP
  152.         bitmap
  153.  
  154.    WXMAP.BMP
  155.         bitmap
  156.  
  157.  
  158.