IBM Cognos TM1

Version 9.5

Release Notes

Product InformationThis document applies to IBM Cognos TM1 Version 9.5 and may also apply to subsequent releases. To check for newer versions of this document,visit the IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

CopyrightLicensed Materials - Property of IBM© Copyright IBM Corp. 2007, 2010.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.IBM, the IBM logo, ibm.com, TM1, and Cognos are trademarks or registered trademarks of International Business Machines Corp., in manyjurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks isavailable on the Web at www.ibm.com/legal/copytrade.shtml.Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated inthe United States, and/or other countries.Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.UNIX is a registered trademark of The Open Group in the United States and other countries.Microsoft product screen shot(s) used with permission from Microsoft.

Table of Contents

Chapter 1: Readme Updates By Date 5Updated: April 27, 2010 5

Known issue - Interoperabilty 5

Chapter 2: IBM Cognos TM1 9.5 Release Notes 7Review the Release Note Update 7Review the Fix List 7End-of-life statements 7

TM1 In-Spreadsheet Browser 7TM1 9.0, TM1 9.1 7TM1 Workflow 7

Installation and Configuration 8IIS must be installed before .NET Framework 8TM1 Workflow x64 installation procedure 8

Known issues for IBM Cognos TM1 9.5 11Clients 11TM1 Contributor 12Integration 14TM1 14

Index 19

Licensed Materials – Property of IBM3© Copyright IBM Corp. 2007, 2010.

4 IBM Cognos TM1

Table of Contents

Chapter 1: Readme Updates By Date

This section contains cross references to known issues and documentation updates that were made

after October 8, 2009.

Updated: April 27, 2010The following Release Notes update was made on April 27, 2010.

Known issue - Interoperabilty● Updated - Configuring Interoperability Between IBM Cognos 8 BI 8.4.1 and Other Cognos

Products (8.4 or 8.5)

Licensed Materials – Property of IBM5© Copyright IBM Corp. 2007, 2010.

6 IBM Cognos TM1

Chapter 1: Readme Updates By Date

Chapter 2: IBM Cognos TM1 9.5 Release Notes

This Release Note document contains late-breaking information, including installation issues, lim-

itations, and known issues.

Review the Release Note UpdateThe Release Note Update contains issues that arise after the product is released. To find updates

to the Release Notes and product documentation:

Steps

1. Find the product’s Information Center at http:/publib.boulder.ibm.com.infocenter.cogic/v1r0m0/

index.jsp).

2. Search or navigate to Release Notes Update for your product.

Review the Fix ListThe fix list is a compilation of the known issues that were addressed in this release. The fix list for

this product can be found at:

http://public.dhe.ibm.com/software/data/cognos/support/docs/en/tm1/9.5/tm1_9_5_fix_list.pdf

End-of-life statementsThe following sections note IBM® Cognos® TM1® platforms/features that are no longer supported

in TM1 9.5 or will not be supported in future releases.

TM1 In-Spreadsheet BrowserAs of this 9.5 release, the TM1® In-Spreadsheet Browser is no longer actively supported.

TM1 9.0, TM1 9.1As of December 31, 2010 IBM Cognos will no longer support the 9.0 and 9.1 versions of the TM1®

software.

TM1 WorkflowIn some upcoming major release following TM1® 9.5, we will no longer support TM1 Workflow.

The core capabilities of TM1 Workflow will be provided through alternative Workflow function-

ality in some future TM1 release.

Licensed Materials – Property of IBM7© Copyright IBM Corp. 2007, 2010.

Installation and ConfigurationThe following section contains information that pertains to IBM® Cognos® TM1® 9.5 installation

and configuration.

IIS must be installed before .NET FrameworkMicrosoft® Internet Information Services (IIS) must be installed before installing the .NET 3.5

framework that is required for TM1® Web.

If you install the .NET 3.5 framework before installing IIS, the TM1 Web installation will fail with

an ASPNET error.

TM1 Workflow x64 installation procedureYou must adhere to the following installation order when installing the x64 version of TM1®

Workflow.

Installing web components only

If you want to implement only the web components of TM1® Workflow, install the x64 version of

TM1 first, followed by the x64 version of TM1 Workflow.

Installing both web and Excel components

If you want to perform a complete TM1® Workflow installation on x64, including both web com-

ponents and the Microsoft Excel add-in, install the following items in order.

Steps

1. TM1 x64 version, full install

2. TM1 x86 version, Perspectives only

3. TM1 Workflow, x64 version

Configuring Interoperability Between IBM Cognos 8 BI 8.4.1 and Other Cognos Products (8.4 or 8.5)

IBM® Cognos® products from version 8.4 or 8.5 and IBM Cognos BI version 8.4.1 share a common

architecture and install different versions of the same components.

IBM Cognos products from version 8.4 or 8.5 will work with IBM Cognos BI version 8.4.1 if the

8.4 or 8.5 versions of the IBM Cognos BI components are not running in the IBM Cognos BI 8.4.1

environment.

To ensure that the version 8.4 or 8.5 and version 8.4.1 products work together, you must

❑ copy gateway files from the version 8.4 or 8.5 environment to the IBM Cognos BI 8.4.1 envi-

ronment

❑ disable the common components in the 8.4 or 8.5 environment

❑ configure the IBM Cognos products from version 8.4 or 8.5 to use the IBM Cognos BI 8.4.1

environment

8 IBM Cognos TM1

Chapter 2: IBM Cognos TM1 9.5 Release Notes

❑ configure and start the services so that the shared components of only version 8.4.1 are running

Interoperability between IBM Cognos 8 BI, Version 8.4.1 and IBM Cognos 8 Planning,Version 8.4.1

For compatibility, if you upgrade to IBM® Cognos® BI, Version 8.4.1, we recommend that you also

upgrade to IBM Cognos Planning, Version 8.4.1.

Configuring Interoperability Between IBM Cognos 8 BI, Version 8.4.1 and IBM CognosController 8.4 or 8.5

Because you cannot install IBM® Controller 8.4 or 8.5 components into the same location as IBM

Cognos® 8 BI 8.4.1, you must install the BI and Controller products in separate locations and then

manually register the Controller link in IBM Cognos 8 BI.

The following installation options are supported:

● IBM Cognos 8 BI version 8.4 and IBM Cognos 8 Controller 8.4 or 8.5 are installed in separate

locations, and you upgrade to IBM Cognos 8 BI version 8.4.1. Users access Controller through

IBM Cognos Connection in IBM Cognos 8 BI.

● IBM Cognos 8 Controller 8.4 or 8.5 is installed, and now you are installing IBM Cognos 8 BI

Version 8.4.1 into a separate location. Users access Controller through IBM Cognos Connection

in IBM Cognos 8 BI.

● IBM Cognos 8 BI (version 8.4.1 or version 8.4 which was upgraded to version 8.4.1) is installed,

and now you are installing IBM Cognos 8 Controller 8.4 or 8.5 into a separate location. Users

access Controller through IBM Cognos Connection in IBM Cognos 8 BI.

After you install both products to comply with one of the installation options, follow the steps

below.

Steps

1. Enable the common components in the BI environment:

● In the BI Content Manager location, enable the Content Manager service.

● In the BI Application Tier Components location, enable the report service, portal service,

event service, and dispatcher service, plus other common services as desired.

2. Disable the common components in the Controller environment:

● In the Controller Content Manager location, disable the Content Manager service.

● In the Controller Application Tier Components location, disable the report service, portal

service, event service, and dispatcher service, plus other common services that are enabled

in the BI Application Tier Components location.

3. Configure the Controller environment to use the BI resources by configuring URI properties in

the Controller Application Tier Components location:

● Configure the Content Manager URI to point to the BI Content Manager.

● Configure the Gateway URI to point to the BI Gateway.

Release Notes 9

Chapter 2: IBM Cognos TM1 9.5 Release Notes

4. Register the Controller link in IBM Cognos 8 BI by following the instructions in IBM Technote

#1345546 at http://www-01.ibm.com/support/docview.wss?rs=0&uid=swg21345546.

Configuring Interoperability Between IBM Cognos 8 BI, Version 8.4.1 and IBM CognosTM1 Products, Version 9.4 or Version 9.5

To ensure that access to version 9.4 or 9.5 of IBM® Cognos® TM1® works with dashboards in IBM

Cognos 8 BI version 8.4.1, you must install the BI and TM1 portlets products in separate locations.

Then you must carefully copy some of the TM1 filesfrom the TM1 portlet installation locations to

the BI server locations.

The following installation options are supported:

● IBM Cognos 8 BI version 8.4 and IBM Cognos TM1 products are installed in separate locations,

and you upgrade to IBM Cognos 8 BI version 8.4.1.

● IBM Cognos 8 BI (version 8.4.1 or version 8.4 which was upgraded to version 8.4.1) is installed,

and now you are installing IBM Cognos TM1 products in a separate location.

Steps

1. Follow the instructions in the IBM Cognos 8 BI Installation and Configuration Guide to install

or upgrade to IBM Cognos 8 BI, version 8.4.1 in a separate location from IBM Cognos TM1,

version 9.x.

2. If you are adding IBM Cognos TM1 for the first time, install IBM Cognos TM1 in a separate

location.

Tip: Ensure that you configure the variables_TM1.xml file before you copy files in the following

steps. For more information, see the IBM Cognos TM1 Fragments Installation and Configuration

Guide.

3. Stop the services on the BI computers.

4. In the TM1 installation location, copy the following files from the TM1_locationto

theBI_location on the BI gateway computer:

...\webcontent\fragments\tm1viewers\fdom.js

...\webcontent\fragments\tm1viewers\tm1skin.js

5. In the TM1 installation location, copy the following files from TM1_location to the BI_loca-

tionon the BI Application Tier Components computers where the BI presentation service is

enabled:

...\templates\ps\portal\variables.xsd

...\templates\ps\portal\variables_TM1.xml

...\templates\ps\tm1\messages\tm1_*.xml

...\templates\ps\tm1\*

...\webapps\p2pd\WEB-INF\fragments\producers\messages\tm1*.xml

...\webapps\p2pd\WEB-INF\fragments\producers\tm1viewers\*

10 IBM Cognos TM1

Chapter 2: IBM Cognos TM1 9.5 Release Notes

...\webapps\p2pd\WEB-INF\lib\tm1f_javastage.jar

6. Start the BI services.

Known issues for IBM Cognos TM1 9.5

Clients

Cube Viewer

Long date format does not display correctly in the TM1 Architect Cube Viewer for non-English language formatting

The long date format does not display correctly in the TM1® Architect cube viewer for non-English

languages. In some cases, the long date format displays in English only. Additionally, if you use the

Number Format dialog box for a cube view and the Sample preview of the selected date format

does not display, then that date format will also not display in the cube view.

Excel 2007

Exporting a slice from TM1 Web to Excel 2007 on a Windows Vista system

Excel may hang when exporting a slice from TM1® Web to Excel 2007 on a Windows® Vista system.

This can happen when using Excel 2007 with TM1 Perspectives and you click Open on the web

browser’s Download/Open dialog box.

This is not an issue if Excel is not open or TM1 Perspectives is not loaded. This is also not an issue

if you click Save instead of Open on the download dialog box.

Unsupported Excel 2007 features

TM1® Web does not support Excel features that were introduced in Excel 2007, such as enhanced

conditional formatting.

Pivot tables

Pivot tables are fully functional in Excel 2003. Due to a new data access component in Excel 2007,

pivot tables are currently not supported.

Excel 2007 column and rows

Excel 2007 expanded its row and column capabilities, however, TM1® Web does not support these

expanded capabilities. The previous Excel 2003 row and column parameters are used in TM1 Web

for this release.

Customizing the Quick Access Toolbar

When customizing the Quick Access Toolbar, if you select the Customize TM1® tab from the

Microsoft Office/Excel options menu, Visual Basic displays an error.

Release Notes 11

Chapter 2: IBM Cognos TM1 9.5 Release Notes

Slice to Excel

When ExcelWebPublishEnabled is set to T, slicing may cause a message of "File error: Data may

have been lost" to mistakenly display. The data is not lost in this case, only the display of the message

is incorrect.

Set ExcelWebPublishEnabled=F to prevent these error messages from displaying.

TM1 Contributor

Vista TM1 Contributor Administration

On Windows® Vista, the TM1 Contributributor Administration process does not properly stop

after opening then closing the TM1® Contributor Workflow page.

If the TM1 Contributor Administration process continues to run after closing the application, use

the task manager to manually stop the process.

Session timeout setting

If the session timeout and the TM1 Cam_passport check time are not set lower than the CAM session

timeout, the system cannot properly a detect CAM session termination. As a result In this case the

CAM session has actually terminated so no changes to the subset take effect.

Be sure to set the session timeout and TM1 CAM_passport check time to a time interval that is less

than the CAM session timeout value.

Multiple TM1 Contributor Administration logout messages

Logging out of the TM1® Contributor Administration can result in two warning messages.

Accept these warnings to log out.

Incorrect time out message

If your session times out when you are on the Rights page, a warning message displays, but you

must manually return to the login page to log back in.

Administration console

Although a warning message displays when you try to save an application that has the same name

as an existing application, you can create a new application using the same name as an existing

application. This is incorrect and will cause problems.

Do not create an application using the same name as an existing application. A user cannot save 2

applications with the same file name, but the name of the application can be duplicated.

Extra submit or reject clicks can result in error messages

Submitting or rejecting an item can take a few moments to complete when the TM1® server is very

busy. If you click Submit or Reject while waiting for the original Submit to complete, you will

receive an error message every time you hit Submit or Reject.To break this cycle, log out, close the

web client, then reopen.

12 IBM Cognos TM1

Chapter 2: IBM Cognos TM1 9.5 Release Notes

Sandbox delete

Although the name "default" displays in the Delete Sandbox listing, you cannot delete the default,

or base, sandbox.

Deactivating an application

If an application is deactivated while users are still logged into that application, the data they enter

after deactivation is still uploaded to the server.

Ensure that all users are logged out of an application before deactivating it.

Multi-cell paste into consolidation cells

Pasting multiple cells onto cells that include a consolidation fails and generates an error message

indicating that the paste cannot be done.

To paste onto a consolidated cell, copy a single cell at a time.

Submitting

In TM1® Contributor, if ownership of a node is taken by a user on a node that is currently owned

by a different user, even though the Submit button is available, the first user cannot submit to a

node that is currently owned by another user.

Ownership change

When two users have submit rights to the same node, the second user may take ownership of the

node without the first receiving any warning that ownership has changed.

Parent to child node change

If an approval hierarchy node is changed from a parent node to a child node, you must log out and

log back in to be able to take ownership of the changed node.

Under certain circumstances you must log out and log back in to be able to take ownership.

Status of a rejected node

Although a Rejected node's children may properly reflect a status of Reviewed, the parent consoli-

dation node may continue to indicate its status as not yet Reviewed.

Using a dynamic subset approval hierarchy

Opening the TM1® Contributor TM1 Contributor Workflow page may result in an error if the

approval hierarchy is a dynamic subset.

To prevent this error, you can (a) make your approval hierarchy a static subset or (b) you can also

avoid this error by indexing the approval hierarchy first within the dimension. Ensuring that your

approval hierarchy is loaded or created prior to the creation or loading of any alternate hierarchies

will also avoid this issue.

View Filter

Activating a view filter does not persist after closing and reopening a node. You must reset any filters

once you leave a view.

Release Notes 13

Chapter 2: IBM Cognos TM1 9.5 Release Notes

Integration

Setting up an Environment Variable for TM1 as a Data Source

Your installation includes IBM Cognos 8 BI Server and TM1® data sources on AIX, Solaris, or

Linux on System Z. After configuring one or more TM1 data sources, you receive the following

error message:

TM1-ERR-0055 The TM1 server <server_name> is no longer responding.

To use TM1 as a data source, you must set the TM1_PATH environment variable on the BI server

to point to the bin directory of IBM Cognos 8 BI Server.

For example, TM1_PATH=c8_location/bin

TM1

Action Button for a TI Process with Parameters Stops Working after Saving the Worksheet in Excel2007

If a TM1® Action button that runs a TurboIntegrator process with parameter inputs is created and

saved in an Excel 2007 worksheet, the Action button stops working after the file is saved and re-

opened.

As a workaround when using a TM1 Action button in Excel 2007 to run a TI process that requires

parameters, save the worksheet file in the .xls format.

TEXT function in TM1Web

The TEXT function changes a cell's contents to text in Excel, however, when you publish a sheet

that uses TEXT to TM1® Web, the format displays the placeholders instead of the text value. For

example, if you write a number such as 38443 in a cell then apply the TEXT function to it (

=TEXT(C4; MMMM YYY) the value in Excel becomes April 2005. If you publish this sheet in

TM1 Web, the cell becomes April YYY

Invalidate Rule configuration parameter

The configuration parameter InvalidateRuleDependenciesOnDataChange that was available in a

limited number of 9.4.1 hotfixes is no longer necessary. The underlying issue that this parameter

addressed has been fix in 9.5.

Oracle ODBC connectivity on UNIX

TM1® requires DataDirect drivers (not provided with TM1) for use with the Oracle ODBC connec-

tion on UNIX®.

TurboIntegrator process views

A TurboIntegrator process fails to zero out a portion of a specified view in the following scenario:

1. Open the process for editing.

2. Click the Maps tab.

3. Click the Edit View button.

14 IBM Cognos TM1

Chapter 2: IBM Cognos TM1 9.5 Release Notes

4. Click Cancel.

At this point, the name of the view to be zeroed out is removed from the ViewName box. If you

execute the process, data will not be zeroed out from any view, possibly affecting subsequent pro-

cesses.

You can close TurboIntegrator and restart the TM1® server to restore the view in the ViewName

box.

DSN with Unicode and TM1

TI processes importing Unicode data from an Oracle database using the version 11g client/ODBC

driver can fail unless an option is specified when configuring the DSN.

To avoid problems with SqlFreeStmt SQL_CLOSE, check the Enable Closing Cursors option on

the Application tab when configuring the DSN of the Oracle 11g ODBC driver.This Oracle

behavior is documented in the Oracle support website.

Long strings, greater than 255 bytes

Long strings work in data input or SQL statements but not in object names (dimensions or elements).

Although the user interface allows input of long strings, processing them may cause a server crash

or truncation of data.

You cannot input long strings via Perspectives on Excel 2003 due to a limitation of the Excel 2003

API. However, you can input long strings via Perspectives on Excel 2007.

You can input long strings through TM1® Web even if you are using Excel 2003 on the web server.

MDX queries that pass long strings (> 255 bytes) as arguments to the following functions can cause

a TM1 server crash:

● CellPropertiesUpdateable

● Rank

● TM1FilterByPattern

PDFCamp driver and Vista User Account Control (UAC) settings

If you install TM1® on a Windows® Vista system where User Account Control (UAC) is enabled

and the Run this program as administrator is selected for the TM1 setup.exe file, the PDFCamp

driver for generating PDF files from TM1 is not installed correctly. This can cause all PDFs from

TM1 to be generated with a "Please purchase PDFcamp Printer" message.

The Run this program as administrator setting is located on the Compatibility tab when you right-

click on the TM1 setup.exe file and select Properties.

To resolve this PDFcamp issue, it is recommended that you install TM1 with the Windows Vista

UAC option disabled.

Incompatible versions

Using a newer TM1® client with an older TM1 Admin Server and/or TM1 server is not a supported

TM1 environment. If you use TM1 Perspectives/Architect 9.5 with older TM1 servers, you will

Release Notes 15

Chapter 2: IBM Cognos TM1 9.5 Release Notes

experience unexpected behavior; the TM1 client may hang or not even open when started. If the

TM1 client does open, older servers may be listed in the Server Explorer, but the following error

displays when you try to log in: Log in Failed: SystemServerConnectionInvalid.

Error saving some active forms in Excel when file name is same as first sheet name

The error "That name is not valid" may display when recalculating an Active Form in Excel if the

worksheet has been saved with a file name that is the same as the one and only sheet in the worksheet.

As a workaround, do not use the same name for your Excel worksheet as the first sheet in the

worksheet when it contains an Active Form.

IBM AIX - Server error messages require UTF-8

Server error messages may display as garbled if the TM1® server system locale encoding is anything

other than UTF-8.

As a workaround, change the TM1 server system locale encoding to codepage UTF-8.

TM1 Workflow

Sophos anti-virus package may prevent TM1 Workflow from loading properly

The Sophos Ant-Virus package may prevent TM1® Workflow from loading properly.

To work around this problem, add the TM1_install\bin folder to the list of on-demand exclusions

in Sophos.

TM1 Workflow on Excel 2007

If running TM1® Workflow on Excel 2007, IBM Cognos TM1 Perspectives (Tm1p.xla) must not

be configured to autoload as an Excel add-in. If IBM Cognos TM1 Perspectives is auto-loaded in

Excel, TM1 Workflow always loads the English version of the TM1 Workflow toolbar, even when

TM1 Workflow is configured for a different language.

To configure Excel 2007 to run TM1 Workflow:

1. Open the Excel Add-Ins dialog box.

2. Clear the checkbox next to IBM Cognos TM1 Perspectives.

3. Fill the checkbox next to TM1 Workflow.

4. Click OK.

5. Restart Excel.

Workflow Administration Console does not function after applying Microsoft securitybulletin MS09-032: Cumulative Security Update of ActiveX Kill Bits

After applying the security update associated with MS09-032: Cumulative Security Update of

ActiveX Kill Bits, the TM1® Workflow Administration Console ceases to function. Attempts to

open the Administration Console result in an error message, "Compile error in hidden module",

sometimes followed by an unexpected closing of TM1 Workflow.

16 IBM Cognos TM1

Chapter 2: IBM Cognos TM1 9.5 Release Notes

A solution to this problem is currently being developed and tested. Please contact customer support

for details on the availability of a hot fix for this issue.

Release Notes 17

Chapter 2: IBM Cognos TM1 9.5 Release Notes

18 IBM Cognos TM1

Chapter 2: IBM Cognos TM1 9.5 Release Notes

Index

Symbols.NET framework, 8

Aaction button, 14

active forms, 16

AIX, 16

CCognos 8, 14

configuration, 8

Ddata source

TM1 requirements, 14

dynamic subset, 13

EEOL, 7

Ffix list, 7

IIBM Cognos Controller

interoperability with IBM Cognos 8 BI, Version

8.4.1, 9

IIS, 8

incompatible versions, 15

In-Spreadsheet Browser, 7

installation, 8

interoperability

IBM Cognos BI 8.4.1 and IBM Cognos Controller

8.4 and 8.5 configuration requirements, 9

IBM Cognos BI 8.4.1 and IBM Cognos TM1 9.4

and 9.5 configuration requirements, 10

IBM Cognos Planning 8.4 and IBM Cognos BI 8.4.1

configuration requirements, 9

requirements for version 8.4 products with version

8.4.1 products, 8

InvalidateRuleDependenciesOnDataChange, 14

ISB, 7

Llogout messages, 12

Long date, 11

long strings, 15

MMicrosoft Excel 2007, 11

Nnaming application, 12

OODBC, 14

Ppivot tables, 11

Rreadme updates, 7

rejected node, 13

Ssession timeout, 12

TTEXT, 14

TM1, 14

data source requirements, 14

TM1_PATH, 14

TM1 9.0, 7

TM1 Contributor, 12

TM1-ERR-0055, 14

TM1 Workflow, 7, 16

TurboIntegrator, 14

UUnicode DSN, 15

Licensed Materials – Property of IBM19© Copyright IBM Corp. 2007, 2010.

Vview filter, 13

Vista, 11, 12, 15

WWorkflow

x64 installation, 8

Xx64

Workflow installation, 8

20 IBM Cognos TM1

Index