home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / som / somem / c / emdemo / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-10  |  4.4 KB  |  102 lines
  1. #   10H9767, 10H9769  (C) COPYRIGHT International Business Machines Corp. 1992,1994,1996
  2. #   All Rights Reserved
  3. #   Licensed Materials - Property of IBM
  4. #   US Government Users Restricted Rights - Use, duplication or
  5. #   disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
  6.  
  7.  **********************************************************************
  8.  * DISCLAIMER OF WARRANTIES.
  9.  * The following [enclosed] code is sample code created by IBM
  10.  * Corporation. This sample code is not part of any standard or IBM
  11.  * product and is provided to you solely for the purpose of assisting
  12.  * you in the development of your applications.  The code is provided
  13.  * "AS IS". IBM MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT
  14.  * NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  15.  * FOR A PARTICULAR PURPOSE, REGARDING THE FUNCTION OR PERFORMANCE OF
  16.  * THIS CODE.  IBM shall not be liable for any damages arising out of
  17.  * your use of the sample code, even if they have been advised of the
  18.  * possibility of such damages.
  19.  *
  20.  * DISTRIBUTION.
  21.  * This sample code can be freely distributed, copied, altered, and
  22.  * incorporated into other software, provided that it bears the above
  23.  * Copyright notice and DISCLAIMER intact.
  24.  **********************************************************************
  25.  
  26. EMDEMO
  27.  
  28.    DESCRIPTION:
  29.       This sample allows the user to use a graphical user interface
  30.       to set up a timer, update a timer, and register work procedures.
  31.  
  32.    CONCEPT/FEATURE:
  33.       This directory contains a sample program that illustrates the use of
  34.       Event Manager.  The executable built is called "main.exe".
  35.  
  36.    HOW TO RUN THE PROJECT FROM THE COMMAND LINE:
  37.       Before building the executable, make sure the environment variable 
  38.       SOMIR is set appropriately.
  39.  
  40.       Note also that there are several different ways to build the sample.  A
  41.       quick look at main.c will show that you can choose to define preprocessor
  42.       constants that conditionally compile in code that will illustrate the 
  43.       EMan loop (ILLUSTRATE_LOOP), or will run the EMan in its own thread 
  44.       (THREAD_EMAN).  Please try out each of these options by modifying the
  45.       makefile or by adding defines from the nmake command line.
  46.  
  47.  
  48.       To build the sample:
  49.        - "nmake -f vac.mak all".
  50.  
  51.       To clean up the directory after running the samples:
  52.  
  53.        - "nmake -f vac.mak clean".
  54.  
  55.       Before running the program, make sure that the following environment
  56.       variables are set up as follows.
  57.  
  58.       - SOMSOCKETS should not be set on Win32 machines.
  59.       - HOSTNAME should be set to machine on which this program is running.
  60.         (For Win32 Workstation DSOM this must have a value of "localhost")
  61.  
  62.       Run the program "main".
  63.  
  64.       The following are the menu driven commands supported by the sample:
  65.  
  66.        Register
  67.          Work Procedure  - Registers a Work procedure to be called back when 
  68.                            there are no events.
  69.          Timer           - Registers a timer that pops every 1000 milliseconds
  70.          Update Timer    - Changes the above timer registration to pop 
  71.                            every 800 milliseconds instead
  72.  
  73.        Unregister
  74.          Work Procedure  - Unregisters the above work procedure interest
  75.          Timer           - Unregisters the above timer
  76.          Socket          - Unregisters the above socket.
  77.  
  78.        Event
  79.          Client 1        - Creates a client event with a method callback
  80.          Client 2        - Creates a client event with a procedure callback
  81.  
  82.        Quit              - Exit program
  83.  
  84.  
  85.    HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  86.     -Open the project "emdemo.iwp" in this sample directory.
  87.     -To make the project:
  88.         from the "Project" menu, select "Make",
  89.         or from the pop-up menu for the icon "vac.mak", select "Make"
  90.     -From workframe, click "Run", or  from the project monitor window, 
  91.      type "main" to execute.
  92.     -From the command line, "nmake -f vac.mak clean" to clean up.
  93.  
  94.    VisualAge for C++ SAMPLES INFORMATION:
  95.      A complete listing of samples shipped with the VisualAge for C++
  96.      product can be found in the online GUIDE TO SAMPLES.  To access
  97.      this notebook, simply:
  98.  
  99.      -  Open the VisualAge for C++ program group in the Program
  100.         Manager window, then
  101.      -  Open the GUIDE TO SAMPLES notebook in the program group.
  102.