home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / DSKUSAGE / DSKUSAGE.REA < prev    next >
Text File  |  1995-06-07  |  5KB  |  118 lines
  1. PROJECT - Disk Usage
  2.  
  3.    DESCRIPTION:
  4.         This program uses a sorted map and a sorted relation to display
  5.         sorted lists of the name and size of files contained on a disk.
  6.         It uses the default classes, ISortedMap and ISotredRelation, to
  7.         implement the collections. The program uses the sorted map to
  8.         store the name of the file because all elements in a sorted map
  9.         are unique and all names on a disk are unique. It uses a sorted
  10.         relation for the file size because there may be identical file
  11.         sizes and identical values are permissible in sorted relations.
  12.  
  13.    TASK:
  14.         This program uses a sorted map and a sorted relation to display
  15.         sorted lists of the name and size of files contained on a disk.
  16.  
  17.    CONCEPT/FEATURE:
  18.         This program is a sample to demonstrate the use of the default
  19.         classes ISortedMap and ISortedRelation.
  20.  
  21.    PROJECT LOCATION:
  22.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  23.         folder). 
  24.  
  25.    SOURCE FILE LOCATION:
  26.         X:\ibmcpp\samples\ioc\dskusage
  27.  
  28.         where X: is the drive you installed the samples and document
  29.         component of VisualAge C++.
  30.  
  31.    HOW TO RUN THE SAMPLE:
  32.  
  33.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  34.              To run the prebuilt project, open the Samples folder on your
  35.              OS/2 desktop then double-click on the project's icon to open
  36.              the project view of the sample.  Click on the RUN button of
  37.              the project's toolbar.
  38.  
  39.         FROM THE COMMAND LINE:
  40.              Simply type the name of the .EXE file, that is:
  41.  
  42.                  DSKUSAGE
  43.  
  44.              If the sample fails to execute or abnormally ends, you can
  45.              get more information about the failure by turning on the
  46.              ICLUI trace.  This is done by setting the environment
  47.              variable ICLUI_TRACE as follows:
  48.  
  49.                    SET ICLUI_TRACE=ON
  50.                    SET ICLUI_TRACETO=STDERR
  51.  
  52.              The second export controls where the trace information is
  53.              reported.  With tracing turned on, ICLUI exception text will
  54.              be written to a standard error file. For example:
  55.  
  56.                    HELLO1 >HELLO1.OUT 2>&1
  57.  
  58.              The exception data is now in the file hello1.out.
  59.  
  60.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  61.  
  62.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  63.              Open the Samples folder on your OS/2 desktop then
  64.              double-click on the project's icon to open the project view
  65.              of the sample. In the upper half of the project window you
  66.              will see the icons of the files associated with the sample.
  67.              From the Project pulldown, select Build -> Rebuild All. To run
  68.              the sample project, see How to run the sample project above.
  69.  
  70.         FROM THE COMMAND LINE:
  71.            - A command file is provided to allow rebuilding of the
  72.              WorkFrame projects from the command line.  Simply type:
  73.  
  74.                  BUILD
  75.  
  76.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT
  77.              above.
  78.  
  79.            - The sample application can also be built by entering:
  80.                  NMAKE
  81.              with no options while in the directory containing the
  82.              sample application files.  The makefile is named
  83.                  Makefile
  84.              To clean up the files generated from running make, enter:
  85.                  NMAKE CLEAN 
  86.              while in the directory containing the sample program files.
  87.  
  88.    SOFTWARE/HARDWARE PREREQUISITES:
  89.  
  90.         o   IBM VisualAge C++
  91.         o   OS/2 2.1 or Warp
  92.         o   IBM or compatible 386 and up.
  93.  
  94.    ADDITIONAL INFORMATION:
  95.  
  96.         o   For more information on the creation and use of projects in
  97.             the WorkFrame environment, see the VisualAge C++ for OS/2
  98.             User's Guide.
  99.         o   For more information on the Collection Classes, see the
  100.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  101.  
  102.         Both books can be found online.  To access an online book, simply
  103.         open the main VisualAge C++ desktop folder, then open the
  104.         Information Folder inside.  To view a book, double-click on that
  105.         book's icon.
  106.  
  107.  
  108. SOURCE FILES - Disk Usage
  109.  
  110.    Required files:
  111.    o   dskusage.rea
  112.    o   build.cmd
  113.    o   dskusage.exe
  114.    o   dskusage.cpp
  115.    o   dskusage.xpc
  116.    o   dsu.dat
  117.    o   dsur.h
  118.