IBM Cognos TM1
Version 9.5.1
Release Notes
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.
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.
4 IBM Cognos TM1
Table of Contents
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.
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
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
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
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
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
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
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
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
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
● 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
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
● 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
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
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.