home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / PUSHPOP / PUSHPOP.REA < prev    next >
Text File  |  1995-06-07  |  4KB  |  103 lines
  1. SAMPLE - Word Stack (pushpop)
  2.  
  3.    DESCRIPTION:
  4.         This program creates two stacks (Stack1 and Stack2) using the
  5.         default class, IStack. It adds a number of words to Stack1,
  6.         removes them from Stack1, adds them to Stack2, and finally
  7.         removes them from Stack2 so that they can be printed. The push()
  8.         and pop() functions are used for adding and removing elements.
  9.  
  10.    TASK:
  11.         This program uses stacks to push and pop elements.
  12.  
  13.    CONCEPT/FEATURE:
  14.         This program is a sample to demonstrate the use of the default
  15.         class IStack.
  16.  
  17.    PROJECT LOCATION:
  18.         Inside the IOC Samples folder (inside the VisualAge C++ Samples    
  19.         folder). 
  20.  
  21.    SOURCE FILE LOCATION:
  22.         X:\ibmcpp\samples\ioc\pushpop
  23.  
  24.         where X: is the drive you installed the samples and document
  25.         component of VisualAge C++.
  26.  
  27.    HOW TO RUN THE SAMPLE:
  28.  
  29.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  30.              To run the prebuilt project, open the Samples folder on your
  31.              OS/2 desktop then double-click on the project's icon to open
  32.              the project view of the sample.  Click on the RUN button of
  33.              the project's toolbar.
  34.  
  35.         FROM THE COMMAND LINE:
  36.              Simply type the name of the .EXE file, that is:
  37.  
  38.                  PUSHPOP
  39.  
  40.              If the sample fails to execute or abnormally ends, you can
  41.              get more information about the failure by turning on the
  42.              ICLUI trace.  This is done by setting the environment
  43.              variable ICLUI_TRACE as follows:
  44.  
  45.                    SET ICLUI_TRACE=ON
  46.                    SET ICLUI_TRACETO=STDERR
  47.  
  48.              The second export controls where the trace information is
  49.              reported.  With tracing turned on, ICLUI exception text will
  50.              be written to a standard error file. For example:
  51.  
  52.                    HELLO1 >HELLO1.OUT 2>&1
  53.  
  54.              The exception data is now in the file hello1.out.
  55.  
  56.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  57.  
  58.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  59.              Open the Samples folder on your OS/2 desktop then
  60.              double-click on the project's icon to open the project view
  61.              of the sample. In the upper half of the project window you
  62.              will see the icons of the files associated with the sample.
  63.              From the Project pulldown, select Build -> Rebuild All. To run
  64.              the sample 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
  68.              WorkFrame projects from the command line.  Simply type:
  69.  
  70.                  BUILD
  71.  
  72.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT
  73.              above.
  74.  
  75.    SOFTWARE/HARDWARE PREREQUISITES:
  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 more information on the Collection Classes, see the
  87.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  88.  
  89.         Both books can be found online.  To access an online book, simply
  90.         open the main VisualAge C++ desktop folder, then open the
  91.         Information Folder inside.  To view a book, double-click on that
  92.         book's icon.
  93.  
  94.  
  95.  
  96.    REQUIRED FILES - WORD STACK:
  97.  
  98.    o   pushpop.rea
  99.    o   build.cmd
  100.    o   pushpop.cpp
  101.    o   pushpop.xpc
  102.    o   pushpop.exe
  103.