home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / vismalta.zip / README.TXT < prev    next >
Text File  |  1994-02-28  |  7KB  |  194 lines
  1. VisualAge* - README
  2. __________________________________
  3.  
  4.    Welcome to VisualAge*.
  5.  
  6.    This readme contains helpful hints found in our
  7.    testing as well as updated information that did
  8.    not make our printed publications.  It is divided
  9.    into the following categories:
  10.  
  11.    o  Install tips
  12.    o  Known problems
  13.         - FAT internal filename problem and fix 
  14.    o  Packaging Applications
  15.    o  Files required for VisualAge at runtime
  16.    o  Files required for specific VisualAge features at runtime
  17.    o  IBM Database Hints & Tips
  18.    o  Trademarks and Service Marks
  19.  
  20.  
  21. IMPORTANT ADDITIONAL DOCUMENTATION
  22. --------------------------------------------------------------------
  23.  
  24.   The complete VisualAge API is documented in the file "VisualAg.API".
  25.   This document explains which VisualAge classes and methods you may safely 
  26.   reuse when programming using VisualAge's embedded Smalltalk language.
  27.   You should read at least the introductory paragraphs of this file before 
  28.   embarking on any significant Smalltalk programming with VisualAge.
  29.  
  30. INSTALL TIPS
  31. ___________
  32.  
  33.    o  If you have VisualAge or VisualAge Team beta code installed,
  34.       and now plan to install Version 1.0, please do the following:
  35.  
  36.             - from the directory in which you installed VisualAge,
  37.               change all Install Package files to read/write.
  38.  
  39.                            ex. attrib *.pkg -r
  40.  
  41.             - run the Install program and select delete/reinstall
  42.  
  43.       *Note that this applies to VisualAge beta code installed from
  44.        CD ROM only.
  45.  
  46.     o When installing the Communications and Multimedia Features
  47.       for VisualAge Team, you will be asked whether to replace
  48.       the document files abtcme10.inf and mtuge10.inf respectively.  
  49.       Answer "yes".  During the VisualAge Team install, placeholders
  50.       for these books are installed.
  51.  
  52.  
  53. KNOWN PROBLEMS
  54. ______________
  55.  
  56.    o  There is a problem with the file naming algorithm used for the VisualAge
  57.        *.cch files on FAT file systems.  The fix for this problem is contained in
  58.        fixp3053.st.  This file is located on VisualAge - Disk 16, and in the fixes
  59.        subdirectory on both VisualAge and VisualAge Team CD ROMs.
  60.        
  61.        To install this fix do the following:
  62.           1. Open a workspace on the file using the File->Open menu on the Transcript.
  63.           2. Highlight ALL of the text in the file.  (Ctrl-a will do this.)
  64.           3. Use the Edit->FileIn menu item (on the workspace menubar)
  65.               to file in the code.
  66.           4. Close the workspace.
  67.           5. Save your image.
  68.           6. [Team only] Other users can now load this change directly into their image.
  69.              They can use the application manager to load AbtEditPackagesApp V1.0.0-P3053 .
  70.  
  71.    o  Creating a "Deferred Update Part" of a "Deferred Update Part"  will cause a
  72.        stack overflow.
  73.  
  74.    o  Packaging of SubApplications is not supported
  75.  
  76.    o  Parameter constants defined for Event-To-Script-Connections are not
  77.        generated with the archival code.
  78.  
  79.    o  If you have added views as components of your nonvisual parts,
  80.         you must add CwConstants to the pool dictionary list of AbtAppBldrPart
  81.                 to generate the code for the part without compile errors.
  82.  
  83.    o  The NoteBookPage attribute 'pageWidget' has known bugs and
  84.        may be removed in a future release.  It's use is not recommended.
  85.  
  86.    o  Do not use the Symbol converter.
  87.  
  88.    o  The product numbers as displayed in the Product Information
  89.       Window are not correct.  Please refer to your Installation
  90.       Guide for correct numbers.
  91.  
  92. PACKAGING APPLICATIONS
  93. ______________________
  94.  
  95.   In our description of what files are needed to create
  96.   your runtime image, we failed to discuss bitmaps and
  97.   icons you may have used.
  98.  
  99.   Parts that can use icons and bitmaps include labels,
  100.   push buttons, toggle buttons, and icon gadgets.
  101.  
  102.   If you specified a module name when using any of
  103.   the above parts, you will need to ship that module as
  104.   part of your run-time application.
  105.  
  106.   For example, if you used the module name 'AbtBmp10'
  107.   for an icon gadget, you will need to include the file
  108.   abtbmp10.dll with your application.
  109.  
  110.   Tips (for packaging)
  111.  
  112.      o You can experiment with icons and still avoid
  113.         shipping an 'extra' dll.  To do this, leave the module
  114.         name blank and use an ID of 1 when choosing icon graphics.
  115.        The icon used will come from the run-time executable file.
  116.  
  117.         o  The user's guide suggests RENAMING the file Abtrti10 to image.
  118.         You will save yourself some time if you COPY Abtrti10 to image.
  119.  
  120.         If you copy instead of rename, you will always have an untouched
  121.         version of Abtrti10 in your merge directory.  Remember that every
  122.         time you package an application you must have a file named 'image'
  123.         which is an exact copy of Abtrti10.
  124.  
  125.  
  126. FILES REQUIRED FOR VISUALAGE AT RUN TIME
  127. _________________________________________________________
  128.  
  129.    o The two files CURSORS.OBJ and RGB.TXT are not required at
  130.       runtime as specified in the Users Guide.
  131.  
  132. FILES REQUIRED FOR SPECIFIC VISUALAGE FEATURES AT RUN TIME
  133. _________________________________________________________
  134.  
  135.    o  The following clarifies the location of the files listed
  136.        in section "Runtime system setup" of "Packaging Your
  137.        VisualAge Application" within the Users Guide:
  138.  
  139.        o All files ending with the extension of VKG or MRI are
  140.           located within the subdirectory named ABT beneath the
  141.           main VisualAge install directory.
  142.  
  143.        o The VisualAge run time image file named ABTRTI10 is
  144.           located within the subdirectory named ABT beneath the
  145.           main VisualAge install directory.
  146.  
  147.    o  The following files are added to the list of files required
  148.        for specific VisualAge features at run time:
  149.  
  150.        o  ABTIDS10.VKG - Required for the VisualAge IBM* Database
  151.            sample applications.
  152.  
  153.        o  ABTMMS10.VKG - Required for the VisualAge MMPM/2*
  154.            sample applications.
  155.  
  156.  
  157. IBM DATABASE HINTS & TIPS
  158. __________________________
  159.  
  160.   o Remember that before you access any IBM Database (unless that
  161.     database was created using VisualAge), you must bind the VisualAge
  162.     package to it. This only needs to be done once for each database
  163.     (SQL Error 805 is returned if you try to access an un-bound database.)
  164.     To bind a database named TestDatabase:
  165.  
  166.       - if you are running DB2/2, from an OS/2 window
  167.         type sqlbind ABTD3200.BND TestDatabase
  168.       - if you are running Extended Services Database Manager, from
  169.          an OS/2 window type sqlbind ABTD1600.BND TestDatabase
  170.  
  171.  
  172. TRADEMARKS AND SERVICE MARKS
  173. ____________________________
  174.  
  175.  
  176.    o Terms denoted by a single asterisk in this file
  177.       (*) are trademarks of the IBM Corporation in the
  178.       United States and/or other countries.  These terms
  179.       include:
  180.  
  181.       o  IBM
  182.       o  MMPM/2
  183.       o  VisualAge
  184.  
  185.  
  186.     IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED OR
  187.     IMPLIED, INCLUDING WITHOUT LIMITATION, WARRANTIES
  188.     OF FITNESS AND MERCHANTABILITY WITH RESPECT TO THE
  189.     INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS
  190.     DOCUMENT, IBM GRANTS NO LICENSES TO ANY RELATED
  191.     PATENTS OR COPYRIGHTS.
  192.  
  193.     Copyright IBM Corporation, 1994, all rights reserved.
  194.