home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / datatl25.zip / README.DA < prev    next >
Text File  |  1997-09-16  |  17KB  |  374 lines
  1. IBM VisualAge DataAtlas Multiplatform Version 2.5
  2. =================================================
  3.  
  4.  
  5. Contents
  6. ========
  7.  
  8. This file explains the following:
  9.  
  10.    1.  Getting help
  11.    2.  Installing DataAtlas
  12.    3.  Migrating from TeamConnection V1 to TeamConnection V2
  13.    4.  TeamConnection Hints and Tips
  14.    5.  Modeler Version 2.5 functions and restrictions not cited in the books
  15.    6.  Dictionary Version 2.5 functions and restrictions not cited in the books
  16.    7.  Your satisfaction
  17.  
  18.  
  19. 1. Getting Help
  20. ===============
  21.  
  22.    General
  23.    -------
  24.    After reading this file, we recommend that you:
  25.  
  26.       1. Browse the DataAtlas CD-ROM's Electronic Showcase for product information and installation
  27.          instructions.
  28.  
  29.       2. Use the online tutorial to learn how to use DataAtlas Dictionary and
  30.          Designer quickly.
  31.  
  32.       3. Refer to the DataAtlas user's guides as needed.
  33.  
  34.  
  35.    User's Guides
  36.    -------------
  37.    DataAtlas Dictionary and Designer (SC26-9134) and DataAtlas Modeler (SC26-9041)
  38.    have hardcopy user's guides with the order numbers shown.  The user's guides are
  39.    also available in three other formats:  Library Reader file, Adobe Acrobat file,
  40.    and PostScript file.
  41.  
  42.    An order card inside the product box tells how to get a free copy of each of the
  43.    hardcopy publications.
  44.  
  45.    The Library Reader, Adobe Acrobat, and PostScript files are on the CD-ROM in the
  46.    \BOOKS directory.  The file names are:
  47.  
  48.       EWSDD250.BOO    Dictionary and Designer User's Guide     (Library Reader)
  49.       EWSDD250.PS     Dictionary and Designer User's Guide     (PostScript)
  50.       EWSDD250.PDF    Dictionary and Designer User's Guide     (Acrobat)
  51.       CDMU7250.BOO    Modeler User's Guide                     (Library Reader)
  52.       CDMU7250.PS     Modeler User's Guide                     (PostScript)
  53.       CDMU7250.PDF    Modeler User's Guide                     (Acrobat)
  54.  
  55.    If you choose to install the DataAtlas documentation, the Library Reader and
  56.    Acrobat files will be installed in the \HELP subdirectory.
  57.  
  58.    You can view Acrobat files with an Adobe Acrobat reader.  You can install the reader
  59.    from the DataAtlas CD-ROM, or you can download it free of charge from the
  60.    Adobe Web site:  http://www.adobe.com/.
  61.  
  62.  
  63.  
  64.    Service and Technical Support
  65.    -----------------------------
  66.    We are ready to help you with your DataAtlas questions.
  67.  
  68.    In countries where Internet forums are available, you can electronically access
  69.    DataAtlas technical information, exchange messages with other DataAtlas users,
  70.    and receive information about the availability of fixes via our Internet address:
  71.  
  72.       http://www.software.ibm.com/ad/datatlas
  73.  
  74.  
  75.  
  76. 2. Installing DataAtlas
  77. =======================
  78.  
  79.    Detailed installation instructions are located in the Installation topic of the
  80.    VisualAge DataAtlas V2.5 CD-ROM, found in the Electronic Showcase folder.
  81.  
  82.    Shell Extension Conflict
  83.    ----------------------
  84.    This conflict only occurs on Windows NT 4.0 when
  85.    additional Winlogon extensions are installed.  The
  86.    install detects this condition and issues a message.
  87.    The install then exits.
  88.  
  89.    The only known product with this conflict to date is
  90.    IBM AntiVirus V2.5.2 for NT. In order to install DataAtlas,
  91.    you should choose one of the following solutions (option 'a'
  92.    is HIGHLY recommended since you can encounter this problem
  93.    with other install programs):
  94.  
  95.         a)  Install the V3 level of IBM AntiVirus.  This fixes
  96.             the conflict by avoiding the bug.
  97.  
  98.         b)  Uninstall IBM AntiVirus V2.5.2.  Install DataAtlas, and
  99.             then re-install IBM AntiVirus.
  100.  
  101.         c)  NOTE: This alternative is dangerous and may render NT unusable.
  102.  
  103.             Using the Windows NT Registry Editor, find the key:
  104.             'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogin'.
  105.             The variable name "Shell" under this key will have a value of
  106.             "Explorer.exe,xxxxx" where  xxxxx is the problem string.
  107.             - remove the comma and the string xxxxxx
  108.               NOTE: write this string down exactly and save.
  109.             - install DataAtlas
  110.             - replace the comma and the string in the registry being
  111.               careful to type it back in accurately!
  112.  
  113.    If the conflicting Winlogon shell extension is not
  114.    IBM AntiVirus, the error message includes the name
  115.    of the program.  You can bypass this conflict by following
  116.    options 'b' or 'c' above.
  117.  
  118. 3. Migrating from TeamConnection V1 to TeamConnection V2
  119. ========================================================
  120.  
  121.    If you want to access the data that you created using TeamConnection
  122.    DataAtlas V1, you must migrate your data from TeamConnection V1 to
  123.    TeamConnection V2.  For more information, see "Migrating your TeamConnection
  124.    V1 Database" under the Installation topic in the Electronic Showcase folder.
  125.  
  126.  
  127. 4. TeamConnection Hints and Tips
  128. ========================================================================
  129.  
  130.    We strongly suggest that you periodically freeze your TeamConnection work areas as you
  131.    are creating and maintaining persistent data.  You can do this via the TeamConnection
  132.    client (teamcgui).  Also, backup up your TeamConnection databases regularly just as
  133.    you would back up any important data.
  134.  
  135.    For further information, hints and tips regarding the best way to take advantage
  136.    of TeamConnection, please refer to the TeamConnection readme file and the TeamConnection
  137.    Considerations section of the DataAtlas user's guide.
  138.  
  139.  
  140. 5. Modeler Version 2.5 Functions and Restrictions Not Cited in the Books
  141. ========================================================================
  142.  
  143.    General
  144.    -------
  145.    After reading this file, you should:
  146.  
  147.      1.  Read the Installation topic of the VisualAge DataAtlas V2.5 CD-ROM, found
  148.          in the Electronic Showcase folder.
  149.  
  150.      2.  Refer to the DataAtlas Modeler user's guide as needed.
  151.  
  152.    TeamConnection Work Area and Component Names
  153.    --------------------------------------------
  154.    The names of the TeamConnection work areas and components that you use in DataAtlas Modeler
  155.    cannot begin with a slash (/).
  156.  
  157.    VGA Considerations
  158.    ------------------
  159.    The default window settings for DataAtlas Modeler are not suitable
  160.    with VGA screens.  To change the settings for VGA, do one of the following:
  161.  
  162.      - Change all window settings manually:
  163.        * Open each window, resize and move it as required
  164.        * To save the settings, select the layout menu choice from the
  165.          object pulldown menu (the one at far left)
  166.        * Select 'Apply' for this session and 'Save' for default
  167.  
  168.      - Use the default settings prepared for VGA screens.
  169.        * Change to the datatlas\lang\en_US directory
  170.        * copy cdmpar.ini to cdmpar.bak to save the standard settings
  171.        * copy cdmparvg.ini to cdmpar.ini to activate the VGA settings
  172.  
  173.      When you open a data model all windows and dialogs should fit on VGA screens.
  174.  
  175.    Diagram View Restrictions (OS/2 Only)
  176.    -------------------------------------
  177.    If you try to create a relationship between entities in different entity groups,
  178.    the system hangs on some machines and must be rebooted.  This is a problem
  179.    with some display device drivers.  Contact your hardware supplier to get the
  180.    latest driver version for your video card, or download the latest version from:
  181.    http://www.pc.ibm.com.
  182.  
  183.    For example, for IBM PC750 Models P133 with S3 Trio 64V+ Chipset 86C76,
  184.    the pre-installed driver version 1.5B17 causes the error situation.  Version
  185.    2.81.05 is available via the Internet and this works correctly.
  186.  
  187.  
  188.    Reverse Transformation Restriction
  189.    ----------------------------------
  190.    During a reverse transformation, you cannot continue modeling on the
  191.    same client machine.  If you do, you get the following error message:
  192.    "CDMtre4101I: Unexpected telegram received."  However, you can continue
  193.    modeling on a different machine.
  194.  
  195.  
  196.    Transform a Data Model from or into a CASE Model
  197.    -----------------------------------------------
  198.    After you transform a data model into a CASE model, you should unload
  199.    the data model.  To unload a model, make sure you are the only person
  200.    who currently has the model loaded; then close the tree.
  201.  
  202.    After you transform a CASE model into a data model, open a diagram view
  203.    of each entity group in the data model.  Afterward, you should unload and
  204.    save the data model.
  205.  
  206.  
  207.    Computer Seems to Stall during Document Generation
  208.    --------------------------------------------------
  209.    When generating a document, DataAtlas Modeler displays a progress indicator.
  210.    Sometimes the progress indicator seems to stall at 50%, but in fact it is
  211.    waiting for a program call to complete.  Do not assume the hardware is
  212.    stalled.  Reboot only if both (1) the progress indicator seems to be stuck
  213.    at 50%, and (2) there is no disk I/O activity; that is, the disk I/O light
  214.    on your computer is not blinking.
  215.  
  216.    Hints and Tips
  217.    --------------
  218.    This section lists some DataAtlas Modeler error messages with hints on
  219.    how to solve the problem.
  220.  
  221.    Note:  On the server and in a single machine installation the DataAtlas
  222.    Modeler Control Server displays messages in an 'Info' window.
  223.  
  224.    CDMcsr2014E: Error on binding name 'hostname.portnumber'.  Port is in use.
  225.      Try again later or specify another port in the local '\etc\services' file.
  226.  
  227.      This error can occur if you shutdown a DataAtlas Modeler Control Server
  228.      and immediately restart the server again. The TCP/IP port used to
  229.      communicate between clients and server is not released yet.  Wait about
  230.      20 seconds and start the control server again.
  231.  
  232.    CDMxxx: Cannot send to message queue 'nnnn'.
  233.    CDMxxx: Cannot read from message queue 'nnnn'.
  234.  
  235.      These messages appear when you work with a DataAtlas Modeler client after
  236.      the Data Model Server has been shut down.  Close the client windows and
  237.      open the data model again.
  238.  
  239.  
  240. 6. Dictionary Version 2.5 Functions and Restrictions Not Cited in the Books
  241. ===========================================================================
  242.  
  243.    DataAtlas on Windows NT
  244.    ------------------------
  245.    On Windows NT, the current directory is called DATATLAS\WORKING.   These
  246.    files must be found in the current directory:  ipf32.dll, cpdrdef.ini.  The product
  247.    may not execute if they are missing from the current directory.  If you
  248.    inadvertently delete the files, you can copy them from the \BIN directory.
  249.  
  250.    If you close any notebook, folder or dialog window in DataAtlas while a
  251.    Help window is being displayed, the Help window will be closed.  If you still
  252.    need the Help information, you can reopen the Help window from any
  253.    open notebook, folder or dialog window.
  254.  
  255.    Using DataAtlas to access DB2 databases
  256.    ---------------------------------------
  257.    If you encounter a problem using DataAtlas on Windows NT when trying to
  258.    connect to a DB2 for OS/390 database via a DDCS Gateway, add the environment
  259.    variable DB2CODEPAGE and assign it an appropriate value based on your DB2
  260.    for OS/390 code page setting.  For instance, for a DB2 for OS/390
  261.    installation specifying code page 037, the Windows NT system variable
  262.    DB2CODEPAGE would be set to 437.  You can do this in the Control Panel
  263.    folder, using the System icon and the Environment tab.  Depending on
  264.    your country and code page settings, these values will vary.  See your
  265.    data base administrator for the appropriate settings.
  266.  
  267.    In general, you should consult your database administrator for the correct value
  268.    to use for DB2CODEPAGE.
  269.  
  270.    Running with low resolution
  271.    --------------------------
  272.    If you are running with low resolution, for example, 640x480 mode, you
  273.    may run into these situations:
  274.  
  275.    1.  Cannot move a window with the mouse because the title bar is hidden.
  276.        - On OS/2 you can move the window by:  (a) pressing the Alt-F7,
  277.          (b) using the arrow keys to move the window, and (c) pressing Enter
  278.          to accept the new position.
  279.        - On Windows NT you can move the window by: (a) holding down the Alt
  280.          key and then pressing and releasing the space bar, which causes
  281.          the System menu to drop down; (b) selecting "Move" from the menu.
  282.  
  283.    2.  OK button or other notebook controls are hidden.
  284.        - Use the System menu also to close the window and accept the changes.
  285.        - If the notebook has scroll bars, use them to see hidden controls.
  286.  
  287.    ==========================================================================
  288.                                     Populate
  289.    ==========================================================================
  290.  
  291.    General Populate
  292.    ----------------
  293.    In some cases a populate operation after a trial run will fail with the
  294.    message that an object already exists.  If this happens and there is no
  295.    object with the same name, close all workfolders and try the populate again.
  296.  
  297.    Relational Database Populate
  298.    ----------------------------
  299.    If, while executing a populate operation after a trial run, you get
  300.    CONSTRAINT VIOLATIONS such as:
  301.  
  302.    --------------------------------------------------------------------------------------
  303.    6025-085E (Cardinality violation) with the following details
  304.    The attribute 'pContainedInRC' on object 'DSRORDIndex' has a minimum cardinality of 1.
  305.    The attribute 'pContainedInRC' on object 'DSRORDView' has a minimum cardinality of 1.
  306.    The attribute 'pContainedInRC' on object 'DSRORDTable' has a minimum cardinality of 1.
  307.    --------------------------------------------------------------------------------------
  308.  
  309.    Close all workfolders and try the populate again.
  310.  
  311.    ==========================================================================
  312.                           Maintain/Create Data Definitions
  313.    ==========================================================================
  314.  
  315.    General
  316.    -------
  317.    When storing objects, if you see the TeamConnection message:
  318.  
  319.    ----------------------------------------------------------------------------
  320.    6021-141
  321.    The part <yourPart> in release <yourRelease> has been changed in work area
  322.    <otherWorkArea>. If trying to check out the part to another work area,
  323.    first it must be linked to that other work area or the other work area must
  324.    be refreshed from work area <otherWorkArea>.
  325.    ----------------------------------------------------------------------------
  326.  
  327.    Do NOT link the parts to the other work area.  Refresh your work area from
  328.    <otherWorkArea> to ensure that all updated parts in the first work area are
  329.    properly refreshed in the other work area.
  330.  
  331.  
  332.    PL/I and COBOL
  333.    ---------------
  334.    DataAtlas does limited checking of attribute values, such as the Picture
  335.    clause that can be entered from the user interface.  It is possible to
  336.    create structures that cannot be compiled successfully or that cannot be
  337.    converted successfully to another representation.
  338.  
  339.    Naming Considerations:  PL/I, COBOL, and IMS
  340.    ------------------------------------------
  341.    When creating an elementary item in a Shared Data Structure (SDS) notebook using,
  342.    for example, the PL/I representation, if you specify an item name before checking
  343.    the "Use existing shareable data element" box, this item name will be used for the
  344.    other two representations.  However, if you check the "Use existing shareable data
  345.    element" box and select a shareable data element to use prior to specifying an
  346.    item name. then the shareable data element name will be used as the item name
  347.    in the other two representations.
  348.  
  349.    Name checking of an elementary item is only performed if the item is updated.
  350.    Thus it is possible to create an elementary item in the PL/I representation with
  351.    a PL/I-specific name that can be viewed in the COBOL representation.  However, if
  352.    this item is updated while in the COBOL representation, its name must be changed
  353.    to an acceptable COBOL name.
  354.  
  355.    PL/I and COBOL Maintenance
  356.    ---------------------------
  357.    If you encounter a situation where more than one item in the tree view
  358.    of a Shareable data structure or Included source notebook appears to be
  359.    selected, then click on or re-select each of the highlighted objects in
  360.    the tree until only one remains highlighted.  Do this in order to avoid
  361.    unpredictable behavior in either of these notebooks.
  362.  
  363.  
  364. 7. Your Satisfaction
  365. ====================
  366.  
  367. Your satisfaction with IBM is important to us. If you are not completely
  368. satisfied with this product, please contact us through one of the Service and
  369. Technical support channels listed above.
  370.  
  371. Tell us what is not meeting your expectations and why you are dissatisfied.
  372. Provide your name, your organization's name, and your telephone number so that
  373. we can contact you.  We will work with you to resolve your concerns.
  374.