home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / COMPILER / SAMPLE07 / READ.ME
Text File  |  1995-06-04  |  3KB  |  116 lines
  1.  
  2. SAMPLE - SAMPLE07 
  3.  
  4.  
  5. DESCRIPTION:
  6.  
  7.   This sample calculates the geometric area of a triangle or rectangle.  
  8.   It provides an example of a _DLL_InitTerm function and demonstrates 
  9.   exporting function entry points using two different techniques. 
  10.  
  11. TASK:
  12.  
  13.   Calculates the geometric area of a triangle or rectangle based on
  14.   size parameters provided by the user.
  15.  
  16. FEATURE/CONCEPT:
  17.   Demonstrates building and using a dynamic link library (DLL).  The sample
  18.   includes:
  19.  
  20.   - Example of a _DLL_InitTerm function.
  21.  
  22.   - Exporting function entry points, using two techniques: 
  23.     (1) #pragma export, and 
  24.     (2) module definition file.
  25.  
  26.   - Exporting variables using a module definition file.
  27.  
  28. PROJECT LOCATION:
  29.  
  30. This sample is not provided in project form.
  31.  
  32.  
  33. SOURCE FILE LOCATION:
  34.  
  35.   X:\IBMCPP\SAMPLES\COMPILER\SAMPLE07
  36.   X:\IBMCPP\SAMPLES\COMPILER\SAMPLE07\METHOD1
  37.   X:\IBMCPP\SAMPLES\COMPILER\SAMPLE07\METHOD2  
  38.  
  39.   where X: is the drive you installed the samples and document component
  40.   of VisualAge C++ for OS/2.
  41.  
  42. HOW TO RUN THE SAMPLE:
  43.  
  44. **NOTE**
  45.   The DLL that is created in the dll directory is moved into the sample07
  46.   directory. Set sample07 as the current directory to run MAIN07.EXE. In order
  47.   for the system to find the SAMPLE07.DLL, the LIBPATH setting in CONFIG.SYS
  48.   must include the current directory (i.e., ".;" must be specified).    
  49.  
  50. - FROM THE COMMAND LINE
  51.   Simply type the name of the .EXE file, that is:
  52.     
  53.   RUN   
  54.   
  55.   from the \SAMPLE07\METHOD1 directory to run the first method, or 
  56.   from the \SAMPLE07\METHOD2 directory to observe the second method.
  57.  
  58. SOFTWARE/HARDWARE PREREQUISITES:
  59.  
  60.   IBM VisualAge C++
  61.   OS/2 2.1 or Warp
  62.   IBM or compatible 386 and up.
  63.  
  64. ADDITIONAL INFORMATION:
  65.  
  66.   For a complete listing and description of samples provided with the 
  67.   VisualAge C++ for OS/2 product, see the VisualAge C++ for OS/2 Guide to 
  68.   Samples.
  69.  
  70.   To access an online book, simply open the main VisualAge C++ desktop folder,
  71.   then open the Information Folder inside.  To view a book, double-click on 
  72.   that book's icon.  
  73.  
  74.  
  75.  
  76.     FILE NAME(s)   DESCRIPTION
  77.     ------------   ------------
  78.     \IBMCPP\SAMPLES\COMPILER\SAMPLE07 directory:
  79.  
  80.     READ.ME        Description and instructions for the sample.
  81.  
  82.     FILE NAME(s)   DESCRIPTION
  83.     ------------   ------------
  84.  
  85.     \IBMCPP\SAMPLES\COMPILER\SAMPLE07\METHOD1 directory:
  86.  
  87.     RUN.CMD       Command file to run the sample.    
  88.  
  89.     MAIN.EXE      Sample's executable file.
  90.  
  91.     MAIN.CPP      CPP source for main function that calls each area function
  92.  
  93.     BASIC.DEF     Module definition file used to create MAIN07.EXE
  94.  
  95.     VF.CPP        CPP source for the DLL initialization/termination routine
  96.     
  97.     VF.H          Prototypes for the area functions
  98.  
  99.    FILE NAME(s)   DESCRIPTION
  100.     ------------   ------------
  101.  
  102.     \IBMCPP\SAMPLES\COMPILER\SAMPLE07\METHOD2 directory:
  103.  
  104.     RUN.CMD       Command file to run the sample.    
  105.  
  106.     MAIN.EXE      Sample's executable file.
  107.  
  108.     MAIN.CPP      CPP source for main function that calls each area function
  109.  
  110.     BASIC.DEF     Module definition file used to create MAIN07.EXE
  111.  
  112.     STK.C         C source for the DLL initialization/termination routine
  113.     
  114.     STK.H         Prototypes for the area functions
  115.  
  116.     STACK.CPP     CPP source for the DLL initialization/termination routine