home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / buildrun.txt
Encoding:
Text File  |  1996-02-26  |  5.7 KB  |  151 lines
  1. =========================================================================
  2. BUILD AND RUN INSTRUCTIONS FOR THE WorkFrame ENVIRONMENT:
  3.  
  4.    To build the sample, click the "Build normal" button on the project's
  5.    toolbar or from the Project pulldown, select "Build normal"
  6.  
  7.    To execute the sample, click the "Run" button on the project's toolbar.
  8.  
  9.    NOTE:
  10.           Data Access Builder Samples: the above Build and Run methods
  11.           do not apply to these samples.  Please see the README.TXT file
  12.           associated with each of the Data Access Builder samples for
  13.           detailed information on building and running these samples.
  14.  
  15.           SOM Samples:  the above Build and Run methods do not apply to
  16.           these samples.  Please see the README.TXT file associated with
  17.           each of the SOM samples for detailed information on building
  18.           and running these samples.
  19.  
  20.           Visual Builder Samples: the above Build method does apply to
  21.           the Visual Builder samples.  Please see the README.TXT file
  22.           associated with each of the Visual Builder samples for detailed
  23.           information on building these samples.
  24.  
  25.           All Samples: Because all samples are enabled for Performance
  26.           Analyzer, CPPWPA3.DLL must be present to Run a sample
  27.           and CPPWPA3.OBJ must be present to Build a sample without errors.
  28.           These objects are automatically installed if you installed the
  29.           Performance Analyzer component.  Otherwise, copy the CPPWPA3.DLL
  30.           from the \BIN directory and the CPPWPA3.OBJ from the \LIB directory
  31.           of the CD-ROM to the corresponding directories on your system.
  32.  
  33.                        Copying CPPWPA3.DLL and CPPWPA3.OBJ simply allows you
  34.           to invoke Run and Build on the samples without errors.  To actually
  35.           use the Performance Analyzer, or any other component, with a sample
  36.           you must have installed these components.
  37.  
  38. IF YOU DIDN'T CHOOSE THE 'TYPICAL INSTALL' OPTION:
  39.  
  40.   If you chose a CD-ROM install, a MINIMAL install, or a CUSTOM install
  41.   which left the Samples and Documentation component on the source drive,
  42.   the %REPLACEDIR% portion of the samples path in the WorkFrame project
  43.   will not have been updated.
  44.  
  45.   To RUN or BUILD a particular sample under the above install options,
  46.   you must
  47.  
  48.   - copy the files from the source directory on the server or
  49.      CD-ROM to a directory on your hard drive.
  50.  
  51.      It is recommended you create the same subdirectories for the
  52.      samples as they appear on the CD-ROM then copy each set of samples
  53.      files into their respective sub-directory.
  54.  
  55.   - set the path for the sample's WorkFrame project.
  56.  
  57.      From the Guide to Samples notebook, select the sample of interest then
  58.      choose the Open Project View button.  The Project View will open but
  59.      no files will be displayed.  To set the path to the files copied in
  60.      the previous step, choose VIEW -> SETTINGS -> DIRECTORIES.  Substitute
  61.      the correct path segment for the %REPLACEDIR% variable to complete the
  62.      path specification in the 'Source directories for project files'
  63.      listbox. Change the path displayed in the 'Working Directory' list box
  64.      to match that of the Source Directory list box. Finally, select the
  65.      OK button to complete the update.
  66.  
  67.   Your sample project is now locally installed and accessible for building
  68.   and running.
  69.  
  70. ADDITIONAL INFORMATION:
  71.  
  72.    For additional information on a particular VisualAge for C++ sample
  73.    (including how to build and run the sample from the command line),
  74.    please view the readme file for that sample.
  75.  
  76.    From the Guide to Samples notebook
  77.    - Select the Component (choose ALL for a list of all samples)
  78.    - then, select the sample from the sample list
  79.    - finally, select the View Readme button to open the readme file
  80.      for that sample
  81.  
  82.  
  83. RUNNING SAMPLES IN Win32s:
  84.  
  85.    Many of the samples can be built to run in Win32s.  However, since most
  86.    use COUT, and since a text window is not a default in Win32s like it
  87.    is in WindowsNT and Windows95, you won't see the output.  A solution
  88.    to this is:
  89.  
  90.      - Redirect the output of the sample to a file by linking the sample
  91.        with redirect.obj.
  92.  
  93.        icc -b-noe sample.c redirect.obj
  94.  
  95.      - Run the sample from within File Manager, using Run in the File
  96.        menu and redirect output to a file.
  97.  
  98.    Redirect.obj is shipped with VisualAge for C++ for Windows in the
  99.    LIB directory.  The code inside of redirect.obj is skipped when NOT
  100.    executing in a Win32s environment, so one binary for all Windows
  101.    platforms is sufficient.
  102.  
  103.    Profiler support is not available on Win32s, so either do not build
  104.    samples using -Gh option, or make cppwpa3.dll available on your
  105.    Win32s machine.
  106.  
  107.    There are some restrictions.  The file handles are not inherited by
  108.    child processes.  Redirect.obj does not work with the subsystem library.
  109.  
  110.    Under Win32s, there are further restrictions if you are creating shared
  111.    DLLs or your own custom DLL initterm function.  See the Programming
  112.    Guide for more information.
  113.  
  114. SAMPLES WHICH CANNOT BE BUILT TO RUN IN WIN32S
  115.  
  116. The following are the samples which are shipped with VisualAge for C++ for
  117. Windows which cannot be built to run with Win32s.
  118.  
  119. Compiler
  120. --------
  121. MultiThread Hello World (Sample02)
  122. Thread Local Storage (TLS)
  123. Direct-To-SOM (DTS)
  124. Subsystem DLL (Sample05)
  125.  
  126. Database
  127. --------
  128. SOM Stock (StockSOM)
  129.  
  130. Editor
  131. ------
  132. LPEX (LXMIN2)
  133.  
  134. Visual Builder
  135. --------------
  136. All Samples
  137.  
  138. SOM
  139. ---
  140. All Samples
  141.  
  142. IOC
  143. ---
  144. Basic Server (ACDF1)
  145. Advanced Server (ACDF2)
  146. Basic Container (ACDF3)
  147. Advanced Container (ACDF4)
  148. Collection Streaming (ACDF5)
  149. Compound Document Hello5 (ACDF6)
  150.  
  151.