home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / datatl25.zip / _SETUP.LIB / README.DCT < prev    next >
Text File  |  1997-03-02  |  35KB  |  695 lines
  1.  
  2. README.DCT
  3.  
  4. IBM TeamConnection DataAtlas for OS/2 Version 1.0.1
  5. ===================================================
  6.  
  7. DataAtlas on the Web
  8. ====================
  9. TeamConnection DataAtlas product support is provided via its web site:
  10.         http://www.software.ibm.com/ad/datatlas
  11.  
  12. README.DCT Contents
  13. ===================
  14.  
  15. This file explains the following: 
  16.         * How to install DataAtlas Version 1.0.1
  17.                 (See 1. Installation below)
  18.         * How to access and use online and printable book files
  19.                 (See 2. Online and Printable Books below)
  20.         * Version 1.0.1 functions and restrictions that are not cited in the books
  21.  
  22. DataAtlas on the Web
  23. ====================
  24. TeamConnection DataAtlas product support is provided via its web site:
  25.         http://www.software.ibm.com/ad/datatlas
  26.  
  27. 1. Installation
  28. ===============
  29.  
  30. The information in this section guides you through the TeamConnection
  31. DataAtlas V1.0.1 (Fixpak 1) installation process.  DataAtlas must be installed 
  32. on each client system where it will be used.
  33.  
  34. 1.1 Installation Prerequisites
  35.     a) If you are upgrading your installed TeamConnection DataAtlas V1.0
  36.         to DataAtlas V1.0.1 (Fixpak 1), then you must have already installed
  37.         the following products and their components in the order presented
  38.         as described in "IBM TeamConnection DataAtlas for OS/2 Installation,
  39.         Version 1.0" (SC26-8083).
  40.  
  41.         TeamConnection Server
  42.         ---------------------
  43.         * IBM TeamConnection for OS/2 V1.0 Server
  44.            TeamConnection V1.0 was shipped on a separate CD-ROM that was
  45.            included in the DataAtlas V1.0 package.
  46.         * IBM TeamConnection for OS/2 V1.0 Fixpak 3
  47.           June 24 version downloaded from the TeamConnection home page.
  48.  
  49.         TeamConnection DataAtlas Modeler Server
  50.         ---------------------------------------
  51.         * IBM TeamConnection DataAtlas for OS/2 V1.0 Modeler Server
  52.           This was included on the DataAtlas V1.0 CD-ROM.
  53.  
  54.         TeamConnection DataAtlas Client
  55.         -------------------------------
  56.         * TeamConnection for OS/2 V1.0 Client
  57.           TeamConnection V1.0 was shipped on a separate CD-ROM that was
  58.           included in the DataAtlas V1.0 package.
  59.         * IBM TeamConnection for OS/2 V1.0 Fixpak 3
  60.           June 24 version downloaded from the TeamConnection home page.
  61.         * TeamConnection DataAtlas for OS/2 V1.0 Modeler Client
  62.         * TeamConnection DataAtlas for OS/2 V1.0 Dictionary and Designer
  63.  
  64.     b) A version of TeamConnection Fixpak 3 was shipped on the
  65.         TeamConnection DataAtlas V1.0 CD-ROM.  Shortly after the
  66.         availability of DataAtlas V1.0, it was discovered that the
  67.         TeamConnection Fixpak 3 shipped on the DataAtlas V1.0 CD-ROM
  68.         had a problem.  TeamConnection Fixpak 3 was re-released and
  69.         made available via the TeamConnection home page on June 24.
  70.  
  71.         If you:
  72.              1. Installed TeamConnection V1.0
  73.              2. Installed TeamConnection Fixpak 3 from the DataAtlas V1.0 CD-ROM
  74.              3. Installed DataAtlas V1.0
  75.              4. Defined data in your TeamConnection database using DataAtlas
  76.         then the data in your TeamConnection database will be unusable
  77.         if you install any other TeamConnection fixpak, including the
  78.         re-release of TeamConnection Fixpak 3.  At this time there is no
  79.         way to recover the data in your TeamConnection database.  You must
  80.         re-create your TeamConnection Family Server database.
  81.  
  82.         If you:
  83.              1. Installed TeamConnection V1.0
  84.              2. Installed the June 24 TeamConnection Fixpak 3 downloaded from
  85.                  the TeamConnection home page.
  86.              3. Installed DataAtlas V1.0
  87.              4. Defined data in your TeamConnection database using DataAtlas
  88.         Now you can:
  89.              5. Download and install TeamConnection Fixpak 5 on your
  90.                  TeamConnection V1.0 Server and on every TeamConnection V1.0
  91.                  Client.
  92.              6. Download and install DataAtlas V1.0.1 (Fixpak 1) on your
  93.                  DataAtlas V1.0 Modeler Control Server and on every DataAtlas
  94.                  V1.0 Client.
  95.         and you can continue to use the data in your TeamConnection
  96.         database.
  97.  
  98.         If you are installing TeamConnection and DataAtlas for the first time:
  99.              1. Install TeamConnection V1.0 from the CD-ROM included in the
  100.                  DataAtlas V1.0 package.
  101.              2. Download and install TeamConnection Fixpak 5 on your
  102.                  TeamConnection V1.0 Server and on every TeamConnection V1.0
  103.                  Client.
  104.              3. Install DataAtlas V1.0 from the CD-ROM included in the
  105.                  DataAtlas V1.0 package.
  106.              4. Download and install DataAtlas V1.0.1 (Fixpak 1) on your
  107.                  DataAtlas V1.0 Modeler Control Server and on every DataAtlas
  108.                  V1.0 Client.
  109.  
  110.         Now you can start defining data in your TeamConnection database
  111.         using DataAtlas.
  112.  
  113.         Note: TeamConnection Fixpak 5 is available from the TeamConnection
  114.         home page, which can be accessed from the IBM Application Development
  115.         home page at http://www.software.ibm.com/ad or directly at
  116.         http://www.software.ibm.com/software/ad/teamcon.
  117.  
  118. 1.2 Getting Ready to Install TeamConnection DataAtlas V1.0.1
  119.  
  120.  Before you begin installing DataAtlas V1.0.1, be sure to shut down
  121.  your DataAtlas Modeler V1.0 Server and each DataAtlas V1.0 Modeler
  122.  and/or Dictionary and Designer Client.
  123.  
  124.  1. Stop or shut down DataAtlas Modeler Clients:
  125.  
  126.     a.  Close all open windows except the tree view of the model.
  127.     b.  Close the tree view.
  128.     c.  If you are using DataAtlas Modeler in a single-user
  129.         environment, or if you are the only person using the model
  130.         in a multiuser environment, the Unload Data Model window opens.
  131.     d.  Do one of the following:
  132.         *  Unload and save changes to end the data modeling session
  133.            and check the changes to the data model into TeamConnection.
  134.            This also unlocks any objects that were still locked when
  135.            you closed the model.
  136.  
  137.         *  Unload and discard changes to end the data modeling session
  138.            and discard all changes made to the data model since the
  139.            model was checked out of the TeamConnection database.  This
  140.            discards ALL changes made by ALL users.
  141.  
  142.  2. Stop or shut down the DataAtlas Modeler Control Server:
  143.  
  144.     a.  Ensure that there are no data models loaded.
  145.     b.  Double-click on the DataAtlas Modeler Control Server icon or close the
  146.         DataAtlas Modeler Control Server from the OS/2 Window List.  You can
  147.         stop or shut down the DataAtlas Modeler Control Server from the OS/2
  148.         Window List, from the OS/2 command prompt, or using the program icon.
  149.  
  150.  3. Stop or shut down DataAtlas Dictionary and Designer Clients:
  151.  
  152.     a.  Close all object Settings notebooks.
  153.     b.  Close all workfolders.
  154.     c.  Close the Workfolders folder.
  155.     d.  Close the DataAtlas Main Folder.
  156.  
  157.  
  158. 1.3 Using Software Installer/2 to Install TeamConnection DataAtlas V1.0.1
  159.  
  160.  Once you have downloaded and unpacked DataAtlas V1.0.1, you are
  161.  ready to install this fixpak.  You must install it on your
  162.  TeamConnection DataAtlas Modeler V1.0 Server and on every
  163.  TeamConnection DataAtlas V1.0 Modeler and Dictionary and Designer
  164.  Client.
  165.  
  166.  Furthermore, if you want to use TeamConnection Build to invoke
  167.  DataAtlas to build DB2/MVS or DB2/2 DDL, IMS source, or COBOL COPY
  168.  files, you must install DataAtlas Dictionary and Designer V1.0 on your
  169.  TeamConnection build server first and then install DataAtlas
  170.  Dictionary and Designer V1.0.1 (Fixpak 1).
  171.  
  172.  For instructions on installing DataAtlas V1.0, refer to
  173.  "IBM TeamConnection DataAtlas for OS/2 Installation, Version 1.0"
  174.  (SC26-8083), which was included in your original TeamConnection
  175.  DataAtlas V1.0 product package.
  176.  
  177.  Finally, in the directory into which you unpacked DataAtlas V1.0.1,
  178.  you will find two subdirectories:
  179.  
  180.  *   DataAtlas Modeler: modeler
  181.  *   DataAtlas Dictionary and Designer: dictnary
  182.  
  183.  The following step-by-step process applies to each component:
  184.  
  185.  Step 1: Starting the installation
  186.  
  187.  1.  At an OS/2 command prompt:
  188.      a.  Change directory to that of the product you want to install.
  189.      b.  Type Install and press Enter.
  190.  
  191.      The product installation window appears, followed by the
  192.      installation instructions window.
  193.  2.  Select Continue.  The Install window opens.
  194.  
  195.  
  196.  Step 2: Updating CONFIG.SYS
  197.  
  198.  1.  From the Install window, indicate that you want to have your
  199.      CONFIG.SYS file updated.  This is the default.  If you want
  200.      existing installation files overwritten during the installation
  201.      process, select Overwrite files.
  202.  
  203.      If you select not to have your CONFIG.SYS file updated
  204.      automatically, you must update the file manually after the
  205.      installation program completes.  The installation process
  206.      creates a file called CONFIG.ADD that contains your entire
  207.      CONFIG.SYS with the installation modifications included.
  208.  
  209.  2.  Select OK or press Enter.  The Install - directories window opens.
  210.  
  211.  
  212.  Step 3: Selecting components for installation
  213.  
  214.  1.  From the Install - directories window, select the components to
  215.      be installed.
  216.  
  217.  2.  To verify that the default drive has sufficient space, or to see
  218.      what other drives are available, select Disk space.
  219.  
  220.      If you want to use a different drive, do the following from the
  221.      Disk space window:
  222.  
  223.      a.  Select the drive you want to use.
  224.      b.  Select Change directories to selected drive.
  225.      c.  Select OK or press Enter.  The Install - directories window opens.
  226.  
  227.  3.  Select Install from the Install - directories window to start the
  228.      installation.  The Install - progress window shows you the
  229.      progress of the installation.
  230.  
  231.  
  232.  Step 4: Completing the installation
  233.  
  234.  1.  After the installation completes, the Installation and Maintenance
  235.      window appears indicating the product successfully installed.
  236.  
  237.      Select OK or press Enter to return to the product Installation window.
  238.  
  239.  2.  Select Exit or press F3.
  240.  
  241.  3.  After you've installed the desired products, shutdown your
  242.      workstation and then restart it to accept any changes made
  243.      to CONFIG.SYS.
  244.  
  245.  
  246.  Step 5: Verifying your TeamConnection setup
  247.  
  248.  Before using DataAtlas, ensure that the TeamConnection clients can
  249.  still access the TeamConnection Server.  Refer to IBM TeamConnection
  250.  for OS/2 Getting Started, SC34-4498, for TeamConnection Client
  251.  installation and setup documentation.
  252.  
  253.  Step 6: Starting TeamConnection DataAtlas
  254.  
  255.  1.  Before you can start a DataAtlas Modeler Client, you must start the
  256.      DataAtlas Modeler Control Server.  You can start a control server
  257.      in one of the following two ways:
  258.  
  259.      * From the command line
  260.          - From the OS/2 command prompt, type:
  261.               start cdmcsrv /F family /D dbpath
  262.            where:
  263.               * family is the name of the TeamConnection family that you
  264.                 are using.  This parameter is optional; if not specified,
  265.                 the TC_FAMILY setting in CONFIG.SYS is used.
  266.               * dbpath is the fully qualified path of the directory where
  267.                 the TeamConnection family database is located.  This
  268.                 parameter is optional; if not specified, the TC_DBPATH
  269.                 setting in CONFIG.SYS is used.
  270.  
  271.      * From the program icon
  272.          - Double-click on the DataAtlas Modeler Control Server icon
  273.           in the DataAtlas folder
  274.  
  275.  2.  Start DataAtlas Modeler Client by double-clicking on the DataAtlas
  276.      Modeler icon in the DataAtlas folder.
  277.  
  278.  3.  Start DataAtlas Dictionary and Designer by double-clicking on the
  279.      DataAtlas Dictionary/Designer icon in the DataAtlas folder.
  280.  
  281. As before, all of the preceding actions assume that a TeamConnection
  282. Family Server is up and running, and that both the DataAtlas Modeler
  283. Control Server and DataAtlas clients have been set up properly to
  284. access the TeamConnection Family.
  285.  
  286. Binding ewsddb2x.bnd to your DB2/x databases
  287. --------------------------------------------
  288. In order for DataAtlas to populate data definitions from a DB2 family 
  289. database, you must bind 'ewsddb2x.bnd' to every database that will 
  290. be accessed by DataAtlas.  If you have already used DataAtlas V1.0
  291. to populate data definitions from your existing databases, you must
  292. bind the latest version of 'ewsddb2x.bnd' shipped with DataAtlas V1.0.1
  293. to each database from which to expect to populate data definitions
  294. in the future.  See the "DataAtlas Dictionary User's Guide" for more
  295. information on how to do this.  Also note the following correction in
  296. the bind command in the User's Guide:
  297.  
  298.     db2 bind ewsddb2x.bnd
  299.  
  300. Special Notes
  301. ------------- 
  302.      * Install OS/2 Warp Fixpak 17 or higher to fix the following problems:                
  303.        - Notebook tab text always aligns on the left of the tab.
  304.        - The 'Tab' key doesn't move the cursor between controls on a         
  305.           notebook page.
  306.  
  307. 2. Online and Printable Books
  308. =============================
  309. Four publications accompanied the release of DataAtlas Version 1.0: 
  310.         * DataAtlas Modeler User's Guide
  311.         * DataAtlas Dictionary User's Guide
  312.         * DataAtlas Designer User's Guide
  313.         * DataAtlas Installation
  314. Of these, the first two have been updated for DataAtlas Version 1.0.1. 
  315. The Installation booklet, although unchanged, is superseded by the 
  316. instructions in section 1. Installation in this file.  
  317.  
  318. After you have installed DataAtlas Version 1.0.1, you can double-click 
  319. on the folder labeled "DataAtlas Information,"  and then double-click on 
  320. the book icons inside to read any of the online books.  You should refer
  321. to the "Summary of Changes" pages in both the Dictionary User's Guide
  322. and the Modeler User's Guide to see a synopsis of the updates.
  323.  
  324. For your convenience, the two updated guides are also available in Adobe
  325. Acrobat and PostScript formats.  You can find the DataAtlas Dictionary
  326. Version 1.0.1 Acrobat file in the \HELP subdirectory of the directory
  327. where you installed DataAtlas Dictionary and Designer Version 1.0.1.  
  328. For DataAtlas Modeler Version 1.0.1, the Adobe Acrobat file is in the 
  329. \LANG\EN_US subdirectory of the directory where you installed DataAtlas
  330. Modeler Version 1.0.1.  
  331. In both cases, the PostScript files are in the \PRINTABL subdirectory in 
  332. the 
  333. directory into which you downloaded and unpacked each respective product.
  334. The Acrobat and PostScript files are named as follows: 
  335.         EWSDC000.PDF - Dictionary User's Guide (Acrobat)
  336.         EWSDC000.PS - Dictionary User's Guide (PostScript)
  337.         CDMU7A00.PDF - Modeler User's Guide (Acrobat)
  338.         CDMU7A00.PS - Modeler User's Guide (PostScript)
  339. To view the Acrobat files, you must have the Adobe Acrobat reader. You can 
  340. download this free of charge from the Adobe website: http://www.adobe.com/. 
  341.  
  342. 3. General
  343. ==========
  344. * After reading this document, we recommend that you:
  345.         1. Read the DataAtlas Dictionary and Designer 
  346.            Installation booklet for installation,
  347.            setup, and startup instructions.
  348.         2. Use the online tutorial to learn how to
  349.            use DataAtlas Dictionary and Designer quickly. 
  350.         3. Refer to the DataAtlas Dictionary User's Guide
  351.            and the DataAtlas Designer User's Guide as needed.
  352.         4. Refer to the readme file for the TeamConnection 
  353.            DataAtlas Modeler for further information on that
  354.            part of DataAtlas. 
  355.  
  356.  * Install OS/2 Warp fixpack 17, to fix the following:             
  357.         - Notebook tab text is always aligning on the left of the tab.
  358.         - The Tab key not moving the cursor between controls on a notebook page.                                               
  359.  
  360.  * Sample data for running DataAtlas Dictionary and Designer scenarios
  361.   is supplied with the Version 1 product.
  362.  
  363.   DB2 for OS/2 database:
  364.     The DA_CELD DB2 for OS/2 database is used with the
  365.     DataAtlas Dictionary and Designer tutorial. Directions
  366.     for installing DA_CELD are in the Installation
  367.     booklet. Before attempting to install the database, 
  368.     at the OS/2 command line change to the
  369.     <DARoot>\samples\celdial directory, where <DARoot>
  370.     is the root directory in which DataAtlas is installed.
  371.     You must have DB2 for OS/2 Version 1.2 or higher in 
  372.     order to install the sample DA_CELD sample database.
  373.  
  374.   IMS data:
  375.     Sample IMS DBD and PSB source files are in 
  376.     <DARoot>\samples\ims.
  377.  
  378.   Sample Queries:
  379.     Sample SQL queries are in <DARoot>\samples\query.
  380.  
  381. 4. TeamConnection 1.x Considerations
  382. =====================================
  383. * In TeamConnection there is a limitation on the maximum amount
  384.   of data which can be integrated in a single workarea.  We have
  385.   successfully integrated a workarea in which 200 DB2/MVS tables
  386.   and their associated objects had been populated.  To help avoid
  387.   exceeding this limitation, we strongly recommend that you make
  388.   large changes incrementally, creating and integrating a workarea
  389.   for each increment.  If you do not limit your workareas, there
  390.   is a possibility that the workarea cannot be integrated, and
  391.   therefore your data cannot be used in the database.
  392.  
  393. * You may experience a problem in which a TeamConnection workarea
  394.   integrate appears to be successful on the client, but which the
  395.   audit.log on the TeamConnection server shows to have actually
  396.   failed.  If you encounter this defect, this workarea cannot be
  397.   successfully integrated. We recommend that you make changes to
  398.   your data incrementally, creating and integrating a workarea for
  399.   each increment.  This will help minimize the potential impact of
  400.   this defect.  Also, we strongly recommend that you periodically
  401.   back up your TeamConnection database, perhaps before every workarea
  402.   integrate, and verify the success of every integrate by checking the
  403.   server audit.log.  Another possible workaround is to have all users
  404.   do their work in a single common workarea which is never integrated,
  405.   avoiding TeamConnection versioning function at this time.  IBM does
  406.   not recommend this solution, as it does not give you the advantages
  407.   of using the versioning function.                                           
  408.  
  409. * A TeamConnection server which will support clients using DataAtlas
  410.   must be run with only one server daemon.  We strongly recommend that
  411.   you do not start more than one daemon, as you may see unpredictable
  412.   failures.
  413.  
  414. * TeamConnection is actively working on removing these limitations
  415.   and restrictions.  If you encounter additional problems, please
  416.   contact your service representative.
  417.  
  418. 5. DataAtlas Performance Considerations
  419. =======================================
  420. * Significant performance and scalability improvements have been
  421.   made in this DataAtlas CSD and its associated TeamConnection
  422.   fixpack, especially for DB2/MVS related objects.  Further
  423.   improvements in performance will be a focus for the next release
  424.   of DataAtlas.
  425.  
  426. * TeamConnection currently supports DataAtlas only on an OS/2-based
  427.   server, which supports a limited number of concurrent users of
  428.   "fine-grained" data, such as that used by DataAtlas.  Operations
  429.   that are described below as "CPU-intensive" may degrade the
  430.   performance of other DataAtlas operations which would otherwise
  431.   perform well.  We recommend that if many users will be active in
  432.   DataAtlas concurrently, you should schedule such "CPU-intensive"
  433.   operations for a time when the expected user load will be light.
  434.  
  435. * The DataAtlas populate function can be quite CPU-intensive,
  436.   depending upon the number of objects involved in the populate.
  437.   To obtain adequate performance during populate, close any
  438.   workfolders that contain objects used during the populate.  This
  439.   will allow populate to clean up the local cache memory as it
  440.   progresses.
  441.  
  442. * Queries that involve many DataAtlas objects, or that span across 
  443.   many objects, can be very CPU-intensive.  To get the best performance 
  444.   from your SQL queries, write queries that reference only those 
  445.   columns in which you are interested. A few viewtypes have hundreds 
  446.   of columns, so returning all columns can potentially be slow. 
  447.   For example:
  448.                                                                         
  449.   1) SELECT d.* FROM OUTER DataAtlasDBD d; --> potentially long-running
  450.   2) SELECT d.rootDBDname FROM OUTER DataAtlasDBD d;  --> faster query
  451.  
  452. * Some DataAtlas Designer activities are CPU-intensive, requiring some
  453.   time for execution:
  454.         - Concurrent tasks, like propose, validate, or inform, on many 
  455.           objects simultaneously
  456.         - The Propose Foreign Key task for a given table when the 
  457.           physical design object contains many tables
  458.         - Opening a physical design group (DB2/MVS table, DB2/MVS 
  459.           tablespace, etc.) with more than 50 objects in that group
  460.  
  461. * The DataAtlas Modeler forward and reverse transform operations can be
  462.   very CPU-intensive.  We recommend that for models with more than 100
  463.   entities, these operations be done on a client machine with more than
  464.   32MB RAM.
  465.  
  466. * In each execution of DataAtlas, there is an initial overhead for the
  467.   first access of each object type in the TeamConnection database.
  468.   Later accesses of any other objects of each type will not incur this
  469.   overhead.
  470.  
  471. * Opening the maintenance notebook for certain DB2/MVS objects will
  472.   also retrieve information for certain related objects into the local
  473.   cache.  For example, opening an Index will retrieve information about
  474.   the related Table.  Opening a Table will retrieve any other Tables for
  475.   which it has a foreign key.  Retrieving this additional information
  476.   will slow the performance of opening the maintenance notebook for the
  477.   object.  However, that information is now in the local cache, so the
  478.   performance of opening the related objects would be improved.
  479.  
  480. * Objects which have been viewed via their maintenance notebook
  481.   or which have been generated may take up space in the local cache
  482.   memory so long as the workfolder is open, degrading performance
  483.   over time.  Periodically closing the workfolder will clean up the
  484.   local cache, improving the performance as well as saving the state
  485.   of the workfolder.  We also recommend closing and restarting
  486.   DataAtlas each day for complete local cache cleanup.
  487.  
  488. * We strongly recommend that you run the DataAtlas client on a separate
  489.   machine from your TeamConnection server.  This will improve the
  490.   performance for most DataAtlas tasks.
  491.  
  492. * With the TeamConnection server on its own machine, we recommend that
  493.   you set the OS_CACHE_SIZE environment variable for the TeamConnection
  494.   server daemon to at least half the total memory of the machine, but
  495.   leaving at least 16MB available.  For example, on a server machine
  496.   with 64MB RAM, set OS_CACHE_SIZE to at least 32MB but no greater than
  497.   48MB.  This will improve the performance of the largest DataAtlas
  498.   tasks, such as populates and Modeler transforms.
  499.  
  500. 6. Population of IMS PSBs and DBDs in Object Form
  501. =================================================
  502. IMS PSBs and DBDs in object form, typically members in a PSBLIB or
  503. DBDLIB, can be populated by DataAtlas.  Since the populate function
  504. works only from source code, the object modules must be converted
  505. to source form before they can be populated.  A set of utilities 
  506. to do this conversion are available in the IMS System Utilities/Data 
  507. Base Tools (DBT) Version 2 product.  DBT's DBD/PSB/ACB Library 
  508. Management Utilities contain several useful functions: DBD/PSB/ACB 
  509. Compare, Mapper and Reversal.  The function used to convert object
  510. code to source is Reversal.
  511.  
  512. Even in the best-run shops, the definitions of objects stored in 
  513. a repository database sometimes differ from those in production.  
  514. You should periodically regen and compare all of the objects for 
  515. a given application to the objects being used in production to
  516. verify the integrity of the data in the database.  This process
  517. is analogous to taking an annual inventory to verify that the 
  518. perpetual inventory records are correct.
  519.  
  520. 7. Loading Generated DB2 DDL
  521. ============================
  522. * The generated DDL that you wish to load into your target DB2/2
  523.   system from a file requires the -f option to specify a file and
  524.   the -t option to accept the semicolon (;) as the statement 
  525.   termination character in the DB2 batch command.
  526.  
  527. * Generated DDL for DB2/MVS needs post processing:
  528.   Due to a known problem that will be fixed in a future release, the
  529.   generated DDL places the ALTER statements for foreign key
  530.   creation ahead of the INDEX statements, resulting in DDL that may
  531.   be out of order. The REXX command file EWSMVALT.CMD 
  532.   can be used to move the ALTER statements to the end of the DDL file.
  533.   This command file can be found in the \CLIENT subdirectory of the 
  534.   directory where you installed DataAtlas Dictionary and Designer 
  535.   Version 1.0.1.
  536.  
  537. 8. DataAtlas Dictionary Maintenance Limitations
  538. ================================================
  539. * DB2/MVS partitioned indexes that use GRAPHIC columns in the
  540.   index are currently not supported. 
  541.  
  542. * Very little syntax checking is performed on the COBOL PICTURE clause.
  543.  
  544. * Negative scale values are not yet supported on the RDB, VisualGen,
  545.   or COBOL representations.
  546.  
  547. * In some notebooks, validation will be performed on the name,
  548.   variation and revision fields to ensure that invalid or reserved 
  549.   characters are not used. This validation may not be performed
  550.   in all cases, however. Among the set of characters that you may 
  551.   not use in an object name, variation, or revision are <, >, :, and |.
  552.   If you use any of these characters and the mistake is not caught
  553.   by a validator in a notebook, unexpected results may occur.
  554.  
  555. * DataAtlas reports are saved on your hard disk in the directory
  556.   specified by your DataAtlas profile.  You can delete any of the 
  557.   files with the name val*.rpt, dbd*.rpt, psb*.rpt, cob*.rpt or rdb*.rpt 
  558.   when you no longer need these reports.
  559.  
  560. * New tables created as a result of a forward transfrom from the 
  561.   Modeler are not automatically added to your workfolder. You must
  562.   add them to a workfolder before you can generate the DDL.
  563.  
  564. * If you are using a profile created by the DataAtlas 1.0 product, 
  565.   ensure that the mandatory fields on the General Page of the Profile 
  566.   (working, Populate, Generate, and Query directory paths) are filled 
  567.   in with a value. If you do not do this, you may encounter the 
  568.   following error: 
  569.  
  570.       EWS0088S:  A processing error occurred while attempting to access
  571.       an attribute or object.  The object type being accessed was
  572.       <DSMultiPlatformFile>.  The attribute that could not be
  573.       gotten was <OS2/MVS info>.
  574.  
  575. *  When attempting to use the ims, db22, db2 or cobol builder, the 
  576.    DataAtlas Profile must exist on the build processor machine.  If 
  577.    the Profile does not exist, start DataAtlas on the machine.  After 
  578.    the create Profile panel appears, press OK to create the Profile.  
  579.    Close DataAtlas. This is also true for any user-created builder 
  580.    using DataAtlas build scripts.  
  581.  
  582. * Included Source Definition and Shareable Data Structure maintenance 
  583.   functions have these limitations: 
  584.     - Information may be hidden if the notebook is not resized 
  585.     - Little syntax checking is done during create or update; the 
  586.       validation done during the Generate step will catch problems 
  587.       that would otherwise be caught by the compiler
  588.     - The Included Source Definition support does not allow Level 88s
  589.       on items nested directly within the Included Source Definition
  590.     - The Shareable Data Structure support does not allow arrays of 
  591.       shareable components or the creation of OCCURS DEPENDING ON
  592.       relationships between arrayed objects and components outside 
  593.       of the root Shareable Data Structure
  594.     - There is no support for POINTER and PROCEDURE-POINTER types 
  595.       of data items      
  596.  
  597. 9. DataAtlas Designer Maintenance Limitations
  598. =============================================
  599. * You cannot create a physical design directly from a DataAtlas 
  600.   workfolder. To create a new physical design, you must first create
  601.   a relational design, and then create the physical design from that 
  602.   notebook.
  603.  
  604. * When working with the propose function of the Designer, you must 
  605.   provide as input the necessary data load and work load information.
  606.  
  607. * You can specify a usage intent of a DB2/MVS storage group. However, 
  608.   this usage intent will not be enforced by the system.
  609.  
  610. * Proposed new objects are not automatically included in the current
  611.   workfolder. If you want to include them in a workfolder, you must 
  612.   search the TeamConnection database after running the propose function
  613.   which created the new objects.
  614.  
  615. * If you start a propose rule action from an opened notebook and then 
  616.   execute the proposals, you will see the changes only after you have 
  617.   closed the proposal actions panel.
  618.  
  619. * When object names are changed, new names are not directly reflected 
  620.   in the notebooks of affected objects. You will see the new names only 
  621.   after you have closed and reopened these notebooks.
  622.  
  623.  
  624. 10. TeamConnection DataAtlas Build Scripts
  625. ==========================================
  626. When using TeamConnection to build DB2/x DDL, IMS source, or COBOL COPY 
  627. files, you may see the following messages in the Build Progress window on your 
  628. TeamConnection client workstation:
  629.  
  630. 6021-700 Number of distinct build events for this build: 1.
  631. Build of 'ims01.dbd' failed at '17:33:15 1996-08-20'.
  632. Completed Jobs: 726908
  633. Remaining Jobs: 726804
  634. Processing Completed for 'ims01.dbd'.
  635. 6021-637 The build of part: 'ims01.dbd' in work area: '' and release:
  636.          '(null)' has already been canceled.
  637.  
  638. Disregard these messages in the Build Progress window and view the Build 
  639. Message for the output part, namely the DB2/x DDL, IMS source, or COBOL 
  640. COPY file, to determine the disposition of build events.
  641.  
  642. 11. COBOL Populate/Generate Limitations
  643. =======================================
  644. * There is a known problem with the SYSADATA produced by the VisualAge 
  645.   for COBOL for OS/2 compiler version 1.2 that results in incorrect 
  646.   data being populated into the DataAtlas Dictionary.  For example, 
  647.   if you populate a Included Source Definition containing a data item 
  648.   with a value of four (4) apostrophes
  649.  
  650.                 05   APOST-04 PIC X(4) VALUE ''''.
  651.  
  652.   the populate will appear to work correctly.  However, an attempt to 
  653.   generate the Included Source Definition that contains this data item 
  654.   will fail because the VALUE is incorrect.  
  655.  
  656.   This problem should be fixed by the VisualAge for COBOL for OS/2 
  657.   "1.2 Refresh" that is planned to be available in September 1996.
  658.  
  659. * There is another known SYSADATA problem in which a level 88 data item                                                            
  660.    that has a large number of values (for example, more than 50) appears                                                            
  661.    to be populated correctly.  However, the SYSADATA actually contains                                                              
  662.    one or more incorrect values.  Therefore, an attempt to generate                                                                 
  663.    the includedSourceDefinition that contains the level 88 data item                                                                
  664.    will fail with a compilation error.                                                                                              
  665.                                                                                                                                     
  666.    The fix for this problem should be available in the release of                                                                   
  667.    the VisualAge for COBOL for OS/2 compiler that follows the                                                                       
  668.    "1.2 Refresh."                                                                                                                   
  669.                                                                                                                                     
  670.  * There is a known problem in DataAtlas in which a data item with a                                                                
  671.    picture of the form X(nnnnn) where n is a numeric can be populated,                                                              
  672.    but not generated.  An example is "05 DataItemA PIC X(32000)".  Also,                                                            
  673.    an attempt to open an includedSourceDef or shareable Data Structure                                                              
  674.    that contains a data item with such a picture may trap.                                                                          
  675.    A fix for this problem can be obtained from DataAtlas service.                                                                   
  676.                                                                                                                                     
  677.  * You may experience problems when executing a Trial Run Populate 
  678.   followed by a real Populate of the same object within the same 
  679.   DataAtlas session; you may receive Duplicate Name errors. A common 
  680.   cause for this error is that the cache is not cleaned up properly 
  681.   between populates. If you receive this error, ensure that all 
  682.   workfolders that contain objects used during the Populate are closed 
  683.   prior to executing subsequent populates.     
  684.    
  685. 12. National Language Support
  686. =============================
  687. DataAtlas supports the following code pages:                           
  688.     437 (English), 850 (Multilingual), 852 (Latin 2), 857 (Turkish),     
  689.     932 (Japanese), 942 (Japanese SAA), 933 (Korean), 950 (Taiwanese).   
  690.                                                                          
  691. The current version of DataAtlas is presented in English.  A Japanese  
  692. language version wll be available next year.                    
  693.  
  694.  
  695.