IBM Cognos Business IntelligenceVersion 10.1.1

Administration and Security Guide

NoteBefore using this information and the product it supports, read the information in Notices on page 785.

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

Microsoft product screen shot(s) used with permission from Microsoft.

Licensed Materials - Property of IBM

Copyright IBM Corporation 2005, 2011.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

ContentsIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

Chapter 1. What's New? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1New Features in Version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Archived report output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1SharePoint 2010 integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Support for WebSphere 7.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Restricting search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Dashboards are now workspaces . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Content IDs during deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Support for running reports with report owner capabilities . . . . . . . . . . . . . . . . . . . 2Index search support for active reports . . . . . . . . . . . . . . . . . . . . . . . . . 3Safari 5 support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Secure the CAM passport cookie. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Specify the JMX proxy server host . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Internal postscript interface for printing on UNIX operating systems . . . . . . . . . . . . . . . 3

Changed features in version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Location of troubleshooting information . . . . . . . . . . . . . . . . . . . . . . . . . 4

Deprecated Features in Version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 4The Disable query plan caching Property . . . . . . . . . . . . . . . . . . . . . . . . . 4

New Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Dynamic Query Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4IBM Cognos Active Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5IBM Cognos Business Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Collaboration Using IBM Cognos Business Insight . . . . . . . . . . . . . . . . . . . . . . 5My Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6IBM Cognos Connection Login Page Customization . . . . . . . . . . . . . . . . . . . . . 6New Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6New Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Support for Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Style Management Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Support for New Scheduling Options . . . . . . . . . . . . . . . . . . . . . . . . . . 7Accessible Report Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Report Name Used for the Exported Output File Name . . . . . . . . . . . . . . . . . . . . 7New for Metric Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8New Deployment for Human Tasks and Annotations . . . . . . . . . . . . . . . . . . . . . 8New Data Schema Tables for Logging for Human Task and Annotation Services. . . . . . . . . . . . 8New for Data Movement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8New for Content Manager Load Management . . . . . . . . . . . . . . . . . . . . . . . 8New Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Convert Numeric Search Keys to Strings in Queries . . . . . . . . . . . . . . . . . . . . . 8Group 1 Language Support in IBM Cognos Business Intelligence . . . . . . . . . . . . . . . . . 9Curly Brackets and Parentheses are Breakable . . . . . . . . . . . . . . . . . . . . . . . 9

Changed Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Changes to Portlet and Portlet Group Names . . . . . . . . . . . . . . . . . . . . . . . 9Watch Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10IBM Cognos Report Studio Professional and Express Authoring Modes . . . . . . . . . . . . . . 10Enhanced Search Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Change of Name for IBM Metadata Workbench . . . . . . . . . . . . . . . . . . . . . . 10IBM Cognos Now! Name Has Changed . . . . . . . . . . . . . . . . . . . . . . . . . 10IBM Cognos 8 Portal Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Line break rules in PDFs have changed . . . . . . . . . . . . . . . . . . . . . . . . . 11

Deprecated Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Support for Excel 2000 and Excel 2000 Single Sheet Formats . . . . . . . . . . . . . . . . . . 11IBM Cognos PowerCube Connection Utility and cubeswap . . . . . . . . . . . . . . . . . . 11

Copyright IBM Corp. 2005, 2011 iii

New Features in Version 8.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Additional Language Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Support for IBM Metadata Workbench as a Lineage Solution . . . . . . . . . . . . . . . . . . 12Access to IBM InfoSphere Business Glossary . . . . . . . . . . . . . . . . . . . . . . . 12Managing Comments Using Cognos Viewer . . . . . . . . . . . . . . . . . . . . . . . 12Adding Application Context to Dynamic SQL . . . . . . . . . . . . . . . . . . . . . . . 12Support for New Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Support for New Portal Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Hiding Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Updating Published PowerCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Object Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Schedule Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Save History Details for Job Steps . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Viewing Lineage Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Enhanced Drill-through Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . 14Metric Studio Content in Portal Pages . . . . . . . . . . . . . . . . . . . . . . . . . 14

Changed Features in Version 8.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Composite Information Server is Replaced By IBM Cognos Virtual View Manager . . . . . . . . . . 14IBM Cognos 8 Portal Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Deprecated Features in Version 8.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . 15IBM Cognos 8 PowerCube Connection Utility and cubeswap . . . . . . . . . . . . . . . . . . 15

New Features in Version 8.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Improved User Interface for Administrators . . . . . . . . . . . . . . . . . . . . . . . 15Access to More Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15More Granular Administrative Capabilities . . . . . . . . . . . . . . . . . . . . . . . . 15Access to System Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Snapshot of System Health . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Managing Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Reducing Deployment Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Setting Priority on Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Better Control of Interactive Features in Reports . . . . . . . . . . . . . . . . . . . . . . 16New Sample Audit Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Publishing and Managing Packages in Non-root Folders . . . . . . . . . . . . . . . . . . . 17Enabling Report Studio Authoring Modes . . . . . . . . . . . . . . . . . . . . . . . . 17Server Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Transformer Integrated into IBM Cognos 8 . . . . . . . . . . . . . . . . . . . . . . . . 18My Activities and Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18My Watch Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Report Alerts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Watch Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Drilling Through on Multiple Values . . . . . . . . . . . . . . . . . . . . . . . . . . 19Go Directly to Target Report When Only One Target Report Exists . . . . . . . . . . . . . . . . 19Support for Microsoft Excel 2007 . . . . . . . . . . . . . . . . . . . . . . . . . . . 19Saving Report Outputs to a File System . . . . . . . . . . . . . . . . . . . . . . . . . 19Resubmitting Failed Jobs and Reports . . . . . . . . . . . . . . . . . . . . . . . . . 20Resubmitting Failed Agent Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Default Actions for Agent Items . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Tabbed Portal Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20Global Filters and Enhanced Portal Interactivity . . . . . . . . . . . . . . . . . . . . . . 20Metric Studio Content in Portal Pages . . . . . . . . . . . . . . . . . . . . . . . . . 21Support for Microsoft SharePoint Portal 2003 and 2007 . . . . . . . . . . . . . . . . . . . . 21

Changed Features in Version 8.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Updated IBM Cognos Connection Look . . . . . . . . . . . . . . . . . . . . . . . . . 21More Information in the Go To Page . . . . . . . . . . . . . . . . . . . . . . . . . . 22Cognos Watchlist Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Replaced Capability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Chapter 2. IBM Cognos Software Administration . . . . . . . . . . . . . . . . . . 23IBM Cognos Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23Automating Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Setting up a Multilingual Reporting Environment . . . . . . . . . . . . . . . . . . . . . . 27

iv IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Configuring Your Database For Multilingual Reporting . . . . . . . . . . . . . . . . . . . . . 28Installing Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

IBM Cognos Default Font. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Report Studio Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Set Up Printers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Configure Web Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Allow User Access to Series 7 Reports from IBM Cognos Connection . . . . . . . . . . . . . . . . 33Restricting Access to IBM Cognos Software . . . . . . . . . . . . . . . . . . . . . . . . . 34

Chapter 3. Building IBM Cognos Business Intelligence Applications . . . . . . . . . 37

Chapter 4. Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39The Sample Outdoors Company . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39The Sample Outdoors Group of Companies . . . . . . . . . . . . . . . . . . . . . . . . 40Employees. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Sales and Marketing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Sample Outdoors Database, Models, and Packages . . . . . . . . . . . . . . . . . . . . . . 43Setting Up the Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Restoring Backup Files for the Samples Databases . . . . . . . . . . . . . . . . . . . . . 46Restore Backup Files for Sample Databases for DB2 Using Scripts . . . . . . . . . . . . . . . . 48Restore Backup Files for Sample Databases for Oracle Using Scripts . . . . . . . . . . . . . . . 52Create Data Source Connections to the Samples Databases. . . . . . . . . . . . . . . . . . . 55Set Up Microsoft Analysis Services Cube Samples . . . . . . . . . . . . . . . . . . . . . 57Set Up the InfoSphere Warehouse Cubing Services Sample . . . . . . . . . . . . . . . . . . 58Set Up the TM1 Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Set Up the Essbase Cube Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Creating Data Source Connections to OLAP Data Sources . . . . . . . . . . . . . . . . . . . 61Setting Up the Metric Studio Sample . . . . . . . . . . . . . . . . . . . . . . . . . . 63Import the Samples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Sample Database Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Example - Running the Sample ELM Returns Agent Against Changed Data . . . . . . . . . . . . . 68Remove the Samples Databases from IBM Cognos BI . . . . . . . . . . . . . . . . . . . . 70

Chapter 5. Setting up Logging . . . . . . . . . . . . . . . . . . . . . . . . . 71Log Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

Logging Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Set Logging Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Audit Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Setting Up Audit Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Sample Audit Model and Audit Reports . . . . . . . . . . . . . . . . . . . . . . . . . 75

View Full Details for Secure Error Messages . . . . . . . . . . . . . . . . . . . . . . . . 81Disable the Creation of Core Dump Files . . . . . . . . . . . . . . . . . . . . . . . . . 81

Turn Off Core File Creation for IBM Cognos BI MR1 . . . . . . . . . . . . . . . . . . . . 82Turn Off Core File Creation for IBM Cognos BI MR2 and Later Versions . . . . . . . . . . . . . . 82

Use Logging to Diagnose a Problem for a Specific User. . . . . . . . . . . . . . . . . . . . . 82Disable Logging for a Specific User . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Chapter 6. System Performance Metrics . . . . . . . . . . . . . . . . . . . . . 87How Metric Data is Gathered . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87System Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Panes on the Status System Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Assess System Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99View Attributes for Metric Scores. . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Set Metric Threshold Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Reset Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Reset Metrics for the System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Refresh Report Service Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

Chapter 7. Server Administration . . . . . . . . . . . . . . . . . . . . . . . . 103Dispatchers and Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

Contents v

Stop and Start Dispatchers and Services . . . . . . . . . . . . . . . . . . . . . . . . 106Active Content Manager Service . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Remove Dispatchers from the Environment . . . . . . . . . . . . . . . . . . . . . . . 109Group Dispatchers in Configuration Folders . . . . . . . . . . . . . . . . . . . . . . . 110Advanced Dispatcher Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Specify Gateway Mappings for IBM Cognos Series 7 PowerPlay Data . . . . . . . . . . . . . . 113Rename Dispatchers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114Test Dispatchers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Failover for Multiple Dispatchers . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Securing Dispatchers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Specifying the dispatchers to host the JMX proxy server . . . . . . . . . . . . . . . . . . . 117

Content Manager Locations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Setting Advanced Content Manager Parameters . . . . . . . . . . . . . . . . . . . . . . 119Set the Cache Size Limit for the Content Manager Cache . . . . . . . . . . . . . . . . . . . 121Reduce the Content Manager Load by Storing User Session Files Locally . . . . . . . . . . . . . 122

Override the (Default) Locale Processing in the Prompt Cache . . . . . . . . . . . . . . . . . . 123Maintain the Content Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Before You Start Internal Content Store Maintenance . . . . . . . . . . . . . . . . . . . . 124Content Store Maintenance on External Namespaces . . . . . . . . . . . . . . . . . . . . 124Create a Content Store Maintenance Task . . . . . . . . . . . . . . . . . . . . . . . . 125Run a Content Store Maintenance Task . . . . . . . . . . . . . . . . . . . . . . . . . 125Starting and stopping background activities . . . . . . . . . . . . . . . . . . . . . . . 126

Migrating PowerPlay Reports Published to IBM Cognos BI . . . . . . . . . . . . . . . . . . . 126Tune Server Performance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

Set Server Group Names for Advanced Dispatcher Routing . . . . . . . . . . . . . . . . . . 127Balance Requests Among Dispatchers . . . . . . . . . . . . . . . . . . . . . . . . . 127Balance Dispatcher Load with In-Progress Request Factor . . . . . . . . . . . . . . . . . . 128Use Cluster Compatible Mode for Dispatchers . . . . . . . . . . . . . . . . . . . . . . 130Balance the Data Movement Task Execution Load . . . . . . . . . . . . . . . . . . . . . 130Set Usage Peak Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Maximum Number of Processes and Connections . . . . . . . . . . . . . . . . . . . . . 132Specify Queue Time Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134PDF File Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Set Maximum Execution Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138Specify How Long to Keep Watch List Report Output . . . . . . . . . . . . . . . . . . . . 139Limit Hotspots That are Generated in an Analysis Studio or Report Studio Chart . . . . . . . . . . 140Setting E-mail Attachment Maximum Size Configuration Parameters . . . . . . . . . . . . . . . 141Set Compression for Email Attachments . . . . . . . . . . . . . . . . . . . . . . . . 142Set the Report Size Limit for the Report Data Service . . . . . . . . . . . . . . . . . . . . 142Exclude the context ID for an agent from IBM WebSphere web service tasks . . . . . . . . . . . . 143

Tune Metric Studio Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144Query Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145

Concurrent Query Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145Set Query Prioritization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Conversion of Numeric Search Keys to Strings in Queries . . . . . . . . . . . . . . . . . . 150

Session Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Disable Session Caching at Server Level . . . . . . . . . . . . . . . . . . . . . . . . 152Disable Session Caching at the Package or Report Level . . . . . . . . . . . . . . . . . . . 152

Secure the CAM Passport Cookie. . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Enabling the HTTPOnly parameter . . . . . . . . . . . . . . . . . . . . . . . . . . 152

Reduce Decimal Precision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Saved Report Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

Set File Location to Save a Copy of Report Output Outside of IBM Cognos Software . . . . . . . . . 154File Location to Save a Copy of Report Output in IBM Cognos Software . . . . . . . . . . . . . 155

Supporting large worksheets in Microsoft Excel . . . . . . . . . . . . . . . . . . . . . . . 156Configuring report and batch report services to use large worksheets . . . . . . . . . . . . . . 157

Enable Accessible Report Output Using System-wide Settings . . . . . . . . . . . . . . . . . . 157Configure the Lineage Solution . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Configure the IBM InfoSphere Business Glossary URI . . . . . . . . . . . . . . . . . . . . . 160Configuring the Collaboration Discovery URI . . . . . . . . . . . . . . . . . . . . . . . 160Enable Job, SMTP, and Task Queue Metrics . . . . . . . . . . . . . . . . . . . . . . . . 161

vi IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Set Lifetime of Completed Human Tasks and Annotations (Comments) . . . . . . . . . . . . . . . 162Changing Drill-Through Filter Behavior . . . . . . . . . . . . . . . . . . . . . . . . . 163Restricting searches of IBM Cognos content . . . . . . . . . . . . . . . . . . . . . . . . 163Printing from UNIX operating systems . . . . . . . . . . . . . . . . . . . . . . . . . . 164

Editing RSVP.PRINT.POSTSCRIPT . . . . . . . . . . . . . . . . . . . . . . . . . . 165Controlling whether URL parameters sent to Content Manager . . . . . . . . . . . . . . . . . . 165

Chapter 8. Data Sources and Connections . . . . . . . . . . . . . . . . . . . . 167DB2 Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168

DB2 Connection Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168IBM Cognos Cubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169

IBM Cognos Finance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170IBM Cognos Now! - Real-time Monitoring Cube. . . . . . . . . . . . . . . . . . . . . . 170IBM Cognos Planning Contributor . . . . . . . . . . . . . . . . . . . . . . . . . . 171IBM Cognos Planning - Series 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . 171IBM Cognos PowerCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

Oracle Essbase Data Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Configure Scenario Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Specify Balanced Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176Specify Measure Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

IBM InfoSphere Warehouse Cubing Services . . . . . . . . . . . . . . . . . . . . . . . . 178Informix Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179Microsoft Analysis Services Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . 180Microsoft SQL Server Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Microsoft SQL Server Connection Parameters. . . . . . . . . . . . . . . . . . . . . . . 185ODBC Data Source Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

ODBC Connection Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187Oracle Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Oracle Connection Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189SAP Business Information Warehouse (SAP BW) Data Sources . . . . . . . . . . . . . . . . . . 190

Application Server Logon Type Connection Parameters . . . . . . . . . . . . . . . . . . . 190Destination Logon Type Connection Parameters . . . . . . . . . . . . . . . . . . . . . . 191Message Server Logon Type Connection Parameters . . . . . . . . . . . . . . . . . . . . 192

Sybase Adaptive Server Enterprise Data Sources. . . . . . . . . . . . . . . . . . . . . . . 193TM1 Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194XML Data Sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Data Source Creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197

Create a Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Deploy Updated PowerCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Add or Modify a Data Source Connection . . . . . . . . . . . . . . . . . . . . . . . . . 200

Create a New Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Modify a Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Data Source Connection Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Change Data Source Connection Settings . . . . . . . . . . . . . . . . . . . . . . . . 202

Create or Modify a Data Source Signon. . . . . . . . . . . . . . . . . . . . . . . . . . 203Create a Signon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Modify a Signon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Specifying Isolation Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Passing IBM Cognos Context to a Database . . . . . . . . . . . . . . . . . . . . . . . . 207

Using Command Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Example - Open Connection Command Block . . . . . . . . . . . . . . . . . . . . . . 210Example - Close Connection Command Block . . . . . . . . . . . . . . . . . . . . . . 210Example - Passing Request Information . . . . . . . . . . . . . . . . . . . . . . . . 210Example - Using Parameter Maps . . . . . . . . . . . . . . . . . . . . . . . . . . 211Example - Passing Authentication Provider Details . . . . . . . . . . . . . . . . . . . . . 211Example - Using Command Blocks for Proxy Connections . . . . . . . . . . . . . . . . . . 211Example - Using Command Blocks for Virtual Private Databases for Oracle . . . . . . . . . . . . 212Trusted Database Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Add Command Blocks While Creating a Data Source . . . . . . . . . . . . . . . . . . . . 213Add or Modify Command Blocks for a Connection. . . . . . . . . . . . . . . . . . . . . 214Using DB2 CLI Connection Attributes for DB2 . . . . . . . . . . . . . . . . . . . . . . 214

Contents vii

Add Application Context to Dynamic SQL . . . . . . . . . . . . . . . . . . . . . . . 216Securing Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Chapter 9. Query Service Administration . . . . . . . . . . . . . . . . . . . . 221Query Service Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221Query Service Caching Administration . . . . . . . . . . . . . . . . . . . . . . . . . . 223

Clear Everything in the Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223Analyze Cache Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Create and Schedule Query Service Administration Tasks . . . . . . . . . . . . . . . . . . 225

Chapter 10. Back Up Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 227Back Up the Content Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227Back Up Framework Manager Projects and Models. . . . . . . . . . . . . . . . . . . . . . 227

Chapter 11. IBM Cognos Content Archival . . . . . . . . . . . . . . . . . . . . 229External repository data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Creating a connection to a file system . . . . . . . . . . . . . . . . . . . . . . . . . . 231Specifying an external repository for report output . . . . . . . . . . . . . . . . . . . . . . 232Creating content archival content maintenance tasks . . . . . . . . . . . . . . . . . . . . . 233Creating a retention rule update maintenance task . . . . . . . . . . . . . . . . . . . . . . 233Creating a content removal content maintenance task . . . . . . . . . . . . . . . . . . . . . 234Finding content in your external repository . . . . . . . . . . . . . . . . . . . . . . . . 235Searching archived content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

Chapter 12. Data Movement Entries . . . . . . . . . . . . . . . . . . . . . . . 237Run a Data Movement Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238Change Default Data Movement Entry Properties . . . . . . . . . . . . . . . . . . . . . . 238Create a Data Movement View . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239

Chapter 13. Security Model . . . . . . . . . . . . . . . . . . . . . . . . . . 241Authentication Providers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Deleting or Restoring Unconfigured Namespaces . . . . . . . . . . . . . . . . . . . . . 242Authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243Cognos Namespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244IBM Cognos Application Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . . 244

Data Validation and Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . 245Logging and Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Chapter 14. Users, Groups, and Roles. . . . . . . . . . . . . . . . . . . . . . 247Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

User Locales. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Groups and Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

Create a Cognos Group or Role . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Add or Remove Members of a Cognos Group or Role . . . . . . . . . . . . . . . . . . . . 251

Chapter 15. Access Permissions and Credentials . . . . . . . . . . . . . . . . . 253Set Access Permission for Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Set Access Permissions for an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . 257Trusted Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258

Create Trusted Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258Manage Your Own Data Source Credentials . . . . . . . . . . . . . . . . . . . . . . . . 259Save Data Source Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260View and Remove Your Data Source Credentials . . . . . . . . . . . . . . . . . . . . . . 260

Chapter 16. Secured Functions and Features. . . . . . . . . . . . . . . . . . . 261Set Access to a Secured Function or Feature . . . . . . . . . . . . . . . . . . . . . . . . 267Set Access to User Interface Profiles for Report Authors . . . . . . . . . . . . . . . . . . . . 269

Chapter 17. Object Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . 271viii IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Set Up Object Capabilities for a Package . . . . . . . . . . . . . . . . . . . . . . . . . 273

Chapter 18. Initial Security. . . . . . . . . . . . . . . . . . . . . . . . . . . 275Built-in Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275Predefined Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276Specify Security Settings After Installation . . . . . . . . . . . . . . . . . . . . . . . . . 278System Administrators and Predefined Roles . . . . . . . . . . . . . . . . . . . . . . . . 279Cognos Namespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279Securing the Content Store . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280

Chapter 19. IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . . . 281Log On . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281Log Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Create a Shortcut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Create a URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Bookmark an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284

Using Any Web Browsers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284Using Internet Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

Entry Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285General Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288Report, Query, Analysis, and PowerPlay Report Properties . . . . . . . . . . . . . . . . . . 289Job Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Agent Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Page Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292Rule Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Organizing Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293Copy an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Move an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294Rename an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295Disable an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296Hide an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Select a Link for an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Delete an Entry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299Specify the Order of Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299Create a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300

Specify an Alternative Icon for an Entry . . . . . . . . . . . . . . . . . . . . . . . . . 301Search options in IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . . . . . 301

Searching for entries using name, description, and name or description . . . . . . . . . . . . . . 302Searching for entries using full text and all fields . . . . . . . . . . . . . . . . . . . . . 303

Search for an Entry in Multiple Languages . . . . . . . . . . . . . . . . . . . . . . . . 303Personalize the Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304My Watch Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

View Watch Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308Remove Yourself from an Alert List . . . . . . . . . . . . . . . . . . . . . . . . . . 308Edit a Watch Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Chapter 20. Pages and Dashboards . . . . . . . . . . . . . . . . . . . . . . . 311Create a Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Edit a Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Share a Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Modify a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Enable Communication Between Cognos Portlets . . . . . . . . . . . . . . . . . . . . . . 315Portal Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

Add a Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Delete a Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318Reorder the Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

Change Your Home Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319Create a Dashboard with Multiple Tabs . . . . . . . . . . . . . . . . . . . . . . . . . 319

Implement global filters in multi-tabbed dashboards . . . . . . . . . . . . . . . . . . . . 322

Contents ix

Adding Interactivity to Pages and Dashboards . . . . . . . . . . . . . . . . . . . . . . . 322Defining Global Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Enable Sharing of Drill-up and Drill-down Actions . . . . . . . . . . . . . . . . . . . . . 326Enable Sharing of Drill-through Actions . . . . . . . . . . . . . . . . . . . . . . . . 327

Chapter 21. Activities Management . . . . . . . . . . . . . . . . . . . . . . . 329Manage Current Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Manage Past Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331Manage Upcoming Activities for a Specific Day . . . . . . . . . . . . . . . . . . . . . . . 332Manage Suspended Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Suspend entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334View a list of suspended entries for a specific day . . . . . . . . . . . . . . . . . . . . . 335

Manage Scheduled Activities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335Manage Entry Run Priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337View the Run History for Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338Specify How Long to Keep Run Histories . . . . . . . . . . . . . . . . . . . . . . . . . 340Rerun a Failed Entry Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

Chapter 22. Schedule Management . . . . . . . . . . . . . . . . . . . . . . . 343Schedule an Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

Example - Schedule an Entry on the Last Day of the Month . . . . . . . . . . . . . . . . . . 346Example - Change the Credentials for a Schedule . . . . . . . . . . . . . . . . . . . . . 346

Use Jobs to Schedule Multiple Entries . . . . . . . . . . . . . . . . . . . . . . . . . . 346Cached Prompt Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348

Trigger-based Entry Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349Setting Up Trigger-based Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . 349Schedule an Entry Based on an Occurrence . . . . . . . . . . . . . . . . . . . . . . . 350

Chapter 23. Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Deployment Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Deployment Archives. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Deployment Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352

Security and Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352Deploying the Entire Content Store . . . . . . . . . . . . . . . . . . . . . . . . . . 353Deploying Selected Public Folders and Directory Content . . . . . . . . . . . . . . . . . . 355

Advanced Deployment Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359Specify if Report Output is Part of Deployment . . . . . . . . . . . . . . . . . . . . . . 360Specify if Configuration Objects and Children are Part of Deployment . . . . . . . . . . . . . . 360

Deployment Conflict Resolution Rules When Importing and Exporting . . . . . . . . . . . . . . . 361Conflict Resolution Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Conflict Resolution Rules For Deploying the Entire Content Store . . . . . . . . . . . . . . . . 362Conflict Resolution Rules For Partial Deployment . . . . . . . . . . . . . . . . . . . . . 364

Deploying IBM Cognos Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365Exporting from a Source Environment . . . . . . . . . . . . . . . . . . . . . . . . . 366Move the Deployment Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . 369Importing to a Target Environment . . . . . . . . . . . . . . . . . . . . . . . . . . 370Include Configuration Objects in Import of Entire Content Store . . . . . . . . . . . . . . . . 372Testing Deployed Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

Upgrade Report Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Content ID assignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374Deploy Human Task and Annotation Services . . . . . . . . . . . . . . . . . . . . . . . 375Deploying IBM Cognos Business Insight comments . . . . . . . . . . . . . . . . . . . . . 376

Storing and reporting on IBM Cognos Business Insight comments . . . . . . . . . . . . . . . . 377

Chapter 24. Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Data Trees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Creating a Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380

Create a Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380Create a Package for a PowerCube . . . . . . . . . . . . . . . . . . . . . . . . . . 381Create a Package for SAP BW . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

x IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

View Data Sources Used by a Package . . . . . . . . . . . . . . . . . . . . . . . . . . 384Configure or Reconfigure a Package . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

Set Permissions for Package Configuration . . . . . . . . . . . . . . . . . . . . . . . 385Remove a Package Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . 385

Select Which Data Sources Can Be Used to Create a Package . . . . . . . . . . . . . . . . . . 385

Chapter 25. Managing User Profiles . . . . . . . . . . . . . . . . . . . . . . . 387Edit the Default User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387View or Change a User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

View or Change a User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . 388Delete Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

Delete a User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389Copy a User Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

Chapter 26. Administering Microsoft Office Documents . . . . . . . . . . . . . . 393Deploying IBM Cognos for Microsoft Office Client . . . . . . . . . . . . . . . . . . . . . . 393

Set Macro Security Level for Microsoft Office XP . . . . . . . . . . . . . . . . . . . . . 394Install the CA Certificate for the HTTPS Interface to Series 7 PowerPlay . . . . . . . . . . . . . . 394

Download a Microsoft Office Document . . . . . . . . . . . . . . . . . . . . . . . . . 394

Chapter 27. Reports and Cubes . . . . . . . . . . . . . . . . . . . . . . . . 397IBM Cognos Active Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398View, Run, or Open a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398Set Default Report Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Set Report Options for the Current Run . . . . . . . . . . . . . . . . . . . . . . . . . 400Set Advanced Report Options for the Current Run . . . . . . . . . . . . . . . . . . . . . . 401Set Advanced PDF Options for a Report . . . . . . . . . . . . . . . . . . . . . . . . . 404Running reports with report owner capabilities . . . . . . . . . . . . . . . . . . . . . . . 405Create a Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Creating a Query Studio Report Without Using Actual Data . . . . . . . . . . . . . . . . . . 406Create a Report View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407View Lineage Information for a Data Item. . . . . . . . . . . . . . . . . . . . . . . . . 408Access the IBM InfoSphere Business Glossary . . . . . . . . . . . . . . . . . . . . . . . 408Editing a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

Edit a Report in IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . . . . . 410Edit a Query Studio Report in Report Studio . . . . . . . . . . . . . . . . . . . . . . . 410

Report Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410HTML Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410XML Format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411PDF Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411Microsoft Excel Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411CSV Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Report Languages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Add Multilingual Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413Specify the Default Language for a Report . . . . . . . . . . . . . . . . . . . . . . . 413

Specify the Default Prompt Values for a Report . . . . . . . . . . . . . . . . . . . . . . . 414Save Report Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415Enabling Accessible Report Output . . . . . . . . . . . . . . . . . . . . . . . . . . . 416

Enable accessible report output using the run option . . . . . . . . . . . . . . . . . . . . 416Enable accessible report output using set properties . . . . . . . . . . . . . . . . . . . . 416Enable accessible report output as a user preference . . . . . . . . . . . . . . . . . . . . 416Enable accessible output for a scheduled entry . . . . . . . . . . . . . . . . . . . . . . 417Enable accessible output for a job . . . . . . . . . . . . . . . . . . . . . . . . . . 417Enable accessible output for a step in a job . . . . . . . . . . . . . . . . . . . . . . . 417

View Report Output Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Viewing archived report output . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418Specifying how long to keep report output versions . . . . . . . . . . . . . . . . . . . . . 419Specify How Long to Keep Report Output Histories . . . . . . . . . . . . . . . . . . . . . 419Specifying an external repository for report output . . . . . . . . . . . . . . . . . . . . . . 420Enable an Alert List for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Contents xi

Adding or Removing Yourself from the Alert List for a Report . . . . . . . . . . . . . . . . . . 421Add Yourself to an Alert List in IBM Cognos Connection. . . . . . . . . . . . . . . . . . . 421Remove Yourself from an Alert List in IBM Cognos Connection . . . . . . . . . . . . . . . . 422Add or Remove Yourself from an Alert List in IBM Cognos Viewer . . . . . . . . . . . . . . . 422

Remove Users From an Alert List . . . . . . . . . . . . . . . . . . . . . . . . . . . 422Watch Rules in Saved Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

Enable Watch Rules for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 423Create a Watch Rule for a Specific Condition . . . . . . . . . . . . . . . . . . . . . . . 423Create a Watch Rule for Different Condition Status Indicators . . . . . . . . . . . . . . . . . 424Define the Alert Details for the Watch Rule . . . . . . . . . . . . . . . . . . . . . . . 425View, Edit, or Delete a Watch Rule in IBM Cognos Viewer . . . . . . . . . . . . . . . . . . 426

Comments in Saved Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426Enable Comments in Saved Output Versions . . . . . . . . . . . . . . . . . . . . . . . 427Add Comments to a Report Version in IBM Cognos Viewer . . . . . . . . . . . . . . . . . . 427Viewing, Modifying, or Deleting Comments in IBM Cognos Viewer . . . . . . . . . . . . . . . 428

Disable Selection-based Interactivity . . . . . . . . . . . . . . . . . . . . . . . . . . . 429Exclude Blank Pages in PDF Reports . . . . . . . . . . . . . . . . . . . . . . . . . . 429Distributing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430

Saving a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430Sending a Report by Email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431Sending a Report to your Mobile Device . . . . . . . . . . . . . . . . . . . . . . . . 431Printing a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431Distributing a Report by Bursting . . . . . . . . . . . . . . . . . . . . . . . . . . 431Creating Distribution Lists and Contacts . . . . . . . . . . . . . . . . . . . . . . . . 432

Drilling to View Related Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433Drill Up or Drill Down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433Drill Through to Another Target . . . . . . . . . . . . . . . . . . . . . . . . . . . 434Drill Through to Another Target Passing Multiple Values . . . . . . . . . . . . . . . . . . . 435

Data Sources With Named Sets May Produce Unpredictable Results . . . . . . . . . . . . . . . . 436Series 7 Reports in IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . . . . . 436

Series 7 PowerPlay Reports and Cubes . . . . . . . . . . . . . . . . . . . . . . . . . 437Single Signon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437Run or Open a Series 7 PowerPlay Report . . . . . . . . . . . . . . . . . . . . . . . . 438Change the Defaults for a Series 7 PowerPlay Report . . . . . . . . . . . . . . . . . . . . 439Open a Series 7 Cube. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439Multilingual Properties for Series 7 Reports and Cubes . . . . . . . . . . . . . . . . . . . 440

Chapter 28. Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441Run an Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441Change Default Agent Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442Create an Agent View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442Open or Create an Agent from IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . 444Enable an Alert List for an Agent. . . . . . . . . . . . . . . . . . . . . . . . . . . . 444Adding Yourself to or Remove Yourself from an Alert List for an Agent . . . . . . . . . . . . . . . 445

Add Yourself to or Removing Yourself from One Alert List . . . . . . . . . . . . . . . . . . 445Remove Yourself from Multiple Alert Lists . . . . . . . . . . . . . . . . . . . . . . . 446

Remove All Users from the Alert List for an Agent . . . . . . . . . . . . . . . . . . . . . . 446Receive News Item Headlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446View the Most Recent Event List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446

Chapter 29. Managing Human Tasks . . . . . . . . . . . . . . . . . . . . . . 449Open the Task Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449Viewing your Task Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449Filter Tasks in your Inbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449Approval Requests and Ad-hoc Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . 450

View Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450Subscribe to E-mail Notifications . . . . . . . . . . . . . . . . . . . . . . . . . . . 451Create an Ad-hoc Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

Actions That You can Perform on Approval Requests and Ad-hoc Tasks . . . . . . . . . . . . . . . 453Claim a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

xii IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Change the Recipients for a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Change the Current Owner. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454Change the Potential Owners and Stakeholders . . . . . . . . . . . . . . . . . . . . . . 454Revoke Ownership of a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Set Deadlines for a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Change the Priority of a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Add Comments to a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Start or Stop a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Completing a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Cancel a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457

Notification Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457Create a Notification Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458Read and Acknowledge a Notification Request . . . . . . . . . . . . . . . . . . . . . . 459

Archive Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459View the Task Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

Chapter 30. Metric Studio Metrics. . . . . . . . . . . . . . . . . . . . . . . . 461Create a Metric Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

Change the Default Action for Packages . . . . . . . . . . . . . . . . . . . . . . . . 462Run a Metric Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462

Run a Task Now . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462Schedule a Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463Delete a Metric Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463Modify a Metric Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

Metric Import Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463Create New Metric Import Task . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Edit Metric Import Task Properties . . . . . . . . . . . . . . . . . . . . . . . . . . 465

Metric Maintenance Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465New Metric Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466Edit Metric Maintenance Properties . . . . . . . . . . . . . . . . . . . . . . . . . . 466

Metric Export Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467Change Metric Export Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . 469

Chapter 31. Managing Index Search. . . . . . . . . . . . . . . . . . . . . . . 471Create an Index Update Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471Run an Index Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473Restrict Content Searches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Refine the Scope of the Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474Manage Data Collection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476Limit Index by Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476Adjust Results Relevance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477Suggest Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477Integrate with Another Search Engine . . . . . . . . . . . . . . . . . . . . . . . . . . 478Publish Content to an Enterprise Search Engine . . . . . . . . . . . . . . . . . . . . . . . 481

Publish Content on Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482Publish Content on UNIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483

Include Access Control Information in the Index . . . . . . . . . . . . . . . . . . . . . . 484Secure Search Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484Collect Statistics About the Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . 485Set Advanced Parameter to Control Resources for Index Update . . . . . . . . . . . . . . . . . 486Change Index Data Service Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 486Index and Search Rules for Workspaces . . . . . . . . . . . . . . . . . . . . . . . . . 487

Chapter 32. Drill-through Access . . . . . . . . . . . . . . . . . . . . . . . . 489Understanding Drill-through Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . 490

Drill-through Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490Selection Contexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491Drilling Through to Different Report Formats . . . . . . . . . . . . . . . . . . . . . . 491Drilling Through Between Packages . . . . . . . . . . . . . . . . . . . . . . . . . . 492Bookmark References. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492

Contents xiii

Members and Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492Member Unique Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493Conformed Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494Business Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 495Mapped Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496Drilling Through on Dates Between PowerCubes and Relational Packages . . . . . . . . . . . . . 497

Set Up Drill-through Access in Packages . . . . . . . . . . . . . . . . . . . . . . . . . 497Steps to Edit an Existing Drill-through Definition . . . . . . . . . . . . . . . . . . . . . 499Setting Up Parameters for a Drill-Through Report . . . . . . . . . . . . . . . . . . . . . 500

Example - Drill Through Between OLAP Reports in the Same Package . . . . . . . . . . . . . . . 502Check the Target and Source Report . . . . . . . . . . . . . . . . . . . . . . . . . . 503Create and Test the Drill-through Definition . . . . . . . . . . . . . . . . . . . . . . . 503

Example - Drill Through from an OLAP Report to a DMR Report . . . . . . . . . . . . . . . . . 504Check the Target and Source Reports . . . . . . . . . . . . . . . . . . . . . . . . . 505Create and Test the Drill-through Definition . . . . . . . . . . . . . . . . . . . . . . . 506

Debugging a Drill-through Definition . . . . . . . . . . . . . . . . . . . . . . . . . . 507Access the Drill-through Assistant . . . . . . . . . . . . . . . . . . . . . . . . . . . 508Example - Debugging a Drill-through Definition . . . . . . . . . . . . . . . . . . . . . . 509Set Up Drill-through Access in a Report . . . . . . . . . . . . . . . . . . . . . . . . . 510Example - Drill Through to a Hidden Report from a Report Studio Report . . . . . . . . . . . . . . 511

Check the Target Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511Create and Test the Drill-Through Definition . . . . . . . . . . . . . . . . . . . . . . . 511

Specify the Drill-through Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Set Up Drill-through Access from IBM Cognos Visualizer . . . . . . . . . . . . . . . . . . . 513Set Up Drill-through Access from PowerPlay Web . . . . . . . . . . . . . . . . . . . . . . 514Create and Test the Target for a Series 7 Report . . . . . . . . . . . . . . . . . . . . . . . 514

Chapter 33. Managing Portlets and Styles . . . . . . . . . . . . . . . . . . . . 517Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

Cognos Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517Using TM1 Viewer Portlets in IBM Cognos 8 . . . . . . . . . . . . . . . . . . . . . . . 520Other Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Import Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Control Access to Portlets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Configure the Portlet Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Modify a Portlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Display the HTML Code From the Source RSS Feed in RSS Viewer and IBM Cognos Navigator . . . . . . 527

Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Add a New Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Control Access to Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Modify a Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

Chapter 34. Deploying Cognos Portlets to Other Portals . . . . . . . . . . . . . . 533Deploying Cognos Portlets to WebSphere Portal 6.0, 6.1, and 7.0 . . . . . . . . . . . . . . . . . 533

Install the Portlet Applications File . . . . . . . . . . . . . . . . . . . . . . . . . . 534Configure the Portlet Applications . . . . . . . . . . . . . . . . . . . . . . . . . . 535Configure the Portlet Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536Customize the Content of Cognos Portlets. . . . . . . . . . . . . . . . . . . . . . . . 536Special Considerations for WebSphere Portal 6.0 and 6.1 . . . . . . . . . . . . . . . . . . . 537

Deploying Cognos Portlets to SAP Enterprise Portal 6.0, 6.4, 7.0 and 7.1 . . . . . . . . . . . . . . . 537Install the IBM Cognos Business Package for Versions 6.0, 6.4 and 7.0 . . . . . . . . . . . . . . 538Install the IBM Cognos Business Package for Version 7.1 . . . . . . . . . . . . . . . . . . . 539Edit Properties for the iViews . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Set the Default iView Content and Appearance for All Users . . . . . . . . . . . . . . . . . 541

Deploying Cognos Portlets to Oracle WebCenter Interaction Portal 10.3 . . . . . . . . . . . . . . . 541Start the Remote Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542Import the Cognos Portlet Package File. . . . . . . . . . . . . . . . . . . . . . . . . 545Connect to the Remote Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Customize the Content of Cognos Portlets. . . . . . . . . . . . . . . . . . . . . . . . 546

xiv IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Deploying Cognos Portlets to Microsoft SharePoint Portal Server 2003 . . . . . . . . . . . . . . . 546Set up Virtual Directories and Change the Gateway URIs. . . . . . . . . . . . . . . . . . . 547Copy the Cognos Web Parts Resources to the IIS HTTP Root Directory . . . . . . . . . . . . . . 548Set Up the IBM Cognos Security Trust File . . . . . . . . . . . . . . . . . . . . . . . 549Modify the .NET Framework web.config File . . . . . . . . . . . . . . . . . . . . . . . 550Edit the Cognos Web Parts Catalog Files . . . . . . . . . . . . . . . . . . . . . . . . 553Restart IIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553Add Cognos Web Parts to a SharePoint Page . . . . . . . . . . . . . . . . . . . . . . . 553Customize the Content of Cognos Web Parts . . . . . . . . . . . . . . . . . . . . . . . 554

Deploying Cognos Portlets to Microsoft SharePoint Portal Server 2007 and 2010 . . . . . . . . . . . . 555Deploy IBM Cognos Web Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . 556Restart IIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558Configure Cognos Web Part connection settings . . . . . . . . . . . . . . . . . . . . . . 558Configure Cognos Web Part preferences . . . . . . . . . . . . . . . . . . . . . . . . 558Configure Microsoft Internet Information Services (IIS) Manager for SharePoint 2010 . . . . . . . . . 559IBM Cognos BI and SharePoint 2010 Collaboration . . . . . . . . . . . . . . . . . . . . . 560

Migrating Cognos Portlets from IBM Cognos ReportNet 1.1 to IBM Cognos BI . . . . . . . . . . . . 561Change the Root Name of File Paths in Cognos Portlets . . . . . . . . . . . . . . . . . . . . 562Disable the Transfer of the IBM Cognos Passport ID as a URL Parameter . . . . . . . . . . . . . . 562Set Portal Services Protocol Scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Configuring Security for Portal Services . . . . . . . . . . . . . . . . . . . . . . . . . 564

Disable Anonymous Access to IBM Cognos Components . . . . . . . . . . . . . . . . . . . 564Enable Single Signon Using Shared Secret . . . . . . . . . . . . . . . . . . . . . . . . 565Enable Single Signon for SAP EP with the SAP Logon Ticket . . . . . . . . . . . . . . . . . 570Enable Single Signon for SAP EP with User Mapping . . . . . . . . . . . . . . . . . . . . 571Enable Secure Communication Between SAP EP and IBM Cognos Components . . . . . . . . . . . 572Enable Single Signon for WebSphere Portal Using the Application Server . . . . . . . . . . . . . 572Enable Single Signon for Oracle WebCenter Interaction Portal Using Basic Authentication . . . . . . . . 572Enable Single Signon for Oracle WebCenter Interaction Portal Using SiteMinder . . . . . . . . . . . 573

Chapter 35. Customizing the Appearance of IBM Cognos BI . . . . . . . . . . . . 575Predefined Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575IBM Cognos Components Affected by Styles . . . . . . . . . . . . . . . . . . . . . . . . 575Using the Style Management Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

XML Style Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576IBM Cognos Connection and IBM Cognos Administration . . . . . . . . . . . . . . . . . . 576Report Studio, IBM Cognos Viewer, Query Studio, and Prompt Pages . . . . . . . . . . . . . . 577Style Management Utility Commands . . . . . . . . . . . . . . . . . . . . . . . . . 578Creating a Custom Style. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579

Create a Custom Style Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581Customized Environment and the Corporate Style . . . . . . . . . . . . . . . . . . . . . . 582Making Other Style Changes to all Components . . . . . . . . . . . . . . . . . . . . . . . 582

Rebranding the IBM Cognos Interface . . . . . . . . . . . . . . . . . . . . . . . . . 582Changing IBM Cognos Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583Changing the Global IBM Cognos Style Sheet . . . . . . . . . . . . . . . . . . . . . . 584Migrating Changes to Future Releases . . . . . . . . . . . . . . . . . . . . . . . . . 585

Modifying the Appearance of IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . 585Example - Customize the Default Welcome Page . . . . . . . . . . . . . . . . . . . . . 585Example - Change the Branding Details in the IBM Cognos Connection Main Header . . . . . . . . . 586Example - Change the Background Color in the IBM Cognos Connection Main Header. . . . . . . . . 587Example - Change the Portal Graphics . . . . . . . . . . . . . . . . . . . . . . . . . 587Example - Change the Default Fonts for Page Titles and Instructions . . . . . . . . . . . . . . . 588

Modifying the Report Studio Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . 589Example - Change the Fonts Used in Report Studio . . . . . . . . . . . . . . . . . . . . 589Example - Change the Colors Used in Report Studio Menus. . . . . . . . . . . . . . . . . . 590Example - Change the Report Studio Graphics . . . . . . . . . . . . . . . . . . . . . . 590

Modifying the Query Studio Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . 590Example - Change the Colors Used in Query Studio Menus . . . . . . . . . . . . . . . . . . 591Example - Change the Query Studio Graphics . . . . . . . . . . . . . . . . . . . . . . 592Customize the Query Studio Toolbar and Menus . . . . . . . . . . . . . . . . . . . . . 592

Modifying the Appearance of IBM Cognos Viewer . . . . . . . . . . . . . . . . . . . . . . 595

Contents xv

Modifying the IBM Cognos Viewer Style Sheets . . . . . . . . . . . . . . . . . . . . . . 596Example - Change the Language of the IBM Cognos Viewer User Interface. . . . . . . . . . . . . 596

Modifying the Prompt Page Style Sheets . . . . . . . . . . . . . . . . . . . . . . . . . 597Adding Custom Report Templates for Report Studio . . . . . . . . . . . . . . . . . . . . . 598

Create a Report Specification for a Custom Report Template. . . . . . . . . . . . . . . . . . 598Add a Custom Report Template to the templates.xml File . . . . . . . . . . . . . . . . . . 599Provide an Icon for the Custom Report Template . . . . . . . . . . . . . . . . . . . . . 600Add the Custom Template Information to the Resources.xml File . . . . . . . . . . . . . . . . 600

Changing the Style of Report Objects in Workspaces . . . . . . . . . . . . . . . . . . . . . 602Show Headers and Footers in Expanded Report Parts in the IBM Cognos Business Insight Content Pane . . . . 602Enter Advanced Configuration Settings in Analysis Studio . . . . . . . . . . . . . . . . . . . 603

Chapter 36. Customizing the Functionality of IBM Cognos Software . . . . . . . . . 605Upgrade the system.xml Files to IBM Cognos Version 10.1 . . . . . . . . . . . . . . . . . . . 605Customizing IBM Cognos Connection . . . . . . . . . . . . . . . . . . . . . . . . . . 606

Add or Hide User Interface Elements Based on Groups and Roles. . . . . . . . . . . . . . . . 606Hide and Disable the New URL Button. . . . . . . . . . . . . . . . . . . . . . . . . 611Limit the Number of Entries That Users Can Cut, Copy, and Paste . . . . . . . . . . . . . . . 612Customizing Object Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612Restrict Content Browsing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617Implementing a Custom Welcome Page . . . . . . . . . . . . . . . . . . . . . . . . 618Customize Report Output Formats in IBM Cognos Connection and IBM Cognos Viewer . . . . . . . . 622Configure the Document Lookup Table . . . . . . . . . . . . . . . . . . . . . . . . . 624Hide Inaccessible Tabs Referenced in the User Account Preferences . . . . . . . . . . . . . . . 624

Customizing the IBM Cognos Connection Login Page . . . . . . . . . . . . . . . . . . . . . 625Login Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625Set Up and Configure a Login Page . . . . . . . . . . . . . . . . . . . . . . . . . . 625Customizing the Login Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627Redirect User to a Web Site When They Log Off. . . . . . . . . . . . . . . . . . . . . . 630Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

Customizing Server-side Printing for UNIX and Linux Platforms . . . . . . . . . . . . . . . . . 631Start Query Studio in Preview Mode . . . . . . . . . . . . . . . . . . . . . . . . . . 632Customizing Data Formats for Query Studio . . . . . . . . . . . . . . . . . . . . . . . . 633

Modify the cogformat.xml File. . . . . . . . . . . . . . . . . . . . . . . . . . . . 633Change the Order of Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . 634Change the Text Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635Remove Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635Add a Data Format to a Locale . . . . . . . . . . . . . . . . . . . . . . . . . . . 636Add Data Formats for a New Locale . . . . . . . . . . . . . . . . . . . . . . . . . 637

Change the Default Query Studio Template . . . . . . . . . . . . . . . . . . . . . . . . 637Modify Properties for the CSV Output Format . . . . . . . . . . . . . . . . . . . . . . . 638

CSV Properties and Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639Supported Encoding Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640

Repeat Crosstab Labels in CSV Output Format . . . . . . . . . . . . . . . . . . . . . . . 641Auto-Size Select and Search Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . 642Using in_range Filters with Character Data . . . . . . . . . . . . . . . . . . . . . . . . 642Modify Properties for the Batch Report Service and Report Service . . . . . . . . . . . . . . . . 642

Batch Report Service and Report Service Properties and Values. . . . . . . . . . . . . . . . . 643Customize Error-Handling on the SMTP Mail Server . . . . . . . . . . . . . . . . . . . . . 644

SMTP Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644Examples - SMTP Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646

Disable Report Attachments in Email Messages . . . . . . . . . . . . . . . . . . . . . . . 647Show Attachments in IBM Lotus Notes . . . . . . . . . . . . . . . . . . . . . . . . . . 647Disable Support for Trigger-based Scheduling . . . . . . . . . . . . . . . . . . . . . . . 648Set Up a Trigger Occurrence on a Server . . . . . . . . . . . . . . . . . . . . . . . . . 648Change the Default File Extension for Excel 2002 Spreadsheets . . . . . . . . . . . . . . . . . . 650Specify Whether the Don't Print Style is Applied to Excel 2007 Report Output. . . . . . . . . . . . . 650Disabling Toolbox Widgets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651

Chapter 37. IBM Cognos Business Insight . . . . . . . . . . . . . . . . . . . . 653

xvi IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Launching IBM Cognos Business Insight . . . . . . . . . . . . . . . . . . . . . . . . . 653Browser chrome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653Displaying Business Insight thumbnails from version 10.1.0 . . . . . . . . . . . . . . . . . . . 653Removing HTML markup from RSS feed details. . . . . . . . . . . . . . . . . . . . . . . 654

Appendix A. Round Trip Safety Configuration of Shift-JIS Characters . . . . . . . . 655Example: Safe Conversion of Shift-JIS . . . . . . . . . . . . . . . . . . . . . . . . . . 656The Round Trip Safety Configuration Utility . . . . . . . . . . . . . . . . . . . . . . . . 656

Specify Conversions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657Specify Substitutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658Apply the Conversions and Substitutions . . . . . . . . . . . . . . . . . . . . . . . . 658Restore the Default Conversion Settings . . . . . . . . . . . . . . . . . . . . . . . . 659Specify Conversions for Series 7 PowerPlay Web Reports . . . . . . . . . . . . . . . . . . 659

Appendix B. Initial Access Permissions . . . . . . . . . . . . . . . . . . . . . 661Content Manager Hierarchy of Objects . . . . . . . . . . . . . . . . . . . . . . . . . . 661Access Permissions for IBM Cognos Business Insight Reports . . . . . . . . . . . . . . . . . . 679

Appendix C. Localization of Samples Databases . . . . . . . . . . . . . . . . . 685One Column Per Language. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

Determining the Language (Columns) in the Model . . . . . . . . . . . . . . . . . . . . 685Sample Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

One Row Per Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686Determining the Language (Rows) in the Model. . . . . . . . . . . . . . . . . . . . . . 686Sample Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686

Transliterations and Multiscript Extensions . . . . . . . . . . . . . . . . . . . . . . . . 687Transliterations in the Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687Multiscript Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688Using Multi-Script Extensions for Conditional Formatting . . . . . . . . . . . . . . . . . . 688

Appendix D. User Interface Elements Reference List . . . . . . . . . . . . . . . 689Elements You Can Hide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689Elements You Can Add . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

Appendix E. User Reference Help for Portal Services . . . . . . . . . . . . . . . 697IBM Cognos Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697IBM Cognos Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699IBM Cognos Viewer (IBM Cognos Connection) . . . . . . . . . . . . . . . . . . . . . . . 701IBM Cognos Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706IBM Cognos Extended Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 707IBM Cognos Metric List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708TM1 Cube Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711TM1 Navigation Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713TM1 Websheet Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714IBM Cognos History Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715IBM Cognos Impact Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716IBM Cognos Custom Diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718Bookmarks Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720HTML Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721Image Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723RSS Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724HTML Source . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725Multi-page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

Appendix F. Schema for Data Source Commands . . . . . . . . . . . . . . . . . 731commandBlock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732sessionStartCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732sessionEndCommand. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733

Contents xvii

arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733argument . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734setCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734sqlCommand . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734sql . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735

Appendix G. Data Schema for Log Messages. . . . . . . . . . . . . . . . . . . 737Table Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 737Table Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738

COGIPF_ACTION Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 739COGIPF_AGENTBUILD Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741COGIPF_AGENTRUN Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742COGIPF_ANNOTATIONSERVICE Table . . . . . . . . . . . . . . . . . . . . . . . . 744COGIPF_EDITQUERY Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745COGIPF_HUMANTASKSERVICE Table . . . . . . . . . . . . . . . . . . . . . . . . 747COGIPF_HUMANTASKSERVICE_DETAIL Table . . . . . . . . . . . . . . . . . . . . . 749COGIPF_NATIVEQUERY Table . . . . . . . . . . . . . . . . . . . . . . . . . . . 751COGIPF_PARAMETER Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752COGIPF_RUNJOB Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752COGIPF_RUNJOBSTEP Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754COGIPF_RUNREPORT Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 755COGIPF_THRESHOLD_VIOLATIONS Table . . . . . . . . . . . . . . . . . . . . . . . 757COGIPF_USERLOGON Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760COGIPF_VIEWREPORT Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762

Appendix H. Performing tasks in IBM Cognos BI using URLs. . . . . . . . . . . . 765Recommendations for URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765CGI Program and Alternative Gateways . . . . . . . . . . . . . . . . . . . . . . . . . 765URL Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766

Parameterized URL Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . 766cognosLaunch Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767Common Optional Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . 768

URL Validation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769Starting IBM Cognos BI Components . . . . . . . . . . . . . . . . . . . . . . . . . . 769

Start Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769Starting Report Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770Starting Business Insight Advanced . . . . . . . . . . . . . . . . . . . . . . . . . . 772Starting Query Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773Starting Analysis Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775Starting Metric Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776Starting Event Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777Starting IBM Cognos Viewer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778Starting IBM Cognos BI Components in a Specified Browser Window . . . . . . . . . . . . . . 780

Access an IBM Cognos Connection Page . . . . . . . . . . . . . . . . . . . . . . . . . 782Preparing a Page for Standalone Access . . . . . . . . . . . . . . . . . . . . . . . . 783

Using Search Paths and Page IDs. . . . . . . . . . . . . . . . . . . . . . . . . . . . 783Using a Page ID Instead of the Object Search Path . . . . . . . . . . . . . . . . . . . . . 784

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 789D . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 790E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791G . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791

xviii IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

H . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792J. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792L . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792M . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 792N . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793P . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793Q . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794R . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794S . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794T . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795U . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795W . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 795

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797

Contents xix

xx IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

IntroductionThis information is intended for use with IBM Cognos software.

This information is intended for use with IBM Cognos Administration, the IBMCognos software.

This information contains step-by-step procedures and background information tohelp you administer IBM Cognos software.

Audience

To use this information, you should be familiar with reporting and securityconcepts, and have experience using a Web browser.

Finding information

To find IBM Cognos product documentation on the web, including all translateddocumentation, access one of the IBM Cognos Information Centers. Release Notesare published directly to Information Centers, and include links to the latesttechnotes and APARs.

You can also read PDF versions of the product release notes and installation guidesdirectly from IBM Cognos product disks.

Forward-looking statements

This documentation describes the current functionality of the product. Referencesto items that are not currently available may be included. No implication of anyfuture availability should be inferred. Any such references are not a commitment,promise, or legal obligation to deliver any material, code, or functionality. Thedevelopment, release, and timing of features or functionality remain at the solediscretion of IBM.

Samples disclaimer

The Great Outdoors Company, GO Sales, any variation of the Great Outdoorsname, and Planning Sample depict fictitious business operations with sample dataused to develop sample applications for IBM and IBM customers. These fictitiousrecords include sample data for sales transactions, product distribution, finance,and human resources. Any resemblance to actual names, addresses, contactnumbers, or transaction values is coincidental. Other sample files may containfictional data manually or machine generated, factual data compiled fromacademic or public sources, or data used with permission of the copyright holder,for use as sample data to develop sample applications. Product names referencedmay be the trademarks of their respective owners. Unauthorized duplication isprohibited.

Accessibility Features

Accessibility features help users who have a physical disability, such as restrictedmobility or limited vision, to use information technology products. Because the

Copyright IBM Corp. 2005, 2011 xxi

IBM Cognos Administration component supports a wide range of IBM Cognoscomponents, the availability of accessibility features varies by component withinIBM Cognos Administration.

In IBM Cognos Administration, you can enable system-wide settings to createaccessible report output. For more information, see Enable Accessible ReportOutput Using System-wide Settings on page 157.

xxii IBM Cognos Business Intelligence Version 10.1.1: Administration and Security Guide

Chapter 1. What's New?This section contains a list of new, changed, and deprecated features for thisrelease. It also contains a cumulative list of similar information for previousreleases. It will help you plan your upgrade and application deployment strategiesand the training requirements for your users.

For updates according to product version:v New Features in Version 10.1.1v New Features in Version 10.1.0 on page 4v New Features in Version 8.4v New Features in Version 8.3

For information about upgrading, see the Installation and Configuration Guide foryour product.

For information about other new features for this release, see the New FeaturesGuide.

To review an up-to-date list of environments supported by IBM Cognos products,including operating systems, patches, browsers, Web servers, directory servers,database servers, and application servers, access one of the IBM CognosInformation Centers at http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp.

New Features in Version 10.1.1New