IBM
®
Cognos
®
8
Product Information
This document applies to IBM®Cognos®8 Version 8.4 and may also apply to subsequent releases. To check for newer versions of this document,
visit the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html).
Copyright
Copyright © 2008 Cognos ULC (formerly Cognos Incorporated). Cognos ULC is an IBM Company.
Portions of Cognos ULC software products are protected by one or more of the following U.S. Patents: 6,609,123 B1; 6,611,838 B1; 6,662,188 B1; 6,728,697 B2; 6,741,982 B2; 6,763,520 B1; 6,768,995 B2; 6,782,378 B2; 6,847,973 B2; 6,907,428 B2; 6,853,375 B2; 6,986,135 B2; 6,995,768 B2; 7,062,479 B2; 7,072,822 B2; 7,111,007 B2; 7,130,822 B1; 7,155,398 B2; 7,171,425 B2; 7,185,016 B1; 7,213,199 B2; 7,243,106 B2; 7,257,612 B2; 7,275,211 B2; 7,281,047 B2; 7,293,008 B2; 7,296,040 B2; 7,318,058 B2; 7,325,003 B2; 7,333,995 B2.
Cognos and the Cognos logo are trademarks of Cognos ULC (formerly Cognos Incorporated) in the United States and/or other countries. IBM and the IBM logo are trademarks of International Business Machines Corporation in the United States, or other countries or both. Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.
While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in this document.
This document shows the publication date. The information contained in this document is subject to change without notice. Any improvements or changes to the information contained in this document will be documented in subsequent editions.
U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or dis-closure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer clause at DFARS 252.227-7013, or subparagraphs (C)(1) and (2) of the Commercial Computer Software - Restricted Rights at 48CFR52.227 as applicable. The Contractor is Cognos Corporation, 15 Wayside Road, Burlington, MA 01803.
Table of Contents
Introduction 27
Chapter 1: What’s New? 31
New Features in Version 8.4 31
Additional Language Support 31
Support for IBM Metadata Workbench as a Lineage Solution 32
Access to IBM WebSphere Business Glossary 32
Managing Comments Using Cognos Viewer 32
Adding Application Context to Dynamic SQL 32
Support for New Data Sources 32
Support for New Portal Versions 32
Hiding Entries 32
Updating Published PowerCubes 33
Object Capabilities 33
Schedule Credentials 33
Save History Details for Job Steps 33
Viewing Lineage Information 33
Enhanced Drill-through Capabilities 33
Metric Studio Content in Portal Pages 34
Changed Features in Version 8.4 34
Composite Information Server is Replaced By IBM Cognos 8 Virtual View Manager 34
IBM Cognos 8 Portal Services 34
Deprecated Features in Version 8.4 34
IBM Cognos 8 PowerCube Connection Utility and cubeswap 34
New Features in Version 8.3 35
Improved User Interface for Administrators 35
Access to More Documentation 35
More Granular Administrative Capabilities 35
Access to System Statistics 35
Snapshot of System Health 35
Managing Queues 36
Reducing Deployment Details 36
Setting Priority on Schedules 36
Better Control of Interactive Features in Reports 36
New Sample Audit Reports 36
Publishing and Managing Packages in Non-root Folders 36
Enabling Report Studio Authoring Modes 37
Server Administration 37
Transformer Integrated into IBM Cognos 8 37
My Activities and Schedules 37
My Watch Items 38
Report Alerts 38
Watch Rules 38
Go Directly to Target Report When Only One Target Report Exists 39
Support for Microsoft Excel 2007 39
Saving Report Outputs to a File System 39
Resubmitting Failed Jobs and Reports 40
Resubmitting Failed Agent Tasks 40
Default Actions for Agent Items 40
Tabbed Portal Pages 40
Global Filters and Enhanced Portal Interactivity 40
Metric Studio Content in Portal Pages 41
Support for Microsoft SharePoint Portal 2003 and 2007 41
Changed Features in Version 8.3 41
Updated IBM Cognos Connection Look 41
More Information in the Go To Page 41
Cognos Watchlist Portlet 42
Replaced Capability 42
Part 1: IBM Cognos 8 Administration
Chapter 2: IBM Cognos 8 Administration 43
IBM Cognos Administration 43
Automating Tasks 44
Setting up a Multilingual Reporting Environment 46
Configuring Your Database For Multilingual Reporting 47
Installing Fonts 47
IBM Cognos 8 Default Font 48
Report Studio Fonts 48
Set Up Printers 48
Configuring Web Browsers 50
Allow User Access to Series 7 Reports from IBM Cognos Connection 52
Restricting Access to IBM Cognos 8 53
Chapter 3: Building IBM Cognos 8 Applications 55
Chapter 4: Samples 57
The Great Outdoors Company Samples 57
The Great Outdoors Group of Companies 58
Employees 60
Sales and Marketing 60
Great Outdoors Database, Models, and Packages 61
Setting Up the Samples 63
Restore Backup Files for the Samples Databases 64
Create Data Source Connections to the Samples Databases 67
Set Up Microsoft Analysis Services Cube Samples 68
Set Up the Essbase Cube Sample 69
Create Data Source Connections to OLAP Data Sources 70
Set Up the Metric Studio Sample 73
Import the Samples 74
Sample Database Models 76
Example - Running the Sample ELM Returns Agent Against Changed Data 76
Chapter 5: Setting up Logging 79
Log Messages 80
Logging Levels 80
Set Logging Levels 82
Audit Reports 82
Setting Up Audit Reporting 83
Sample Audit Model and Audit Reports 83
View Full Details for Secure Error Messages 88
Disable the Creation of Core Dump Files 89
Part 2: System Administration
Chapter 6: System Performance Metrics 91
How Metric Data is Gathered 91
System Metrics 92
Panes on the Status System Page 99
Assess System Performance 100
View Attributes for Metric Scores 101
Set Metric Threshold Values 101
Reset Metrics 103
Reset Metrics for the System 103 Chapter 7: Server Administration 105
Dispatchers and Services 105
Stop and Start Dispatchers and Services 108
Activate a Content Manager Service 110
Remove Dispatchers from the Environment 111
Group Dispatchers in Configuration Folders 112
Specify Advanced Dispatcher Routing 113
Specify Gateway Mappings for Series 7 PowerPlay Data 116
Rename Dispatchers 116
Test Dispatchers 117
Administering Failover for Multiple Dispatchers 118
Securing Dispatchers 120
Content Manager Computers 121
Managing Database Connection Pool Settings for Content Manager 121
Sorting Entries for Non-English Locales 122
Managing Content Manager Synchronization 123
Control Browsing of External Namespaces 123
Set Advanced Content Manager Parameters 123
Override the (Default) Locale Processing in the Prompt Cache 124
Maintain the Content Store 125
Migrating PowerPlay Reports Published to IBM Cognos 8 127
Tune Server Performance 127
Set Server Group Names for Advanced Dispatcher Routing 128
Balance Requests Among Dispatchers 129
Use Cluster Compatible Mode for Dispatchers 129
Set Usage Peak Periods 130
Set the Maximum Number of Processes and Connections 131
Specify Queue Time Limits 133
PDF File Settings 134
Set Maximum Execution Time 137
Specify How Long to Keep Watch List Report Output 138
Limit Hotspots That are Generated in an Analysis Studio or Report Studio Chart 139
Set Compression for Email Attachments 140
Set the Report Size Limit for the Report Data Service 141
Set Parameters for Concurrent Query Execution 141
Set Query Prioritization 143
Disable Session Caching 145
Add Application Context to Dynamic SQL 147
Saved Report Output 148
Set File Location to Save a Copy of Report Output Outside of IBM Cognos 8 149
Set File Location to Save Copy of Report Output in IBM Cognos 8 149
Configure the Lineage Solution 151
Configure the IBM WebSphere Business Glossary URI 152
Enable Job, SMTP, and Task Queue Metrics 153
Part 3: Data Management
Chapter 8: Data Sources and Connections 155
DB2 156
IBM Cognos Cubes 157
IBM Cognos Finance 157
IBM Cognos Now! Cube 158
IBM Cognos Planning - Contributor 158
IBM Cognos Planning - Series 7 159
IBM Cognos PowerCubes 159
IBM DB2 OLAP and Hyperion Essbase Data Source 164
Configure Scenario Dimensions 165
Specify Balanced Hierarchies 165
Specify Measure Formats 166
Specify the Attributes of a Dimension 167
IBM Infosphere Warehouse Cubing Services 168
Informix Data Sources 169
Microsoft Analysis Services Data Sources 169
Microsoft SQL Server Data Sources 171
ODBC Data Sources 173
Oracle Data Sources 176
SAP Business Information Warehouse (SAP BW) Data Sources 176
TM1 Data Sources 178
XML Data Sources 179
Create a Data Source 180
Add or Modify a Data Source Connection 183
Manage Data Source Connections 184
Create or Modify a Data Source Signon 186
Specifying Isolation Levels 188
Using Database Commands for Oracle, DB2, and Microsoft SQL Server 190
Example - Open Connection Command Block 191
Example - Close Connection Command Block 191
Add or Modify Command Blocks for a Connection 191
Command Block Examples 192
Securing Data Sources 195 Chapter 9: Back Up Data 197
Chapter 10: Data Movement Entries 199
Run a Data Movement Entry 199
Change Default Data Movement Entry Properties 200
Part 4: Security Administration
Chapter 11: Security Model 201
Authentication Providers 201
Deleting or Restoring Unconfigured Namespaces 202
Authorization 203
Cognos Namespace 203
IBM Cognos Application Firewall 204
Data Validation and Protection 204
Logging and Monitoring 205 Chapter 12: Users, Groups, and Roles 207
Users 207
User Locales 208
Groups and Roles 208
Create an Cognos Group or Role 210
Add or Remove Members of an Cognos Group or Role 211 Chapter 13: Access Permissions 213
Set Access Permissions for an Entry 216
Trusted Credentials 218
Create Trusted Credentials 218
Chapter 14: Secured Functions and Features 221
Set Access to a Secured Function or Feature 225
Set Access to the Report Studio User Interface Profiles 227 Chapter 15: Object Capabilities 229
Set Up Object Capabilities for a Package 231 Chapter 16: Initial Security 233
Built-in Entries 233
Predefined Entries 234
Specify Security Settings After Installation 236
Securing the Content Store 237
Part 5: Content Administration in IBM Cognos Connection
Chapter 17: IBM Cognos Connection 239
Log On 239
Log Off 239
Create a Shortcut 240
Create a URL 241
Bookmark an Entry 242
Models and Packages 243
Entry Properties 243
General Properties 243
Permissions 246
Report, Query, Analysis, and PowerPlay Report Properties 247
Job Properties 248
Select a Link for an Entry 256
Delete an Entry 257
Specify the Order of Entries 257
Create a Folder 258
Specify an Alternative Icon for an Entry 259
Search for an Entry 259
Personalize the Portal 260
My Watch Items 263
View Watch Items 264
Remove Yourself from an Alert List 264
Edit a Watch Rule 264
Chapter 18: Pages and Dashboards 267
Create a Page 269
Edit a Page 270
Share a Page 270
Modify a Portlet 271
Enable Communication Between Cognos Portlets 271
Portal Tabs 273
Add a Tab 273
Delete a Tab 274
Reorder the Tabs 275
Change Your Home Page 275
Create a Dashboard with Multiple Tabs 275
Adding Interactivity to Pages and Dashboards 278
Defining Global Filters 278
Enable Sharing of Drill-up and Drill-down Actions 283
Enable Sharing of Drill-through Actions 283 Chapter 19: Activities Management 285
Manage Current Activities 285
Manage Past Activities 287
Manage Upcoming Activities for a Specific Day 289
Manage Entry Run Priority 293
View the Run History for Entries 294
Specify How Long to Keep Run Histories 296
Rerun a Failed Entry Task 297 Chapter 20: Schedule Management 299
Schedule an Entry 300
Example - Schedule an Entry on the Last Day of the Month 301
Use Jobs to Schedule Multiple Entries 301
Trigger-based Entry Scheduling 304
Setting Up Trigger-based Scheduling 304
Schedule an Entry Based on an Occurrence 305 Chapter 21: Deployment 307
Deployment Specifications 307
Deployment Archives 308
Deployment Planning 308
Security and Deployment 308
Deploying the Entire Content Store 309
Deploying Selected Public Folders and Directory Content 311
Deployment Rules When Importing 315
Rules For Deploying the Entire Content Store 316
Rules For Partial Deployment 320
Deploying IBM Cognos 8 Entries 324
Create an Export Deployment Specification 325
Move the Deployment Archive 328
Import to a Target Environment 328
Include Configuration Objects in Import of Entire Content Store 331
Testing Deployed Applications 332
Upgrade Report Specifications 332 Chapter 22: Administering Packages 335
Data Trees 335
Configure or Reconfigure a Package 336
Set Permissions for Package Configuration 336
Remove a Package Configuration 337 Chapter 23: Managing User Profiles 339
Edit the Default User Profile 339
Delete a User Profile 340
Copy a User Profile 340
View or Change a User Profile 341
Chapter 24: Administering Microsoft Office Documents 343
Deploying IBM Cognos 8 Go! Office Client 343
Set Macro Security Level for Microsoft Office XP 344
Install the CA Certificate for the HTTPS Interface to Series 7 PowerPlay 344
Download a Microsoft Office Document 344
Part 6: Report, Agent, and Metric Administration
Chapter 25: Reports and Cubes 347
View, Run, or Open a Report 348
Set Default Report Options 348
Set Report Options for the Current Run 350
Set Advanced Report Options for the Current Run 351
Create a Report 353
Creating a Query Studio Report Without Using Actual Data 354
Create a Report View 354
View Lineage Information for a Data Item 355
Access the IBM WebSphere Business Glossary 356
Edit a Report 356
Specify the Default Language for a Report 362
Specify the Default Prompt Values for a Report 362
Save Report Output 363
View Report Output Versions 364
Specify How Long to Keep Report Output 365
Enable an Alert List for a Report 365
Add Yourself to or Remove Yourself from the Alert List for a Report 366
Watch Rules in Saved Reports 366
Enable Watch Rules for a Report 367
Create a Watch Rule for a Report 367
Modify or Delete a Watch Rule in Cognos Viewer 368
Comments in Saved Reports 369
Enable Comments in Saved Output Versions 369
Add Comments to a Report Version in Cognos Viewer 370
View, Modify or Delete Comments in Cognos Viewer 370
Disable Selection-based Interactivity 371
Exclude Blank Pages in PDF Reports 372
Distributing Reports 372
Saving a Report 373
Sending a Report by Email 373
Sending a Report to your Mobile Device 373
Printing a Report 373
Distributing a Report by Bursting 374
Create Distribution Lists and Contacts 374
Drilling to View Related Data 375
Drill Up or Drill Down 376
Drill Through to Another Target 376
Data Sources With Named Sets May Produce Unpredictable Results 378
Series 7 Reports in IBM Cognos Connection 378
Series 7 PowerPlay Reports and Cubes 379
Single Signon 380
Run or Open a Series 7 PowerPlay Report 380
Change the Defaults for a Series 7 PowerPlay Report 381
Open a Series 7 Cube 382
Multilingual Properties for Series 7 Reports and Cubes 382 Chapter 26: Agents 383
Run an Agent 383
Change Default Agent Properties 384
Create an Agent View 385
Open or Create an Agent from IBM Cognos Connection 385
Enable an Alert List for an Agent 386
Add Yourself to or Remove Yourself from an Alert List for an Agent 386
Remove All Users from the Alert List for an Agent 387
Receive News Item Headlines 387
View the Most Recent Event List 387 Chapter 27: Metric Studio Metrics 391
Create a Metric Package 391
Change the Default Action for Packages 392
Run a Metric Task 392
Delete a Metric Task 393
Modify a Metric Task 393
Metric Import Tasks 394
Create New Metric Import Task 394
Edit Metric Import Task Properties 395
Metric Maintenance Tasks 395
New Metric Maintenance 396
Edit Metric Maintenance Properties 396
Metric Export Tasks 397
Change Metric Export Properties 399 Chapter 28: Drill-through Access 401
Understanding Drill-through Concepts 402
Drill-through Paths 402
Selection Contexts 402
Drilling Through to Different Report Formats 403
Drilling Through Between Packages 403
Bookmark References 404
Drilling Through on Dates Between PowerCubes and Relational Packages 408
Set Up Drill-through Access in Packages 408
Set Up Parameters for a Drill-Through Report 411
Set Up Parameters for a Drill-through Target in Analysis Studio 412
Example - Drill Through Between OLAP Reports in the Same Package 413
Example - Drill Through from an OLAP Report to a DMR Report 416
Debugging a Drill-through Definition 419
Access the Drill-through Assistant 420
Example - Debugging a Drill-through Definition 421
Set Up Drill-through Access in a Report 422
Example - Drill Through to a Hidden Report from a Report Studio Report 423
Specify the Drill-through Text 425
Setting Up Drill-through Access from IBM Cognos Visualizer 426
Setting Up Drill-through Access from PowerPlay Web 426
Create and Test the Target for a Series 7 Report 426
Part 7: Portal Services Administration
Chapter 29: Managing Portlets and Styles 429
Portlets 429
Cognos Portlets 429
Other Portlets 432
Import Portlets 432
Control Access to Portlets 433
Configure the Portlet Cache 434
Modify a Portlet 435
Display the HTML Code From the Source RSS Feed in RSS Viewer and Cognos Navig-ator 436
Styles 437
Add a New Style 438
Control Access to Styles 439
Modify a Style 440
Chapter 30: Deploying Cognos Portlets to Other Portals 441
Deploying Cognos Portlets to WebSphere Portal 5.0, 5.1, 6.0, and 6.1 441
Install the Portlet Applications File 442
Configure the Portlet Applications 443
Configure the Portlet Cache 444
Customize the Content of Cognos Portlets 444
Deploying Cognos Portlets to SAP Enterprise Portal 6.0, 6.4, and 7.0 445
Install the IBM Cognos Business Package 446
Edit Properties for the iViews 447
Set the Default iView Content and Appearance for All Users 448
Deploying Cognos Portlets to ALUI 6.1 and 6.5 Portal 449
Start the Remote Server 449
Import the Cognos Portlet Package File 452
Connect to the Remote Server 453
Customize the Content of Cognos Portlets 454
Deploying Cognos Portlets to Microsoft SharePoint Portal Server 2003 and 2007 454
Set up Virtual Directories and Change the Gateway URIs 455
Copy the Cognos Web Parts Resources to the IIS HTTP Root Directory 456
Modify the .NET Framework web.config File 458
Edit the Cognos Web Parts Catalog Files 461
Restart IIS 461
Add Cognos Web Parts to a SharePoint Page 462
Customize the Content of Cognos Web Parts 463
Migrating Cognos Portlets from IBM Cognos ReportNet 1.1 to IBM Cognos 8 464
Change the Root Name of File Paths in Cognos Portlets 464
Disable the Transfer of the IBM Cognos 8 Passport ID as a URL Parameter 465
Set Portal Services Protocol Scheme 467
Configuring Security for Portal Services 467
Disable Anonymous Access to IBM Cognos 8 Components 468
Enable Single Signon Using Shared Secret 468
Enable Single Signon for SAP EP with the SAP Logon Ticket 474
Enable Single Signon for SAP EP with User Mapping 474
Enable Secure Communication Between SAP EP and IBM Cognos 8 Components 475
Enable Single Signon for WebSphere Portal Using the Application Server 476
Enable Single Signon for BEA ALUI Portal Using Basic Authentication 476
Enable Single Signon for BEA ALUI Portal Using SiteMinder 477
Part 8: Customization
Chapter 31: Customizing the Appearance of IBM Cognos 8 479
Making Global Changes to all Components 479
Customizing Styles 479
Rebranding the IBM Cognos 8 Interface 481
Changing IBM Cognos 8 Fonts 482
Changing the Global IBM Cognos 8 Style Sheet 482
Migrating Changes to Future Releases 483
Modifying the Appearance of IBM Cognos Connection 484
Example - Customize the Default Welcome Page 484
Example - Change the Branding Details in the IBM Cognos Connection Main Header 484
Example - Change the Background Color in the IBM Cognos Connection Main Header 485
Example - Change the Portal Graphics 486
Example - Change the Default Fonts for Page Titles and Instructions 486
Modifying the Report Studio Style Sheets 486
Example - Change the Fonts Used in Report Studio 487
Example - Change the Colors Used in Report Studio Menus 487
Example - Change the Report Studio Graphics 488
Modifying the Query Studio Style Sheets 488
Example - Change the Colors Used in Query Studio Menus 489
Example - Change the Query Studio Graphics 489
Customize the Query Studio Toolbar and Menus 490
Modifying the Appearance of Cognos Viewer 492
Modifying the Cognos Viewer Style Sheets 493
Example - Change the Language of the Cognos Viewer User Interface 493
Modifying the Prompt Page Style Sheets 494
Adding Custom Report Templates for Report Studio 495
Create a Report Specification for a Custom Report Template 495
Add a Custom Report Template to the templates.xml File 497
Provide an Icon for the Custom Report Template 497
Add the Custom Template Information to the Resources.xml File 497 Chapter 32: Customizing the Functionality of IBM Cognos 8 501
Upgrade the ReportNet system.xml Files to IBM Cognos 8 501
Customizing IBM Cognos Connection 502
Add or Hide User Interface Elements Based on Groups and Roles 503
Hide and Disable the New URL Button 508
Limit the Number of Entries That Users Can Cut, Copy, and Paste 509
Customizing Object Actions 509
Restrict Content Browsing 513
Implementing a Custom Welcome Page 514
Customize Report Output Formats in IBM Cognos Connection and Cognos Viewer 517
Configure the Document Lookup Table 519
Start Query Studio in Preview Mode 520
Customizing Data Formats for Query Studio 520
Modify the cogformat.xml File 521
Change the Order of Data Formats 521
Change the Text Strings 522
Remove Data Formats 523
Add a Data Format to a Locale 524
Add Data Formats for a New Locale 525
Change the Default Query Studio Template 525
Modify Properties for the CSV Output Format 526
CSV Properties and Values 527
Supported Encoding Values 528
Modify Properties for the Batch Report Service and Report Service 529
Batch Report Service and Report Service Properties and Values 529
Customize Error-Handling on the SMTP Mail Server 530
Disable Report Attachments in Email Messages 534
Show Attachments in IBM Lotus Notes 534
Disable Support for Trigger-based Scheduling 535
Set Up a Trigger Occurrence on a Server 535
Hide History Summary Counts 537
Change the Suppression Functionality in Analysis Studio 538
Part 9: Troubleshooting
Chapter 33: Troubleshooting Resources 539
Error Messages 539
Example - Testing Report Studio 545
View the Report Definition in Query Studio 545
Call IBM Cognos Resource Center 545
Chapter 34: Problems Using Documentation 547
Problems When Printing a PDF Manual 547
Unable to Launch a Web Browser When Accessing Help 547
Text Does Not Appear Properly in Quick Tours 548 Chapter 35: Installation and Configuration Problems 549
Problems Starting IBM Cognos 8 549
CFG-ERR-0106 Error When Starting the IBM Cognos 8 Service in IBM Cognos Configur-ation 549
Cryptographic Error When Starting IBM Cognos 8 551
Unable to Start the IBM Cognos 8 Service Because the Port is Used by Another Process 551
IBM Cognos 8 Service Does Not Start or Fails After Starting 552
IBM Cognos 8 Server Fails to Start and Gives No Error Message 552
IBM Cognos BI Server Not Available When Starting IBM Cognos 8 553
Cannot Log On to a Namespace When Using IBM Cognos Connection 556
IBM Cognos 8 Services Fail to Restart After a Network Outage 557
No Warning That Installing a Later Version of IBM Cognos 8 Will Automatically Update the Earlier Version of the Content Store 557
Download of Resource Fails 557
DB2 Returns SQL1224N Error When Connecting from AIX 558
Content Manager Error When Starting IBM Cognos 8 558
DPR-ERR-2014 Error Appears in Log File on Content Manager Computer 558
Non-ASCII Characters in Installation Directory Cause Run-time Errors 558
Cannot Open an MS Cube or PowerCube 559
Cannot Open an OLAP Data Source 560
The Page Cannot Be Found When Starting IBM Cognos 8 in Windows 2003 560
The Page Is Not Shown When Opening a Portal After Installing IBM Cognos 8 560
DPR-ERR-2058 Error Appears in Web Browser When Starting IBM Cognos 8 560
EBA-090034 Error When Starting WebLogic 8 562
Report Studio Does Not Start 563
DPR-ERR-2022 Error Appears in Web Browser When Starting IBM Cognos 8 563
Unable to Download the cognos.xts File 563
Application Server Startup Script Fails 564
Issues with IBM WebSphere 6.0 on AIX 5.3 564
IBM Cognos 8 Running under WebLogic Application Server on AIX Fails 564
Deploying IBM Cognos 8 to an Oracle Application Server or IBM WebSphere Application Server Fails 564
Microsoft Excel 2000 Multipage Report Type Does Not Work 565
Unable to Deserialize Context Attribute Error When Deploying the p2pd.war File to WebLogic 565
Error Appears After Upgrading IBM Cognos 8 on a WebLogic Application Server 566
Chinese, Japanese, or Korean Characters Are Different After Upgrade 566
Accented or Double-Byte Characters May Not Display Correctly When Installing IBM Cognos 8 on Linux 567
RSV-SRV-0066 A soap fault has been returned or RQP-DEF-0114 The user cancelled the request Errors Appear in High User Load Environments 567
Problems Configuring IBM Cognos 8 567
Configuration Tool cogconfig.sh Return Values Are Not Compliant with Conventional UNIX Return Values 567
Run Database Cleanup Scripts 568
Error Trying to Encrypt Information When Saving Your Configuration 570
Problems Generating Cryptographic Keys in IBM Cognos Configuration 570
CAM-CRP-1315 Error When Saving Configuration 571
Manually Changing the Installation Directory Name Affects Installations Running Under an Application Server 571
Configuration Data is Locked by Another Instance of IBM Cognos Configuration 572
Unable to Exit a Tab Sequence When Using Keyboard-only Navigation in IBM Cognos Configuration 572
Unable to Save Your Configuration 572
Java Error When Starting IBM Cognos Configuration 573
Cryptographic Error When Starting IBM Cognos Configuration 573
Current Configuration Settings Are Not Applied to Your Computer 574
CM-CFG-029 Error When Trying to Save a Configuration That Specifies a SQL Server Content Store 574
DPR-ERR-2079 When Content Manager Configured For Failover 574
Importing a Large Content Store in Solaris using JRE 1.5 Fails 575
Users are Prompted for Active Directory Credentials 575
Font on UNIX Not Found When Starting IBM Cognos Configuration 575
Unable to Load Essbase/DB2 OLAP Library in Framework Manager 576
Group Membership is Missing From Active Directory Namespace 576
Deploying IBM Cognos 8 to an Oracle Application Server or IBM WebSphere Application Server 577
Errors Displayed Deploying to Oracle 10G Application Server 578
Page Cannot be Found Error Running Reports using IBM Cognos 8 Go! Office 578
Error Initializing Oracle Content Store After Upgrade from ReportNet 578
CGI Timeout Error While Connected to IBM Cognos 8 Components Through a Web Browser 579
Servlet Class Fails to Load in WebLogic 579
Desktop Icons or IBM Cognos Configuration Window Flicker on Windows 580 Chapter 36: Security Problems 581
Problems Setting Up Security 581
Access to Entries is Denied During Deployment 581
Prompt to Change Passwords When Logging On to an Active Directory Security Source 581
Unable to Log On 581
Certificate Authority Error When Logging On to IBM Cognos Connection 582
HTTPS DRP-ERR-2068 Error In Log File When No Error is Reported During a Switch to HTTPS 582
Entries Do Not Appear in IBM Cognos Connection for a Member of a Newly Created Group 582
Problems Logging On to Cognos Portlets 583
Existing Passwords May not Work in an SAP Namespace 584
Users Are Repeatedly Prompted for Credentials When Trying to Log On to an SAP Namespace 585
Problems Using Authentication Providers 585
CAM-AAA-0096 Unable to Authenticate User When Using an IBM Cognos Series 7 Namespace 585
Single Signon Is Not Working When Using Active Directory Server 586
Unable to Authenticate User for Cognos Portlets 587
Unable to Identify SAP Permissions Required 587
Unable to Access IBM Cognos Administration When an NTLM Namespace Is Used and Single Signon Is Enabled 587
Chapter 37: Report and Server Administration Problems 589
Database Connection Problems 589
Unable to Select ODBC as the Type of Data Source Connection 589
Cannot Connect to an SQL Server Database Using an OLE DB Connection 590
Intermittent Problems Connecting to a SQL Server Database 590
Cannot Access IBM Cognos Series 7 Reports from IBM Cognos Connection 590
Series 7 Namespaces Do Not Initialize When Services are Started 591
Content Manager Connection Problem in Oracle (Error CM-CFG-5036) 591
Cannot Connect to an OLAP Data Source 592
Error When Creating a Data Source Connection to a PowerCube 592
Not Yet Optimized IBM Cognos PowerCubes May Open Slowly in IBM Cognos 8 592
Other Administration Problems 593
Restarting Servers After Solving Content Store Problems 593
An Update or Delete Request Fails 594
BI Bus Server Processes Remain in Memory After a Shutdown 594
Higher Logging Levels Negatively Affect Performance 594
Problems Accessing Cognos Portlets 595
Unable to Edit Object Properties in ALUI 6.1 and 6.5 Portal 596
Only the Administrator Can See Cognos Portlets 597
Locale Mismatch in Cognos Navigator Portlet 597
Properties Pages in Cognos Portlets Are not Displayed Properly 598
Problems Displaying HTML Reports in a Multi-tab Dashboard 598
Unable to Identify SAP BW Version and Corrections 599
SBW-ERR-0020 Error When Running Reports Based on SAP BW Data Sources 599
Links to Referenced Content Objects are Broken Following Deployment 599
Table or View Does not Exist for Sample Database 600 Chapter 38: Problems When Using Framework Manager 601
Measures Not Added After Initial Import in an Upgraded Model 601
Unable to View the Result Set of a Stored Procedure 601
Unable to Compare Two CLOBs in Oracle 601
An Out of Memory Error with ERWin Imported Metadata 602
Calculation Fails Testing 602
Framework Manager Cannot Access the Gateway URI 602
Object Names Appear in the Wrong Language 603
Full Outer Joins in Oracle Return Incorrect Results 603
Error When Testing Query Subjects in a Model Imported from Teradata 603
Error for Type-In SQL Query Subject 603
Function Name Not Recognized 604
QE-DEF-0259 Error 604
QE-DEF-0260 Parsing Error 605
Externalized Key Figures Dimension Retains Old Prompt Value 605
Older IBM Cognos 8 Models Display Level Object Security 605
Exporting a Framework Manager Model to a CWM File Fails With ErrorMILOG.TXT was not found 605
Difference in SQL for Inner Joins After Upgrading to IBM Cognos 8.3 606
Publishing a Large Package Results in a CCLOutOfMemory Error 606
Full Outer Joins Not Sent to Oracle 9i and 10GR1 606
Review Governors When Upgrading Models 606
File Creation from Framework Manager fails with Error QE-DEF-0178 607 Chapter 39: Problems When Using Transformer 609
Known Issues When Modeling in IBM Cognos Transformer 609
BAPI Error Occurs After the Prompt Specification File Edited Manually 609
Unable to Access an IQD Data Source using a Sybase Database Connection 609
Importing Time Dimensions from IBM Cognos 8 Packages Not Supported 610
Data in Multiple Languages Does Not Display Properly 610
Unable to Use an IQD Created in Framework Manager That Contains an Oracle Stored Procedure 610
Preventing Errors When Model Calculations Use Double Quotation Marks 611
Framework Manager and Transformer may Display Different Locale Session Parameters for Some Languages 611
Regular Columns cannot be Converted to Calculated Columns and Vice Versa 611
Transformer Takes a Long Time to Retrieve Data from an SAP-based Data Source 612
Categories Missing When Creating a Transformer Model Based on an SAP Query Containing a Manually Created SAP Structure 612
Error Occurs When Creating a PowerCube Containing an SAP Unbalanced Hierarchy 612
Rebuilding a PowerCube Soon After Publishing Produces a TR0787 Error 612
Known Issues Using Cubes in the IBM Cognos 8 Studios 613
Not Yet Optimized IBM Cognos PowerCubes May Open Slowly in IBM Cognos 8 613
Analysis Studio Shows the Wrong Currency Symbol 614
Changes to Decimals in Currency Formats 615
Ragged or Unbalanced Hierarchies Result in Unexpected Behavior 615
Error Opening Saved Reports After PowerCube Refresh 616
Unable to Open Sample Model, Great Outdoors Sales.mdl, and Generate Cubes 616
Data Records that Support External Rollup Measure Data are Not Always Created 617 Chapter 40: Problems Authoring Reports 619
Problems Creating Reports 619
Chart Labels Overwrite One Another 619
Chart Shows Only Every Second Label 619
Chart Gradient Backgrounds Appear Gray 619
Division by Zero Operation Appears Differently in Lists and Crosstabs 620
Application Error Appears When Upgrading a Report 620
Nested List Report Containing a Data Item That is Grouped More Than Once Does Not Run After Upgrade 620
Background Color in Template Does not Appear 621
Subtotals in Grouped Lists 621
Metadata Change in Essbase Not Reflected in Reports and in the Studios 621
Relationships Not Maintained in a Report With Overlapping Set Levels 621
Creating Sections on Reports That Access SAP BW Data Sources 622
Error Characters (--) Appear in Reports 622
Columns, Rows, or Data Disappear With SSAS 2005 Cubes 623
Unexpected Cell Formatting in Reports 624
Report Differences Between TM1 Executive Viewer and IBM Cognos 8 with TM1 Data Sources 624
Order of Metadata Tree Differs for TM1 Data Sources 624
Problems Calculating Data 625
Count Summaries in Query Calculations Include Nulls with SAP BW Data Sources 625
Unexpected Summary Values in Nested Sets 625
Incorrect Results with IBM Cognos PowerCubes and Time Measures 626
Problems Filtering Data 626
HRESULT= DB_E_CANTCONVERTVALUE Error When Filtering on a _make_timestamp Column 626
Problems Distributing Reports 627
A Report Link in an Email Notification Does Not Work 627
Report Contains No Data 627
Hyperlinks in Email Messages Are Stripped Out When the Agent is Saved 627
CNC-ASV-0001 The Following Agent Service General Error Occurred: java.lang.Stack-OverflowError 628
Cannot Call the SDK from Event Studio 628
Saving a Report Takes a Long Time 628
Chapter 41: Problems Running, Viewing, or Printing Reports and Analyses 629
Problems Running Reports and Analyses 629
Summaries in Report Do not Correspond to the Visible Members 629
Unexpected Results for Analysis Studio Reports Using Suppression and Nested Rows 630
Unexpected Results May Occur When Using Items from the Same Hierarchy on Multiple Crosstab Edges 631
Defining Languages for OLAP Data Sources 631
Crosstab Shows Percentage But Chart Shows Values 631
Cube Refresh in Data Analysis Studio Uses UTC/GMT Time 631
Cannot Drill when Caption Represents a Blank or a Zero-length String 632
DPR-ERR-2082 The Complete Error Has Been Logged by CAF With SecureErrorID 632
Query Studio Does Not Generate a SELECT DISTINCT statement if a Column is Aliased Without Using the Actual Column Name 632
Cannot Find the Database in the Content Store (Error QE-DEF-0288) 632
Parse Errors When Opening or Running an Upgraded Report 633
Overflow Error Occurs When a Value in a Crosstab Is More Than 19 Characters 633
IBM Cognos 8 Runs Out of TEMP Space 633
A Report Does Not Run as Expected 633
Performance Issues when Showing Multiple Attributes Using Dimensionally Modeled Relational Data Sources 634
Analysis Studio Shows the Wrong Currency Symbol 634
Error Occurs in Japanese Internet Explorer 7 When Running an Excel Report in Analysis Studio 635
The ORA-00907 Error Appears When Running a Report 635
Drilling Through to IBM Cognos 8 from an IBM Cognos Series 7 Product Results in Firewall Error 635
Scheduled Reports Fail 636
The Table or View Was Not Found in the Dictionary 636
Mixed Languages Are Displayed in IBM Cognos Connection When Using Samples 636
Unable to Select Multiple Report Formats When Running a Report 637
A Report Does Not Run as Scheduled 637
A Report or Analysis Does Not Run Because of Missing Items 637
Cannot View Burst Report 638
PCA-ERR-0057 Recursive Evaluation Error 639
Arithmetic Overflow Error When Running a Report in PDF Format 639
Performance Problems When Running Reports 639
CGI Timeout Error While Transferring Data to IBM Cognos 8 Components 639
Slow Server Performance 640
The BAP-ERR-0002 BAPI Error 641
The Out of Memory Error Appears in HP-UX 641
A Query Is Slow When Filtering Non-ASCII Text 641
Query Studio Output Takes a Long Time to Run 641
Problems Viewing Reports 641
A Report Upgraded from ReportNet Does Not Retain its Original Look 641
Drill-through Links Not Active in the Safari Browser 642
A Running Total in Grouped Reports Gives Unexpected Results 642
The Page Cannot Be Found Error Appears When Viewing Report Outputs from Email Links 642
Non-English Characters Appear as Placeholders 642
Cannot Drill Between PowerCubes Because MUNs Do Not Match 643
Unexpected or Empty Results When Drilling Through 643
Cannot Drill From a Relational Source to a Cube 644
Charts Do Not Appear in HTML reports 644
Portal Problems 645
Cannot Connect to a SQL Server Database Using an ODBC Driver 645
The My Folders Tab Does Not Appear After Logging On to IBM Cognos Connection 646
Icon Graphics Are Not Working in Portlets 646
Styles Used in the Previous Installation Still Appear 647
Unable to Click Links 647
Missing Images in a PDF Report 648
Charts in PDF Output Show Unexpected Results 648
Problems Printing Reports 648
Unable to Print PDF Reports 648
A Printed HTML Report is Unsatisfactory 649 Chapter 42: Problems When Using Map Manager 651
Problems Importing Files 651
Error Importing Translated Text File 651 Chapter 43: Problems With Metrics 653
Metric Studio Log Files 653
Metric Studio Support Bundle 654
Known Issues When Using Metric Studio 654
Metric Studio Reports Fail Because of an Oracle Internal Error 654
Metric Studio Errors Occur When Loading Data into an Oracle Database 655
Oracle Errors Occur When Using the cmm_uninstall Script 655
Error When Attempting to Run Metric Studio on SQL Server 2005 655
A Metric Maintenance Task Fails to Run 657
You Do Not Have Permission to Access This Metric Package. Contact Your System Administrator. 657
Failed to Check the Metrics Store Install Status Error When Using DB2 8.2.3 657
Errors Occur When Importing Tab-delimited Files into a DB2 Metric Store 657
Required User Permissions for the Metric Store Database (MS SQL Server) 658
Error When Viewing a History Chart or Diagram on a DB2 Server with the 8.2 JDBC Driver 658
Oracle 9.2 Package Initialization Error if NLS_LANG Environment Variable is Not Set Appropriately Before Starting Up IBM Cognos 8 Tomcat Server 658
Known Issues When Using Metric Designer 658
Adding Multiple IQD Files to an Import Source 658
Previewed Scorecard Hierarchy Shows Blanks 659
Chapter 44: Troubleshooting IBM Cognos 8 for Microsoft Office and the Report Data Service 661
Configuration Issues 661
The IBM Cognos 8 for Microsoft Office Interface Fails to Initialize in Microsoft Office 661
IBM Cognos 8 Go! Office Does Not Start in Microsoft Word 661
IBM Cognos 8 for Microsoft Office Fails to Initialize in Microsoft Internet Explorer 662
bo:heap Buffer Overflow Error 662
Microsoft Office Does Not Open a Microsoft Office Document Published from IBM Cognos 8 for Microsoft Office 662
Unable to Open Published Microsoft Office Documents from IBM Cognos Connection 663
Error Messages, the .NET shortcut, or the .NET Console Are Not in the Language of the .NET Framework 2.0 That Was Installed 664
Workbook Closes Unexpectedly if the Name Contains a Square Bracket 664
The server committed a protocol violation. Section=ResponseHeader Detail=CR must be followed by LF 664
Reports Unavailable in IBM Cognos Connection Jobs after Using Save As Command in Report Studio 665
Unable to Correctly Display East Asian Characters 665
The Content of the Cell-based Report Shows #NAME? 665
Processing Issues 666
Cannot Render this Report 666
RDS Data Limit Exceeded When Importing from Large Report Outputs 666
RDS Server Unavailable 666
Imported Reports Are Missing Charts or Images 667
#ERROR Appears in Cells with Multiple Images in a Cell (Excel Only) 667
The Dispatcher Is Unable to Process the Request. The Request Is Directed to an Unknown Service Name:Content 667
Report Content is Not Imported 667
Incorrect Format for the Prompt Value in Prompted Reports 668
DPR-ERR-2079 Firewall Security Rejection 668
This item cannot be expanded. Microsoft Excel has reached the maximum number of rows or columns for this worksheet 669
Prompted to Log on for Each Imported Report 669
Object reference not set to an instance of an object 669
Error 0:RSV-BBP-0027 The Secondary Request Failed 669
Security Issues 669
IBM Cognos 8 for Microsoft Office Unable to Create Trust Relationship 670
Unable to View Reports After Clicking View Report 670
Report Data Service (RDS) Numbered Error Messages 670
RDS-ERR-1000 Report Data Service Could Not Process the Response from the Content Provider 670
RDS-ERR-1001 The PowerPlay ReportNameCould Not Be Run. The Expected Response Was Not Returned by PowerPlay 671
RDS-ERR-1004 A Connection Could Not Be Established with IBM Cognos 8 671
RDS-ERR-1005 The Logon Requirements for IBM Cognos 8 Could Not Be Obtained. You May Already Be Logged into this Namespace, or the Target Namespace Does Not Exist 672
RDS-ERR-1012 IBM Cognos Content Service was Unable to Discover the Content Pro-viders 672
RDS-ERR-1013 Report Data Service Was Unable to Query Content Manager 672
RDS-ERR-1014 Report Data Service Was Unable to Create the Document ObjectObject Name 672
RDS-ERR-1015 Report Data Service Was Unable to Create a New Document Version 672
RDS-ERR-1016 Report Data Service Was Unable to Create a New Document Content Object 672
RDS-ERR-1018 The IBM Cognos 8 ReportNameCould Not Be Run. The Expected Response Was Not Returned by IBM Cognos 8 673
RDS-ERR-1019 IBM Cognos Content Service Was Unable to Retrieve the Portal Information from IBM Cognos Connection 673
RDS-ERR-1020 The Currently Provided Credentials are Invalid. Please Provide the Logon Credentials 673
RDS-ERR-1021 The IBM Cognos 8 ReportNameCould Not be Run Because it Contains Unanswered Prompts. Please Provide the Prompt Answers, and Run the Report Again 674
RDS-ERR-1022 The Request Received by Report Data Service Is Not Valid 674
RDS-ERR-1023 The ReportNameCould Not Be Run Because It Exceeds the Report Data Service Data Size Limit Set by the Administrator 674
RDS-ERR-1027 The Encoding for the PowerPlay ServerNameCould Not Be Determined. ISO-8859-1 Will Be Used as the Encoding 674
RDS-ERR-1030 A Security Error Occurred While Trying to Establish a Connection with
Name 674
RDS-ERR-1031 Report Data Service was unable to retrieve the metadata forName 674
RDS-ERR-1033 Report Data Service Was Unable to Create the Report ViewName 674
RDS-ERR-1034 The Report Specification forNameCould Not Be Retrieved From IBM Cognos 8 675
RDS-ERR-1039 The Request Could Not Be Cancelled. The Request is No Longer Run-ning 675
RDS-ERR-1040 The Conversation WithConversation IDHas Been Cancelled 675
RDS-ERR-1044 The Output for the Requested Version for ObjectNameCould Not be Retrieved 675
RDS-ERR-1045 LayoutDataXML Output Was Not Generated for the Requested Version for Object [Name] 676
IBM Cognos 8 Go! Office Numbered Error Messages 676
COC-ERR-1003 Failed to Create Slide 676
COC-ERR-2005 The Import Failed 676
COC-ERR-2006 Failed to Load the Portal Tree:Name 677
COC-ERR-2012 Failed to Render the List 677
COC-ERR-2013 This Is an Unsupported Office Application 677
COC-ERR-2014 Refresh Failed 677
COC-ERR-2015 Failed to Open the Import Wizard Dialog 677
COC-ERR-2019 Failed to Refresh an Image 678
COC-ERR-2301 Logon Failed 678
COC-ERR-2303 This Report Is Not Valid for Rendering 678
COC-ERR-2304 This Is a Prompted Report. It Is Not Currently Supported 678
COC-ERR-2305 Microsoft Excel Returned an Error. Ensure That Microsoft Excel is Not in Edit Mode, Then Try Again 679
COC-ERR-2308 Report Specification is Empty 679
COC-ERR-2603 You Must Add a Slide to the Presentation Before Importing Any Con-tent 679
COC-ERR-2604 Cannot Render Empty List Object 679
COC-ERR-2607Microsoft Office Message 679
COC-ERR-2609 The Custom property "Property_Name" does not exist 679
IBM Cognos 8 for Microsoft Office Numbered Error Messages 680
COI-ERR-2002 Block type is not valid 680
COI-ERR-2005 This Version of Microsoft Office Is Not Supported 680
COI-ERR-2006 This Microsoft Office Product Is Not Supported 680
COI-ERR-2008 Unable to Retrieve from Resources. Tried '{0}' 680
COI-ERR-2009 Unable to Perform This Operation Because Microsoft Excel is in Edit Mode 681
COI-ERR-2010 The Name {0} is Not Valid. A Name Must Not Contain Both a Quote (") Character and an Apostrophe (') Character 681
COI-ERR-2011 The server did not return the expected response. Check that the gateway is valid. 681
IBM Cognos 8 BI Analysisfor Microsoft ExcelNumbered Error Messages 681
COR-ERR-2002 Block Type is Not Valid 681
COR-ERR-2005 Block Specification is Not Valid or Missing "{0}" 681
COR-ERR-2006 Unexpected Type: [Stacked Block] 681
COR-ERR-2007 Error Retrieving from Resources. Tried '{0}' 682
COR-ERR-2009 Name Formula is Not Valid 682
COR-ERR-2010 Formula is Not Valid 682
COR-ERR-2011 Prompted Metadata Is Not Supported 682
COR-ERR-2012 Unable to Load Metadata 682
COR-ERR-2013 Exploration Cannot Be Converted to Formula Based Because at Least One Context Item Contains a Selection 682
COR-ERR-2014 Due to Excel worksheet limitations the results may be truncated 682
COR-ERR-2015 Exploration Cannot Be Converted to Formula Based Because There is a Default Measure and a Measure on Either Rows or Columns 683
COR-ERR-2016 Unable to Retrieve PackageName 683
COR-ERR-2017 The Current Selection Did Not Return Any Data 683
Part 10: Reference Material
Appendix A: Round Trip Safety Configuration of Shift-JIS Characters 685
Example: Safe Conversion of Shift-JIS 686
The Round Trip Safety Configuration Utility 686
Specify Conversions 687
Specify Substitutions 688
Apply the Conversions and Substitutions 689
Restore the Default Conversion Settings 689
Specify Conversions for Series 7 PowerPlay Web Reports 690 Appendix B: Initial Access Permissions 691
Content Manager Hierarchy of Objects 691 Appendix C: Localization of Samples Databases 703
One Column Per Language 703
One Row Per Language 704
Transliterations and Multiscript Extensions 705 Appendix D: User Interface Elements Reference List 707
Elements You Can Hide 707
Elements You Can Add 714
Appendix E: User Reference Help for Portal Services 717
Cognos Navigator 717
Cognos Search 719
Cognos Viewer (IBM Cognos Connection) 721
Cognos Viewer 724
Appendix F: Schema for Data Source Commands 741
commandBlock 742
Child Elements of commandBlock Element 742
Parent Elements of commandBlock Element 742
commands 742
Child Elements of commands Element 742
Parent Elements of commands Element 742
sessionStartCommand 742
Child Elements of sessionStartCommand Element 743
Parent Elements of sessionStartCommand Element 743
sessionEndCommand 743
Child Elements of sessionEndCommand Element 743
Parent Elements of sessionEndCommand Element 743
arguments 744
Parent Elements of arguments Element 744
argument 744
Child Elements of argument Element 744
Parent Elements of argument Element 744
setCommand 745
sqlCommand 745
Child Elements of sqlCommand Element 745
Parent Elements of sqlCommand Element 745
sql 745
Child Elements of sql Element 745
Parent Elements of sql Element 745
name 745
Child Elements of name Element 746
Parent Elements of name Element 746
value 746
Child Elements of value Element 746
Parent Elements of value Element 747 Appendix G: Data Schema for Log Messages 749
Table Definitions 749 Appendix H: Performing Tasks in IBM Cognos 8 Using URLs 773
CGI Program and Alternative Gateways 773
URL Methods 774
Parameterized URL Method 774
cognosLaunch Method 775
Common Optional Parameters 776
URL Validation 776
Starting IBM Cognos 8 Components 777
Start Parameters 778
Starting IBM Cognos 8 Components in a Specified Browser Window 785
Access an IBM Cognos Connection Page 787
Preparing a Page for Standalone Access 788
Using Search Paths and Page IDs 788
Using a Page ID Instead of the Object Search Path 789 Glossary 791
Introduction
This document is intended for use with IBM Cognos 8. IBM Cognos 8 is a Web product with integrated reporting, analysis, scorecarding, and event management features.
This document contains step-by-step procedures and background information to help you administer IBM Cognos 8.
Audience
To use this guide, you should be familiar with reporting and security concepts, and have experience using a Web browser.
Related Documentation
Our documentation includes user guides, getting started guides, new features guides, readmes, and other materials to meet the needs of our varied audience. The following documents contain related information and may be referred to in this document.
Note: For online users of this document, a Web page such asThe page cannot be foundmay appear when clicking individual links in the following table. Documents are made available for your par-ticular installation and translation configuration. If a link is unavailable, you can access the document on the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html).
Description Document
Using IBM Cognos Connection to publish, find, manage, organize, and view IBM Cognos content, such as scorecards, reports, analyses, and agents IBM Cognos Connection User Guide
Creating self-service business intelligence reports Query Studio User Guide
Authoring reports that analyze corporate data according to specific needs
Report Studio Professional Authoring User Guide
Authoring financial reports that analyze corporate data according to specific needs
Report Studio Express Authoring User Guide
Creating and managing agents that monitor data and perform tasks when the data meets predefined thresholds
Event Studio User Guide
Creating and publishing models using Framework Manager
Description Document
Administering PowerPlay servers and deploying cubes and reports to PowerPlay users in Windows environments or on the Web
IBM Cognos PowerPlay Enterprise Server Guide
Viewing, exploring, formatting, and distributing PowerPlay reports using a Web browser
IBM Cognos PowerPlay Web User Guide
Viewing, finding, organizing, and sharing inform-ation in Upfront, the customizable interface used to publish IBM Cognos reports to the Web IBM Cognos Web Portal User Guide
Authoring scorecard applications and monitoring the metrics within them
Metric Studio User Guide
Using IBM Cognos 8 Go! Office to retrieve content from IBM Cognos reporting products within Microsoft Office
IBM Cognos 8 Go! Office User Guide
Exploring, analyzing, and comparing dimensional data
Analysis Studio User Guide
Describing features that are new in this release IBM Cognos 8 New Features
Installing and using the Localization Development Kit to translate and customize the messages and user interface text in IBM Cognos products Localization Development Kit Installation
and User Guide
Installing and using Map Manager to import and manage maps that are used in map reports Map Manager Installation and User Guide
Understanding the IBM Cognos 8 architecture, developing installation strategies, including security considerations, and optimizing performance IBM Cognos 8 Architecture and Deployment
Guide
Installing, upgrading, configuring, and testing IBM Cognos 8, changing application servers, and setting up samples
IBM Cognos 8 Installation and Configuration Guide
Creating a custom authentication provider or a trusted signon provider using the Custom Authentication Provider API
Custom Authentication Provider Developer Guide
Creating and publishing models using the Frame-work Manager API
Description Document
Creating and managing financial reports and administering the database
IBM Cognos Finance User Guide
Using the samples included with the IBM Cognos 8 SDK to learn how to automate IBM Cognos 8 IBM Cognos 8 Software Development Kit
Getting Started
Moving metadata and applications from IBM Cognos Series 7 to IBM Cognos 8
IBM Cognos 8 Migration Tools User Guide
Installing and Configuring IBM Cognos 8 Planning Products
IBM Cognos 8 Planning Installation and Configuration Guide
Finding Information
Product documentation is available in online help from theHelpmenu or button in IBM Cognos products.
To find the most current product documentation, including all localized documentation and knowledge base materials, access the IBM Cognos Resource Center (http://www.ibm.com/software/ data/support/cognos_crc.html).
You can also read PDF versions of the product readme files and installation guides directly from IBM Cognos product CDs.
Using Quick Tours
Quick tours are short online tutorials that illustrate key features in IBM Cognos product components. To view a quick tour, start IBM Cognos Connection and click theQuick Tourlink in the lower-right corner of the Welcome page.
Getting Help
For more information about using this product or for technical assistance, visit the IBM Cognos Resource Center (http://www.ibm.com/software/data/support/cognos_crc.html). This site provides information on support, professional services, and education.
Printing Copyright Material
You can print selected pages, a section, or the whole book. You are granted a exclusive, non-transferable license to use, copy, and reproduce the copyright materials, in printed or electronic format, solely for the purpose of operating, maintaining, and providing internal training on IBM Cognos software.
Chapter 1: What’s New?
This section contains a list ofnew,changed, anddeprecatedfeatures for this release. It also contains a cumulative list of similar information for previous releases. It will help you plan your upgrade and application deployment strategies and the training requirements for your users.
For information about upgrading, see theInstallation and Configuration Guidefor your product.
For information about other new features for this release, see theNew Features Guide.
For changes to previous versions, see:
● New Features in Version 8.3
● Changed Features in Version 8.3
To review an up-to-date list of environments supported by IBM Cognos products, such as operating systems, patches, browsers, Web servers, directory servers, database servers, and application servers, visit the IBM Cognos Resource Center Web site (http://www.ibm.com/software/data/support/cognos_ crc.html).
New Features in Version 8.4
Listed below are new features since the last release. Links to directly-related topics are included.
Additional Language Support
In addition to Japanese, German, and French, the installation documentation and the user interface for the installation program and IBM Cognos Configuration are available in the following languages:
● Chinese (simplified) ● Chinese (traditional) ● Korean
● Italian ● Spanish
● Portuguese (Brazilian)
You can use the new product languages when personalizing your user interface in IBM Cognos 8
(p. 260).
Support for IBM Metadata Workbench as a Lineage Solution
You can now configure IBM Metadata Workbench as a lineage solution in IBM Cognos 8. For more information, see"View Lineage Information for a Data Item" (p. 355).
Administrators can configure the lineage solution by specifying the lineage URI in IBM Cognos Administration(p. 151).
Access to IBM WebSphere Business Glossary
If you use the IBM WebSphere Business Glossary, you can now access the glossary from Cognos Viewer(p. 356).
You can configure the IBM WebSphere Business Glossary URL in IBM Cognos Administration
(p. 152).
Managing Comments Using Cognos Viewer
You can now add user-defined comments to saved HTML, PDF and XML reports using Cognos Viewer.
For more information, see(p. 369).
Adding Application Context to Dynamic SQL
An administrator can now define a custom string including application context that is added as a comment marker within SQL generated by the application.
For more information, see"Add Application Context to Dynamic SQL" (p. 147).
Support for New Data Sources
You can now use the following data sources in IBM Cognos 8:
● IBM Cognos Now! Cube(p. 158)
● IBM Infosphere Warehouse Cubing Services(p. 168)
● TM1(p. 178)
Support for New Portal Versions
IBM Cognos 8 Portal Services now provide extended support IBM WebSphere 6.0 and 6.1, and BEA AquaLogic User Interaction 6.5 (ALUI 6.5)
For more information, see"Deploying Cognos Portlets to Other Portals" (p. 441).
Hiding Entries
You can hide entries in IBM Cognos Connection and IBM Cognos Administration, such as reports, packages, pages, folders, jobs, data sources, portlets, and so on. This functionality is most often used with drill-through reports.
For more information, see"Hide an Entry" (p. 254).
Updating Published PowerCubes
You can now use thepcactivatecommand to make new versions of published PowerCubes available to users.
For more information, see"Deploy Updated PowerCubes" (p. 163).
Object Capabilities
You can now specify capabilities for individual packages.
For more information, see"Object Capabilities" (p. 229).
Schedule Credentials
When you choose to import schedules in the deployment, you can change the imported schedule credentials to your credentials.
For more information, see"Including Schedules" (p. 313).
Save History Details for Job Steps
You can save history details for job steps when the run activity completes successfully.
For more information, see"Job Properties" (p. 248).
Viewing Lineage Information
A data item’s lineage information traces the item’s metadata back through the package and the package’s data sources. Viewing lineage information ensures that you add the correct data items to a report.
For more information, see"View Lineage Information for a Data Item" (p. 355).
Enhanced Drill-through Capabilities
In earlier versions of IBM Cognos 8, model-based drill-through supported only reports created in Analysis Studio, Query Studio, or Report Studio as targets. Other types of drill-through targets are now supported. For example, you can drill through to PowerPlay Studio reports saved in the content store, or to a package that contains a PowerCube.
In earlier versions of IBM Cognos 8, drill-through access required the existence of parameters in the target. IBM Cognos 8 now allows dynamic filtering of the data. In cases where more control is needed, you can continue to use the existing parameterized drill-through.
You now also can restrict the availability of package drill-through definitions to measures as well as other data when you set the scope.
If the source is based on a dimensional package, you can choose what property of the source metadata item to map to the target. For example, you can map the member caption of the source metadata item to a relational value in the target instead of using the business key. For more information, see"Drill-through Access" (p. 401).
