home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / COMPILER / SAMPLE05 / READ.ME < prev    next >
Text File  |  1995-06-08  |  5KB  |  141 lines
  1. SAMPLE -SAMPLE05 Process Registration Subsystem DLL
  2.  
  3. DESCRIPTION:
  4.      The DLL keeps a global count of the number of processes that
  5.      access it, running totals for each process that accesses the
  6.      subsystem, and a grand total for all processes.  There are two
  7.      external entry points for programs accessing the subsystem.  The
  8.      first is "DLLINCREMENT", which increments both the grand total
  9.      and the total for the calling process by the amount passed in.
  10.      The second entry point is "DLLSTATS", which prints out statistics
  11.      kept by the subsystem, including the grand total and the total
  12.      for the current process.
  13.  
  14.      The grand total and the total for the process are stored in a
  15.      single shared data segment of the subsystem.  Each process total
  16.      is stored in its own data segment.
  17.  
  18. TASK:
  19.      Creating a simple subsystem DLL.
  20.  
  21. FEATURE/CONCEPT:
  22.      Example of a subsystem _DLL_InitTerm function.
  23.  
  24. PROJECT LOCATION:
  25.      Inside the COMPILER Sample folder (inside the VisualAge C++ 
  26.      SAMPLES folder).
  27.  
  28. SOURCE FILE LOCATION:
  29.      X:\ibmcpp\samples\compiler\sample05
  30.  
  31.      where X: is the drive you installed the samples and document
  32.      component of VisualAge C++.
  33.  
  34.  
  35.  
  36. HOW TO RUN THE SAMPLE:
  37.  
  38.    FROM WITHIN THE WORKFRAME ENVIRONMENT:
  39.         Open the Samples folder on your OS/2 desktop then double-click on
  40.         the project's icon to open the project view of the sample.  Click
  41.         on the RUN button of the project's toolbar.
  42.  
  43.         NOTE:  The DLL that is created in the dll directory is moved into
  44.         the sample05 directory. Set sample05 as the current directory to
  45.         run MAIN05.EXE. In order for the system to find the SAMPLE05.DLL,
  46.         the LIBPATH setting in CONFIG.S YS must include the current
  47.         directory (i.e., ".;" must be specified).
  48.  
  49.    FROM THE COMMAND LINE:
  50.         Simple type the name of the .exe file, that is:
  51.  
  52.             MAIN05
  53.  
  54.  
  55. HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  56.  
  57.    FROM WITHIN THE WORKFRAME ENVIRONMENT:
  58.         Open the Samples folder on your OS/2 desktop then double-click on
  59.         the project's icon to open the project view of the sample. You
  60.         will see the icons of the files associated with the sample.
  61.         Delete the prebuilt .EXE file.  Now double-click on the BUILD
  62.         button of the project's toolbar.  An .EXE object will be created
  63.         and shown in the listing of file objects.  To run the sample
  64.         project, see How to run the sample project above.
  65.  
  66.    FROM THE COMMAND LINE:
  67.         A command file is provided to allow rebuilding of the WorkFrame
  68.         projects from the command line.  Simply type:
  69.  
  70.             BUILD
  71.  
  72.         To run the sample project, see HOW TO RUN THE SAMPLE
  73.         project above.
  74.  
  75. SOFTWARE/HARDWARE PREREQUISTES:
  76.  
  77.      o   IBM VisualAge C++
  78.      o   OS/2 2.1 or Warp
  79.      o   IBM or compatible 386 and up.
  80.  
  81. ADDITIONAL INFORMATION:
  82.  
  83.      o   For more information on the creation and use of projects in
  84.          the WorkFrame environment, see the VisualAge C++ for OS/2
  85.          User's Guide.
  86.      o   For a complete listing and description of samples provided
  87.          with the VisualAge C++ for OS/2 product, see the VisualAge
  88.          C++ for OS/2 Guide to Samples.
  89.  
  90.      Both books can be found online.  Open the main VisualAge C++
  91.      desktop folder, then open the Information Folder inside.  To any
  92.      of the books shown, simple double-click on that book's icon.
  93.  
  94.  
  95. SOURCE FILES - Process Registration Subsystem DLL
  96.  
  97.    Required files:
  98.  
  99.    README
  100.         Description and instructions for the sample.
  101.  
  102.    BUILD.CMD
  103.         Command to invoke the WorkFrame build action to make the project
  104.         parts.
  105.  
  106.    SAMPLE05.EXE
  107.         Sample's executable file.
  108.  
  109.    MAIN05.C
  110.         C source for main function that calls each entry point in the
  111.         DLL, depending upon user input in response to a prompt that is
  112.         issued.
  113.  
  114.    MAIN05.DEF
  115.         Module definition file used to create MAIN05.EXE
  116.  
  117.    SAMPLE05.H
  118.         Prototypes for the "increment" and "stats" entry points
  119.  
  120.    CLEANUP.CMD
  121.         Erases the files that were created by the BUILD.CMD
  122.  
  123.    Additional files in the "dll" subdirectory:
  124.  
  125.    SAMPLE05.C
  126.         C source for the DLL initialization/termination routine and for
  127.         the "increment" and "stats" functions. Also, there are internal
  128.         functions for registering and de-registering each process that
  129.         uses the SAMPLE05.DLL.
  130.  
  131.    SAMPLE05.H
  132.         Prototypes for the "increment" and "stats" entry points
  133.  
  134.    SAMPLE05.DEF
  135.         Module definition file used to create SAMPLE05.DLL
  136.  
  137.  
  138.  
  139.  
  140.  
  141.