home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / IOC / TRANSTAB / TRANSTAB.REA < prev    next >
Text File  |  1995-06-07  |  4KB  |  111 lines
  1. SAMPLE - Code Translation
  2.  
  3.    DESCRIPTION:
  4.         This program allows EBCDIC to ASCII and ASCII to EBCDIC
  5.         translation of a string. It uses two maps, one with the EBCDIC
  6.         code as key (E2AMap) and one with the ASCII code as key (A2EMap).
  7.         It converts from EBCDIC to ASCII by finding the element whose key
  8.         matches the EBCDIC code in E2AMap (which has the EBCDIC code as
  9.         key) and taking the ASCII code information from that element. It
  10.         converts from ASCII to EBCDIC by finding the key that matches the
  11.         ASCII code in A2EMap (which has the ASCII code as key) and taking
  12.         the EBCDIC code information for that element.
  13.  
  14.    TASK:
  15.         This program uses maps to translate strings from EBCDIC to ASCII
  16.         and from ASCCII to EBCDIC.
  17.  
  18.    CONCEPT/FEATURE:
  19.         This program is a sample to demonstrate the use of the default
  20.         class IMap in connection with element operation classes.
  21.  
  22.    PROJECT LOCATION:
  23.         Inside the IOC Samples folder (inside the VisualAge C++ Samples
  24.         folder). 
  25.  
  26.    SOURCE FILE LOCATION:
  27.         X:\ibmcpp\samples\ioc\transtab
  28.  
  29.         where X: is the drive you installed the samples and document
  30.         component of VisualAge C++.
  31.  
  32.    HOW TO RUN THE SAMPLE:
  33.  
  34.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  35.              To run the prebuilt project, open the Samples folder on your
  36.              OS/2 desktop then double-click on the project's icon to open
  37.              the project view of the sample.  Click on the RUN button of
  38.              the project's toolbar.
  39.  
  40.         FROM THE COMMAND LINE:
  41.              Simply type the name of the .EXE file, that is:
  42.  
  43.                  TRANSTAB
  44.  
  45.              If the sample fails to execute or abnormally ends, you can
  46.              get more information about the failure by turning on the
  47.              ICLUI trace.  This is done by setting the environment
  48.              variable ICLUI_TRACE as follows:
  49.  
  50.                    SET ICLUI_TRACE=ON
  51.                    SET ICLUI_TRACETO=STDERR
  52.  
  53.              The second export controls where the trace information is
  54.              reported.  With tracing turned on, ICLUI exception text will
  55.              be written to a standard error file. For example:
  56.  
  57.                    HELLO1 >HELLO1.OUT 2>&1
  58.  
  59.              The exception data is now in the file hello1.out.
  60.  
  61.    HOW TO BUILD THE SAMPLE PROJECT YOURSELF:
  62.  
  63.         FROM WITHIN THE WORKFRAME ENVIRONMENT:
  64.              Open the Samples folder on your OS/2 desktop then
  65.              double-click on the project's icon to open the project view
  66.              of the sample. In the upper half of the project window you
  67.              will see the icons of the files associated with the sample.
  68.              From the Project pulldown, select Build -> Rebuild All. To run
  69.              the sample project, see HOW TO RUN THE SAMPLE PROJECT above.
  70.  
  71.         FROM THE COMMAND LINE:
  72.              A command file is provided to allow rebuilding of the
  73.              WorkFrame projects from the command line.  Simply type:
  74.  
  75.                  BUILD
  76.  
  77.              To run the sample project, see HOW TO RUN THE SAMPLE PROJECT
  78.              above.
  79.  
  80.    SOFTWARE/HARDWARE PREREQUISITES:
  81.  
  82.         o   IBM VisualAge C++
  83.         o   OS/2 2.1 or Warp
  84.         o   IBM or compatible 386 and up.
  85.  
  86.    ADDITIONAL INFORMATION:
  87.  
  88.         o   For more information on the creation and use of projects in
  89.             the WorkFrame environment, see the VisualAge C++ for OS/2
  90.             User's Guide.
  91.         o   For more information on the Collection Classes, see the
  92.             VisualAge C++ for OS/2 Open Class Library User's Guide.
  93.  
  94.         Both books can be found online.  To access an online book, simply
  95.         open the main VisualAge C++ desktop folder, then open the
  96.         Information Folder inside.  To view a book, double-click on that
  97.         book's icon.
  98.  
  99.  
  100.    REQUIRED FILES - CODE TRANSLATION:
  101.  
  102.    o   transtab.rea   
  103.    o   build.cmd
  104.    o   transtab.cpp
  105.    o   transtab.xpc
  106.    o   trmapops.h
  107.    o   xebc2asc.h
  108.    o   transelm.h
  109.    o   transtab.exe
  110.  
  111.