Tivoli Decision Support Release Notes Version 2.1.1

Transcription

1 Tivoli Decision Support Release Notes Version April 20, 2001

2 Tivoli Decision Support Release Notes (April 20, 2001) Copyright Notice Copyright IBM Corporation 2000, All rights reserved. May only be used pursuant to a Tivoli Systems Software License Agreement, an IBM Software License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranties of merchantability and fitness for a particular purpose. U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Trademarks IBM, the IBM logo, Tivoli, the Tivoli logo, and IBMLink are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others. Notices References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services is not intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to valid intellectual property or other legally protectable right of Tivoli Systems or IBM, any functionally equivalent product, program, or service can be used instead of the referenced product, program, or service. The evaluation and verification of operation in conjunction with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, New York , U.S.A.

3 Contents Accessing Publications Online...1 Ordering Publications...2 Contacting Customer Support...2 New Features for Tivoli Decision Support...3 New Features for Version Features from Version 2.1 Supported in Version System Requirements...11 Installation Notes...11 Internationalization Issues...14 Known Product Limitations and Workarounds...14 Installation Limitations and Workarounds...14 Discovery Administrator Limitations and Workarounds...14 Discovery Client Limitations and Workarounds...17 Process Scheduling Limitations and Workarounds...19 General Limitations and Workarounds...20 Defects Fixed for Version Tivoli Decision Support Documentation...24 Books in This Set...24 Online Books...25 Information about Third-party Products and Documentation...26 Documentation Changes...26 Tivoli Decision Support Release Notes iii

4 iv Version 2.1.1

5 1Release Notes Accessing Publications Online These release notes provide important information about Tivoli Decision Support, Version These notes are the most current information for the product and take precedence over all other documentation except for the readme.txt file that is installed with Tivoli Decision Support and is located on the Tivoli Decision Support CD. The readme.txt file contains last-minute information that does not appear in these notes. Review these notes thoroughly before installing or using this product. These release notes include the following topics: Accessing Publications Online on page 1 Ordering Publications on page 2 Contacting Customer Support on page 2 New Features for Tivoli Decision Support on page 3 System Requirements on page 11 Installation Notes on page 11 Internationalization Issues on page 14 Known Product Limitations and Workarounds on page 14 Defects Fixed for Version on page 21 Tivoli Decision Support Documentation on page 24 Accessing Publications Online The Tivoli Customer Support Web site ( offers a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and technical information, including release notes, user's guides, redbooks, and white papers. You can access Tivoli publications online at The documentation for some products is available in PDF and HTML formats. Translated documents are also available for some products. Tivoli Decision Support Release Notes 1

6 Ordering Publications To access most of the documentation, you need an ID and a password. To obtain an ID for use on the support Web site, go to Resellers should refer to for more information about obtaining Tivoli technical documentation and support. Business Partners should refer to Ordering Publications for more information about obtaining Tivoli technical documentation. The online books are also available on the Tivoli Decision Support CD in the \Docs\Pdf folder. Ordering Publications Order Tivoli publications online at or by calling one of the following telephone numbers: U.S. customers: (800) Canadian customers: (800) Contacting Customer Support If you need support for this or any Tivoli product, contact Tivoli Customer Support in one of the following ways: Submit a problem management record (PMR) electronically from our Web site at For information about obtaining support through the Tivoli Customer Support Web site, go to Submit a PMR electronically through the IBMLink system. For information about IBMLink registration and access, refer to the IBM Web page at Send to support@tivoli.com. Customers in the U.S. can call TIVOLI8 ( ). Customers outside the U.S. should refer to the Tivoli Customer Support Web site at 2 Version 2.1.1

7 New Features for Tivoli Decision Support for customer support telephone numbers. When you contact Tivoli Customer Support, be prepared to provide the customer number for your company so that support personnel can assist you more readily. We are very interested in hearing from you about your experience with Tivoli products and documentation. We welcome your suggestions for improvements. If you have comments or suggestions about this documentation, send to New Features for Tivoli Decision Support New Features for Version This section describes the new features in Tivoli Decision Support, Version Ability to Sort Data Displayed in the Right Pane of the Discovery Administrator The user can now sort the contents of the right pane of the Discovery Administrator by single-clicking a column header. The first time a column is clicked, the data is sorted in ascending order. The second time the column is clicked in succession, the data is sorted in descending order. The sort order is based on the text value, not on the numeric value of the content. For example, 10 (ten) sorts before 2 (two). New Query Properties and Methods Defined for the Discovery Administrator ColumnAttributeModifiers Text (string) data output to the drill-through database was previously limited to 255-character text fields. When text data longer than 255 characters was exported, a run-time error occurred. Now you can specify an option to truncate the text data to 255 characters, or you can specify an option to store the text data in a Memo field, which can hold longer text strings without truncation. Tivoli Decision Support Release Notes 3

8 New Features for Tivoli Decision Support To specify this option, assign a value to the Query object string property ColumnAttributeModifiers. ColumnAttributeModifiers can contain a semicolon-delimited modifier list. The ColumnAttributeModifiers property is transient and must be reassigned each time the query is executed. The following example of a modifier list truncates the contents of a column named SUMMARY and stores the contents of a column named NOTES in a Memo field: "SUMMARY/LongTextDTDB=TruncToFit;NOTES/LongTextDTDB=StoreInMemo" The ColumnAttributeModifiers property must be assigned in a BeforeQuery script. The BeforeQuery script must appear in front of the BeforeExport script, as in the following example: Sub BeforeQuery() Query.ColumnAttributeModifiers = _ "RECIPE/LongTextDTDB=StoreInMemo" End Sub Sub BeforeExport()... The ColumnAttributeModifiers property can be used for columns from the SQL query and for calculated columns. If neither option is specified, or if an incorrect syntax is used, data longer than 255 characters still results in the following run-time error: Error: Error exporting query...the field is too small... ScriptTimeout Each execution of a script during the export of a query is interrupted by a dialog box after 1000 seconds (about 17 minutes) to determine if the user wants the execution to continue. To specify a value for the script execution time before the dialog box is displayed, assign a 32-bit signed integer to the Query object ScriptTimeout property. ScriptTimeout contains the number of milliseconds of execution allowed before the execution dialog box is displayed. The default value is 1 million milliseconds (1000 seconds or about 17 minutes). A value of 1 suppresses the dialog box. The ScriptTimeout property is transient and must be reassigned each time the query is exported. 4 Version 2.1.1

9 New Features for Tivoli Decision Support The following code example sets the ScriptTimeout property to 40 seconds: Sub BeforeExport() Query.ScriptTimeout = Note: Assigning a ScriptTimeout value in a script does not change the timeout value during execution of that script. However, a value assigned by one script in a query affects succeeding scripts in that query, as follows. If assigned in this script: BeforeQuery BeforeExport Calculated column scripts AfterExport The value affects the following scripts: BeforeExport Calculated column scripts AfterExport Calculated Column Scripts AfterExport AfterExport (None) QueryTimeout You can now specify the length of time an SQL query can execute before it times out. To specify the duration, assign the Query object numeric property QueryTimeout. QueryTimeout contains the number of seconds the query can execute before a timeout error occurs. If QueryTimeout is set to zero, the default value, the query does not time out. The QueryTimeout property is transient; it must be reassigned each time the query is executed. This property must be assigned in a Tivoli Decision Support Release Notes 5

10 New Features for Tivoli Decision Support BeforeQuery script, and the BeforeQuery script must occur in front of the BeforeExport script as in the following example: Sub BeforeQuery() Query.QueryTimeout = 120 End Sub Sub BeforeExport()... Note: The QueryTimeout property limits the time the query executes before it starts returning rows. When the SQL query is returning rows, the QueryTimeout property has no effect. ExcludeRowNow Previously, all rows extracted by the SQL query were written to the export output files (the.csv file and the drill-through database). Now you can refine the row selection in one or more of the calculated column scripts. You can invoke the ExcludeRowNow method of the Query object from a script. When the script returns control, the Query object stops processing the current query row, inserts any rows specified by the InsertRow method (see the next section) into the output, and proceeds to the next row in the query row set. The ExcludeRowNow method can only be used in a calculated column script. The following code excludes rows whose IP addresses have a value of 37 in the third octet, such as , , and IPOctetArray = Split( Columns( "IP_ADDRESS" ), "." ) If IPOctetArray( 2 ) = "37" Then (The array is zero-based, so the third element has index number 2.) Query.ExcludeRowNow Exit Function End If The Exit Function statement that follows the call to the ExcludeRowNow method is not required, but, in most cases, if you exclude the row, you have no need for further processing with its data. 6 Version 2.1.1

11 InsertRow New Features for Tivoli Decision Support Previously, only rows extracted by the SQL query were written to the export output files (the.csv file and the drill-through database). Now you can include additional data using one or more of the calculated column scripts or the AfterExport script, which collectively are called event procedures. You can invoke the InsertRow method of the Query object from a script. The method takes a parameter that contains the data to be stored in the output row. The InsertRow parameter must be a variant containing a one-dimensional, zero-based array of values. All VBScript variables are variants. Use the Array function to build an array in a variant. The array must have the same number and order of elements as columns in the export text file (.csv file). The Query object saves the specified data until it has finished processing the current query row. When the script returns control, the Query object constructs a row for each time the InsertRow method was called and writes it to the export text file. If the Export to Drill Through option was selected, the Query object writes the same data to the drill-through database. The InsertRow method is valid only in a calculated column script or in the AfterExport script. The following code example inserts a row with four columns: -- Calculate values. CalculatedValue2 = Columns( "YTD_something" ) _ + Columns( "PriorYear_something" ) CalculatedValue4 = Left( Columns( "DeviceName" ), 2) -- Put all required values into an array. ValueArray = Array( Columns( "something" ), CalculatedValue2, _ Columns( "something_else" ), CalculatedValue4 ) -- Request that a row be built from the array and inserted into the output. Query.InsertRow ValueArray Note: This method saves the parameter data in main memory (RAM) before writing it. Avoid calling InsertRow a large number of times in a script; this can result in the following run-time error: "Error: 7 - Out of memory." Tivoli Decision Support Release Notes 7

12 New Features for Tivoli Decision Support With the combined use of the ExcludeRowNow and InsertRow methods, you can include additional summarization beyond what is specified in the SQL query. ODBC Drivers Previous versions of Tivoli Decision Support included Tivoli-provided Open Database Connectivity (ODBC) drivers. The Tivoli-provided ODBC drivers are not included with this release. Use the ODBC drivers provided by your database client software when configuring the ODBC connection for Tivoli Decision Support discovery guides. If you have a previous version of Tivoli Decision Support that installed Tivoli-provided ODBC drivers, you can continue to use those drivers with the existing licenses. If you have purchased new Tivoli Decision Support licenses, the following table shows you which ODBC driver is needed if your discovery guide documentation specifies a Tivoli-provided ODBC driver. If the discovery guide documentation specifies this Tivoli-provided ODBC driver... You should use one of these ODBC drivers shipped with your database client: Informix (3.11) Informix bit Version Informix bit Version Informix 9 (3.11) Informix bit Version Informix bit Version Version 2.1.1

13 New Features for Tivoli Decision Support If the discovery guide documentation specifies this Tivoli-provided ODBC driver... You should use one of these ODBC drivers shipped with your database client: Oracle 8 (3.11) Oracle ODBC driver Version (Oracle client) Oracle ODBC driver Version (Oracle client) Oracle ODBC driver Version (Oracle client) Oracle ODBC driver Version (Oracle client) SQL Server (3.11) SQL Server Version (Microsoft SQL Server 6.5 client) Sybase (3.11) Sybase System 11 Version (Sybase 11.5 client) Sybase System 11 Version (Sybase client) To obtain the latest information about Tivoli Decision Support or Tivoli Decision Support discovery guides, contact your Tivoli support provider. For more information, see Contacting Customer Support on page 2. For information about how to install and set up an ODBC connection for your database client, refer to your database client setup documentation or contact your system or database administrator if you require additional assistance. Features from Version 2.1 Supported in Version The following features were new for Tivoli Decision Support 2.1 and are included in Tivoli Decision Support Tivoli Decision Support Release Notes 9

14 New Features for Tivoli Decision Support Migration Utility (Migrat20.exe) The Migrat20.exe file allows you to migrate the Tivoli Decision Support discovery guides that you are currently using with Tivoli Decision Support 2.0 to Tivoli Decision Support 2.1.x. Step-by-step procedures are provided in the Tivoli Decision Support Administrator Guide, in the section that discusses migrating discovery guides from Tivoli Decision Support 2.0 to 2.1. On the Windows 95 and Windows 98 operating systems, the migration utility might not convert all the.pyg files to.mdl files. Convert the.pyg files to.mdl files using Cognos Transformer 5.2 that was installed with Tivoli Decision Support 2.0. Make sure that you perform this conversion before uninstalling Cognos PowerPlay. Do not perform migration if you are currently using Tivoli Decision Support 2.1 and are upgrading to Tivoli Decision Support See Known Product Limitations and Workarounds on page 14 in this document for additional information and limitations of this function. Automatic and Manual Publishing to HTML Tivoli Decision Support 2.1 has the ability to publish user-specified views as HTML or as a graphic file from the Discovery Interface or with a task schedule created using the Discovery Administrator. See Known Product Limitations and Workarounds on page 14 in this document for additional information and limitations of this function. You can enable and disable the publishing feature in the Discovery Interface by following the step-by-step procedures described in the Tivoli Decision Support Administrator Guide sections discussing publishing to HTML and enabling publishing to HTML for the Discovery Interface. You can also schedule automatic publishing tasks. See Tivoli Decision Support Process Scheduler on page 11 in this document. Exporting Discovery Guides The Discovery Administrator export feature exports a discovery guide and all its constituent files to a folder. You can use the export feature to back up data or create a snapshot that can be reused at a later date or with another installation of Tivoli Decision Support 2.1.x. All the 10 Version 2.1.1

15 System Requirements discovery guide data and folders (for example, the Cognos PowerPlay reports, Seagate Crystal Reports, PowerPlay models, release notes, and so forth) are copied to a destination folder. The new discovery guide file (.dgf) and the guide-specific ranking file (.ini) are also created in the destination folder. Step-by-step procedures are provided in the Tivoli Decision Support Administrator Guide section that discusses exporting discovery guides. Tivoli Decision Support Process Scheduler The Tivoli Decision Support Process Scheduler is a service that runs with the Windows NT operating system. This service runs in the background and can be set up to start Tivoli Decision Support cube builds and publish views. Step-by-step procedures for using this feature are provided in the Tivoli Decision Support Administrator Guide. See Known Product Limitations and Workarounds on page 14 in this document for additional information and limitations of this function. System Requirements Installation Notes Hardware and software requirements are described in the Tivoli Decision Support Installation Guide. You can access the Tivoli Decision Support Installation Guide in Portable Document Format (PDF) files. These documents should be viewed using Adobe Acrobat Reader 4.0 or later. Adobe Acrobat Reader can be installed from the Tivoli Decision Support CD or downloaded for free from the Adobe Web site at For additional information, see the following: Online Books on page 25 Documentation Changes on page 26 Before installing Tivoli Decision Support 2.1.1, use a text editor to open and review the readme.txt file located in the root folder of the Tivoli Decision Support CD. This file contains last-minute information. Tivoli Decision Support Release Notes 11

16 Installation Notes If you are using Tivoli Decision Support 2.0, complete the following activities before starting the installation procedure: 1. Back up your data from the following folders in the Tivoli Decision Support 2.0 installation folder (by default, c:\program Files\TDS) on your machine or the folder that contains the Tivoli Decision Support 2.0 shared data: ~ \ActiveX ~ \cubes ~ \data ~ \Docs (optional) ~ \Guide Docs (optional) ~ \Install (optional) ~ \models ~ \reports ~ \Util ~ Any folders that contain published reports (optional) 2. If you currently have Crystal Reports 7.0, uninstall Crystal Reports 7.0 and restart your machine before installing Tivoli Decision Support Tivoli Decision Support is designed to use the Crystal Reports 6.0 run-time engine and the Crystal Reports 6.0 product. 3. Complete the installation procedure in the Tivoli Decision Support Installation Guide. 4. Use the migration tool, Migrat20.exe, before uninstalling Version 2.0, as described in the Tivoli Decision Support Administrator Guide in the section that discusses migrating discovery guides from Tivoli Decision Support 2.0 to 2.1. After completing the migration procedure, verify that an.mdl file was created in the Tivoli Decision Support \Models folder for each.pyg file used by Tivoli Decision Support 2.0. See Known Product Limitations and Workarounds on page After completing the migration of your Tivoli Decision Support 2.0 data to Tivoli Decision Support 2.1.1, you can uninstall any 12 Version 2.1.1

17 Installation Notes Tivoli Decision Support 2.0 patches and Tivoli Decision Support 2.0. Use Add/Remove Programs in the Control Panel to uninstall these products. You must uninstall Cognos PowerPlay 5.2 before using Tivoli Decision Support 2.1.x. Refer to the Cognos documentation that was shipped with Tivoli Decision Support 2.0 for uninstalling Cognos PowerPlay 5.2. Some Tivoli Decision Support registry keys are needed for Tivoli Decision Support Uninstalling Tivoli Decision Support 2.0 removes these registry keys. You must use PathManager.exe to refresh the registry keys for Tivoli Decision Support Use the Path Manager utility to refresh the Tivoli Decision Support registry keys after uninstalling Tivoli Decision Support 2.0 by performing the following steps: a. Navigate to the Tivoli Decision Support Discovery Administrator installation folder. The default folder is c:\program Files\TDS 2.1. b. Double-click PathManager.exe. c. On the Tools menu, click Refresh Registry after 2.0 Uninstall. d. Click OK on the message box informing you that the registry keys were refreshed. e. Click Exit. 6. Install Tivoli Decision Support Discovery Administrator on a machine running the Windows NT 4.0 operating system. If you install the Discovery Administrator on a machine running the Windows 95 or Windows 98 operating system, the Tivoli Decision Support Process Scheduler service cannot be used to automate cube building and publishing functions, and performance might be adversely affected. Tivoli Decision Support Release Notes 13

18 Internationalization Issues 7. Reinstall your Oracle or SQL Server client if you receive the following error messages while installing Tivoli Decision Support 2.1.1: File(s) failed to self-register: c:\program Files\Common Files\System\OLE DB\MSDASQL.DLL You do not have to reinstall Tivoli Decision Support. Internationalization Issues Tivoli Decision Support is provided only in English and is supported only in an English locale. Known Product Limitations and Workarounds The following items are known limitations and workarounds for Tivoli Decision Support, Version Installation Limitations and Workarounds 1. During the Tivoli Decision Support installation to a file server, the Unable to Register Controls error message is received. Workaround: This is a harmless error message and has nothing to do with the registry or any of its controls. It can be ignored and the installation can be continued. 2. During the Tivoli Decision Support installation procedure for the Shared Data component to a file server, you receive the Error #3 error message. Workaround: This error message most often occurs because the file server does not support long file names, a requirement for Tivoli Decision Support Cancel the installation setup and install the product on a file server that supports long file names. Discovery Administrator Limitations and Workarounds 1. If you have more than one installation of Tivoli Decision Support Discovery Administrator, and your discovery guide uses an 14 Version 2.1.1

19 Known Product Limitations and Workarounds ActiveX component, you must use RegSvr32.exe to register the component on the machine with the Discovery Administrator that was not used to install the discovery guide. Workaround: To register an ActiveX dynamic link library (DLL), follow these steps: a. Exit Tivoli Decision Support and any Cognos applications you are using. b. Open an MS-DOS window. c. Navigate to the c:\program Files\TDS 2.1\ActiveX directory, which contains the ActiveX component. d. Type the following command to register the ActiveX component: RegSvr32.exe <filename>.dll 2. When creating a new category parameter using the Add Parameter wizard, you are required to add at least two categories to the parameter before you can save it. This behavior only occurs if the Toggle Wizard Use button is not selected. When creating a new category parameter without using the wizard (the Toggle Wizard Use button on the toolbar is not selected), the parameter can be saved with only one category. After you create the parameter with only one category, if you attempt to open the parameter by double-clicking it, you receive the following error message, and then the Discovery Administrator closes: Tivoli Discovery Administrator Run-time error 340. Control array element 1 does not exist. Workaround: Right-click the parameter and select Edit. After the window opens, add another category to the list of categories for this parameter. Click OK, and then double-click the parameter. It opens without problems. (CMVC-87068) Tivoli Decision Support Release Notes 15

20 Known Product Limitations and Workarounds 3. Depending on the amount of data in your databases, the cube building process can take a considerable length of time. This is due to the following factors: Each database query is run against every record in the database. The more records in existence, the longer the query time required. In addition to the basic query, the discovery guide performs calculations on every record in the database. The discovery guide calculations are of varying complexity that, in many cases, require additional queries and additional connections to the database. Therefore, during a cube build, the discovery guides are making multiple connections and pulling large amounts of information from the database. Workaround: Contact your database administrator to investigate the possibility of indexing your database as a performance enhancement. 4. When attempting to build a cube using an Oracle database, you receive the error message Table or view does not exist. Workaround: Using an SQL query tool such as SQLPlus, verify that the table specified in the error message exists. If the table does exist, verify that the table qualifier in the assigned data source is stored in the correct case. Oracle table qualifiers are case sensitive. 5. When attempting to build a cube, the following error message is received: TR2700: The columns query <query> do not match the datasource columns Workaround: A column was added to the query using the Discovery Administrator but was not added to the Cognos model (.pyg or.mdl file). Use the Cognos Transformer to add the column to the model. Refer to the Cognos documentation on the Tivoli Decision Support CD for information on adding columns to the model. 16 Version 2.1.1

21 Known Product Limitations and Workarounds Discovery Client Limitations and Workarounds 1. When attempting to launch a PowerPlay report (.ppr file) from the Discovery Interface, you receive the error message Unable to retrieve view. This error message indicates that a required multidimensional cube (.mdc) file associated with the view has not been built. Workaround: Close the report, and build the cube (.mdc file) using the Discovery Administrator. 2. The publishing task generates the following error message: Error Error Publishing Task Occasionally, you might receive this error message if a user has a report open in the Discovery Interface while a publishing task is attempting to publish the report. Workaround: Close the report, and rerun the publishing task. You can also reschedule your publishing task to run during a time when users are not accessing the reports. See the Tivoli Decision Support Administrator Guide section that discusses publishing to HTML. 3. APAR IY08314: When executing the Publish to HTML task and specifying Graphic Image, the resulting.htm and.jpg files have the following problems: Some graphical data is truncated, resulting in missing data from the report. Scroll bars are not displayed on the.htm and.jpg graphical output. This is a known limitation of PowerPlay 6.5. PowerPlay creates a bitmap image of what is displayed on the screen and then converts the image to an HTML file. Workaround: Maximize the screen resolution before publishing to HTML. Note: The results of publishing to HTML are dependent on the machine that performs the publishing action. For best results, maximize the size of the view pane by selecting the Full Screen button on the Discovery Interface toolbar Tivoli Decision Support Release Notes 17

22 Known Product Limitations and Workarounds or clicking Full Screen from the View menu. If necessary, change the resolution of your display. If the source machine is set to a high resolution, the output might be difficult to read by users whose machines are set to a lower resolution. If the Publish to HTML task is scheduled to run through the Tivoli Decision Support Process Scheduler, you cannot change the appearance of the output. 4. APAR IY08315: You cannot specify the size of the.htm and.jpg output files created when publishing a graphic image using the Publish to HTML task in the Discovery Interface or when scheduling a Publish to HTML task in the Discovery Administrator. This is a known limitation of PowerPlay 6.5. PowerPlay creates a bitmap image of what is displayed on the screen and then converts the image to an HTML file. Workaround: Maximize the screen resolution before publishing to HTML. 5. APAR IY14404: The message Drop Columns Here is sometimes displayed on PowerPlay reports. This is a known Cognos PowerPlay 6.5 limitation (reference Cognos bug report #312092). 6. When the user selects the Powerplay Preferences option from the File menu, a dialog box titled Preferences is displayed. If this dialog box is being displayed and the user opens another application or switches to an already open application and then switches back to the Discovery Interface, the Discovery Interface locks. This PowerPlay 6.5 OLE Automation error has been reported to Cognos. Use the Windows Task Manager to close the Tivoli Discovery Interface and the Preferences dialog box. 7. Column and Row labels are blank when publishing a report to a printer. This Cognos PowerPlay 6.5 OLE Automation error was introduced by changes made to the PowerPlay Print Object for 18 Version 2.1.1

23 Known Product Limitations and Workarounds PowerPlay 6.5 RBF 3, which is installed by Tivoli Decision Support Patch 2.1-TDS-0005 (reference Cognos bug report # ). Users with access to the Tivoli Decision Support 2.1 CD can uninstall PowerPlay 6.5 RBF 3 and then reinstall PowerPlay 6.5 RBF 1 from the Tivoli Decision Support 2.1 CD. 8. APAR IY11681: The View menu in the Discovery Interface displays the Page Layout, Page Width, and Dimension Viewer options as unavailable. This is a known Cognos PowerPlay 6.5 OLE Automation limitation (reference Cognos bug report # ). These options are not supported by Cognos OLE Automation and should not be displayed. Process Scheduling Limitations and Workarounds Attention: In Tivoli Decision Support, Version 2.0, the process scheduling function was provided by the Tivoli Task Server. Do not use the Tivoli Task Server in Version 2.1.x. If you install the Discovery Administrator component on a system running the Windows NT operating system, you must use the Process Scheduler service. If you installed the Discovery Administrator component on a system running the Windows 95 or Windows 98 operating system, use the Cognos Scheduler instead of the Tivoli Task Server. To start the Cognos Scheduler, from the Start menu, select Programs Cognos PowerPlay 6.5 Scheduler. For information about the Cognos Scheduler, refer to the Cognos documentation. For additional information about the Process Scheduler or the Tivoli Task Server, refer to the Tivoli Decision Support Administrator Guide. 1. Tivoli Decision Support Process Scheduler fails because the shared source file path registry entry has not been set. Workaround: If you install Tivoli Decision Support Discovery Administrator on one machine and the shared data component on another machine, the Tivoli Decision Support Process Scheduler does not start until you start either the Discovery Administrator Tivoli Decision Support Release Notes 19

24 Known Product Limitations and Workarounds or the Discovery Interface on that machine and set the shared source file path. Refer to the Tivoli Decision Support Administrator Guide for more information on setting the shared source file path. The Tivoli Decision Support Process Scheduler is then able to start because a registry entry has been created for the shared source file path. 2. If you change the Tivoli Decision Support shared source file path, the Tivoli Decision Support Process Scheduler service might not start the scheduled tasks using the new shared source file path. Workaround: When you change the shared source file path, you must stop and restart the Tivoli Decision Support Process Scheduler service to update the shared source file path setting used by this service. Unless you stop and restart the service, the service continues to use the old source file path. Step-by-step procedures for using this feature are provided in the Tivoli Decision Support Administrator Guide in the section that discusses starting and stopping the Tivoli Decision Support Process Scheduler service. General Limitations and Workarounds 1. During installation of Tivoli Decision Support or when attempting to start the Discovery Interface, Discovery Administrator, or Discovery Publisher, the following error messages are received: 339 error Component xxxxxxx not correctly registered 429 error Active X component cannot create object This indicates that a.dll file or an ActiveX component is not registered or does not exist. Workaround: Back up all modified files, including.pyg,.ppr,.rpt,.mdl, and.mdb files. Then reinstall Tivoli Decision Support, or manually register the file using Regsvr32.exe. 2. The report headers do not appear on the PowerPlay reports because the TX4OLE.OCX file did not register correctly during 20 Version 2.1.1

25 Defects Fixed for Version the installation of Cognos 6.5. You must register the TX4OLE.OCX file. Workaround: To register the TX4OLE.OCX file: a. Exit Tivoli Decision Support and any Cognos applications you are using. b. Open an MS-DOS window. c. Navigate to the PowerPlay 6.5 installation folder, by default: c:\program Files\Cognos\PowerPlay 6.5 d. Type the following command to register the OCX file: RegSvr32.exe TX4OLE.OCX Defects Fixed for Version APAR IC26020: For the Tivoli Decision Support for Application Performance 1.0 Discovery Guide, PowerPlay cubes no longer fail during the cube transform process. The Cube Transform Status window no longer displays the following message: (TR2605) Transformer can t process this model. It uses features that are part of a more comprehensive edition than the one you have installed. Refer to the documentation for a description of the 4 available editions [->OK]. APAR IY04974: When you open a view in the Discovery Interface, move the legend box, and click the Print button, the following error message is no longer displayed: Run-time Error '3015' There is no display for the current report. Selecting OK displays the Print dialog box with an OK and a Cancel button. The application hangs until it is shut down through the Windows NT Task Manager. APAR IY07172 (Cognos Fix # ): PowerPlay report legends are printed when the Include Legend check box on the Options tab of the Print dialog is checked. Tivoli Decision Support Release Notes 21

26 Defects Fixed for Version APAR IY07217: When building a cube using a rolling time period, the Tivoli Decision Support Discovery Administrator writes the correct date into the current date file. APAR IY07571: When creating a new view based on a PowerPlay report, the new view displays the correct icon in the topic map. APAR IY08429: During database export, string fields that contain double-quoted text are now exported to Comma Separated Values (CSV) format according to the American National Standards Institute (ANSI) (SQL2/SQL92) standards. APAR IY10590: Cubes scheduled to be built automatically using the Tivoli Decision Support Process Scheduler service on Windows NT systems get built when the cube name contains any of the eight invalid file name characters: \ / : *? < > The TDS_CubeBuild.log file no longer contains the following error: <date> <time> [Scheduled Task Name] - ERROR : Cube [cube name containing the invalid character] appears to be in process of being built or deployed...aborting APAR IY11367: Multilayered views now publish to HTML properly when you create a scheduled task in the Discovery Administrator and select the Publish Now option or set up a scheduled time for the task to be published. The Web files (.htm,.jpg) are created. APAR IY11820: When you publish to HTML through the Tivoli Decision Support Process Scheduler service as a scheduled task in the Discovery Administrator or select the Publish now option for a scheduled task in the Discovery Administrator, the legend is resized and is properly displayed in the HTML file. APAR IY13901: When adding a scheduled task in the Discovery Administrator, you must enter a name for the scheduled task. If you enter a name that contains a forward slash (/), the scheduled task no longer writes the following error message to the 22 Version 2.1.1

27 Defects Fixed for Version TDS_CubeBuild.log file in the Discovery Administrator directory each time the scheduled task is executed: Schedule not found in database. For the Tivoli Decision Support for Storage Management Analysis 1.1 Discovery Guide, two of the Seagate Crystal Reports views, What potential problems exist in my server environment? and What is the status of scheduled administrative operations?, now open. (CMVC-23209) The reference to the SA-Script report has been removed. (CMVC-62538) You can apply changes more than once per session. If the shared source directory exists in two separate locations, you can change between the two locations using the same instance of the Path Manager utility. (CMVC-78886) You can set the path to a mapped network drive. (CMVC-80911) When trying to connect to a shared data drive, the following error message is no longer displayed: Unable to connect to the data source. The database does not exist or is read only. (CMVC-81071) The administrative users are not required to specify the user name, password, and the network share name that is used by the Tivoli Decision Support Process Scheduler service to create a network connection. (CMVC-81616) The option on the Tools menu that is used to reregister the Microsoft data access objects (DAO) library file dao350.dll works if the path to the file contains a space. (CMVC-81727) Source code is converted after upgrading to a new version of the programming language. (CMVC-83875) The Get Categories button on the Ranking properties page has been fixed. (CMVC-84634) You can now delete discovery guides. (CMVC-84637) Tivoli Decision Support Release Notes 23

28 Tivoli Decision Support Documentation The Re-register MS DAO Library option has been removed from the Tools menu. This option was disabled in patch 2.1-TDS (CMVC-84761) When you enter an invalid path in one of the entry fields on the Paths tab and then select the Service Login tab, an error message is displayed and the Service Login tab is not displayed. (CMVC-84808) If the name of the Tivoli Decision Support shared data directory contains an apostrophe, the export procedure no longer fails with the following error message: Error: Syntax error in FROM clause. (CMVC ) The discovery guide export process no longer fails if any of the Tivoli-supplied roles are customized by a change in name, description, or both. The following error message is no longer received: Error: The changes you requested to the table were not successful because they would create duplicate values in the index, primary key, or relationship...source: DAO.Indexes (CMVC ) The Drop Bars Here string is no longer displayed on the X-axis when a report created in PowerPlay 5.21 reads all new data in the input file (CSV file). (CMVC ) (Cognos Fix # ) Tivoli Decision Support Documentation Books in This Set In addition to this book, the Tivoli Decision Support documentation set includes other books that might help you: Tivoli Decision Support Installation Guide This book provides step-by-step installation procedures for the Discovery Administrator, Discovery Interface, and Cognos 24 Version 2.1.1

29 Online Books Tivoli Decision Support Documentation PowerPlay. This book lists system requirements for Tivoli Decision Support and its components and provides procedures for setting up Tivoli Decision Support in stand-alone mode and in network mode. Tivoli Decision Support Administrator Guide This book explains the features of the Tivoli Discovery Administrator. This book describes topics such as how to use the Discovery Administrator, how to connect a data source, how to manually or automatically create cubes, and how to schedule tasks. Tivoli Decision Support User s Guide This book discusses the basic features and concepts of Tivoli Decision Support for end users. The book introduces the Discovery Interface and describes Tivoli Decision Support capabilities. The book also explains how to open and work with different types of views and configure Tivoli Decision Support to display data in the desired format. Tivoli Decision Support Advanced Topics This book describes advanced topics for using Tivoli Decision Support. Topics include creating and modifying cubes, queries, and reports. This book can be downloaded from the Tivoli Customer Support Web site. Updates to the Tivoli Decision Support documentation can be downloaded from the Tivoli Customer Support Web site. For information about how to navigate to the Tivoli Customer Support Web site, see Contacting Customer Support on page 2. All the books in the Tivoli Decision Support documentation set are available as online books from the Tivoli Customer Support Web site. To view these documents, use the Adobe Acrobat Reader that can be installed from the Tivoli Decision Support CD. For more information about installing Adobe Acrobat Reader, refer to the Tivoli Decision Support Installation Guide. Tivoli Decision Support Release Notes 25

30 Tivoli Decision Support Documentation The online books are also available on the Tivoli Decision Support CD in the \Docs\Pdf folder. Information about Third-party Products and Documentation Tivoli Systems documents products created at Tivoli Systems. Sometimes, products created by other software manufacturers are shipped with Tivoli products. Because Tivoli Systems does not support products created by other software manufacturers, contact those manufacturers if you need assistance while using their software. Cognos PowerPlay and Cognos Transformer Documentation The Cognos PowerPlay and Transformer documentation is automatically installed during the Cognos PowerPlay and Transformer installation procedure. Refer to these documents for detailed information about these products. Access this documentation from the Start menu by selecting Programs Cognos PowerPlay 6.5 Reference. Documentation Changes Tivoli Decision Support Installation Guide For release 2.1.1, the most recent version of the Tivoli Decision Support Installation Guide is provided with the Tivoli Decision Support 2.1.x-TDS-0006 patch and is located on the Tivoli Customer Support website. Tivoli Decision Support User s Guide For release 2.1.1, the most recent version of the Tivoli Decision Support User s Guide is provided with the Tivoli Decision Support 2.1.x-TDS-0006 patch and is located on the Tivoli Customer Support website. 26 Version 2.1.1

31 Tivoli Decision Support Documentation Tivoli Decision Support Advanced Topics Guide For release 2.1.1, the most recent version of the Tivoli Decision Support Advanced Topics Guide is provided with the Tivoli Decision Support 2.1.x-TDS-0006 patch and is located on the Tivoli Customer Support website. Tivoli Decision Support Administrator Guide For release 2.1.1, the most recent version of the Tivoli Decision Support Administrator Guide is provided with the Tivoli Decision Support 2.1.x-TDS-0006 patch and is located on the Tivoli Customer Support website. For updated information about the Process Scheduler Service, refer to the Managing the Process Scheduler Service section in the most recent version. This supersedes the information located in the Process Scheduler Service section in previous versions. Tivoli Decision Support Release Notes 27

32 Tivoli Decision Support Documentation 28 Version 2.1.1