IBM Cognos Transformer Version 10.2.1: User Guide

413 Pages·2013·3.25 MB·English

IBM Cognos Transformer
Version 10.2.1
User Guide
Note
Before using this information and the product it supports, read the information in “Notices” on page 377.
Product Information
This document applies to IBM Cognos Business Intelligence Version 10.2.1 and may also apply to subsequent
releases.
Licensed Materials - Property of IBM
© Copyright IBM Corporation 2007, 2013.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Chapter 1. What's New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
New features in version 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Changed encryption algorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
New preference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
New features in version 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Enhancements for the -n command line option . . . . . . . . . . . . . . . . . . . . . . . 2
New rule for defining hierarchies in a time dimension . . . . . . . . . . . . . . . . . . . . 2
New features in version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
New Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Publishing Cube Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Deprecated Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Removed Features in Version 10.1.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
PowerCube Connection (PCConn) Utility . . . . . . . . . . . . . . . . . . . . . . . . . 3
Framework Manager Externalized Queries . . . . . . . . . . . . . . . . . . . . . . . . 3
Chapter 2. Planning Your Model . . . . . . . . . . . . . . . . . . . . . . . . . 5
Dimensional Modeling Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Analyzing Your Requirements and Source Data. . . . . . . . . . . . . . . . . . . . . . . 6
Preprocessing Your Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Building a Prototype. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Refining Your Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Diagnose and Resolve Any Design Problems . . . . . . . . . . . . . . . . . . . . . . . 11
Upgrade an IBM Cognos Series 7 Model. . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 3. Data Sources for Your Model . . . . . . . . . . . . . . . . . . . . . 15
Techniques for Designing Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Data Source Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
IBM Cognos Package or Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Business Viewpoint Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
IBM InfoSphere Warehouse Cubing Services . . . . . . . . . . . . . . . . . . . . . . . 20
TM1 Cubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Impromptu Query Definition File . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Delimited-field Text with Column Titles . . . . . . . . . . . . . . . . . . . . . . . . . 21
Delimited-field Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Access Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Access Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Excel Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Excel Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
PowerHouse Portable Subfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Fixed-field Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Fixed Field and Record Without CR LF . . . . . . . . . . . . . . . . . . . . . . . . . 23
Designing Successful IBM Cognos PowerCubes . . . . . . . . . . . . . . . . . . . . . . . 23
Conformed Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
IBM Cognos Business Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Member Unique Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Resolving Uniqueness Problems in Your Data Source . . . . . . . . . . . . . . . . . . . . 25
Creating a Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Creating a Model Using an IBM Cognos Package or Report . . . . . . . . . . . . . . . . . . 27
Creating a Model Using an SAP BW Package . . . . . . . . . . . . . . . . . . . . . . . 29
Creating a Model Using Other Data Sources . . . . . . . . . . . . . . . . . . . . . . . 30
Edit Existing Prompts in IBM Cognos Reports and Packages . . . . . . . . . . . . . . . . . . . 31
Generate a File of Prompt Values for Use in the Command Line. . . . . . . . . . . . . . . . . 33
Remove Obsolete Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
© Copyright IBM Corp. 2007, 2013 iii
Specifying a Segmenting Prompt for an SAP BW Query . . . . . . . . . . . . . . . . . . . . 34
Change a Data Source Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Create Dimensions from the Dimension Map Using OLAP and DMR Packages . . . . . . . . . . . . . 35
Adding an IBM Cognos Data Source to an Existing Model . . . . . . . . . . . . . . . . . . . 36
Add Additional Queries to Existing IBM Cognos Data Sources . . . . . . . . . . . . . . . . . 37
Adding Other Data Sources to an Existing Model. . . . . . . . . . . . . . . . . . . . . . . 38
Synchronizing Columns with Your Data Source . . . . . . . . . . . . . . . . . . . . . . . 39
Synchronizing Columns with Text Data Files or IQDs . . . . . . . . . . . . . . . . . . . . 40
Connecting to an IQD Data Source . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Isolation Levels for an IQD Data Source . . . . . . . . . . . . . . . . . . . . . . . . . 41
Example - Using an .iqd File to Access a UNIX Data Source . . . . . . . . . . . . . . . . . . 42
Modify the SQL Query in an IQD Data Source . . . . . . . . . . . . . . . . . . . . . . . 42
Character Sets Used with Delimited Text Data Sources . . . . . . . . . . . . . . . . . . . . . 43
Named Ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Example - Specifying Named Ranges for a Multipage Crosstab . . . . . . . . . . . . . . . . . 43
Example - Specifying a Named Range for a Spreadsheet Database . . . . . . . . . . . . . . . . 44
PowerHouse Data Source Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Using Multiple Data Sources in Your Model . . . . . . . . . . . . . . . . . . . . . . . . 45
Data Source Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Control When the Source Data Is Read . . . . . . . . . . . . . . . . . . . . . . . . . 48
Defining Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Troubleshooting Issues Related to Column Names . . . . . . . . . . . . . . . . . . . . . 50
Troubleshooting Issues Related to Date Columns . . . . . . . . . . . . . . . . . . . . . . 50
Define Columns in a Fixed-field Text Data Source . . . . . . . . . . . . . . . . . . . . . 51
Scale Input Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Set the Level of Detail for Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Specify Monthly or Quarterly Time Arrays . . . . . . . . . . . . . . . . . . . . . . . . 53
Modify Date Categories When Spanning Two Centuries . . . . . . . . . . . . . . . . . . . 56
Signons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Creating a Data Source Signon . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Creating an IBM Cognos Signon . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Chapter 4. Structuring Your Data Into Dimensions . . . . . . . . . . . . . . . . . 59
AutoDesign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Creating a New Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Creating Dimensions in the Dimension Map Using Relational Data Sources . . . . . . . . . . . . . 60
Creating Dimensions from the Dimension Map Using OLAP and DMR Packages . . . . . . . . . . . 60
Define a Calculated Column. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Example - Using a Calculated Column to Add an Exception Dimension . . . . . . . . . . . . . . 62
Example - Using a Calculated Column to Support Allocated Measures . . . . . . . . . . . . . . 62
Adding Levels and Categories to a Dimension. . . . . . . . . . . . . . . . . . . . . . . . 63
Add Source Levels to a Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Add Manual Levels to a Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Create Categories Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Creating Calculated Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Order Categories Within Levels. . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Order Categories Using a Global Preference Setting . . . . . . . . . . . . . . . . . . . . . 69
Create Unbalanced Level Hierarchies Within a Dimension . . . . . . . . . . . . . . . . . . . 69
Drill-down Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Create an Alternate Drill-down Path . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Define a Scenario Dimension and a Cube Opening Level . . . . . . . . . . . . . . . . . . . . 71
Setting Up the Time Dimension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Creating the Time Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Format Date Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Set up Fiscal Years, Quarters, and Months . . . . . . . . . . . . . . . . . . . . . . . . 76
Set up Calendar and Fiscal Years Within a Single Time Dimension . . . . . . . . . . . . . . . . 76
Specify How Weeks Split When Spanning a Higher-level Time Period . . . . . . . . . . . . . . . 77
Set up Lunar Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Specify How Extra Weeks Get Added to Lunar Years . . . . . . . . . . . . . . . . . . . . 79
Limit the Range of Dates Included in the Model . . . . . . . . . . . . . . . . . . . . . . 79
Set up a Custom Time Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
iv IBM Cognos Transformer Version 10.2.1: User Guide
Setting Up Relative Time Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Set the Current Period Automatically . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Set the Current Period Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Track Changes in a Measure over a Specific Time Period . . . . . . . . . . . . . . . . . . . 83
Track Changes in a Measure for a Period-to-Date . . . . . . . . . . . . . . . . . . . . . . 83
Track Changes in a Measure over Several Time Periods. . . . . . . . . . . . . . . . . . . . 84
Track Changes in a Measure in Future Time Periods . . . . . . . . . . . . . . . . . . . . . 85
Track Monthly Performance Measures in Different Time Periods. . . . . . . . . . . . . . . . . 86
Setting up Special Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Create a New Special Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Create Special Category Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
Disable Rollup on Special Categories . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Resolving the Parentage of Orphan Categories. . . . . . . . . . . . . . . . . . . . . . . . 90
Resolve Invalid Date Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Adjust the Date Range to Encompass Early and Late Dates . . . . . . . . . . . . . . . . . . . 91
Set up a Manual Level for Unknown Categories . . . . . . . . . . . . . . . . . . . . . . . 91
Prevent New Categories from Being Added to a Dimension . . . . . . . . . . . . . . . . . . . 92
Verifying Your Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Generating Categories from a Specified Data Source . . . . . . . . . . . . . . . . . . . . . 92
Chapter 5. Modeling Your Key Performance Measures . . . . . . . . . . . . . . . 95
Add a Regular Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
Define a Measure Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Define a Measure that Counts Categories . . . . . . . . . . . . . . . . . . . . . . . . . 97
Define a Calculated Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Define When Measures are Calculated . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Specify How Missing Values Appear . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Reverse the Sign of Measure Values in Financial Models . . . . . . . . . . . . . . . . . . . . 101
Cognos Transformer Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Controlling How Measures Roll Up . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Set a Regular Rollup Function for Measures . . . . . . . . . . . . . . . . . . . . . . . 103
Create Cubes with External Rollups . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Set a Time State Rollup Function for Measures . . . . . . . . . . . . . . . . . . . . . . 105
Ignore Null and Missing Values in Specified Time State Rollups . . . . . . . . . . . . . . . . 107
Set Regular and Time State Rollup Together . . . . . . . . . . . . . . . . . . . . . . . 108
Consolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Example - Consolidating Data Using Duplicates Rollup (Sum) . . . . . . . . . . . . . . . . . 109
Set a Duplicates Rollup Function for Measures . . . . . . . . . . . . . . . . . . . . . . 110
Allocating Measures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Show the Scope for a Measure. . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Set Dimension Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Set Level Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Set Category Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Suppress Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Setting Up Currency Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Enabling Conversion Using a Base Currency Table . . . . . . . . . . . . . . . . . . . . . 118
Enable Conversion Using a Euro Table . . . . . . . . . . . . . . . . . . . . . . . . . 120
Update a Currency Table Manually . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Chapter 6. Creating PowerCubes . . . . . . . . . . . . . . . . . . . . . . . . 125
Create a Single PowerCube . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Create a Cube Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Defining a Time-based Partitioned Cube . . . . . . . . . . . . . . . . . . . . . . . . . 127
Advantages of a Time-based Partitioned Cube . . . . . . . . . . . . . . . . . . . . . . 128
Disadvantages of a Time-based Partitioned Cube . . . . . . . . . . . . . . . . . . . . . 128
Create a Time-based Partitioned Cube Group. . . . . . . . . . . . . . . . . . . . . . . 130
Processing Issues Related to Time-based Partitioned Cubes . . . . . . . . . . . . . . . . . . 130
Customizing a Time-based Partitioned Cube . . . . . . . . . . . . . . . . . . . . . . . 132
Exclude Measures from a Cube . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Omit Dimensions from a Cube . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Contents v
Customizing Cube Content with Views. . . . . . . . . . . . . . . . . . . . . . . . . . 133
Create a Dimension View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Omit Categories Using Suppress . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Omit Categories Using Cloak . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Omit Categories Using Exclude . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Omit Descendant Categories Using Summarize . . . . . . . . . . . . . . . . . . . . . . 139
Omit Categories Using Apex . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Setting Up Drill-through Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Drill Through in IBM Cognos BI . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Drill Through in IBM Cognos Series 7 . . . . . . . . . . . . . . . . . . . . . . . . . 141
Use Alternate Data Sources for Cube Creation . . . . . . . . . . . . . . . . . . . . . . . 144
Build a Subset of Your Cube Data for Testing Purposes . . . . . . . . . . . . . . . . . . . . 144
Update the PowerCube Metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Check Cube Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Chapter 7. Adding Security . . . . . . . . . . . . . . . . . . . . . . . . . . 147
PowerCubes with IBM Cognos Series 7 Security . . . . . . . . . . . . . . . . . . . . . . 147
Choosing the Type of Security to be Applied . . . . . . . . . . . . . . . . . . . . . . . . 147
IBM Cognos Security Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Create Member-based Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Update Model Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Union of Custom Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Example - Two Custom Views, Each with an Apex in the Same Dimension . . . . . . . . . . . . . 152
Example - Apexed Custom View Cloaked by Another Custom View in the Same Dimension . . . . . . . 153
Example - Apexed Custom View Excluded by Another Custom View in the Same Dimension . . . . . . 153
Example - Union of Two Apexed Custom Views in Different Dimensions . . . . . . . . . . . . . 154
Example - Union of Two Multi-dimensional Apexed Custom Views . . . . . . . . . . . . . . . 154
Example - Union of Excluded Categories in Two Dimensions . . . . . . . . . . . . . . . . . 155
Examples - Unions of Excluded Categories in the Same Dimension . . . . . . . . . . . . . . . 155
Example - Union of Excluded and Cloaked Categories in the Same Dimension . . . . . . . . . . . 156
Example - Union of a Custom Views with Omitted Dimensions . . . . . . . . . . . . . . . . 156
Create Password-protected Cubes . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Combining Custom Views with Dimension Views . . . . . . . . . . . . . . . . . . . . . . 157
Block Total Values for Parent Categories with Excluded Children . . . . . . . . . . . . . . . . . 158
Upgrade an IBM Cognos Series 7 Secured PowerCube . . . . . . . . . . . . . . . . . . . . 158
Chapter 8. PowerCubes in Production Environments . . . . . . . . . . . . . . . 161
Managing Languages and Locales . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Publishing PowerCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Publishing a PowerCube Using the Wizard . . . . . . . . . . . . . . . . . . . . . . . 163
Publishing a PowerCube Using Settings Stored in the Model . . . . . . . . . . . . . . . . . 165
Creating a Publish Specification to Publish One PowerCube . . . . . . . . . . . . . . . . . . 167
Creating a Publish Specification to Publish All PowerCubes in the Model . . . . . . . . . . . . . 167
Publishing a Cube Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
PowerCube Load Balancing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Maintaining Models and Cubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Source Data Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Model Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Cube Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Automatic Creation of Multifile Cubes . . . . . . . . . . . . . . . . . . . . . . . . . 170
Recovering a Failed Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Matching Model and Source Columns . . . . . . . . . . . . . . . . . . . . . . . . . 172
Move Categories When Source Data Changes . . . . . . . . . . . . . . . . . . . . . . 173
Updating hierarchies that are based on non-rollup children of the root category in a time dimension . . . . 175
Cleaning up Your Models and Cubes . . . . . . . . . . . . . . . . . . . . . . . . . 175
Modifying a PowerCube. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Update Cubes Incrementally . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Choosing a Partitioning Strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Updating Published PowerCubes and PowerCube Connections. . . . . . . . . . . . . . . . . . 187
Copying and Activating a Newer Version of a Published PowerCube. . . . . . . . . . . . . . . 187
vi IBM Cognos Transformer Version 10.2.1: User Guide
Activating a Published PowerCube Using pcactivate . . . . . . . . . . . . . . . . . . . . 190
Chapter 9. Guidelines for Optimizing Production Environments. . . . . . . . . . . 193
Building PowerCubes in UNIX or Linux . . . . . . . . . . . . . . . . . . . . . . . . . 193
Guidelines for Model Design, Cube Creation, and System Maintenance Process . . . . . . . . . . . 194
Setting Up Data Sources for UNIX and Linux Cubes . . . . . . . . . . . . . . . . . . . . 194
Using IBM Cognos Reports to Create a Data Source . . . . . . . . . . . . . . . . . . . . 195
Adding Security to a UNIX or Linux Cube . . . . . . . . . . . . . . . . . . . . . . . 196
Controlling Processing with Preference Settings or Environment Variables . . . . . . . . . . . . . . 196
Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Addressing Common UNIX and Linux Processing Problems. . . . . . . . . . . . . . . . . . . 203
Checking UNIX and Linux Job Status . . . . . . . . . . . . . . . . . . . . . . . . . 203
Scheduling Batch UNIX and Linux Production Jobs . . . . . . . . . . . . . . . . . . . . 203
Improving Performance in a UNIX Production Environment . . . . . . . . . . . . . . . . . 203
Performing Incremental Updates on UNIX and Linux . . . . . . . . . . . . . . . . . . . . 204
Example - Updating a Model Using an MDL Script. . . . . . . . . . . . . . . . . . . . . 204
Example - Restarting a Failed Process from a Checkpoint File . . . . . . . . . . . . . . . . . 204
Example - Restarting a Failed Process from the Beginning . . . . . . . . . . . . . . . . . . 204
Reducing Build Times for Large PowerCubes. . . . . . . . . . . . . . . . . . . . . . . . 205
Multiprocessing with Cognos Transformer Server . . . . . . . . . . . . . . . . . . . . . 205
Memory Allocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Reconfiguration of the Hard Drive . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Allocating Sufficient Space for the Temporary Files . . . . . . . . . . . . . . . . . . . . . 207
Optimization of the Operating Environment . . . . . . . . . . . . . . . . . . . . . . . 208
Redistributing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Optimization of Gateway Settings for IBM Cognos Series 7 IQDs . . . . . . . . . . . . . . . . 209
Keeping Model and Cube Sizes Within Practical Limits . . . . . . . . . . . . . . . . . . . 209
Using the Log File to Analyze Processing Bottlenecks . . . . . . . . . . . . . . . . . . . . 210
Appendix A. Command Line Options . . . . . . . . . . . . . . . . . . . . . . 211
Command Line Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Command Line Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
-a option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
-c option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
-d option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
-e option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
-f option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
-g option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
-h option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
-i option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
-j option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
-k option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
-l option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
-m option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
-n option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
-nologo option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
-o option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
-ox option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
-p option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
-r option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
-s option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
-t option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
-u option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
-v option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
-x option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
-y options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Backward Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Sample Windows Preference Files for IBM Cognos Series 7 . . . . . . . . . . . . . . . . . . 238
Sample UNIX and Linux Preference Files for IBM Cognos Series 7 . . . . . . . . . . . . . . . 239
Contents vii
Appendix B. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . 241
Accessing Error Message Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Problems when Modeling in IBM Cognos Transformer . . . . . . . . . . . . . . . . . . . . 241
BAPI Error Occurs After the Prompt Specification File Edited Manually . . . . . . . . . . . . . . 241
Unable to Access an IQD Data Source Using a Sybase Database Connection . . . . . . . . . . . . 241
Unable to Use an IQD Created in Framework Manager That Contains an Oracle Stored Procedure . . . . . 242
Preventing Errors When Model Calculations Use Double Quotation Marks . . . . . . . . . . . . . 242
Framework Manager and Transformer May Display Different Locale Session Parameters for Some Languages 243
Regular Columns Cannot Be Converted to Calculated Columns and Vice Versa . . . . . . . . . . . 243
Transformer Takes a Long Time to Retrieve Data from an SAP-based Data Source . . . . . . . . . . 243
Categories Missing When Creating a Transformer Model Based on an SAP Query Containing a Manually
Created SAP Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Error Occurs When Creating a PowerCube Containing an SAP Unbalanced Hierarchy . . . . . . . . . 244
Rebuilding a PowerCube Soon After Publishing Produces a TR0787 Error . . . . . . . . . . . . . 244
Using the cube group in the sample model Employee expenses.mdl . . . . . . . . . . . . . . . 244
Known Issues When Using PowerCubes in the IBM Cognos Studios . . . . . . . . . . . . . . . . 245
Not Yet Optimized IBM Cognos PowerCubes May Open Slowly in IBM Cognos BI . . . . . . . . . . 245
Analysis Studio Shows the Wrong Currency Symbol . . . . . . . . . . . . . . . . . . . . 246
Changes to Decimals in Currency Formats . . . . . . . . . . . . . . . . . . . . . . . 246
Ragged or Unbalanced Hierarchies Result in Unexpected Behavior . . . . . . . . . . . . . . . 247
Unable to Open the Great Outdoors Sales.mdl Sample Model and Generate Cubes . . . . . . . . . . 247
Unable to Publish a PowerCube . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Appendix C. IBM Cognos Transformer Error Messages . . . . . . . . . . . . . . 249
TR0104 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TR0105 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
TR0106 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TR0107 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TR0108 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
TR0109 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TR0110 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
TR0111 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
TR0112 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Solution for Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Solution for UNIX or Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
TR0113 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TR0114 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TR0116 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TR0118 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
TR0128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TR0131 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TR0132 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TR0133 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
TR0137 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
TR0149 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
TR0202 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TR0203 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TR0205 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TR0206 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TR0207 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
TR0208 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TR0209 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TR0210 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
TR0214 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
TR0215 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
TR0217 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
TR0301 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
TR0303 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
TR0404 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
TR0408 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
TR0412 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
viii IBM Cognos Transformer Version 10.2.1: User Guide
TR0420 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
TR0423 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
TR0476 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
TR0500 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
TR0501 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
TR0502 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
TR0503 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
TR0504 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
TR0505 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
TR0507 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
TR0508 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
TR0510 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
TR0514 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
TR0515 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
TR0518 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
TR0519 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
TR0523 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
TR0524 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
TR0525 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
TR0528 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
TR0534 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
TR0535 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
TR0536 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
TR0538 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
TR0540 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
TR0541 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
TR0552 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
TR0605 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
TR0606 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
TR0607 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
TR0613 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
TR0621 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
TR0623 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
TR0624 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
TR0657 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Matching Model and Source Columns for Text Files or IQDs . . . . . . . . . . . . . . . . . 271
Matching Model and Source Columns for IBM Cognos Data Sources . . . . . . . . . . . . . . . 272
TR0700 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
TR0701 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
TR0702 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
TR0705 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
TR0713 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
TR0745 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
TR0749 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
TR0750 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
TR0751 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
TR0752 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
TR0753 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
TR0800 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
TR0802 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
TR0803 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
TR0804 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
TR0805 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
TR0806 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
TR0807 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
TR0808 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
TR0809 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
TR0810 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
TR0811 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
TR0812 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
TR0813 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Contents ix
TR0815 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
TR0816 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
TR0817 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
TR0900 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
TR0904 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
TR0906 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
TR0907 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
TR0914 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
TR0917 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
TR0919 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
TR1003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
TR1005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
TR1100 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
TR1101 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
TR1102 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
TR1106 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
TR1109 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
TR1304 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
TR1307 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
TR1308 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
TR1309 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
TR1310 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
TR1312 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
TR1319 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
TR1320 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
TR1502 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
TR1503 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
TR1601 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
TR1700 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
TR1703 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
TR1900 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
TR1903 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
TR1907 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
TR2000 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
TR2001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
TR2002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
TR2306 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
TR2307 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
TR2308 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
TR2312 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
TR2313 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
TR2314 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
TR2316 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
TR2317 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
TR2318 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
TR2319 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
TR2320 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
TR2321 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
TR2322 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
TR2323 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
TR2324 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
TR2325 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
TR2326 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
TR2502 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
TR2503 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
TR2504 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
TR2505 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
TR2506 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
TR2507 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
TR2508 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
TR2509 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
x IBM Cognos Transformer Version 10.2.1: User Guide