Tivoli Data Warehouse - PDF Free Download

Tivoli Data Warehouse Version 1.3 Tivoli Data Warehouse Troubleshooting Guide SC09-7776-01

Note Before using this information and the product it supports, read the information in Appendix B, Notices, on page 281. First Edition (April 2005) This edition applies to Tivoli Data Warehouse, Version 1.3 and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2005. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents About this guide........... v Who should read this guide.........v Publications..............v Tivoli Data Warehouse publications......v Related publications..........vi Accessing publications online.......ix Ordering publications..........ix Accessibility..............ix Contacting customer support........ix Conventions used in this guide........x Typeface conventions..........x Operating system-dependent variables and paths x Part 1. Messages.......... 1 Chapter 1. Identifying a message.... 3 Chapter 2. Messages......... 9 Part 2. Troubleshooting...... 221 Chapter 3. Problem determination.. 223 Information for customer support...... 223 Problem determination features....... 224 Log files and the Tivoli Data Warehouse common logging directory........ 225 Messages.............. 229 Problem determination tools....... 230 Problems with IBM DB2 Universal Database Enterprise Server Edition......... 232 Failed to install because NIS is installed in environment............. 232 Unable to restart instance after DB2 Universal Database password change........ 232 Cannot upgrade DB2 when using Windows 2000 Terminal Server edition....... 232 Problems installing Tivoli Data Warehouse... 233 Install components in correct order..... 233 PATH variable is too long........ 233 Cannot install if number sign is in password 233 Cannot install when password is missing or bad 234 Incorrect DB2 Universal Database version installed.............. 234 Problems installing Tivoli Data Warehouse on older versions of Windows........ 234 DB2 command errors in DB2 log...... 234 Processor license error displayed in the DB2 logs............... 235 Export fails............. 235 Control database cannot be created..... 236 Errors in installation log file....... 237 Silent installation does not complete..... 237 Installation fails when command not found.. 237 Problems connecting to the Crystal Enterprise server while installing Tivoli Data Warehouse. 237 Recovering from incomplete installation of Tivoli Data Warehouse......... 239 Problems uninstalling Tivoli Data Warehouse... 239 Uninstalling Tivoli Data Warehouse if warehouse pack uninstallation fails..... 239 Uninstalling Tivoli Data Warehouse only... 239 Dropping databases.......... 240 Uninstallation fails because DB2 Universal Database was stopped......... 240 Manually removing Tivoli Data Warehouse.. 240 Problems when configuring and using Tivoli Data Warehouse.............. 243 When your DB2 Data Warehouse Center logon fails............... 243 DWC06200E and DWC07322E errors when starting the DB2 Data Warehouse Center... 243 Cannot start the DB2 Data Warehouse Center 244 Specifying the control database for the DB2 Warehouse Control Database Manager.... 245 Verifying the control database for ODBC data sources.............. 245 Incorrect library causes segmentation violation 246 Cannot install or uninstall after original host name changes............ 246 System 7937 errors from missing parameters in DB2 Data Warehouse Center sources or targets. 247 Unexpected DB2 Data Warehouse Center errors 247 Problems with warehouse packs....... 247 Installation problems.......... 247 Recovering from unsuccessful installation or reinstallation of a warehouse pack..... 253 Uninstalling warehouse packs....... 254 Other warehouse pack problems...... 254 Problems with ETL processes and steps.... 255 Work in Progress window........ 255 Determining whether ETL processes are running 256 ETL processes do not complete or extract steps do not run............. 257 Error creating table when using Sybase.... 257 Sybase environment variable is incorrectly set 257 ETL processes fail after upgrade...... 258 Cannot change mode on ETL steps..... 258 General ETL errors.......... 258 Adding trace information to the log files for ETL processes............ 260 Troubleshooting scenarios for z/os...... 264 Unavailable resource error in DB2 Universal Database for z/os........... 264 Lack of temporary space in DB2 Universal Database for z/os........... 266 Permission error in DB2 Universal Database for z/os............... 266 DB2 Control Center error when viewing database information.......... 267 Copyright IBM Corp. 2005 iii

Problems running administrative utilities.... 267 System alert when DB2 services cannot be started............... 267 Problems with reports.......... 268 Cannot upgrade Crystal Enterprise when using Windows 2000 Terminal Server...... 268 Problems connecting to the Crystal Enterprise server when publishing reports...... 268 SQL1334N error when configuring an ODBC connection from Crystal Enterprise to a data mart............... 269 Error message reports bad formulas..... 269 No compatible Web server found during Crystal Enterprise installation......... 270 HTTP 403 error when accessing the Crystal Enterprise server........... 270 Cannot log on to Crystal Enterprise server on AIX............... 270 Connection to the Crystal Enterprise server fails after port modification......... 271 Cannot log on to Crystal Enterprise eportfolio 272 Report containing non-ascii characters in its name fails to migrate.......... 272 Problems migrating reports on older versions of Windows.............. 272 Problems migrating reports when upgrading from Tivoli Enterprise Data Warehouse, Version 1.1............. 272 Report displays no data or incomplete data.. 273 Problems viewing or scheduling reports... 273 Cannot view or schedule warehouse pack report on UNIX.............. 274 Problems with language selection in reports.. 275 Font substitution problems for double-byte character sets (DBCS) in Crystal Enterprise reports.............. 275 Problems with mapped drives when publishing reports.............. 275 Appendix A. Support information... 277 Learning about education......... 277 Searching knowledge bases......... 277 Search the documentation........ 277 Search the Internet.......... 277 Obtaining fixes............. 278 Contacting IBM Software Support...... 278 Determine the business impact of your problem 279 Describe your problem and gather background information............. 279 Submit your problem to IBM Software Support 279 Appendix B. Notices........ 281 Trademarks.............. 283 Index............... 285 iv Tivoli Data Warehouse Troubleshooting Guide

About this guide Who should read this guide Tivoli Data Warehouse helps customers produce cross-application reports from various Tivoli and customer applications. The infrastructure enables a set of extract, transform, and load (ETL) utilities to extract and move data from Tivoli application data stores to a central data warehouse database. The architecture of Tivoli Data Warehouse is documented to support integration of data from non-tivoli applications into the central data repository. Customers can generate task-oriented data marts from this repository, and cross-application reports can be produced using these data marts. This guide contains the messages that each of the Tivoli Data Warehouse components generates. Each message includes a sample and a description of the message, and the Administrator Response indicates the appropriate response to the message. This guide is for administrators and installers who plan, install, configure, and maintain Tivoli Data Warehouse. Administrators and installers should know the following information: v Basic system administration and file management of the operating systems on which the components of Tivoli Data Warehouse are installed v Basic concepts of relational database management v Experience administering IBM DB2 databases v Experience with networking, TCP/IP, and Web servers Publications This section lists publications in the Tivoli Data Warehouse library and other related documents. Tivoli Data Warehouse publications The following documents are available in the Tivoli Data Warehouse library: v Tivoli Data Warehouse Release Notes, SC32-1399-01 Provides last-minute information about Tivoli Data Warehouse and lists hardware requirements and software prerequisites. v Installing and Configuring Tivoli Data Warehouse, GC32-0744 Describes how Tivoli Data Warehouse fits into your enterprise, explains how to plan for its deployment, and gives installation and configuration instructions. Additionally, this guide contains maintenance procedures and describes how to install warehouse packs and reports. This document also describes how to install DB2 Universal Database and Crystal Enterprise for use with Tivoli Data Warehouse. v Tivoli Data Warehouse Troubleshooting Guide, SC09-7776 Lists the messages generated by Tivoli Data Warehouse and describes the actions you should take. It also contains troubleshooting information related to installing, configuring, and using Tivoli Data Warehouse. Copyright IBM Corp. 2005 v

Related v Tivoli Data Warehouse Schema Reference, SC32-1497 Describes the database schemas used in the Tivoli Data Warehouse central data warehouse and data mart. This includes the data model for the central data warehouse and data mart and the tables in the central data warehouse. The Tivoli Data Warehouse information center contains the documents from the Tivoli Data Warehouse library in both PDF and HTML formats. All documents are available in English; selected documents are available in other languages. The information center is available online: http://publib.boulder.ibm.com/infocenter/tiv3help/index.jsp?topic= /com.ibm.tivoli.tdwi.doc/welcome.htm publications The following section describes additional publications that can help you understand and use Tivoli Data Warehouse and its prerequisites. The Tivoli Glossary The Tivoli Software Glossary includes definitions for many of the technical terms related to Tivoli software. The Tivoli Software Glossary is available at the following Tivoli software library Web site: http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm IBM Redbooks IBM Redbooks are developed and published by the IBM International Technical Support Organization, the ITSO. They explore integration, implementation, and operation of realistic customer scenarios. The following Redbooks contain information about Tivoli Data Warehouse: v Introduction to Tivoli Enterprise Data Warehouse, SG24-6607 Provides a broad understanding of Tivoli Data Warehouse. Some of the topics that are covered are concepts, architecture, writing your own ETLs, and best practices in creating data marts. v IBM Tivoli Data Warehouse 1.3: Planning and Implementation, SG24-6343-00 Focuses on planning, installation, customization, use, maintenance, and troubleshooting topics related to the new features of Tivoli Data Warehouse, Version 1.3, using a number of case study scenarios and several warehouse packs. A comprehensive chapter describes optimizing the overall performance of a Tivoli Data Warehouse implementation, and focuses on DB2 optimization techniques and remote warehouse agents. Crystal Enterprise publications The following documents describe how to install, use, and administer Crystal Enterprise. These documents are available on the Crystal Enterprise 10 CD, which is shipped with Tivoli Data Warehouse: v Crystal Enterprise 10 Installation Guide Provides information and procedures for installing Crystal Enterprise. This guide also includes detailed instructions for the different installation modes available. v Crystal Enterprise 10 Getting Started Guide Provides basic installation information and serves as a general introduction to Crystal Enterprise, eportfolio, the Crystal Management Console, the Crystal Publishing Wizard, and the overall product architecture. v Using Limited Edition Features in eportfolio vi Tivoli Data Warehouse Troubleshooting Guide

Provides information and procedures for accessing and using eportfolio and its report viewers. v Crystal Enterprise 10 Administrator s Guide Provides information and procedures for the administrative tasks. Procedures are provided for common tasks. Conceptual information and technical details are provided for all advanced topics. v Business Views Administration Guide Provides information and procedures for the administrative tasks associated with Business Views. Business Views provide an abstraction layer that helps report designers and end users access the information they require. Conceptual information and technical details are provided for all topics. v Crystal Reports 10 User s Guide This manual is included in the Crystal Reports CD that is sold as an upgrade by IBM to Tivoli Data Warehouse users. It provides procedures for typical reporting tasks such as placing fields, formatting reports, and sorting records. It also contains information about advanced formula creation and accessing different types of data. Acts as a reference for basic reporting needs as well as an introduction to new concepts in report creation. DB2 Universal Database publications The DB2 library contains important information about the database system and data warehousing technology provided by IBM DB2 Universal Database Enterprise Server Edition, IBM DB2 Warehouse Manager Standard Edition, and the DB2 Data Warehouse Center. If you are new to data warehousing and the DB2 product, there is a tutorial that leads you through the basics of data warehousing and the use of the DB2 Data Warehouse Center. This online tutorial is available from DB2 library. Refer to the DB2 library for help installing, configuring, administering, and troubleshooting DB2 products. The DB2 library is available online at the following Web address: http://publib.boulder.ibm.com/infocenter/db2help/index.jsp The following documents are particularly relevant for people working with Tivoli Data Warehouse: v IBM DB2 Universal Database Quick Beginnings for DB2 Servers, GC09-4836 Guides you through the planning, installation, migration, and setup of a partitioned database system using IBM DB2 servers on Microsoft Windows and UNIX systems. v IBM DB2 Universal Database Quick Beginnings for DB2 Clients, GC09-4832 Guides you through the planning, installation, migration, and setup of a partitioned database system using IBM DB2 clients on Microsoft Windows and UNIX systems. v IBM DB2 Universal Database Administration Guide: Implementation, SC09-4820 Covers the details of implementing your database design. Topics include creating and altering a database, database security, database recovery, and administration using the DB2 Control Center, a DB2 graphical user interface (GUI). v IBM DB2 Universal Database Administration Guide: Performance, SC09-4821 Provides information about configuring and tuning your database environment to improve performance. About this guide vii

v IBM DB2 Universal Database Data Warehouse Center Administration Guide, SC27-1123 Provides information about how to build and maintain a data warehouse using the DB2 Data Warehouse Center. v IBM DB2 Warehouse Manager Installation Guide, GC27-1122 Provides the information for installing the following DB2 Warehouse Manager components: Information Catalog Manager, warehouse agents, and warehouse transformers. v IBM DB2 Universal Database Installation and Configuration Supplement, GC09-4837 Provides advanced installation considerations and guides you through the planning, installation, migration, and setup of a platform-specific DB2 client. After the DB2 client is installed, you configure communications for both the client and server, using the DB2 GUI tools or the Command Line Processor. This supplement also contains information on binding, setting up communications on the server, the DB2 GUI tools, Distributed Relational Database Architecture application server (DRDA AS), distributed installation, the configuration of distributed requests, and accessing heterogeneous data sources. v IBM DB2 SQL Reference Volume 1, SC09-4844 and IBM DB2 SQL Reference Volume 2, SC09-4845 Describes SQL syntax, semantics, and the rules of the language. This book also includes information about release-to-release incompatibilities, product limitations, and catalog views. You can order both volumes of the SQL Reference in the English language in North America with the form number SBOF-8933. v IBM DB2 Universal Database Message Reference Volume 1, GC09-4840 and IBM DB2 Universal Database Message Reference Volume 2, GC09-4841 Lists the messages and codes issued by DB2, the Information Catalog Manager, and the DB2 Data Warehouse Center, and describes the actions you should take. z/os Publications This section lists publications in the DB2 Universal Database for z/os, formerly DB2 Universal Database for z/os and OS/390 library and other documentation for those using Tivoli Data Warehouse on the z/os operating system. DB2 Universal Database for z/os publications: This section lists publications in the DB2 Universal Database for z/os library: v IBM DB2 Universal Database for z/os Administration Guide, SC18-7413 Provides information about how to administer and customize DB2 Universal Database for z/os. Its audience is mainly composed of system administrators, IT administrators, and users. v IBM DB2 Universal Database for z/os and OS/390 An Introduction to DB2 for OS/390, SC26-9937 Provides information about how to get started with DB2 Universal Database for z/os. It also gives an overall view of the product. v IBM DB2 Universal Database for z/os Messages and Codes, GC18-7422 Defines and explains the DB2 Universal Database for z/os messages and codes. v IBM DB2 Universal Database for z/os Installation Guide, GC18-7418 Provides information about how to install DB2 Universal Database for z/os. v IBM DB2 Universal Database for z/os Utility Guide and Reference, SC18-7427 Contains usage information for the tasks of system administration, database administration, and database operation. It presents detailed information about viii Tivoli Data Warehouse Troubleshooting Guide

using utilities, syntax, keyword and parameter descriptions, and information about starting, stopping, and restarting utilities. This book also includes job control language (JCL) and control statements for each utility. v IBM DB2 Universal Database for z/os and OS/390 Diagnosis Guide and Reference, LY37-3740 Provides information about how to debug and fix common problems with DB2 Universal Database for z/os. Accessing publications online IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli Software Information Center Web site. Ordering The product manuals for Tivoli Data Warehouse are located in an Information Center at the following Web address: http://publib.boulder.ibm.com/infocenter/tiv3help/index.jsp?topic= /com.ibm.tivoli.tdwi.doc/welcome.htm The Tivoli Software Information Center is located at the following Web address: http://publib.boulder.ibm.com/tividd/td/tdprodlist.html The DB2 product library is located at the following Web address: http://publib.boulder.ibm.com/infocenter/db2help/index.jsp Note: If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog. This option is available when you click File Print. Fit to page ensures that the full dimensions of a letter-sized page print on the paper that you are using. publications You can order many IBM and Tivoli publications online at the following Web site: http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi Accessibility Contacting customer support Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. For information about the accessibility features of Tivoli Data Warehouse, refer to Installing and Configuring Tivoli Data Warehouse. If you have a problem with any Tivoli product, refer to the following IBM Software Support Web site: http://www.ibm.com/software/sysmgmt/products/support/ If you have a problem with Tivoli Data Warehouse, refer to the following IBM Support Web site: About this guide ix

http://www.ibm.com/software/sysmgmt/products/ support/tivolidatawarehouse.html If you have a problem with a DB2 product, refer to the following IBM Software Support Web site: http://www.ibm.com/software/data/db2 If you want to contact customer support, see the IBM Software Support Guide at the following Web site: http://techsupport.services.ibm.com/guides/handbook.html The guide provides information about how to contact IBM Software Support, depending on the severity of your problem, and the following information: v Registration and eligibility v Telephone numbers and e-mail addresses, depending on the country in which you are located v Information you must have before contacting IBM Software Support Conventions used in this guide Typeface This guide uses several conventions for special terms and actions and for operating system-dependent commands and paths. conventions This guide uses the following typeface conventions: Bold Lowercase and mixed-case commands, command options, and flags that appear within text appear like this, in bold type. Graphical user interface elements except for titles of windows and dialogs also appear like this, in bold type. Italic Variables, values you must provide, new terms, and words and phrases that are emphasized appear like this, in italic type. Monospace Code examples, output, and message text appear like this, in monospace type. Text strings you must type, when they appear within text, names of Java methods and classes, and HTML and XML tags also appear like this, in monospace type. Operating system-dependent variables and paths When referring to environment variables in a context that can occur only on a system running a Windows operating system, environment variables and path names are displayed using the Windows notation. For example, %SystemRoot% and C:\Program Files\TWH\, respectively. If the context applies to both Windows and UNIX operating systems, this guide uses the UNIX convention for specifying environment variables and for directory notation. For example, $TEMP and /usr/local/bin/. To convert from the UNIX format to the Windows format, replace $variable with %variable% for environment variables and replace each forward slash (/) with a backslash (\) in directory paths. x Tivoli Data Warehouse Troubleshooting Guide

Note: If you are using the bash shell on a Windows system, you can use the UNIX conventions. This guide uses the following environment variables: Variable name Meaning ProgramFiles Identifies the directory where program files are installed. Usually, this is C:\Program Files\, but it can also be represented with the SystemDrive environment variable as %SystemDrive%:\Program Files\. TWH_TOPDIR The top-level directory in which the Tivoli Data Warehouse files are installed. The default value on Windows systems is %ProgramFiles%\TWH\. The default value on UNIX systems is /opt/twh/. About this guide xi

xii Tivoli Data Warehouse Troubleshooting Guide

Part 1. Messages Copyright IBM Corp. 2005 1

2 Tivoli Data Warehouse Troubleshooting Guide

Chapter 1. Identifying a message The messages are all identified similarly. The following example explains the components of the identifier: CDWIC0003I CDW Identifies the product code for Tivoli Data Warehouse. IC Identifies the subsystem code. 0003 Identifies the serial number of the message. I Identifies one of the following message types: I Informational messages provide users with information or feedback about normal events that have occurred or are occurring, or request information from users in cases where the outcome would not be negative, regardless of the response. W Warning messages indicate that potentially undesirable conditions have occurred or could occur, but the program can continue. Warning messages often ask users to make decisions before processing continues. E Error messages indicate problems that require intervention or correction before the program can continue. Message and trace logs are generated. The message text is translated into different languages and is displayed according to the locale that the user selects. Messages are appended to the message logs, providing a complete record of the errors. Trace logs provide enough information to diagnose a problem remotely. When a problem occurs, you can change the trace level so that it gathers data that customer support needs to understand the problem. Refer to Setting the trace level on page 228. The messages in this manual are grouped by subsystem code. Refer to the following table for more information about subsystem codes. Note: The following table presents information that references the Tivoli common logging directory. For more information about the directory s location, contents, and subdirectories, see Log files and the Tivoli Data Warehouse common logging directory on page 225 and Installing and Configuring Tivoli Data Warehouse. Table 1. Subsystem codes Code Description CD Indicates messages that can be generated by the utility provided on the CD. Messages are logged in the TWHCatDBMgr_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the TWHCatDBMgr_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Copyright IBM Corp. 2005 3

Table 1. Subsystem codes (continued) Code Description CR Indicates messages that can be generated by the program that migrates reports. Messages are logged in reporting_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the reporting_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. CW Indicates messages that can be generated by the programs that configure warehouse packs: twh_config_wep.pl and ConfigWep.pm, which are called by the installation wizard or by twh_configwep.bat. Messages are logged in the configwep_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the configwep_trc.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. DI Indicates messages that can be generated by the program that accesses user information (DBInfoMgr). Messages are logged in the DBInfoMgr_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the DBInfoMgr_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. ETI Indicates messages that can be generated by tools that configure ODBC data sources and databases. Installation calls these tools. Messages are logged in the dbsetup_message_log.log and in the odbccfg_message_log.log, which are both in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the dbsetup_trace_log.log and in the odbccfg_trace_log.log, which are both in the cdw/logs/tools/ subdirectory under the Tivoli common logging directory. EX Indicates messages that can be generated by the SQL run-time program, which converts generic SQL to vendor-specific SQL that can operate on the source database. Messages are logged in the execsql2_message_log.log in the cdw/logs/etl subdirectory under the Tivoli common logging directory. Trace information is logged in the execsql2_trace_log.log in the cdw/logs/etl subdirectory in the Tivoli common logging directory. FF Indicates messages that can be generated by First Failure Data Capture (FFDC), which can capture useful data after the problem is logged can collect enough data so that the problem can be diagnosed without having to reproduce the problem. This code also indicates messages that can be generated by the utility that lets you update important Tivoli Data Warehouse files before manually moving the Tivoli common logging directory for Tivoli Data Warehouse only. 4 Tivoli Data Warehouse Troubleshooting Guide

Table 1. Subsystem codes (continued) Code Description IC Indicates messages that can be generated during the installation and uninstallation of Tivoli Data Warehouse and warehouse packs. Messages are logged in the core_install_message_log.log, the wep_install_backend_message_log.log, and the wep_uninstall_backend_message_log.log, which are all in the cdw/logs/install subdirectory under the Tivoli common logging directory. Trace information is logged in the core_backend_trace_log.log, the wep_install_backend_trace_log.log, and the wep_uninstall_backend_trace_log.log, which are all in the cdw/logs/install subdirectory under the Tivoli common logging directory. IS Indicates messages that can be generated by the installation wizard during the core installation, upgrades, adding data marts and central data warehouses, and install recovery of Tivoli Data Warehouse. Messages are logged in the core_install_message_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. Trace information is logged in the core_install_trace_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. IT Indicates messages that can be generated by the application that imports resource bundles during the installation of Tivoli Data Warehouse. Messages are logged in the TWHImportBundles_message_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. Trace information is logged in the TWHImportBundles_trace_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. IW Indicates messages that can be generated by the installation wizard during the installation of warehouse packs. Messages are logged in the wep_install_backend_message_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. Trace information is logged in the wep_install_backend_trace_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. LS Indicates messages that can be generated by the list command utilities. The logs are shared among the list commands in the system, such as twh_list_cdws and twh_list_agentsites. Messages are logged in the TWHListCmds_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the TWHListCmds_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. RS Indicates messages that can be generated by the restricted RunScript user-defined program, which Tivoli Data Warehouse provides for backward compatibility with certain warehouse packs such as IBM Tivoli Monitoring. It allows warehouse packs that use this script to run their own miscellaneous scripts that are not part of the regular ETL steps. Messages are logged in the RunScript_message_log.log in the cdw/logs/etl subdirectory under the Tivoli common logging directory. Trace information is logged in the RunScript_trace_log.log in the cdw/logs/etl subdirectory under the Tivoli common logging directory. Chapter 1. Identifying a message 5

Table 1. Subsystem codes (continued) Code Description RT Indicates messages that can be generated by the run_react.pl and React.pm programs, which are internal tools called by other Tivoli Data Warehouse programs. Messages are logged in the react_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the react_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. For React, two additional trace files can be created on a remote agent site that is not the control server. These files are the react_agent_launcher_trc.log and the react_agent_trc.log, which are both in the cdw/logs/tools subdirectory under the Tivoli common logging directory. RU Indicates messages that can be generated by the roll-up script, which warehouse packs use to process data marts. Messages are logged in the rollupmulti_message.log in the cdw/logs/etl/rollup subdirectory under the Tivoli common logging directory. Trace information is logged in the rollupmulti_trace.log in the cdw/logs/etl/rollup subdirectory under the Tivoli common logging directory. SQ Indicates messages that can be generated by RunMultiSQL, which works with the SQL run-time program. Messages are logged in the RunMultiSQL_message_log.log in the cdw/logs/etl subdirectory under the Tivoli common logging directory. Trace information is logged in the RunMultiSQL_trace_log.log in the cdw/logs/etl subdirectory under the Tivoli common logging directory. TD Indicates messages that can be generated by the twh_update_userinfo command that changes user IDs and passwords, data warehouse center sources, and targets. Messages are logged in the TWHDBAdmin_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information in the TWHDBAdmin_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. TG Indicates messages that can be generated by the twh_dwc_xxxx.pl scripts, which are tag file creation scripts that the installation of Tivoli Data Warehouse uses. Messages are logged in the core_install_message_log.log, the core_backend_message_log.log, and the wep_install_backend_message_log.log, which are all in the cdw/logs/install subdirectory under the Tivoli common logging directory. Trace information is logged in the core_install_trace_log.log, the core_backend_trace_log.log, and the wep_install_backend_trace_log.log, which are all in the cdw/logs/install subdirectory under the Tivoli common logging directory. 6 Tivoli Data Warehouse Troubleshooting Guide

Table 1. Subsystem codes (continued) Code Description TR Indicates messages that can be generated when running the program that changes report server values. Messages are logged in the TWHRptAdmin_message_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. Trace information is logged in the TWHRptAdmin_trace_log.log in the cdw/logs/tools subdirectory under the Tivoli common logging directory. UW Indicates messages that can be generated during the uninstallation of the warehouse packs. Messages are logged in wep_uninstall_message_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory. Trace information is logged in the wep_uninstall_trace_log.log in the cdw/logs/install subdirectory under the Tivoli common logging directory by default. Chapter 1. Identifying a message 7

8 Tivoli Data Warehouse Troubleshooting Guide

Chapter 2. Messages CDWCD0001I The twh_create_datasource command completed successfully. CDWCD0002E The twh_create_datasource command was called with an incorrect number of parameters. Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. See Installing and Configuring Tivoli Data Warehouse for more information. CDWCD0003I Refer to the following usage statement when running a twh_create_datasource command: twh_create_datasource DB2UDB uniqueidentifyingnumber odbcdatasourcename databasename servername serverportnumber [username] [password] twh_create_datasource DB2390 uniqueidentifyingnumber odbcdatasourcename databasename servername serverportnumber localdatabasename [username] [password] CDWCD0004E The following parameters that are not valid were passed to the twh_create_datasource command: arguments Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. See Installing and Configuring Tivoli Data Warehouse for more information. CDWCD0005E The twh_create_datasource command requires specification of either DB2UDB or DB2390. Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. See Installing and Configuring Tivoli Data Warehouse for more information. CDWCD0006E The unique identifying number (uniqueidentifyingnumber) must be a numeric value that is less than 1,000. Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. See Installing and Configuring Tivoli Data Warehouse for more information. CDWCD0007E The twh_create_datasource command was unable to start a process to execute a command. Explanation: The twh_create_datasource command starts processes to run the various commands that are necessary to catalog the data source on the system. This message indicates a problem with the operating system or run-time environment. Administrator Response: Verify that the system is working properly and that system resources are available. CDWCD0008E The ODBC data source name (odbcdatasourcename) must be less than 32 characters and in the form of TWH_MARTn, where n is an optional numeric value. Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. See Installing and Configuring Tivoli Data Warehouse for more information. Copyright IBM Corp. 2005 9

CDWCD0009E CDWCD0016I CDWCD0009E The database name (databasename) must be less than 8 characters and in the form of TWH_MART or TMARTn, where n is an optional numeric value. Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. CDWCD0010E The optional values (n) must be identical in both the database name (databasename) and the ODBC data source name (odbcdatasourcename). Explanation: The program cannot continue. Administrator Response: Review the program usage statement and run the program again with valid options. CDWCD0011E The twh_create_datasource command is not supported on this operating system. Explanation: The twh_create_datasource command is supported only on Windows, AIX, and Linux operating systems. Administrator Response: Review the program documentation and run the program only on supported operating systems. CDWCD0012E The program could not open or load the TWHCatDBMgrlogging.properties file in the path_name directory. Explanation: This file is necessary for configuring message and trace logging. Administrator Response: Correct the environment and check the class path and the command that starts the program. Check the informational paths that the program displays. Verify that the paths are correct. Run the program again. CDWCD0013E An error in the environment caused the twh_create_datasource command to encounter an error when trying to start message and trace logging. Explanation: Environmental elements, the class path, the command that starts the program, or the informational paths may be incorrect. Administrator Response: Correct the environment and check the class path and command that start the program. Check the informational paths that the program displays and verify that they are correct. Run the program again. CDWCD0014I The twh_create_datasource command is storing information that establishes a connection to the database server. Explanation: The twh_create_datasource command is running the following command: catalog tcpip node TDWMTuniqueIdentifyingNumber remote servername server serverportnumber. Administrator Response: No action is required. CDWCD0015E A failure occurred while storing information that establishes a connection to the database server. Explanation: The following command failed: catalog tcpip node TDWMTuniqueIdentifyingNumber remote servername server serverportnumber. Administrator Response: Attempt to run the command manually and correct the failing condition. CDWCD0016I The twh_create_datasource command is storing remote database location information. Explanation: If DB2UDB was specified, the twh_create_datasource command is running the following command: catalog database databasename at nodetdwmtuniqueidentifyingnumber authentication server. If DB2390 was specified, the twh_create_datasource command is running the following command: catalog database databasename at node TDWMTuniqueIdentifyingNumber authentication dcs. 10 Tivoli Data Warehouse Troubleshooting Guide

CDWCD0017E CDWCD0023I Administrator Response: No action is required. CDWCD0017E A failure occurred while storing remote database location information. Explanation: The command to store the remote database location information failed. The program cannot continue. Administrator Response: If DB2UDB was specified, the following command failed: catalog database databasename at node TDWMTuniqueIdentifyingNumber authentication server If DB2390 was specified, the following command failed: catalog database databasename at node TDWMTuniqueIdentifyingNumber authentication dcscatalog database databasename at node TDWMTuniqueIdentifyingNumber authentication dcsauthentication dcs. Attempt to run the command manually and correct the failing condition. CDWCD0018I The twh_create_datasource command is storing remote database information for connection services. Explanation: The twh_create_datasource command is running the following command: catalog dcs database databasename as localdatabasename parms,,interrupt_enabled,,,,, Administrator Response: No action is required. CDWCD0019E A failure occurred while storing remote database information for connection services. Explanation: The command to store the remote database location for connection services failed. The program cannot continue. The following command failed: catalog dcs database databasename as localdatabasename parms,,interrupt_enabled,,,,, Administrator Response: Attempt to run the command manually and correct the failing condition. CDWCD0020I The twh_create_datasource command is registering the data source on this system. Explanation: The twh_create_datasource command is registering the ODBC System Data Source Name. Administrator Response: No action is required. CDWCD0021E A failure occurred while registering the data source on this system. Explanation: The command to register the data source on this system failed. The twh_create_datasource command runs an internal tool to register the ODBC System Data Source Name. The program cannot continue. Administrator Response: Contact IBM Customer Support for further assistance. CDWCD0022E The twh_create_datasource command was unable to retrieve the results of a command. Explanation: The twh_create_datasource command starts processes to run the various commands that are necessary to catalog the data source on the system. The twh_create_datasource command was unable to retrieve the output from one of these commands. Administrator Response: Verify that the system is working properly and that system resources are available. CDWCD0023I The twh_create_datasource command is testing the connection to the data source. Explanation: The twh_create_datasource command is running the following command: connect to databasename user username using password Administrator Response: No action is required. Chapter 2. Messages 11

CDWCD0024E CDWCR0005E CDWCD0024E The twh_create_datasource command was unable to connect to the data source. Explanation: The command to register the data source on this system failed. The following command failed: connect to databasename user username using password The program cannot continue. Administrator Response: Attempt to run the command manually and correct the failing condition. CDWCD0025E The twh_create_datasource command was unable to obtain a message or trace logger to write message and trace information. Explanation: Message and trace information cannot be written. Administrator Response: Verify that the file system specified in the TWHCatDBMgrlogging.properties file where the message and trace information is written is available and has sufficient space. CDWCR0001E The report migration utility could not start the message logger that is defined in the reportinglogging.properties file. Explanation: The reportinglogging.properties file, located in /cdw/logs/properties/ under the Tivoli common logging directory, defines the message log and trace files. The log file defined by Tivoli Data Warehouse installation is named reporting_message_log.log and is located in the /cdw/logs/tools/ subdirectory under the Tivoli common logging directory. The program could not write message information to the file. Administrator Response: Verify that the user has permissions to access this file. If the properties file has been modified, restore the original file from a backup. Run the report migration utility again. CDWCR0002E The report migration utility could not start the trace logger that is defined in the reportinglogging.properties file. Explanation: The reportinglogging.properties file, located in /cdw/logs/properties/ under the Tivoli common logging directory, defines the message log and trace files. The log file defined by Tivoli Data Warehouse installation is named reporting_trace_log.log and is located in the /cdw/logs/tools/ subdirectory under the Tivoli common logging directory. The program could not write trace information to the file. Administrator Response: Verify that the user has permission to access this file. If the properties file has been modified restore the original file from a backup. Run the report migration utility again. CDWCR0003I Name, a component of the report migration utility, started processing. CDWCR0004E The TWH_TOPDIR variable was not defined. Explanation: This is an internal error. The Tivoli Data Warehouse installation program should pass a valid parameter list. The TWH_TOPDIR was not passed to the report migration utility on the command line. The TWH_TOPDIR variable is needed to locate files required to run the report migration utility. Administrator Response: Run FFDC and contact IBM Customer Support to help you diagnose the problem. CDWCR0005E An error occurred in the report migration utility. Explanation: This is an internal error. The report migration utility migrates reports that were created for use with Tivoli Enterprise Data Warehouse, Version 1.1 to the Crystal Reports format that can be used with Tivoli Data Warehouse, Version 1.2. This migration utility ran when you upgraded your Tivoli Enterprise Data Warehouse installation from Version 1.1 to Version 1.2 or installed a warehouse pack for Version 1.1. Administrator Response: Review the trace logs for additional information about the error and take corrective action if possible. Otherwise, run FFDC and contact IBM Customer Support to help you diagnose the problem. 12 Tivoli Data Warehouse Troubleshooting Guide

CDWCR0006I CDWCR0013E CDWCR0006I The report migration utility ran without errors. CDWCR0007E The report migration utility ended because of an error. Explanation: A fatal error occurred and no reports were migrated. Administrator Response: Review the reporting_message_log.log file, located in the /cdw/logs/tools subdirectory under the Tivoli common logging directory, for additional messages indicating the specific error that caused the report migration utility to stop. CDWCR0008E A Crystal Management server was not passed to the Crystal connection utility. The ceserver parameter was not specified. Explanation: This error is internal. The Tivoli Data Warehouse installation calls the Crystal connection utility and passes the correct parameters. When calling the Crystal connection utility, the ceserver parameter must be specified. Administrator Response: Verify that the Crystal Management server was specified correctly on the Tivoli Data Warehouse installation panels. Run FFDC and contact IBM Customer Support to help you diagnose the problem. CDWCR0009E A Crystal Enterprise user was not passed to the Crystal connection utility. The parameter, ceuser, was not specified. Explanation: This is an internal error. The Tivoli Data Warehouse installation calls this utility and passes the correct parameters. A Crystal Enterprise user must be specified by using the parameter, ceuser. Administrator Response: Verify that the Crystal Enterprise user was specified correctly on the Tivoli Data Warehouse installation panels. Run FFDC and contact IBM Customer Support to help you diagnose the problem. CDWCR0010I Connection to the Crystal Management server succeeded. CDWCR0011E A connection to the Crystal Management server could not be made. Explanation: The Crystal Management server connection failed. Administrator Response: Verify that the user ID, password and server name for the Crystal Management server were specified correctly in the Tivoli Data Warehouse installation wizard. Also verify that the Crystal Management server is up and running. If the domain of the Crystal Management server is not in the domain name server (DNS) list of the system that is attempting to make the connection, you must make an entry for the Crystal Management server in the host file. See the Installing and Configuring Tivoli Data Warehouse guide for more information. CDWCR0012E The data mart data source name was not passed to the Crystal connection utility. The parameter, dsn, was not specified. Explanation: This is an internal error. The Tivoli Data Warehouse installation calls the Crystal connection utility and passes the correct parameters. A data source name must be specified by using the parameter, dsn. Administrator Response: Run FFDC and contact IBM Customer Support to help you diagnose the problem. CDWCR0013E The data mart user id was not passed to the Crystal connection utility. The parameter, user, was not specified. Explanation: This is an internal error. The Tivoli Data Warehouse installation calls the Crystal connection utility and passes the correct parameters. A data mart user (DB2 user) must be specified by using the parameter, user. Administrator Response: Run FFDC and contact IBM Customer Support to help you diagnose the problem. Chapter 2. Messages 13