IBM VisualAge TeamConnection Dictionary Version 03.00.02
========================================================


Contents
========

This file explains the following:
   1.  New Features
   2.  Getting help
   3.  TeamConnection Requirements, Hints and Tips
   4.  Dictionary functions and restrictions not cited in the books
   5.  Your satisfaction



1.  New Features
================

   Support for TeamConnection Version 3.0.2
   ----------------------------------------
   This is the first version of Dictionary that supports
   TeamConnection Version 3.0.

   Support for Shareable Data Element Hierarchies
   ----------------------------------------------
   New to the Dictionary is the capability to define
   a hierarchy of Shareable Data Elements such that a
   Data Element can have multiple child Data Elements
   that inherit the parent's data type characteristics.


2. Getting Help
===============


   Service and Technical Support
   -----------------------------
   We are ready to help you with your Dictionary questions.

   In countries where Internet forums are available, you can electronically access
   Dictionary technical information, exchange messages with other Dictionary users,
   and receive information about the availability of fixes via our Internet address:

      http://www.software.ibm.com/ad/teamcon




3. TeamConnection Requirements, Hints and Tips
========================================================================
   IBM VisualAge Dictionary requires IBM VisualAge TeamConnection V3.0.2.

   We strongly suggest that you periodically freeze your TeamConnection work areas as you
   are creating and maintaining persistent data.  You can do this via the TeamConnection
   Client.  Also, backup up your TeamConnection databases regularly just as you would back             up any important data.

   For further information, hints and tips regarding the best way to take advantage
   of TeamConnection, please refer to the TeamConnection readme file and the TeamConnection
   Considerations section of the Dictionary user's guide.

   Migrating Dictionary Data from TeamConnection V2x to TeamConnection V3.0.2
   --------------------------------------------------------------------------
   1. Do a TeamConnection (release 2.10) export of the workarea containing
      data to be migrated. For example,
        teamc workarea  -export tc2wa  -file c:\tc2out.cdf  -release tc2rel  -family tc2fam

   2. Run the TeamConnection (release 3) migration tool, modcdf.exe, with the
      Dictionary(release 3) rules file, v3mod.txt.  Use the export cdf file
      from step 1 as the input. This will create a release 3 import cdf file.
      For example,
        modcdf  <dictionary root>:\v3mod.txt c:\tc2out.cdf c:\tc3in.cdf

   3. Set TeamConnection variable TC_SKIPUNKNOWN=1 on the your TeamConnection
      Server machine and bring up the server.

   4. Import the import cdf file created in step (2) above into a workarea
      TeamConnection 3.0.2. For example,
        teamc workarea  -import tc3wa  -file c:\tc3in.cdf  -release tc3rel  -family tc3tfam

   Loading Dictionary Models for the TeamConnection Server
   -------------------------------------------------------
   Before running TeamConnection Dictionary, you must ensure that the Dictionary
   models are initialized on the TeamConnection Server and that the correct set
   of model files are loaded by the Server when it is brought up. The set of
   files required by Dictionary are part of the TeamConnection Server installation.
   They are:  _ewswuip, _ewswsup, _ewswims, _ewswsdd, _ewswhll, _ewswerw, _eze2vgx.

   There are two steps to ensuring the correct models are initialized and loaded:

        1) Update DB2 with the model tables.
           Ensure that there is a .bnd file and a .ddl file for each of the
           TeamConnection Dictionary models in your /nls/cfg directory. There
           should also be some .ddv and .ddt files for a few of the models.
           When you create your TeamConnection family, these files will be used
           along with the rest of the TeamConnection models files to set up
           DB2 properly. If they already exist and your TeamConnection family
           was created with them, you're done. If you did not use these files
           when creating your TeamConnection family, you must run "fhcirtup"
           on each of the _ewsw* files to update DB2 and your family. Please
           refer to the TeamConnection readme file for specifics on this command.

           From /nls/cfg, execute: fhcirtup *.bnd *.ddl *.ddv *.ddt
           where * is the name of each of the 7 required models listed above.

        2) Set the TC_MODELS environment variable to contain the Dictionary
           models prior to bringing up your TeamConnection Server. You will
           see the list of models loaded when you bring up the Server. If you
           do not see the set of 7 models listed above, your TC_MODELS environment
           variable is not set properly.

           Execute the following:
              set TC_MODELS=_ewswuip _ewswsup _ewswims _ewswsdd _ewswhll _ewswerw _eze2vgx
           exactly as shown.

   Loading Dictionary Models for the TeamConnection Builder
   --------------------------------------------------------

   If you make use of the TeamConnection Build facility in order to automatically
   build source files from the objects you create in the Dictionary, there are
   two additional steps you need to go through in order to make sure that the
   TeamConnection build utility can access the Dictionary model objects.

        1) Before you start a TeamConnection builder using the teamcbld command,
           make sure the TC_BUILDMODELS environment variable is set properly:

               set TC_BUILDMODELS=fhmwsdd

           (If you don't do this, you will receive an error message when you
           try to run the build command for an object that has a dictionary
           object as its parent.)

        2) Before you start the TeamConnection client, make sure your TC_CLIENTMODELS
           environment variable is set properly:

               set TC_CLIENTMODELS=ewswsdd

           (If you don't do this, you will receive an error message when you
           try to expand the build tree of a dictionary object in the TeamConnection
           GUI.)

4. Dictionary Functions and Restrictions Not Cited in the Books
===========================================================================


   A) Creating New Sensitive Segments From a New PCB object
   --------------------------------------------------------
   The new PCB object must be saved before attempting to create new Sensitive Segments.
   You may save the PCB by pressing the Save button on the PCB notebook.  This allows the
   Sensitive Segment notebook to list all the available segments.

   B) Performing Original Delete on Shareable Data Element
   -------------------------------------------------------
   When performing a Shareable Data Element Original Delete action and the
   Shareable Data Element has associated Data Element Aliases, more objects
   will appear on the Related Objects list for deletion than you may want
   to have deleted. Please use caution when performing this action so as not
   to delete other Shareable Data Elements that you do not intend to delete.
   Pay close attention to the list of related objects before proceeding with
   your delete action.

   C) Lock/Unlock from Dictionary for Superusers
   ---------------------------------------------
   Although TeamConnection allows users with Superuser authority to unlock
   objects that are locked by other users, this operation is not allowed from
   the Dictionary. If you are a TC superuser and you attempt to unlock an
   object locked by another user, you will receive an error just as if you
   did not have superuser authority.

   D) PCB Glossary Query
   ---------------------
   The PCB Glossary query shipped with Dictionary only returns results for
   GSAM PCBs. The query is mistakenly limited so that it will not show results
   for TP or DB PCBs.

   E) Shareable Data Element Notebook
   ----------------------------------
   An opened Shareable Data Element notebook's inheritance hierarchy may
   not be updated when another Data Element in the hierarchy is updated.
   If an update occurs and it is not seen in other opened notebooks, the
   opened notebooks need to be cancelled and re-opened to see the updates.

   F) Web Queries
   --------------
   Web Queries can be enabled by running the Web Query Wizard on the TeamConnection Server. The steps are
   as follows:
   - On the install CD-ROM, CD to the subdirectory VATCDD
   - Run WEBQRY.EXE which is the Web Query Wizard
   - It will determine whether or not TeamConnection web support exist
   - If web support exist, then it will allow you to proceed with enabling Web Queries
   For information about the Web Query Function, see the Dictionary On-Line Help and search for Web.

5. Your Satisfaction
====================

Your satisfaction with IBM is important to us. If you are not completely
satisfied with this product, please contact us through one of the Service and
Technical support channels listed above.

Tell us what is not meeting your expectations and why you are dissatisfied.
Provide your name, your organization's name, and your telephone number so that
we can contact you.  We will work with you to resolve your concerns.



