+ All Categories
Home > Documents > IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component...

IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component...

Date post: 27-Feb-2021
Category:
Upload: others
View: 2 times
Download: 0 times
Share this document with a friend
19
IBM Cognos TM1 Version 9.5.1 Release Notes
Transcript
Page 1: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

IBM Cognos TM1

Version 9.5.1

Release Notes

Page 2: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Product InformationThis document applies to IBM Cognos TM1 Version 9.5.1 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.Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.UNIX is a registered trademark of The Open Group in the United States and other countries.Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.Microsoft product screen shot(s) used with permission from Microsoft.

Page 3: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Table of Contents

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes 5Review the Fix List 5End-of-life statements 5

TM1 In-Spreadsheet Browser 5TM1 9.0, TM1 9.1 5TM1 Workflow 5Microsoft Internet Explorer 6 5

Software support 5LDAP Support 6IBM Cognos TM1 Package Connector 6

Installation and Configuration 6TM1 Fragments 6IIS must be installed before .NET Framework 6Fonts and images may not display correctly with some display resolutions 7Uninstall message may display incorrectly 7IBM Cognos TM1 Contributor Administration and IBM Cognos Planning Contributor

Web Clients on the same machine 7Font for TM1 Contributor Export to PDF 7Microsoft Windows 2008 7TM1 Package Connector 8

Known issues for IBM Cognos TM1 9.5.1 9Clients 9TM1 Contributor 11Integration 12TM1 13Job Queuing Configuration Parameters 15

New Features 16IBM Cognos TM1 Package Connector 16Personal Workspace and Sandbox Writeback Modes 16Capability Assignments 16Job Queuing 16Transaction Log Performance Enhancements 16Persistent Feeders 17Websheet and Paging 17New websheet column calculation setting 17

Index 19

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

Page 4: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

4 IBM Cognos TM1

Table of Contents

Page 5: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

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

itations, and known issues.

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://www.ibm.com/support/docview.wss?uid=swg27018352

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

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

TM1 In-Spreadsheet BrowserAs of TM1® 9.5.1, In-Spreadsheet Browser (ISB) support is classified as "compatible" which provides

full support of existing functionality. Exploring TM1 data in Microsoft Excel while in writeback

mode is valued by IBM and continued support is planned for this functionality.

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 IBM ® Cognos® TM1® 9.5, we will no longer support

TM1 Workflow. The core capabilities of TM1 Workflow will be provided through alternative

Workflow functionality in some future TM1 release.

Microsoft Internet Explorer 6IBM® Cognos® TM1® support for Microsoft® Internet Explorer 6 (IE 6) will be classified as "com-

patible" in the next Refresh Pack release of TM1. This means the IE 6 version of the browser software

will not be actively tested in our Quality Assurance testing, however operating on IE6 is fully sup-

ported. Support of IE6 will be deprecated in the next major release of TM1.

Software supportAs of TM1® 9.5.1, the following operating systems are supported:

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

Page 6: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Additional ConformanceComponent

Microsoft® Windows 7 operating system software.TM1 clients

Microsoft Windows Server 2008 R2 operating system software.TM1 servers

See the "Supported Hardware and Software Environments" link on the IBM® Cognos® TM1®

Information Center website for complete platform support information.

LDAP SupportLDAP is supported only on the Microsoft® Windows operating system software. You cannot use

LDAP authentication to access a UNIX® TM1® server.

IBM Cognos TM1 Package ConnectorThe IBM® Cognos® TM1® Package Connector is currently supported for use with IBM Cognos

Business Intelligence packages against SAP Business Warehouse data sources and dimensionally

modelled relational (DMR) packages.

For more information supported sources, see the IBM Cognos TM1 Software Environments link

on the IBM Cognos TM1 9.5.1 Information Center website.

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

and configuration.

TM1 FragmentsTo use TM1 Web portlets, TM1 Web no longer needs to be installed on the same machine as IBM

Cognos C8. The configuration settings now provide an additional property to enter the TM1 Web

URL to use. To use this new feature, you must also update the variables_TM1.xml file to reflect

the TM1 Web server used. The default behavior of this feature has not changed: if you prefer you

can continue to install the TM1 Web server on the C8 gateway and the Fragments will work as

they did in previous releases.

Although not required, uninstalling TM1 fragments before installing newer ones is highly recom-

mended to avoid confusion between portlets available for dashboards.

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.

6 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 7: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Fonts and images may not display correctly with some display resolutionsSome fonts and images in the TM1® Installation Wizard may not display correctly when installing

on a system with a high screen resolution of 1920 X 1200 with normal font size (96 DPI) or 1280

X 720 with large font size (120 DPI).

The installation will still function, but as a workaround, you can set your resolution to 1280 X

720 with normal font size (96 DPI) or lower.

Uninstall message may display incorrectlyDue to an MSI issue with UI dialogs when UTF-8 code is used, the message "Please wait while your

application uninstalls" may display as all zeros.

IBM Cognos TM1 Contributor Administration and IBMCognos Planning Contrib-utor Web Clients on the same machine

When IBM® Cognos® TM1® Contributor Administration Client and IBM Cognos 8.4 Planning

Contributor Web Client are installed on the same machine, the TM1 Contributor Administration

must be installed first to properly set the provisioning scenario. If you are installing TM1 Contrib-

utor Administration onto a machine that previously ran IBM Cognos Planning Web Client, use the

ModelingADT.msi to install.

Font for TM1 Contributor Export to PDFThe font to use for the PDF export in TM1® Contributor can be specified using the SyncfusionPDF-

ExportFont web.config parameter. If this parameter is not specified, the system detects the locale

the user is in and select an appropriate font. If the locale is not Chinese or Japanese, Arial is used.

Use this setting to override the language used when exporting in TM1 Contributor.

Microsoft Windows 2008

Vista or Windows Server 2008 needs IBM Cognos BI 8.4.1 FP 2 for TM1 Contributor

On Microsoft® Windows Server 2008 or Vista, TM1® Contributor requires a different tools.jar file

than the one provided by IBM® Cognos® BI 8.4.1 RP1. Before you can run TM1 Contributor from

within an IBM Cognos BI 8.4 RP1 installation on either Windows Server 2008 or Windows Vista

(that is, deploy the pmpsvc.war file to your Cognos 8 Apache Tomcat installation) you must upgrade

the tools.jar file that the IBM Cognos 8 Server Tomcat installation relies on.

If the tools.jar file is not the correct one, when you attempt to open the TM1 Contributor Portal

page an HTTP error code of 500 displays.

To correct this issue install the IBM Cognos BI 8.4.1 Fix Pack 2 which includes the version of

tools.jar that TM1 Contributor requires.

Or you can manually copy the file tools.jar from an installation of the Java™ 1.6 JRE to the location

of Java that your Tomcat installation relies upon.

Step to copy correct tools.jar file

1. Rename the existing copy of tools.jar to tools.jar.backup.

Release Notes 7

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 8: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

The tools.jar file is typically in the following location:

..\cognos\c8\tomcat4.1.27\common\lib

2. Locate the tools.jar file in your installation of Java 1.6 SE.

Java 1.6 is required for TM1 Contributor.

3. Copy the file tools.jar from your Java 1.6 installation to the location in step 1.

Disable UAC when running Integrated Login in Windows 2008

To use Integrated Login with TM1® Contributor on Windows 2008, you must first disable the User

Account Control (UAC). See the Microsoft® TechNet Library article 709691 for details on how to

disable the UAC.

Export to Excel or Export to pdf in Windows 2008

Due to a change in location of a Windows 2008 .dll file, when running TM1® Contributor on

Microsoft® Windows 2008, you must either copy the .dll to the c:\windows\system32 location or

add the following symbolic link to permit Export to Excel or Export to PDF to work.

Steps

1. Login to the system as an administrator. It is not sufficient to be a user who is part of the

administrator group.

2. In a command prompt cd to

c:\windows\system32

3. Enter the following command:

mklink iprop.dll c:\windows\syswow64\iprop.dll

This command creates a pointer to the original file required by TM1 Contributor.

If this link file is ever deleted, you must re-create the link to allow exports to work again.

TM1 Package ConnectorThe following items provide additional information about the IBM® Cognos® TM1® Package

Connector.

IBM Cognos TM1 Package Connector and multiple hierarchy with measure query behavior

The IBM® Cognos® TM1® Package Connector includes only one hierarchy per dimension when

issuing a measure query. If you select more than one hierarchy for a dimension and include measures

in your TurboIntegrator process, the TM1 Package Connector will issue multiple measure queries,

substituting each hierarchy in turn. This behavior is appropriate where the leaf-level members of

each hierarchy are distinct from each other.

If the leaf level members are the same in the hierarchies, you should create a TurboIntegrator process

selecting only one hierarchy per dimension along with the desired measures. Create a separate

process to merge multiple hierarchy structures into the same dimension.

8 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 9: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Invalid key errors when executing measure query

If you get "Invalid key" errors when executing a measure query using a segmenter prompt, ensure

that each characteristic in your SAP BW Info Query has its Display As setting set to Key. Otherwise

there may be a key mismatch between elements in the dimension and key values returned in the

measure query.

TM1CognosInterfacePath environment variable

The IBM® Cognos® TM1® Package Connector CognosTM1InterfacePath variable is required only

when using the TM1 Package Connector on UNIX®.

Known issues for IBM Cognos TM1 9.5.1

Clients

Using a mix of TM1 Contributor and other TM1 interfaces in a single TM1 Application

TM1® Contributor stores a user's data entry in a designated area of their Personal Workspace until

it is either committed to the base TM1 model or reset (cleared). Likewise, when using other TM1

interfaces while in Personal Workspace Writeback Mode, data entry is stored in a designated area

of the user’s Personal Workspace until it is committed to the base TM1 model or reset. Uncommitted

data in any interface can present problems for users expecting a consistent view of data across TM1

Contributor and other TM1 interfaces.

When using TM1 Contributor and another TM1 interface (Microsoft® Excel, Cube Viewer,

TM1Web) on a single TM1 Application the following rules apply:

Uncommitted data (displaysin blue)

Committed dataInterfaceWritebackmode

Data entry made in TM1 Con-

tributor can be viewed in other

interfaces if you have been

assigned Sandbox Capability.

See note below.

Data entry made here

can be viewed in all

TM1 interfaces.

TM1 ContributorPersonal

Workspace

Data entry cannot be viewed

by TM1 Contributor.

Data entry made here

can be viewed in all

TM1 interfaces.

Other TM1 Interfaces

Direct writeback mode is not available in TM1 Contrib-

utor.

TM1 ContributorDirect

All data entry can be viewed in other interfaces.Other TM1 Interfaces

Release Notes 9

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 10: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Note: TM1 Contributor-created sandboxes display in the sandbox list as [<sandbox

name>]_[<approval hierarchy dimension name>].[<approval hierarchy selected element parent

name^selected element name>]_[<contributor application guid>]

IBM Websphere Application Server Community Edition and Personal Workspace Writeback Mode

Assigning Personal Workspace Writeback Mode when using the IBM® Websphere® Application

Server Community Edition (WASCE) webserver software can cause a conflict in sandboxes with

uncommitted data. To avoid this situation be sure to take ownership of data in TM1® Contributor

before using a different TM1 interface or assign Direct Writeback capabilities to users working in

both TM1 Contributor and other TM1 interfaces.

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

Microsoft® Excel may hang when exporting a slice from TM1® Web to Microsoft Excel 2007 in

the Windows® Vista operating 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.

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

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.

10 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 11: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

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

Stopping TM1 Server without saving results in loss of security information

If the TM1® server is stopped after an application is created but before the application is saved, the

security set is not saved. In this case the TM1 Contributor application information is still saved.

Vista TM1 Contributor Administration

On Windows® Vista, the TM1® Contributor 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.

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.

Release Notes 11

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 12: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

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.

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.

Performance

In most situations, TM1® 9.5 performance should be similar to TM1 9.4 however under certain

larger concurrency load, TM1 9.5 may be slightly slower than older versions of TM1. TM1 9.5

also may consume slightly more memory than TM1 9.4.1.

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.

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.

12 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 13: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

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

Corrupted or invalidated feeders file requires restart

If a corrupted or invalid feeder file is detected, all the saved feeders will be deleted and the server

will exit with appropriate messages in the log file. In that case, you must restart the server to reload

and re-compute all of the feeders. The messages in the log will be of the form:

27660 ERROR 2010-05-14 19:10:26.455 TM1.Server All persistent feeder files will be deleted and

server will shut down

27660 ERROR 2010-05-14 19:10:26.455 TM1.Server Restart server to re-load database.

Feeder files are deemed "invalid" if there is a format error in the file, or if the date-time of the feeder

file is older than the corresponding cube (.CUB) file which may happen if one tries to manually

copy feeder or cube files from one data directory to another. When a feeder file is deemed to be

invalid, a message is written to the system log file explaining the exact reason that the feeder file is

deemed to be invalid. The message has the form:

ERROR 2010-05-14 19:00:22.987 TM1.Server Invalid feeder file detected for cube "xxxx" reason:

...

This message will typically (in the case of a multi-threaded load or an error with an cube which

loads early in the startup process) not be near the end of the file, but rather will be in the middle

of the load sequence. Searching the message log for "ERROR" will show the error.

Security

TM1® Architect does not properly update a group name when the name has changed.

To change a group name using Architect, manually remove the group and add it back in with the

new name.

Starting local server from In-Spreadsheet Browser TM1 Perspectives

You cannot start the local server from the In-Spreadsheet Browser.

You must use the Start Local Server option from the File menu.

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.

Release Notes 13

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 14: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

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

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.

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

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

14 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 15: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

● 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.

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.

Job Queuing Configuration ParametersTo help manage the queue thread priority, the following two parameters have been added:

JobQueueMaxWaitTime and JobQueueThreadSleepTime.

The thread processing the queue runs periodically when there are queued jobs. The frequency with

which it runs is controlled by JobQueueThreadSleepTime and defaults to 10 seconds. When the

queue thread runs, it will block all incoming requests to ensure it can get the locks necessary to

process a job on the queue. New requests are blocked for a period of time and currently executing

requests are allowed to complete.

The amount of time incoming requests are blocked is controlled by JobQueueMaxWaitTime and

defaults to 100ms. If the currently executing requests have not completed in this time, the queue

thread goes back to sleep for JobQueueThreadSleepTime and incoming requests are allowed to

proceed.

Release Notes 15

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 16: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

If the currently executing requests have completed and the queue processing thread processes a job,

it will allow incoming requests to proceed before attempting to process the next job. It will again

block incoming requests for up to JobQueueMaxWaitTime. If the queue processing thread cannot

proceed, it will go back to sleep for the configured amount of time.

By default JobQueueMaxWaitTime=100ms and JobQueueThreadSleepTime=10. Both are set in

the tm1s.cfg file and must be added manually.

To give the queue thread higher priority, set the JobQueueMaxWaitTime to a larger number.

If the JobQueueMaxWaitTime parameter is set to zero in the configuration file and Job Queuing is

turned on, the queue will keep trying until it can process, effectively locking out any other activity

until it is complete.

New FeaturesThe following features were introduced in this release.

IBM Cognos TM1 Package ConnectorThe IBM® Cognos® TM1® Package Connector is optional software that allows you to import SAP-

based and other OLAP and dimensionally modeled sources into TM1. See "Importing Data using

the IBM Cognos TM1 Package Connector" in the IBM® Cognos® TM1®Operation Guide.

Instructions for installing the TM1 Package Connector are found in the Installation Guide.

Personal Workspace and Sandbox Writeback ModesIBM® Cognos® TM1® offers different ways to handle the writeback of data to the server. Writeback

modes can be enabled across the server, then targeted to specific user groups with the Capability

Assignments interface. Administrators can set the writeback modes to offer a Personal Workspace,

to allow users to create and name multiple Sandboxes, to maintain the classic TM1 direct writeback

mode. See TM1 Writeback Mode and Sandboxes in the User Guide for more details.

Capability AssignmentsCertain configuration parameters that can be set on a per user basis can be managed using the

Capability Assignments interface. Only Administrators have access to this option. See "User

Capabilities" in the Operations Guide.

Job QueuingAn administrator can turn on the ability to process sandbox submissions using a Job Queue. This

feature allows other server work to proceed until resources are obtained for sandbox calculations.

The Job Queue can be monitored and submissions can be canceled. See "Job Queuing" in the IBM®

Cognos® TM1User Guide for more details.

Transaction Log Performance EnhancementsThree new features have improved Transaction Log performance:

16 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 17: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

● LogReleaseLineCount

The TM1s.cfg parameter LogReleaseLineCount sets the line limit for transaction Log searches

before the lock is temporarily released so other activity can proceed. See "Remote Server

Operations" in the IBM® Cognos® TM1®Operations Guide for more information.

● UNDO

Performance enhancements have been made to the UNDO feature. See "The Transaction Log

File" in the Programming Concepts chapter of the IBM Cognos TM1API Guide.

● Cancel

You can now cancel a long transaction log search. See "Viewing the Transaction Log" in the

Operations Guide for more information.

Persistent FeedersCubes with feeders can now store their feeders into a .feeders file which can be used to significantly

improve cube load times. See "Persistent Feeders" in the IBM® Cognos® TM1 Rules Guide.

Websheet and PagingAlthough not a new feature, IBM® Cognos® TM1® Websheet performance has been enhanced in

this release:

● Large Websheet processing has been significantly improved.

● Paging now encompasses calculation.

New websheet column calculation settingThe following parameter offers a new setting that may change the way this feature worked in pre-

vious releases.

String measurement for wide columns in TM1 Web

StringMeasurement is a web.config parameter that determines the way the contents of a websheet

cell are adjusted to fit in columns. When a column’s width results in a cell that is smaller than its

contents can display, the content is adjusted to that cell based on this setting and the type of cell.

A new method of calculating when to truncate cells is available in TM1® 9.5.1 to work better with

Microsoft® Internet Explorer. If you have made edits to your websheet column widths, you may

decide to set this parameter back to the 9.5.1 setting to preserve your pre-9.5.1 widths.

In all settings when the content is adjusted, digits are replaced with the '#' characters such that the

number would not be mistakenly read as a different number.

If a disproportionately small amount of content is shown in your websheet cells for the given space

available, you will want to use the legacy calculation by setting StringMeasurement=0 in the

web.config file.

If too much content is shown in your websheet for the space available, possibly causing misalignment,

use the 1 through 3 settings, depending on the type of cell.

Release Notes 17

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 18: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

ResultStringMeasurement

Determines where to truncates string and number type cell content as

it did in pre-TM1 9.5.1.

0

String cell measurement uses the newer calculation.1

Number cell measurement use the newer calculation.2

Both number and string content use the newer calculation.3

18 IBM Cognos TM1

Chapter 1: IBM Cognos TM1 9.5.1 Release Notes

Page 19: IBM Cognos TM1public.dhe.ibm.com/.../docs/en/9.5.1/tm1_rdm.pdf · 2010. 6. 16. · Component AdditionalConformance TM1 clients Microsoft® Windows 7 operating system software. TM1

Index

Symbols.NET framework, 6

Aaction button, 13

active forms, 15

AIX, 15

CCognos 8, 12

configuration, 6

Ddata source

TM1 requirements, 12

EEOL, 5

Ffix list, 5

fonts, 7

Fragments, 6

Ggroup name, 13

IIIS, 6

incompatible versions, 15

In-Spreadsheet Browser, 5

installation, 6

Internet Explorer 6, 5

ISB, 5

LLDAP, 6

logout messages, 11

Long date, 10

long strings, 14

MMicrosoft Excel 2007, 10

Nnaming application, 11

OODBC, 14

Pperformance, 12

Persistent feeders, 13

pivot tables, 10

Rrejected node, 12

Ssession timeout, 11

slice, 10

TTEXT, 14

TM1, 13

data source requirements, 12

TM1_PATH, 12

TM1 9.0, 5

TM1 Contributor, 11

TM1-ERR-0055, 12

TM1 Package Connector, 8

TM1 Workflow, 5

TurboIntegrator, 14

UUnicode DSN, 14

Vview filter, 12

Vista, 10, 11, 15

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


Recommended