home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / DDE / README < prev    next >
Text File  |  1995-06-09  |  7KB  |  193 lines
  1. ***************************************************************************
  2. * FILE NAME: readme                (DDE Server Sample Program)            *
  3. *                                                                         *
  4. * COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1995.*
  5. *                                                                         *
  6. * DISCLAIMER OF WARRANTIES:                                               *
  7. *   The following [enclosed] code is sample code created by IBM           *
  8. *   Corporation.  This sample code is not part of any standard IBM product*
  9. *   and is provided to you solely for the purpose of assisting you in the *
  10. *   development of your applications.  The code is provided "AS IS",      *
  11. *   without warranty of any kind.  IBM shall not be liable for any damages*
  12. *   arising out of your use of the sample code, even if they have been    *
  13. *   advised of the possibility of such damages.                           *
  14. ***************************************************************************
  15.  
  16. DDE - Dynamic Data Exchange 
  17.  
  18.    DESCRIPTION:
  19.  
  20.         The DDE Sample contains two applications.  They are the DDE
  21.         Client and DDE Server.  These two applications start DDE
  22.         conversations with each other and can perform data requests to
  23.         the other application.  In addition they can be hotlinked
  24.         together for automatic data requests.  Classes used include
  25.         IDDEClientConversation, IDDEClientAcknowledge,
  26.         IDDEClientEndEvent, IDDEClientHotLinkEvent, IDDEClientHotLinkSet,
  27.         IDDEBeginEvent, IDDEEndEvent, IDDETopicServer,
  28.         IDDERequestDataEvent, IDDEServerHotLinkEvent, and
  29.         IDDEAcknowledgeEvent.
  30.  
  31.    CONCEPT/FEATURE:
  32.         Sample program for demonstrating different styles of message
  33.         boxes in the IBM User Interface Class Library.
  34.  
  35.    PROJECT LOCATION:
  36.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  37.         folder).
  38.  
  39.    SOURCE FILE LOCATION:
  40.         X:\ibmcpp\samples\ioc\dde
  41.  
  42.         X:\ibmcpp\samples\ioc\dde\ddeclnt
  43.  
  44.         where X: is the drive you installed the samples and document
  45.         component of VisualAge C++.
  46.  
  47.    HOW TO RUN THE SAMPLE:
  48.  
  49.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  50.              To run the prebuilt project, open the Samples folder on your
  51.              OS/2 desktop then double-click on the project's icon to open
  52.              the project view of the sample.  Click on the RUN button of
  53.              the project's toolbar.
  54.  
  55.         FROM THE COMMAND LINE:
  56.              Simply type the name of the .EXE file, that is:
  57.  
  58.                  SERVER
  59.  
  60.              or
  61.  
  62.                  CLIENT
  63.  
  64.              If the sample fails to execute or abnormally ends, you can
  65.              get more information about the failure by turning on the
  66.              ICLUI trace.  This is done by setting the environment
  67.              variable ICLUI_TRACE as follows:
  68.  
  69.                    set ICLUI_TRACE=ON
  70.                    set ICLUI_TRACETO=STDERR
  71.  
  72.              The second export controls where the trace information is
  73.              reported.  With tracing turned on, ICLUI exception text will
  74.              be written to a standard error file. For example:
  75.  
  76.                    hello1 >hello1.out 2>&1
  77.  
  78.              The exception data is now in the file hello1.out.
  79.  
  80.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  81.  
  82.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  83.              Open the Samples folder on your OS/2 desktop then
  84.              double-click on the project's icon to open the project view
  85.              of the sample. In the upper half of the project window you
  86.              will see the icons of the files associated with the sample.
  87.              From the Project pulldown, select Build -> Rebuild All. To run
  88.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  89.  
  90.         FROM THE COMMAND LINE:
  91.            - A command file is provided to allow rebuilding of the
  92.              WorkFrame projects from the command line.  Simply type:
  93.  
  94.                  BUILD
  95.  
  96.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT 
  97.              above.
  98.  
  99.            - The sample application can also be built by entering:
  100.                  NMAKE
  101.              with no options while in the directory containing the
  102.              sample application files.  The makefile is named
  103.                  Makefile
  104.              To clean up the files generated from running make, enter:
  105.                  NMAKE CLEAN 
  106.              while in the directory containing the sample program files. 
  107.  
  108.    SOFTWARE/HARDWARE PREREQUISITES:
  109.  
  110.         o   IBM VisualAge C++
  111.         o   OS/2 2.1 or Warp
  112.         o   IBM or compatible 386 and up.
  113.  
  114.    ADDITIONAL INFORMATION:
  115.  
  116.         o   For more information on the creation and use of projects in
  117.             the WorkFrame environment, see the VisualAge C++ for OS/2
  118.             User's Guide.
  119.         o   For more information on the User Interface Classes, see the
  120.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  121.  
  122.         Both books can be found online.  To access an online book, simply
  123.         open the main VisualAge C++ desktop folder, then open the
  124.         Information Folder inside.  To view a book, double-click on that
  125.         book's icon.
  126.  
  127.  
  128.  
  129.    REQUIRED FILES - DDE:
  130.  
  131.    \ibmcpp\samples\ioc\dde directory:
  132.  
  133.      README
  134.         Instructions for using this sample program
  135.  
  136.      BUILD.CMD
  137.         command file to build in project form from command line
  138.  
  139.      SERVER.EXE
  140.         server executable
  141.  
  142.      ASERVER.CPP
  143.         Source code for main() and AServerWindow class
  144.  
  145.      ASERVER.HPP
  146.         Class header file for AServerWindow class
  147.  
  148.      ASERVER.H
  149.         Symbolic definition file
  150.  
  151.      ASERVER.RC
  152.         OS/2 PM resource file
  153.  
  154.      ASERVER.ICO
  155.         icon file
  156.  
  157.      MAKEFILE
  158.         make file to build the sample program on OS/2
  159.  
  160.      DDECLNT1
  161.  
  162.    \ibmcpp\samples\ioc\dde\ddeclnt directory:
  163.  
  164.      README
  165.         description and instructions for client portion of sample
  166.  
  167.      MAKEFILE
  168.         make file to build the sample program on OS/2
  169.  
  170.      CLIENT.EXE
  171.         client executable
  172.  
  173.      ACLIENT.CPP
  174.         Source code for main() and AClientWindow class
  175.  
  176.      ACLIENT.HPP
  177.         Class header file for AClientWindow class
  178.  
  179.      ACLIENT.H
  180.         Symbolic definition file
  181.  
  182.      ACLIENT.RC
  183.         OS/2 PM resource file
  184.  
  185.      ACLIENT.ICO
  186.         icon file
  187.  
  188.  
  189.  
  190. ***************************************************************************                                                                        *
  191. * Note: This sample application works in conjunction with the             *
  192. *       DDE Client Sample located in samples\ioc\ddeclnt.                 *
  193. ***************************************************************************