home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / compiler / dts / readme.txt < prev    next >
Encoding:
Text File  |  1996-02-20  |  4.7 KB  |  117 lines

  1. ***************************************************************************
  2. * SOM SAMPLE PROJECT: Readme File (README.TXT)                            *
  3. *                                                                         *
  4. * COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1995.*
  5. *                                                                         *
  6. * DISCLAIMER OF WARRANTIES:                                               *
  7. *   The accompanying code is sample code created by the IBM Corporation.  *
  8. *   This sample code is not part of any standard IBM product and is       *
  9. *   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        *
  12. *   damages arising out of your use of the sample code, even if they      *
  13. *   have been advised of the possibility of such damages.                 *
  14. ***************************************************************************
  15.  
  16. SAMPLE - Direct-To-SOM (DTS)
  17.  
  18.    DESCRIPTION:
  19.         DTS is a C++ program that uses native SOM classes enabled by
  20.         VisualAge for C++'s Direct-to-SOM (DTS) support and the SOM toolkit.
  21.         The test case shows how easily one can create SOM classes using the
  22.         C++ language and VA for C++'s DTS support. Furthermore it provides an
  23.         example of how SOM classes can be exported to IDL so that clients can
  24.         exploit a SOM enabled class library even though they are not using
  25.         a DTS compiler.
  26.  
  27.    TASK:
  28.         Two client programs create and access instance data of a SOM class.
  29.         The first program (hhmain.exe) uses DTS support for compiling the
  30.         client code as well as in class library creation. The second program
  31.         (xhmain.exe) does not require DTS support for the client code.
  32.  
  33.    CONCEPT/FEATURE:
  34.         SOM is IBM's System Object Model, a new object-oriented programming
  35.         technology for building, packaging, and manipulating binary class
  36.         libraries. VisualAge for C++ (VA for C++) provides DTS support for
  37.         C++, by allowing a user to create native SOM classes in C++ and to
  38.         manipulate non-native SOM classes through the use of "binding files"
  39.         created by the SC compiler. VA for C++ also generates complete
  40.         interface definiton (IDL) files directly from C++ class definitions,
  41.         so that the users in other languages can also exploit SOM enabled C++
  42.         class libraries.
  43.  
  44.         The sample program is an example incorporating all the concepts and
  45.         features listed above:
  46.  
  47.         - class Info is a native DTS class.
  48.         - a DLL is created for class Info.
  49.         - an IDL definition is generated for class Info and placed in file
  50.           info.idl.
  51.         - an "XH" binding file is generated from Info's IDL class definition.
  52.         - two client programs "hhmain.cpp" and "xhmain.cpp", both create
  53.           a instance of class Info and query it's instance data.
  54.  
  55.         For more information on VA for C++'s DTS support, SOM frameworks,
  56.         please refer to VA for C++'s Programming Guide, and SOMobjects
  57.         Developer Toolkit Users Guide, respectively.
  58.  
  59.  
  60. HOW TO RUN THE SAMPLE:
  61.  
  62.    FROM THE COMMAND LINE:
  63.  
  64.        Enter the following:
  65.  
  66.          cd: X:\ibmcppw\samples\compiler\dts
  67.  
  68.          Type HHMAIN.EXE.
  69.  
  70.          cd: X:\ibmcppw\samples\compiler\dts\xhmain
  71.  
  72.          Type XHMAIN.EXE.
  73.  
  74.      Where X: is the drive you installed the samples component of
  75.      VisualAge for C++.
  76.  
  77.      NOTE: ensure that environment variable PATH includes the subdirectory
  78.            containing MYCLS.DLL.  One way of doing this is to enter the
  79.            following on the command line before trying to execute HHMAIN.EXE
  80.            or XHMAIN.EXE
  81.  
  82.            set path=.\xhmain\dtsdll;.\dtsdll;%path%
  83.  
  84.  
  85.    FROM WITHIN THE WorkFrame ENVIRONMENT:
  86.  
  87.        To execute HHMAIN.EXE, click on the "Run" button on DTS.IWP's
  88.        project toolbar.
  89.  
  90.        To execute XHMAIN.EXE, open up sub-project XHMAIN.IWP, and click
  91.        on the "Run" button on XHMAIN.IWP's project toolbar.
  92.  
  93.  
  94. HOW TO BUILD THE SAMPLE PROJECT YOURSELF FROM THE COMMAND LINE:
  95.  
  96.    Enter the following:
  97.  
  98.       cd X:\ibmcppw\samples\compiler\dts
  99.  
  100.    Where X: is the drive you installed the samples component of
  101.    VisualAge for C++.
  102.  
  103.    To build the DTS sample, enter the following:
  104.  
  105.           NMAKE
  106.  
  107.  
  108. ADDITIONAL INFORMATION:
  109.  
  110.    For information on this and other samples shipped with the VisualAge for
  111.    C++ product, please see the Guide to Samples notebook.
  112.  
  113.    To access the notebook from the Program Manager, open the VisualAge for
  114.    C++ product object, then open the Guide to Samples notebook.
  115.  
  116.  
  117.