PMPC-62_release Notes for 6.2

1

Informatica Corporation Informatica® PowerCenter® 6

Informatica® PowerMart® 6 Version 6.2

Release Notes March 2003

Copyright 2003 Informatica Corporation

PowerCenter and PowerMart are registered trademarks of Informatica Corporation. All other

trademarks and copyrights acknowledged.

Metadata Exchange for Data Models: Underlying technology (c) 1997-2003 Yaletown Technology Group Inc.

All Rights Reserved.

Contents CD Contents .............................................................................................................................................3 Informatica Developer Network ................................................................................................................3 Webzine....................................................................................................................................................3 Web Support.............................................................................................................................................3 6.2 New Features and Enhancements.........................................................................................................3

Backward Compatibility........................................................................................................................4 Informatica Server.................................................................................................................................4 Linux ....................................................................................................................................................4 Metadata Reporter .................................................................................................................................4 pmrep....................................................................................................................................................4 pmrepagent ...........................................................................................................................................4 Repository.............................................................................................................................................4 Usability ...............................................................................................................................................4

6.1 New Features and Enhancements.........................................................................................................5 Designer................................................................................................................................................5 Informatica Server Enhancements..........................................................................................................5 Metadata Reporter .................................................................................................................................5 pmrep....................................................................................................................................................5 pmrepagent ...........................................................................................................................................5 Repository Manager ..............................................................................................................................6 Repository Server..................................................................................................................................6 Transformation Language......................................................................................................................6 Workflow Manager ...............................................................................................................................6 Workflow Monitor ................................................................................................................................7

6.0 New Features and Enhancements.........................................................................................................7 Designer................................................................................................................................................7 Informatica Server.................................................................................................................................8 Metadata Reporter .................................................................................................................................9 Repository Manager ..............................................................................................................................9 Repository Server..................................................................................................................................9 Transformation Language......................................................................................................................9 Workflow Manager .............................................................................................................................10

Compilers for External Procedures and Advanced External Procedures ....................................................11 6.2 Bug Fixes..........................................................................................................................................11

Client..................................................................................................................................................11

2

Database and Connectivity ..................................................................................................................11 Informatica Server...............................................................................................................................12

6.1 Bug Fixes..........................................................................................................................................12 Bulk Loading ......................................................................................................................................12 Client..................................................................................................................................................13 Informatica Server...............................................................................................................................13 Repository Agent and Repository Server..............................................................................................15

6.0 Bug Fixes..........................................................................................................................................15 Client..................................................................................................................................................15 Database Connectivity.........................................................................................................................15 Flat Files and COBOL.........................................................................................................................16

Third Party Limitations ...........................................................................................................................16 IBM DB2............................................................................................................................................16 HP-UX................................................................................................................................................18 Informix..............................................................................................................................................18 Linux ..................................................................................................................................................18 Microsoft SQL Server .........................................................................................................................18 Microsoft Windows.............................................................................................................................19 Oracle .................................................................................................................................................19 Sybase ................................................................................................................................................22 Teradata..............................................................................................................................................24

PowerCenter/PowerMart Known Limitations...........................................................................................24 Backward Compatibility......................................................................................................................24 Bulk Loading ......................................................................................................................................25 Client..................................................................................................................................................26 Database and Connectivity ..................................................................................................................29 Date Handling.....................................................................................................................................30 External Loader...................................................................................................................................30 External Procedures and Stored Procedures..........................................................................................31 Flat Files and COBOL.........................................................................................................................31 Informatica Server...............................................................................................................................32 Installation ..........................................................................................................................................35 Metadata Reporter ...............................................................................................................................35 Partitioning .........................................................................................................................................37 Repository Agent and Repository Server..............................................................................................38 Workflow Monitor ..............................................................................................................................39 XML...................................................................................................................................................39

Installation ..............................................................................................................................................39 PowerCenter/PowerMart Platform Components...................................................................................39 Client..................................................................................................................................................40 Informatica Server...............................................................................................................................40 Repository Server................................................................................................................................40

Database Connectivity.............................................................................................................................41 Upgrading...............................................................................................................................................42 Documentation Addenda.........................................................................................................................42

All Manuals ........................................................................................................................................42 Designer Guide ...................................................................................................................................43 Installation and Configuration Guide ...................................................................................................43 Metadata Reporter Guide.....................................................................................................................44 Repository Guide ................................................................................................................................45 Supplemental Guide ............................................................................................................................46 Transformation Guide .........................................................................................................................49 Transformation Language Reference ...................................................................................................49 Troubleshooting Guide........................................................................................................................50 Workflow Administration Guide..........................................................................................................50

Contacting Informatica............................................................................................................................52

3

Note: This document summarizes revisions to PowerCenterRTTM 6.2, PowerCenter® 6.2, and PowerMart® 6.2 that do not appear in the documentation. Do not upgrade to this release from a previous version without carefully reading the relevant sections on upgrading and bug fixes, since bug fixes may change the behavior of existing sessions. For more complete information on the product, consult the manuals and online help. For the final version of this document, please refer to the printed version of release notes included with the product shipment. You can also download the final version of this document from Informatica Corporation at http://my.Informatica.com/.

CD Contents The PowerCenterRT 6.2/PowerCenter 6.2/PowerMart 6.2 installation CD includes the following programs and files: • PowerCenterRT/PowerCenter/PowerMart installation • Metadata Reporter • Sample Repository • DataDirect 4.1 closed 32-bit ODBC drivers for Windows • DataDirect 4.1 closed 32-bit ODBC drivers for UNIX • Online versions of the manuals (Use Adobe Acrobat Reader included on the CD to view these files.) • Release notes

Informatica Developer Network The Informatica Developer Network is a web-based forum for third-party software developers. You can access the Informatica Developer Network at http://devnet.informatica.com. The site contains information on how to create, market, and support customer-oriented add-on solutions based on Informatica�s interoperability interfaces.

Webzine The Informatica Documentation Team delivers an online journal, the Informatica Webzine. This journal provides solutions to common tasks, conceptual overviews of industry-standard technology, detailed descriptions of specific features, and tips and tricks to help you develop data warehouses. The Informatica Webzine is a password-protected site that you can access through the Customer Portal. The Customer Portal has an online registration form for login accounts to its webzine and web support. To register for an account, go to the following URL: http://my.Informatica.com If you have any questions, please email [email protected]. To better serve your needs, the Informatica Documentation Team welcomes all comments and suggestions. You can send comments and suggestions to: [email protected].

Web Support Informatica now has an online registration form for login accounts to webzine and websupport. To register for a webzine or websupport account, go to the following URL: http://my.Informatica.com If you have any questions, please email [email protected].

6.2 New Features and Enhancements This section describes new features and enhancements to PowerCenter 6.2 and PowerMart 6.2.

4

Backward Compatibility Backward compatibility. PowerCenter 6.2/PowerMart 6.2 (version 6.2) provide backward compatibility with PowerCenter 6.1/PowerMart 6.1 (version 6.1) client applications. You can use a version 6.1 client application to connect to a version 6.2 repository.

Informatica Server Partitioning enhancements. When you load to IBM DB2 tables stored on a multi-node tablespace, you can optimize session performance by specifying the database partitioning partition type for IBM DB2 targets. Use sorted input to optimize join performance. You can improve session performance by using sorted data with the Joiner transformation. When you configure the Joiner transformation to use sorted data, the Informatica Server improves performance by minimizing disk input and output. Session recovery. You can recover failed sessions that write to relational targets. When you run a failed session in recovery mode, the Informatica Server continues writing data to the target starting with the row at which the previous session failed.

Linux Linux support. The Informatica Server and Repository Server can run on Linux. On Linux, you can access and connect to IBM DB2, Oracle, and Sybase sources, targets, and repositories using native drivers. Use ODBC drivers to access other sources and targets.

Metadata Reporter Custom Job Report. You can filter workflows by specifying start time and end time parameters in the custom Job Report. The report displays workflows run between the specified start and end time. Access the custom Job Report from the custom report menu.

pmrep Addrepository. Use this command to add a repository configuration to the Repository Server. Listobjects. Use this command to list objects in the repository. Listtablesbysess. Use this command to list source and target names in a session. Updateseqgenvals. Use this command to update some transformation properties for Sequence Generator transformations.

pmrepagent Bulkrestore. Use this command to restore Teradata repositories using FastLoad.

Repository IBM DB2 EEE repositories. You can optimize repository performance when you store the repository tables in a single-node tablespace. Specify the tablespace name when you create, copy, or restore the repository.

Usability Resizeable editors. You can resize the editor dialog boxes in the Workflow Manager and Designer.

5


Designer Advanced External Procedure transformations. You can create non-reusable instances of reusable Advanced External Procedure transformations. Teradata database support. PowerCenter and PowerMart support Teradata as a source, target, or repository database. You can also create Lookup and Stored Procedure transformations to access Teradata databases. Copy objects in the Designer workspace as an image. In the Designer workspace, you can capture an image of objects such as mappings or source qualifiers. Resizable edit dialog boxes. You can resize the edit dialog box when you use the Designer to modify an object.

Informatica Server Enhancements Cache partitioning. When you create a session with multiple partitions, the Informatica Server can partition caches for the Aggregator, Joiner, Lookup, and Rank transformations. It creates a separate cache for each partition, and each partition works with only the rows needed by that partition. User-defined commits. PowerCenter and PowerMart allow you to control commit and rollback transactions based on a row or set of rows that pass through a Transaction Control transformation. You define transactions using an expression in the Transaction Control transformation. Based on the return value of the expression, you can choose to commit, rollback, or continue without any transaction changes. Write metadata to flat file targets. When you configure the Informatica Server, you can choose to write flat file column metadata to flat file targets.

Metadata Reporter Installation on IBM WebSphere Analytic Server. You can now install the Metadata Reporter on IBM WebSphere Analytic Server and run it as a web application. Installation on JRun Java Server Application. You can install the Metadata Reporter on JRun Java Server Application and run it as a web application. Installation on Apache Tomcat. You can install the Metadata Reporter on Apache Tomcat and run it as a web application.

pmrep Updatesrcprefix. Use this command to update the owner name for session source tables. Updatetargprefix. Use this command to update the table name prefix for session target tables.

pmrepagent Delete. Use this command to delete repository tables from the database. Restore. Use this command to restore repositories from a repository backup file.

6

Repository Manager File connection details. You can use the Repository Manager to view connection details for source and target files. You can also use MX Views to view connection details for source and target files. Repository Server Administration Console. The Repository Administration Console issues repository administration commands through the Repository Server. Use the Administration Console to perform repository functions, such as creating, copying, backing up, and restoring repositories. Custom tools. The Repository Manager allows you to add custom tools to the Tools menu. This allows you to start frequently used programs from within the Repository Manager.

Repository Server Database connection pooling. You can specify the maximum number of connections the Repository Server can make to the repository database. Automatic connection closing and automatic lock release. The Repository Server automatically closes repository connections lost due to network or system problems, and automatically releases locks held by lost connections. Teradata repositories. PowerCenter and PowerMart support Teradata as a repository database.

Transformation Language Transformation language updates. Informatica updated the transformation language to increase the precision of calculations in expressions and to improve session performance.

Workflow Manager Copy and paste segments. You can copy segments of existing workflows or worklets into workflows and worklets within the same folder, within another folder, or within a folder in a different repository. Custom tools. The Workflow Manager allows you to add custom tools to the Tools menu. This allows you to start frequently used programs from within the Workflow Manager. Delete links in a workflow or worklet. When you edit a workflow or worklet, you can delete multiple links at once without deleting the tasks they connect. Highlight paths in a workflow or worklet. When you edit a workflow or worklet, you can view the forward or backward link paths to other tasks. Partitioned Joiner transformation. You can set a partition point at the Joiner transformation. Partitioning enhancements. If you use PowerCenter, you can define up to 32 partitions at any partition point in a pipeline that supports multiple partitions. Teradata FastLoad external loader. You can use the Teradata FastLoad external loader to load data to a Teradata database table. Use FastLoad to load data from a session with one partition to a single Teradata database table. Workflow Wizard. You can use the Workflow Wizard to create workflows quickly. When you use the Workflow Wizard to create a workflow, you do not have to create sessions manually, drag sessions into the workspace, or add links manually.

7

Workflow Monitor Custom tools. The Workflow Monitor allows you to add custom tools to the Tools menu. This allows you to start programs from within the Workflow Monitor that you frequently use. Filter for Task view. The Workflow Monitor allows you to create filter settings for Task view. It stores the filter settings, applies them each time you run the Workflow Monitor, and filters all other tasks from view. Mark deleted workflows. The Workflow Monitor marks deleted workflows in Task and Gantt Chart views. Task release. You can release tasks from memory without switching to offline mode.


Designer Compare objects. The Designer allows you to compare two repository objects of the same type to identify differences between them. You can compare sources, targets, transformations, mapplets, mappings, instances, or mapping/mapplet dependencies in detail. You can compare objects across open folders and repositories. Copying objects. In each Designer tool, you can use the copy and paste functions to copy objects from one workspace to another. For example, you can select a group of transformations in a mapping and copy them to a new mapping. Custom tools. The Designer allows you to add custom tools to the Tools menu. This allows you to start programs you use frequently from within the Designer. Flat file targets. You can create flat file target definitions in the Designer to output data to flat files. You can create both fixed-width and delimited flat file target definitions. Heterogeneous targets. You can create a mapping that outputs data to multiple database types and target types. When you run a session with heterogeneous targets, you can specify a database connection for each relational target. You can also specify a file name for each flat file or XML target. Link paths. When working with mappings and mapplets, you can view link paths. Link paths display the flow of data from a column in a source, through ports in transformations, to a column in the target. Linking ports. You can now specify a prefix or suffix when automatically linking ports between transformations based on port names. Lookup cache. You can use a dynamic lookup cache in a Lookup transformation to insert and update data in the cache and target when you run a session. Mapping parameter and variable support in lookup SQL override. You can use mapping parameters and variables when you enter a lookup SQL override. Mapplet enhancements. Several mapplet restrictions are removed. You can now include multiple Source Qualifier transformations in a mapplet, as well as Joiner transformations and Application Source Qualifier transformations for IBM MQSeries. You can also include both source definitions and Input transformations in one mapplet. When you work with a mapplet in a mapping, you can expand the mapplet to view all transformations in the mapplet.

8

Metadata extensions. You can extend the metadata stored in the repository by creating metadata extensions for repository objects. The Designer allows you to create metadata extensions for source definitions, target definitions, transformations, mappings, and mapplets. Numeric and datetime formats. You can define formats for numeric and datetime values in flat file sources and targets. When you define a format for a numeric or datetime value, the Informatica Server uses the format to read from the file source or to write to the file target. Pre- and post-session SQL. You can specify pre- and post-session SQL in a Source Qualifier transformation and in a mapping target instance when you create a mapping in the Designer. The Informatica Server issues pre-SQL commands to the database once before it runs the session. Use pre-session SQL to issue commands to the database such as dropping indexes before extracting data. The Informatica Server issues post-session SQL commands to the database once after it runs the session. Use post-session SQL to issue commands to a database such as re-creating indexes. Renaming ports. If you rename a port in a connected transformation, the Designer propagates the name change to expressions in the transformation. Sorter transformation. The Sorter transformation is an active transformation that allows you to sort data from relational or file sources in ascending or descending order according to a sort key. You can increase session performance when you use the Sorter transformation to pass data to an Aggregator transformation configured for sorted input in a mapping. Tips. When you start the Designer, it displays a tip of the day. These tips help you use the Designer more efficiently. You can display or hide the tips by choosing Help-Tip of the Day. Tool tips for port names. Tool tips now display for port names when you edit an object in the Designer. To view the full contents of the column, position the mouse over the cell until the tool tip appears. View dependencies. In each Designer tool, you can view a list of objects that depend on a source, source qualifier, transformation, or target. Right-click an object and select View Dependencies. Working with multiple ports or columns. In each Designer tool, you can move multiple ports or columns at the same time.

Informatica Server Add timestamp to workflow logs. You can configure the Informatica Server to add a timestamp to messages written to the workflow log. Expanded pmcmd capability. You can use pmcmd to issue a number of commands to the Informatica Server. You can use pmcmd in either an interactive or command line mode. The interactive mode prompts you to enter information when you omit parameters or enter invalid commands. In both modes, you can enter a command followed by its command options in any order. In addition to commands for starting and stopping workflows and tasks, pmcmd now has new commands for working in the interactive mode and getting details on servers, sessions, and workflows. Error handling. The Informatica Server handles the abort command like the stop command, except it has a timeout period. You can specify when and how you want the Informatica Server to stop or abort a workflow by using the Control task in the workflow. After you start a workflow, you can stop or abort it through the Workflow Monitor or pmcmd. Export session log to external library. You can configure the Informatica Server to write the session log to an external library.

9

Flat files. You can specify the precision and field length for columns when the Informatica Server writes to a flat file based on a flat file target definition, and when it reads from a flat file source. You can also specify the format for datetime columns that the Informatica Server reads from flat file sources and writes to flat file targets. Write Informatica Windows Server log to a file. You can now configure the Informatica Server on Windows to write the Informatica Server log to a file.

Metadata Reporter List reports for jobs, sessions, workflows, and worklets. You can run a list report that lists all jobs, sessions, workflows, or worklets in a selected repository. Details reports for sessions, workflows, and worklets. You can run a details report to view details about each session, workflow, or worklet in a selected repository. Completed session, workflow, or worklet detail reports. You can run a completion details report, which displays details about how and when a session, workflow, or worklet ran, and whether it ran successfully. Installation on BEA WebLogic. You can now install the Metadata Reporter on BEA WebLogic and run it as a web application.

Repository Manager Metadata extensions. You can extend the metadata stored in the repository by creating metadata extensions for repository objects. The Repository Manager allows you to create metadata extensions for source definitions, target definitions, transformations, mappings, mapplets, sessions, workflows, and worklets. pmrep security commands. You can use pmrep to create or delete repository users and groups. You can also use pmrep to modify repository privileges assigned to users and groups. Tips. When you start the Repository Manager, it displays a tip of the day. These tips help you use the Repository Manager more efficiently. You can display or hide the tips by choosing Help-Tip of the Day.

Repository Server The Informatica Client tools and the Informatica Server now connect to the repository database over the network through the Repository Server. Repository Server. The Repository Server manages the metadata in the repository database. It accepts and manages all repository client connections and ensures repository consistency by employing object locking. The Repository Server can manage multiple repositories on different machines on the network. Repository connectivity changes. When you connect to the repository, you must specify the host name of the machine hosting the Repository Server and the port number the Repository Server uses to listen for connections. You no longer have to create an ODBC data source to connect a repository client application to the repository.

Transformation Language New functions. The transformation language includes two new functions, ReplaceChr and ReplaceStr. You can use these functions to replace or remove characters or strings in text data. SETVARIABLE. The SETVARIABLE function now executes for rows marked as insert or update.

10

Workflow Manager The Workflow Manager and Workflow Monitor replace the Server Manager. Instead of creating a session, you now create a process called a workflow in the Workflow Manager. A workflow is a set of instructions on how to execute tasks such as sessions, emails, and shell commands. A session is now one of the many tasks you can execute in the Workflow Manager. The Workflow Manager provides other tasks such as Assignment, Decision, and Event-Wait tasks. You can also create branches with conditional links. In addition, you can batch workflows by creating worklets in the Workflow Manager. IBM DB2 external loader. You can use the DB2 EE external loader to load data to a DB2 EE database. You can use the DB2 EEE external loader to load data to a DB2 EEE database. The DB2 external loaders can insert data, replace data, restart load operations, or terminate load operations. Environment SQL. For relational databases, you may need to execute some SQL commands in the database environment when you connect to the database. For example, you might want to set isolation levels on the source and target systems to avoid deadlocks. You configure environment SQL in the database connection. You can use environment SQL for source, target, lookup, and stored procedure connections. Email. You can create Email tasks in the Workflow Manager to send emails when you run a workflow. You can configure a workflow to send an email anywhere in the workflow logic, including after a session completes or after a session fails. You can also configure a workflow to send an email when the workflow suspends on error. Flat file targets. In the Workflow Manager, you can output data to a flat file from either a flat file target definition or a relational target definition. Heterogeneous targets. You can output data to different database types and target types in the same session. When you run a session with heterogeneous targets, you can specify a database connection for each relational target. You can also specify a file name for each flat file or XML target. Metadata extensions. You can extend the metadata stored in the repository by creating metadata extensions for repository objects. The Workflow Manager allows you to create metadata extensions for sessions, workflows, and worklets. Oracle 8 direct path load support. You can load data directly to Oracle 8i in bulk mode without using an external loader. You can load data directly to an Oracle client database version 8.1.7.2 or higher. Partitioning enhancements. To improve session performance, you can set partition points at multiple transformations in a pipeline. You can also specify different partition types at each partition point. Server variables. You can use new server variables to define the workflow log directory and workflow log count. Teradata TPump external loader. You can use the Teradata TPump external loader to load data to a Teradata database. You can use TPump in sessions that contain multiple partitions. Tips. When you start the Workflow Manager, it displays a tip of the day. These tips help you use the Workflow Manager more efficiently. You can display or hide the tips by choosing Help-Tip of the Day. Workflow log. In addition to session logs, you can configure the Informatica Server to create a workflow log to record details about workflow runs.

11

Workflow Monitor. You use a tool called the Workflow Monitor to monitor workflows, worklets, and tasks. The Workflow Monitor displays information about workflow runs in two views: Gantt Chart view or Task view. You can run, stop, abort, and resume workflows from the Workflow Monitor.

Compilers for External Procedures and Advanced External Procedures You can use the following C compiler versions (or later) for both External Procedures and Advanced External Procedures: • HP: HP ANSI C++, bundle number B3910B, version A.03.10 • AIX: Visual Age C++ compiler, version 5.0

If you are upgrading from a version prior to PowerCenter 6.0/PowerMart 6.0, you must upgrade the external procedure and recompile it.

• NT: VC++ 6.0, cl version 12.00.8168 • Solaris: Forte 6 Update 2, C++ patch 111685-07

If you are upgrading from a version prior to PowerCenter 6.1/PowerMart 6.1, you must upgrade the external procedure and recompile it.

• Linux: g++ version 2.96 20000731

6.2 Bug Fixes The following issues are corrected in PowerCenter 6.2 /PowerMart 6.2. Most of the listed corrections were found through in-house testing and are unlikely to affect most users. They are listed here for your information.

Client Fixed CR 47089: Designer no longer shuts down unexpectedly when you export a mapplet with a Router transformation or run a session with a mapplet containing a Router transformation In a previous release, the Designer shut down unexpectedly when you exported a mapplet with a Router transformation to an XML file or when you ran a session with an exported mapplet containing a Router transformation. This happened after you replaced the Router transformation in the mapplet with a Router transformation with the same name, but different ports. This no longer occurs.

Database and Connectivity Fixed CR 44002: Repository no longer shuts down when copying a repository from Teradata to DB2 In a previous release, if you copied a repository on an HP-UX or AIX Teradata database to DB2, the Repository Agent managing the Teradata repository may have shut down. This no longer occurs. Fixed CR 43387: Informatica Server on AIX no longer fails session accessing DB2 and ODBC In a previous release, the Informatica Server on AIX failed sessions with database errors under the

12

following conditions: • The session read from the source through ODBC and wrote to a DB2 target. • The session read from a DB2 source and wrote to the target through ODBC. • The repository was on an IBM DB2 database and the session read from the source through ODBC and

wrote to the target through ODBC. This no longer occurs. Fixed CR 35867: Informatica Server on HP-UX no longer fails session accessing DB2 and ODBC In a previous release, the Informatica Server on HP-UX failed sessions with database errors under the following conditions: • The session read from the source through ODBC and wrote to a DB2 target. • The session read from a DB2 source and wrote to the target through ODBC. • The repository was on an IBM DB2 UDB database and the session read from the source through

ODBC and wrote to the target through ODBC.

Informatica Server Fixed CR 48354, 47248: Informatica Server Load Manager process no longer aborts unexpectedly if you delete transformation used by a shortcut In a previous release, if you deleted the transformation referenced by a shortcut in a mapping and then saved the repository, the Informatica Server unexpectedly aborted the Load Manager process when you tried to run a session using the mapping. This no longer occurs. Fixed CR 47224: Informatica Server no longer generates a core file when performing full outer join, detail outer join, or master outer join In a previous release, the Informatica Server generated a core file when performing a full outer join or detail outer join under the following conditions: • The detail source contained no data. • The join condition contained a String or Binary port. • An Expression transformation immediately followed the Joiner transformation in the mapping. The Informatica Server may have also generated a core file when performing a master outer join when the master source contained no data. This no longer occurs.


Bulk Loading Fixed CR 5429: Errors no longer occur when bulk loading NULL dates to Microsoft SQL Server targets with multiple date fields In a previous release, if you ran a session for which all of the following were true, you might have found inconsistent data in date fields: • The session wrote to a Microsoft SQL Server target containing multiple date fields. • You passed data with NULL date fields.

13

• You set the session for bulk mode. This no longer occurs.

Client Fixed CR 41357: Designer can now import a target from an XML file that has both indexes and metadata extensions In a previous release, when you exported a target definition that contained both indexes and metadata extensions to an XML file, and then imported the file, the Designer displayed an error message. This no longer occurs. Fixed CR 5620: Precision no longer lost when you divide floating point numbers In a previous release, if you wrote an expression that divided a floating point number by an integer, the Informatica Server might have returned a result with incorrect precision. This occurred when the floating point number in the numerator was of high precision. For example, if the numerator was a floating point number with a precision of 19 and the divisor was an integer, the output was of precision 16 rather than the expected 19. This no longer occurs.

Informatica Server Fixed CR 46519: The Informatica Server no longer produces numeric overflow in some decimal calculations In a previous version, the Informatica Server produced numeric overflow in some decimal calculations. This no longer occurs. For example, you have the following expression in a decimal port with precision 10 and scale 5:

(1.123456789 - 1234567890) * 0 In previous versions, the Informatica Server produced an overflow. Now, the Informatica Server returns the correct value, 0. Fixed CR 46517: The Informatica Server now detects numeric overflow when performing integer calculations In a previous version, the Informatica Server returned the maximum integer or minimum integer value in some integer calculations instead of producing numeric overflow. Integer calculations overflow when their results return values greater than the maximum or less than the minimum integer values (2,147,483,647 and -2,147,483,648, respectively). If you created an expression that produced integer overflow, the Informatica Server rounded the calculation result to the maximum or minimum integer value. This no longer occurs. If the expression result is out of range, the Informatica Server produces numeric overflow. For example, you have the following expression:

(2,147,483,647 - 2) + 3

14

Effective in version 6.1, this expression produces numeric overflow. In previous versions, this expression returned 2,147,483,647. Fixed CR 46336: The Informatica Server now evaluates �inf�, �-inf�, �NaN�, and �-NaN� in test and conversion functions as non-numeric strings In a previous version, the Informatica Server evaluated the strings �inf�, �-inf�, �NaN�, and �-NaN� in test and conversion functions differently, depending on the function and platform. This no longer occurs. Effective in version 6.1, the Informatica Server evaluates �inf�, �-inf�, �NaN�, and �-NaN� in the following functions as non-numeric strings: • IS_NUMBER • TO_DECIMAL • TO_FLOAT • TO_INTEGER Fixed CR 11256: No delay in scheduled sessions In a previous release, as the Informatica Server ran scheduled sessions, it went into a wait mode before it initialized and scheduled the next session. Each wait mode lasted from 2 to 30 seconds (or more, if the Informatica Server was extremely busy) and could delay the start of the next session. This no longer occurs. Fixed CR 10977: Informatica Server now correctly writes values to Time fields in flat file targets In a previous release, the Informatica Server did not correctly write datetime values to Time fields in flat file targets. This no longer occurs. You can now specify the format for datetime values when you edit a port in a flat file source or target, a flat file source instance or target instance, or a flat file source definition or target definition. Fixed CR 8251: TRUNC function no longer loses precision when evaluating Double datatypes In a previous version, if you passed ports with Double datatypes to the TRUNC function, you may lose precision. The following example shows possible results of the expression:

TRUNC(input_field, 4) INPUT_FIELD RETURN VALUE 700 699.9999 8000 7999.9999

This no longer occurs. The TRUNC function does not lose precision when evaluating Double datatypes. Fixed CR 3650: Microsoft SQL Server no longer rounds numeric data differently in bulk and normal loads In a previous release, the Informatica Server may have returned different results when you ran a session in bulk or normal mode. In normal mode, Microsoft SQL Server rounded up; in bulk mode, it rounded down. This no longer occurs. Results are now consistent between normal and bulk mode. Microsoft SQL Server now truncates the result based on the precision specified for the column. For example, Microsoft SQL Server truncates values 0.215, 0.214, and 0.216 to 0.21 when the column is configured for a numeric value with a precision of 2.

15

Repository Agent and Repository Server Fixed CR 43606, 41252: Repository Agent process no longer shuts down unexpectedly on AIX system when system locale is set to en_US In a previous release, the Repository Agent process running on an AIX system shut down unexpectedly if you set the system locale to en_US. This no longer occurs.


Client Fixed CR 19933: The Designer no longer fails to preview data for flat file sources In a previous release, when you manually created a flat file source definition and previewed the data, the preview data dialog box was empty. This no longer occurs. Fixed CR 17581: Designer now displays correct messages when you import a global shortcut from an XML file In a previous release, when you imported a global shortcut from an XML file into a folder that already contained the same global shortcut, the Designer displayed the following messages:

The mapping <mapping_name> has been modified by another user. Mapping will be saved as INVALID. Shortcut_To_<mapping_name> already exists. Unable to save this mapping. Continue with save?

Now, the Designer displays the following message:

A shortcut to Shortcut_To_<mapping_name> already exists. Creating another shortcut to the same object is not allowed.

Fixed CR 17531: Designer no longer changes an imported shortcut to an object In a previous release, when you imported a shortcut to an object from an XML file, the shortcut became an object. For example, a local repository contained a shortcut to the source Items called Shortcut_To_Items. If you exported Shortcut_To_Items to an XML file and imported Shortcut_To_Items to a global repository, the Designer converted Shortcut_To_Items to Items and imported Items into the global repository. Now, shortcuts are properly imported.

Database Connectivity Fixed CR 11140: Teradata as ODBC source or target no longer needs an entry in powrmart.ini In a previous release, before you could import sources or targets from or create targets in a Teradata database using ODBC, you were required to manually add an entry to the powrmart.ini file. You no longer need to add an entry to the powrmart.ini file to use Teradata as an ODBC source or target.

16

Flat Files and COBOL Fixed CR 11161: Informatica Server no longer returns parsing errors when session reads a COBOL file that contains tabs In a previous release when the Informatica Server read a COBOL file that contained tabs, it returned error messages similar to the following:

05 FILLER Error at line 16: parse error Error: FD FILE-ONE ignored - invalid or incomplete.

This no longer occurs.

Third Party Limitations Please be aware of the following limitations related to third party and platform products that you may use with PowerCenter 6.2 and PowerMart 6.2. If you encounter difficulties or have further questions regarding one of these limitations, contact Informatica Technical Support and reference the CR number.

IBM DB2 CR 50375, 49780: Sessions using database partitioning may hang when the Informatica Server loads a large number of rows to IBM DB2 targets When the Informatica Server loads a large number of rows to an IBM DB2 target, sessions may hang when you use the database partitioning partition type. Workaround: Reduce the buffer block size, such as 32 KB or less. If the session still hangs, configure the Informatica Server to perform single row inserts by adding the following entry to the pmserver.cfg file:

OptimizeDB2Write=0 For information about configuring the Informatica Server on Windows, contact Informatica Technical Support. CR 49362: Informatica Server fails sessions using database partitioning when the IBM DB2 table uses a Decimal or Numeric datatype for the partitioning key When the Informatica Server loads to an IBM DB2 table, it fails the session when you use the database partitioning partition type and the IBM DB2 table partitioning key uses either a Decimal or Numeric datatype. The Informatica Server writes the following message to the session log:

TT_11102 Database partition router failed due to the following error [Decimal/Numeric partition key type is not supported.].

Workaround: Use pass-through partitioning. Or, do not use Decimal or Numeric datatypes for the partitioning key. CR 46763: Designer does not define correct port precision when importing DB2 for AS/400 stored procedures When you import a DB2 for AS/400 stored procedure, the Designer creates a Stored Procedure transformation with incorrect precision for some input and output ports compared to the precision specified in the stored procedure. Workaround: Open the Stored Procedure transformation in the Designer and correct the precision for input, input/output, and output ports.

17

CR 39615: Sessions load data to a locked DB2 target table on AS/400 If you do not truncate the table, you can load data to a locked DB2 target table on AS/400 because the DB2 database on AS/400 does not detect the lock. You may get inconsistent data. CR 39427: Constraint violations cause session failure when loading to DB2 on AS/400 When loading to DB2 on AS/400 violates key constraints, the session may fail with a communication error. The following messages might appear in the session log:

WRITER_1_1_1> WRT_8229 Database errors occurred: [IBM][CLI Driver][AS] SQL30081N A communication error has been detected. Communication protocol being used: "TCP/IP". Communication API being used: "SOCKETS". Location where the error was detected: "10.1.72.203". Communication function detecting the error: "recv". Protocol specific error code(s): "*", "*", "0". SQLSTATE=08001 . . . WRITER_1_1_1> CMN_1022 Database driver error... CMN_1022 [ [IBM][CLI Driver] CLI0106E Connection is closed. SQLSTATE=08003

Workaround: Verify that you load primary key tables before you load foreign key tables. CR 39101, 29118: Informatica Server reports incorrect load statistics in the session log file for DB2 targets on AS/400 or OS/390 The Informatica Server reports incorrect load statistics in the session log file when: • The session loads to a DB2 database on AS/400 or OS/390. • There are DB2 errors, such as violating not null constraints. • You configure the Informatica Serve to perform array writes. Workaround: Add the following entry to the file pmserver.cfg on the Informatica Server:

DB2ArrayStatusPtrWorkAround=Yes CR 38440: IBM DB2 EE db2load utility fails to load last numeric column to DB2 EE database on UNIX If you use the DB2 EE load utility, db2load does not convert numeric values under the following conditions: • You load to a DB2 EE database on UNIX. • The numeric data is in the last column. The DB2 EE load utility loads a null value to the database. CR 36093: The Repository Server fails to promote a local DB2 repository after creating the repository When you use the Repository Server to create a DB2 repository, it fails to promote the local repository to a global repository. Workaround: Catalog the DB2 database as a remote node instead of a local node. For more detailed instructions, contact Informatica Technical Support and reference Knowledge Base ID 1347. CR 10655: Column names do not appear in the source definition when importing DB2 table aliases containing underscores (_) When you import a DB2 table alias in the Designer, no columns appear in the source definition if the alias name contains an underscore ( _ ).

18

Workaround: Remove the underscore from the table or alias name. or In the DB2 CAE Client Configuration Assistant, clear the Underscore as Wildcard option: 1. Click the Properties button for the database alias. 2. Click Settings. 3. Click Advanced. 4. Click the Optimization tab. 5. Clear the Underscore as Wildcard option. CR 6163: Session fails for non-cached lookups on DB2 When performing a non-cached lookup on an integer value, DB2 has an upper limit of 2147483583. Workaround: Enable caching in the Lookup transformation.

HP-UX CR 46161: Informatica Server on HP-UX may hang when writing to flat files When you run a flat file session against an Informatica Server on HP-UX, the Informatica Server may hang. Workaround: Contact HP regarding bug #JAGad68396, and install HP patch PHSS_26560.

Informix CR 9582: Sybase and Informix string datatypes display incorrectly in the Source Analyzer When you import a Sybase source definition with Nchar and Nvchar datatypes, the Designer displays them as Char and Varchar. When you import an Informix source definition with Nchar datatype, the Designer displays it as Char. Workaround: Manually change these datatypes to Nchar and Nvarchar.

Linux CR 48674: When sessions fail on Linux due to insufficient memory allocation, the Informatica Server does not write a message to the session log When a session fails to allocate enough memory, the session might terminate unexpectedly without logging an error message. Linux does not provide an error message for the Informatica Server to log. Workaround: While a messaging workaround is unavailable, you can modify memory allocation. Verify that you did not over allocate memory for DTM buffer pool size or cache sizes for Joiner, Aggregator, Sorter, Lookup, and Rank transformations. You can also increase the amount of RAM and swap space allocated on the Informatica Server machine.

Microsoft SQL Server CR 42355: Sessions may fail when running multiple workflows against Microsoft SQL Server repository Deadlocks may occur when you run multiple workflows against a Microsoft SQL Server repository. This causes the Repository Agent to stop and sessions to hang. Workaround: Apply Microsoft SQL Server Service Pack 2. For more information on this limitation, see Microsoft Knowledge Base Article # 300412.

19

CR 40506: Microsoft SQL Server may not commit smalldatetime values correctly When you use OLE DB drivers to load data from a flat file into a Microsoft SQL Server smalldatetime field, the Informatica Server does not commit rows if it encounters any invalid smalldatetime data. Workaround: Use one of the following workarounds: • Verify that you load only valid data. • Add a Router transformation to filter rows containing invalid smalldatetime values. • Use bulk mode. • Use an ODBC driver. CR 40190: Repository Server may take several minutes to complete repository operations for folders with very large sources or targets If your repository resides on a Microsoft SQL Server database on a Windows 2000 machine, the Repository Server may take several minutes to complete operations on folders containing multiple sources or targets with 4,000 columns or more. These operations include opening and deleting the folder. CR 22991: Microsoft SQL Server ODBC driver does not report decimal truncation The Microsoft SQL Server ODBC driver does not report decimal truncation when the following conditions are true: • Decimal column in the source has a precision less than the length of the field. • The session uses a Microsoft SQL 2000 ODBC call. The Informatica Server does not report the truncation. Instead, it reads truncated data and loads it to the target. Workaround: Use native drivers. CR 16959: Loading data to Microsoft SQL Server or Sybase targets in bulk mode does not preserve primary key and foreign key relations When the Informatica Server loads a row with a foreign constraint to a Microsoft SQL Server or Sybase target using bulk mode, Microsoft SQL Server and Sybase allow the foreign key table to be loaded before the primary key table. Bulk load bypasses the foreign key restraint check in the database and does not require that the primary key be loaded. Microsoft SQL Server and Sybase SQL Server preserve primary key-foreign key relations for normal load only.

Microsoft Windows CR 20777: Informatica Client and Server installation fails on some Windows 2000 machines with Internet Explorer prior to version 5.5 When you install the Informatica Client or Server on some Windows 2000 machines with Internet Explorer prior to version 5.5, the installation might fail. During installation you might get an Ikernel error or an error message that says �Class Not Registered. No Such Interface Supported.� Workaround: Reinstall Internet Explorer 5.5 and then install the Informatica Client or Server.

Oracle CR 41007: Designer does not properly import Oracle tables When you connect the Informatica Client to an Oracle database, you may encounter the following limitations: • If you import a definition from an Oracle 8, 8i, or 9i table that you created from the Warehouse

Designer, the Oracle client doubles the precision of Nchar and Nvarchar columns. For example, you create a definition in the Warehouse Designer that contains a column of datatype Nchar(2), and then generate and execute the SQL to create the table in the Oracle database. When you import the table from the database into the Source Analyzer or Warehouse Designer, the column has precision 4.

20

• If you install an Oracle 9i client on the Informatica Client machine, and you try to import source or target tables from an Oracle 8 or 8i database, you can import the objects successfully on the first try. If you try to import tables a second time however, the Designer displays the following error:

REP_12001: Failed to log onto Database Server.

Workaround: You can work around the second limitation by closing and reopening the Designer between imports. CR 40983: Repository Agent managing repository on Oracle does not start if Repository Agent process port number is 32768 The Repository Agent process managing a repository database on Oracle does not start if the Repository Agent process port number is 32768. Workaround: Configure the Repository Agent process port number to a value other than 32768. CR 40673, 36431: Repository Agent process on UNIX shuts down unexpectedly when running repository on Oracle 8 database The Repository Agent process on UNIX system shuts down unexpectedly when managing a repository on an Oracle 8 database. Workaround: Apply the Oracle patch for bug 2281980 from patch set 8.1.7.3 to the database client application on the UNIX system. CR 38932: Informatica Server fails to connect to Oracle 9i databases running on Windows XP The Informatica Server fails to connect to Oracle databases under the following conditions: • The database server is Oracle 9i running on Windows XP. • The Informatica Server machine or Repository Server machine run Oracle 8i client. The Informatica Server writes an error message to the session log similar to the following message:

READER_1_1_1> RR_4036 Error connecting to database ORA-12154: TNS:could not resolve service name

Workaround: Use Oracle 9i client on the Informatica Server or Repository Server machine. CR 38672, 36211: Oracle bulk load session fails or runs in normal mode on some versions of Oracle When you configure a session for bulk loading and the target database is on Oracle, the session fails when the Oracle client version is greater than or equal to 8.1.5 and less than 8.1.7.2. When the Oracle client version is less than 8.1.5, the session runs in normal mode. Workaround: Apply the Oracle Threaded Bulk Mode patch (Oracle bug number 1666360), use Oracle client 8.1.7.2 or higher, or run the session in normal mode. CR 37460: Repository Agent shuts down unexpectedly while making concurrent connections to an Oracle 8.1.7 repository If you make multiple, concurrent connections to an Oracle 8.1.7 repository, the Repository Agent process may shutdown unexpectedly. This is because the Oracle 8.1.7 client library is not thread-safe. This problem is most likely to happen while running multiple concurrent sessions. Workaround: Apply the Oracle patch for bug 2281980 from patch set 8.1.7.3 to the Oracle client library used by the Repository Agent.

21

CR 35268: The Informatica Server fails to bulk load to multiple instances of the same Oracle target The Informatica Server fails a session under the following conditions: • You include multiple instances of the same Oracle target table. • You specify bulk mode for at least one target instance. • You specify the same database connection name for all target instances. Workaround: Specify normal mode for all instances of the same Oracle target table. Or, use different database connection names for each target instance, specifying the same user name, password, and connect string. CR 35240: Oracle external loader interprets new line characters as line breaks When reading data from fixed-width or delimited flat file sources, the Oracle SQL*Loader always interprets new line characters as row delimiters. Therefore, you cannot use a new line character as part of any field that converts to the String or Nstring transformation datatype. This includes the following Oracle datatypes: Char, Long, Nchar, Nvarchar2, Varchar, and Varchar2. CR 34337: Oracle 8i sessions running in bulk mode may fail When running an Oracle 8i session in bulk mode, the session may fail and return one of the following errors:

WRITER_1_1_1> CMN_1022 Database driver error... CMN_1022 [ ORA-00600: internal error code, arguments: [kpodpmop_01], [2], [], [], [], [],[], []

-or-

MAPPING> TE_7022 TShmWriter: Initialized MAPPING> Sat Jan 26 13:54:45 2002 MAPPING> TE_7001 Internal error: Failed to allocate a target slot. MAPPING> Sat Jan 26 13:54:45 2002 MAPPING> TE_7017 Failed to Initialize Server Transformation BLK_ALL_DATATYPES1 MAPPING> Sat Jan 26 13:54:45 2002 MAPPING> TM_6006 Error initializing DTM for session... MAPPING> TM_6020 Session [s_BULK_LONG] completed at [Sat Jan 26 13:54:45 2002]

Workaround: Run the session in normal mode. CR 32615: Repository Agent process on Windows NT stops when it loses connection to Oracle repository database When the Repository Agent process on a Windows NT system is running a repository on an Oracle database, the Repository Agent stops if it loses connectivity to the repository database. The Oracle client library generates a heap error. CR 15904, 14573: Using Oracle external loader requires Oracle database version 8.0.5.2.1 or higher If you use an Oracle external loader, the session might complete, even though the external loader encounters errors. To detect Oracle external loader errors, you must have Oracle database version 8.0.5.2.1 or higher. Please refer to Oracle bug 711642 for details. Oracle database version 8.0.5.2.1 does not support Windows 2000.

22

CR 12367: Default packet sizes on Oracle 8 client applications can slow session performance With Oracle 8, the default packet sizes for SQL*Net and Net8 can slow the performance of the Informatica Server, especially when performing updates. Workaround: Set the SDU and TDU parameters in listener.ora and tnsnames.ora to 8KB or greater. For example, you can configure the listener.ora file as follows:

SID_LIST_LISTENER = (SID_LIST = (SID_DESC = (SID_NAME = ORCL ) (ENVS='EPC_DISABLED=TRUE') (SDU=8192) (TDU=8192) (ORACLE_HOME = /usr1/oracle805/8.0.5) ) )

You can configure the tnsnames.ora file as follows:

tsoracle.world = (DESCRIPTION = (SDU=8192) (TDU=8192) (ADDRESS_LIST = (ADDRESS = (COMMUNITY = tcp.world) (PROTOCOL = TCP) (Host = tsoracle) (Port = 1521) ) ) (CONNECT_DATA = (SID = orcl) ) )

For details, see Oracle Doc ID 44694.1.

Sybase CR 39673: Sybase bulk load session fails when you specify owner ID as table name prefix When you configure a session for bulk loading and you specify a table name prefix for the target table on Sybase, the session fails. Workaround: Specify the database name and the owner ID in the target instance Table Name Prefix property. Use the following format:

dbname.ownerID CR 33115: Session fails when Sybase IQ external loader loads to a view for a table The Informatica Server fails the session if the Sybase IQ external loader loads data to a view for a table. The Sybase IQ external loader can only load data to a database table. CR 25953: Sybase IQ sessions fail when using ODBC When you use ODBC to perform array inserts to Sybase IQ 12.4.3 on an AIX or Windows Informatica Server, the session fails and the Sybase database server shuts down. The following message might appear in the session log:

ERROR: Unexpected condition at file:[d:\k2\builder\powrmart\server\dwriter\wrtfile\rejfile.cpp]

23

line:[288]. Application terminating. Contact Informatica Technical Support for assistance.

Workaround: Configure the Informatica Server to perform single row inserts. Add the following entry to the pmserver.cfg file:

OptimizeODBCWrite = 0 For information about configuring the Informatica Server on Windows, contact Informatica Technical Support. CR 17761: Informatica Server loads null values to timestamp columns when bulk loading to Sybase The Informatica Servers loads null values (instead of hexadecimal values) to timestamp columns in Sybase targets when you perform the following steps: • Create a mapping with a Sybase target that includes a timestamp column. • Do not link any transformation ports to the timestamp column. • Create a session with this mapping and choose bulk load. Workaround: To load hexadecimal values to unconnected timestamp columns, use a normal load. CR 16959: Loading data to Microsoft SQL Server or Sybase targets in bulk mode does not preserve primary key and foreign key relations When the Informatica Server loads a row with a foreign constraint to a Microsoft SQL Server or Sybase target using bulk mode, Microsoft SQL Server and Sybase allow the foreign key table to be loaded before the primary key table. Bulk load bypasses the foreign key restraint check in the database and does not require that the primary key be loaded. Microsoft SQL Server and Sybase SQL Server preserve primary key-foreign key relations for normal load only. CR 14799: Informatica Server hangs if session fails using Sybase IQ external loader on Windows If you run the Informatica Server with default service settings, and dbisql encounters a problem that requires desktop interaction, the Informatica Server hangs. Workaround: Allow desktop interaction from the Informatica service. In the Informatica service property sheet, select Log On As System account and select Allow Service to Interact with Desktop. If dbisql sends an error message to the desktop, you can close the message box, allowing dbisql and the Informatica Server to exit properly. CR 13256: Sybase IQ does not support Binary, Varbinary, or Image datatypes If you try to write binary data to Sybase IQ, the external loader fails to run the generated script and issues the following message:

"Unknown PowerMart datatype" This is because Sybase IQ does not support Binary, Varbinary, or Image datatypes. CR 9582: Sybase and Informix string datatypes display incorrectly in the Source Analyzer When you import a Sybase source definition with Nchar and Nvchar datatypes, the Designer displays them as Char and Varchar. When you import an Informix source definition with Nchar datatype, the Designer displays it as Char. Workaround: You must manually change these datatypes to Nchar and Nvarchar.

24

Teradata CR 49499, 44886: pmrepagent or pmrep on AIX generates syntax errors when running commands for a Teradata repository database pmrepagent or pmrep on AIX generates syntax errors when you run a command for a Teradata repository database, even though the command succeeds. You can ignore these errors. CR 48794: Sessions may fail when loading XML data to a Teradata database Sessions may fail when you load XML data to a Teradata database. This occurs when the Informatica Server loads source XML data associated with a DTD file containing more than 2,000 characters. The session log does not indicate the reason for failure. CR 46224: Duplicate entries in REP_SESSION_FILES and REP_SESSION_INST_FILES when using MX Views to access Teradata repository If you configure a session to use multiple file writers to write to the same target file, you will find duplicate entries when you use the REP_SESSION_FILES and REP_SESSION_INST_FILES MX Views to access metadata in a Teradata repository. CR 46211, 45602: Invalid date/time operation error when the Informatica Server runs uncached lookup on Teradata database When you run a session with a mapping that uses an uncached lookup on a Teradata database, the Informatica Server fails the session if any transformation port in the lookup condition uses a Date/Time datatype. The Informatica Server writes the following Teradata error message to the session log:

[NCR][ODBC Teradata Driver][Teradata RDBMS] Invalid operation on an ANSI Datetime or Interval value.

Workaround: Configure the Lookup transformation to use a lookup cache, or remove the Date/Time port from the lookup condition. CR 43632: Informatica Server generates core file if invalid Teradata database specified in odbc.ini The Informatica Server on UNIX generates a core file if the DefaultDatabase entry for a Teradata ODBC source in the odbc.ini file specifies an invalid database. Workaround: Edit the DefaultDatabase entry and specify a valid database.

PowerCenter/PowerMart Known Limitations Please be aware of the following limitations that may occur when using PowerCenter 6.2 and PowerMart 6.2. If you encounter difficulties or have further questions regarding one of these limitations, contact Informatica Technical Support and reference the CR number.

Backward Compatibility CR 50498: Version 6.1 Administration Console displays the tablespace name for version 6.2 repositories When you connect to a version 6.2 Repository Server with a version 6.1 Administration Console and create a repository configuration for an IBM DB2 repository, you can specify a tablespace name. However, when you create the repository in the database, the Repository Server creates the repository tables in the default tablespace, not the tablespace used in the repository configuration. Workaround: Use a version 6.2 Administration Console to create IBM DB2 repositories in a specified tablespace name.

25

CR 49110: A version 6.1 Informatica Client does not allow you to edit a copy of a version 6.2 read-only session after you save the copy When you use a version 6.1 Informatica Client to create a copy of a version 6.2 session or a session configuration object, you can modify the copy. However, once you save the copy, it becomes read-only. If you try to edit the copy, the version 6.1 Informatica Client displays the following message:

The current user does not have write permission on the current folder. You do not have sufficient privileges to obtain a write lock on the object.

If you disconnect and then reconnect to the folder containing the copy, you can edit the copy again. Workaround: Upgrade to the version 6.2 Informatica Client. A version 6.2 Informatica Client allows you to make a copy of a version 6.2 read-only session or a session configuration object and edit the copy without disconnecting and reconnecting to the folder. CR 49101: A version 6.1 Informatica Client does not allow you to edit comments for a shortcut once you save the comments and disconnect from the folder containing the shortcut When you use a version 6.1 Informatica Client to create a shortcut to a version 6.2 read-only Joiner transformation or a 6.2 read-only mapping containing a Joiner transformation, the Designer allows you to add comments to the shortcut. However, when you disconnect and reconnect to the folder containing the shortcut, the version 6.1 Informatica Client does not allow you to edit the comments. It displays the following message:

The current user does not have write permission on the current folder. You do not have sufficient privileges to obtain a write lock on the object.

Workaround: Upgrade to the version 6.2 Informatica Client. A version 6.2 Informatica Client allows you to edit the comments after reconnecting to the folder.

Bulk Loading CR 36404: Sessions configured for bulk load run in normal mode when the Informatica Server running on AIX loads to an Oracle database The Informatica Server on AIX runs sessions in normal load when you configure them for bulk mode. You might see the following error message when this occurs:

WRT_8229 Database errors occurred: ORA-26002: Table QASRVRK2.BULK_PRIMKEY_TGT has index defined upon it.

Workaround: Edit the $ORACLE_HOME/rdbms/admin/shrept.lst file and add the following lines of text: rdbms : OCIDirPathDataSave rdbms : OCIDirPathFinish rdbms : OCIDirPathFlushRow rdbms : OCIDirPathPrepare rdbms : OCIDirPathLoadStream rdbms : OCIDirPathColArrayEntrySet rdbms : OCIDirPathColArrayReset rdbms : OCIDirPathColArrayToStream rdbms : OCIDirPathStreamReset Then, run genclntsh.

26

CR 34329: When running a session in bulk mode, the Informatica Server loads null values for the default value, SYSDATE, in the Oracle target The Informatica Server loads null values into Oracle when the following conditions are true: • You use the Warehouse Designer to create a target definition and generate a target table on Oracle with

two fields (F1 and F2). • You use SQL*Plus to create a third field in the target table with a date datatype and the default value

of SYSDATE. • You run the session in bulk mode. Workaround: Run the session in normal mode or create a column on the relational target definition with the date datatype and the default value of SYSDATE before you generate the target table in Oracle.

Client CR 50911: Mapping Designer may not automatically update a mapping with changes to a mapplet When you have recently modified a port in a mapplet, you may get the following error message when you open a mapping that uses the mapplet:

...mapping <mapping_name> contains a mapplet with a port mismatch. Please edit mapplet <mapplet_name>.

Workaround: To resolve the port mismatch, open the mapplet in the Mapplet Designer. Edit and save the mapplet. Then, return to the mapping in the Mapping Designer. Changes to the mapplet appear in the Mapplet transformation. CR 50706: Mapping Wizard cannot import sources that use SQL keywords as column names The Mapping Wizard cannot import a source when a column name uses an SQL keyword. When the Mapping Wizard encounters an SQL keyword used as a column name, it prompts you to choose another source. Workaround: Create the mapping using the Mapping Designer. CR 48237: Deploy folder performance is slow in an Oracle 8.1.7.2 and lower repository database Performance might be slow when you deploy folders in an Oracle 8.1.7.2 and lower repository database. Workaround: Use a later version of Oracle or update your table and index statistics. For information on updating the index statistics, see �Tuning Repository Performance� in the Supplemental Guide. CR 45696: Designer does not correctly import foreign key on table created in Designer When you create a target definition, you can use the Warehouse Designer to generate and execute the SQL code to create the target in a relational database. If you then import the table with foreign keys into the Source Analyzer or Warehouse Designer, the Designer does not import the foreign keys correctly. Workaround: Edit the generated SQL query before you execute it on the database. For example, you generate the following SQL query for tables AA2 and AA1:

CREATE TABLE AA2 ( byte_1 byte(10), decimal_5 decimal(10) NOT NULL, varbyte_10 varbyte(10), varchar_11 varchar(10) ) ;

27

CREATE TABLE AA1 ( byte_1 byte(10), decimal_5 decimal(10) NOT NULL, varbyte_10 varbyte(10), varchar_11 varchar(10) ) UNIQUE PRIMARY KEY (decimal_5); ALTER TABLE AA2 ADD FOREIGN KEY (decimal_5) REFERENCES AA1 (decimal_5);

Modify the query as follows:

CREATE TABLE AA1 ( byte_1 byte(10), decimal_5 decimal(10) NOT NULL primary key, varbyte_10 varbyte(10), varchar_11 varchar(10) ); CREATE TABLE AA2 ( byte_1 byte(10), decimal_5 decimal(10) NOT NULL, varbyte_10 varbyte(10), varchar_11 varchar(10), foreign key (decimal_5) references AA1 );

Execute the modified query. When you import the table in the Designer, foreign key columns appear correctly. CR 41733: Copy Folder Wizard does not copy reusable metadata extensions When you use the Repository Manager to copy a folder that contains a mapping with reusable metadata extensions, the Copy Folder Wizard might not copy the metadata extensions to the target repository. Workaround: Save the source repository before you copy the folder to the target repository. If you added the reusable metadata extension in the Repository Manager after the last time you saved the repository, you must edit the object in the Designer or Workflow Manager and then save the repository. CR 41232: Changes to reusable metadata extension default values do not get updated in the Designer or Workflow Manager When you create a reusable metadata extension for an object in the Repository Manager and specify a default value for the extension, objects of that type in the Designer and Workflow Manager do not always receive changes to the metadata extension default value. For example, in the Repository Manager you create a reusable metadata extension for targets and supply a default value for the extension. You then create and save a target in the Designer without changing the metadata extension default value. In the Repository Manager, you edit and save the metadata extension default value. When you reopen the Designer, the new target contains the original metadata extension default value. Workaround: To update the metadata extension default value, edit the target and click the Revert button on the Metadata Extension tab.

28

CR 39192: The Designer might shut down unexpectedly when you save a large mapping If your system does not have enough memory, importing a large mapping with the �Save MX Data� option selected might cause the Designer to shut down unexpectedly. Workaround: Go to Tools-Options and clear the �Save MX Data� option. Then import your mapping. CR 37527: Workflow Manager renames or deletes only some database connections When you rename or delete a connection, the Workflow Manager renames or deletes the connection for source and target connections in sessions. The Workflow Manager does not rename or delete the connection for the following session properties: • Location Information in Lookup transformations • Connection Information in Stored Procedure transformations • $Source Connection Value • $Target Connection Value Workaround: When you delete a connection, you must manually delete the residual connection names from the other session properties in all sessions. Also, when you rename a non-relational database connection, you must manually rename the old connection names from the other session properties in all sessions. To rename a relational database connection, complete the following steps: 1. Create a new relational database connection with the same connection information as the connection you want to rename. Give it a new name. 2. Open the Workflow and verify you close all folders in the repository. 3. Choose Connections-Replace to replace the connection you want to rename with the new connection you created. CR 32379: Designer incorrectly imports COBOL file with signed numeric fields When you import a COBOL file with a signed numeric column, the Designer uses an extra space of precision for the signed character. As a result, the Informatica Server may not correctly write signed numeric data for the target. For example, the Designer imports a PIC S9 (2) V99 with a precision of 4 and a scale of 2. The Informatica Server writes the source value -6789 to the target as �6.78 instead of �67.89. Workaround: Increase the precision of the signed numeric field in the COBOL source definition to accommodate the signed character. For the above example, increase the precision to 5. CR 19266: Designer imports Informix table without columns when table name contains slash character (/) The Designer might import an Informix table without columns when the table name contains the slash character (/). CR 17277: Retain Primary/Foreign Key relationship option fails if you do not import all tables affected in the relationship When you import tables with a primary/foreign key relationship into the Source Analyzer or the Warehouse Designer, and then reimport only some of the affected tables, the Designer does not import the key relationships. The import tables option Retain user-defined primary/foreign key relationships fails if you do not select all affected tables. Workaround: Reimport all tables affected by the primary key-foreign key relationship. CR 14760: Foreign keys lost after importing shortcut to source and shortcut to target When you import a shortcut to any folder, you lose key type information. Workaround: To maintain key type information after you import a shortcut, save the shortcut object, and then disconnect and reconnect to the folder in which the shortcut resides.

29

CR 13591: Unable to correctly import Sybase 12.5 database source or target with primary-foreign key When you use the Source Analyzer or Warehouse Designer to import a source or target definition with a primary-foreign key from Sybase 12.5, the Designer imports the source or target with a primary key only. CR 12114: Designer cannot create a Long Varchar column in Teradata when target database type is ODBC If you are loading data to a Teradata table and you configured the target definition as an ODBC database type, you cannot use the Long Varchar datatype in the Designer. Workaround: Configure the target definition as a Teradata database type. or Workaround: To use the Designer to create a Teradata table with a Long Varchar column, complete the following steps: 1. Create a target definition in the Warehouse Designer as an ODBC database type. 2. Define the column as any datatype, for example Text. 3. Manually edit the generated SQL file and change the datatype to Long Varchar. 4. Execute the SQL file. The target definition still displays as the datatype you specify, for example Text, but it loads correctly to the Long Varchar datatype in Teradata. CR 8879: Target update override statements for Sybase target table with Varchar columns do not find matches When you use a Varchar column in the target update override statement for Sybase target tables, the Informatica Server does not find matches and no update takes place. Workaround: Specify Varchar column type in the update override statement. CR 6250: Designer does not import unique keys and referential constraints The Warehouse Designer does not import unique keys or referential constraints on a unique key. Workarounds: Either change the unique key to a primary key in the database before importing the target definition, or edit the target definition after importing it.

Database and Connectivity CR 21801: ODBC drivers do not pass truncation message to Informatica Server If the source column size in the database is larger than the source column size in the Designer, the Informatica Server may truncate source data without writing messages to the session log. This occurs when you use ODBC sources, and the ODBC drivers do not pass the messages to the Informatica Server. Workaround: Ensure that the source definition in the Designer matches the source definition in the database. CR 17221: Precision in Varchar columns in Sybase targets limited to a maximum of 255 characters If you import an Oracle target with Varchar or Varchar2 columns with a precision greater than 255, you must reduce the precision before converting the target to Sybase. For example, if you convert an Oracle target to a Sybase target in the Warehouse Designer with a column Varchar(2000), and then generate and execute SQL, the Designer displays the following error message:

30

[DataDirect][ODBC Sybase driver][SQL Server] Length or precision specification 2000 is not within the range of 1 to 255.

Workaround: Reduce precision to within Sybase specifications before generating and executing SQL, or convert to another target type that supports a precision greater than 255 for Varchar columns. CR 3581: Money data for Informix read as 0.00 when using high precision To prevent fields with a money datatype as being read as 0.00 when using high precision, you must set the following environment variable for that combination: DBMONEY=' .' (that is, a single quote followed by space character followed by a period followed by single quote). This DBMONEY variable tells Informix to not prefix the data with the dollar sign ($) for money data types. In ksh and sh:

DBMONEY=' .' export DBMONEY

In csh:

setenv DBMONEY=' .' On Windows: Set this environment variable in the profile of the person under whose name the Informatica service is started.

Date Handling CR 2947: Data conversion for flat file targets and error files (Double with scale 0) If a mapping outputs Double data to flat file targets or a session reject file (target_name.bad), the following data conversion rules apply: • For UNIX, the Informatica Server converts Double values to their string representation based on the

IEEE math specification of rounding a 5 up if the previous digit is odd, and rounding down if the previous digit is even. For example, the Informatica Server rounds 0.5 to 0, 1.5 to 2, 2.5 to 2, and so on.

• For Windows, the Informatica Server always rounds up when it converts Double values to their string representation. For example, .5 rounds to 1, 1.5 rounds to 2, 2.5 rounds to 3, and so on.

External Loader CR 44703, 17032: Informatica Server prints external loader user name and password in the control file The Informatica Server does not encrypt the database user name and password in the external loader control file. Workaround: You can configure the Informatica Server to write the external loader control file to a directory separate from the target flat file. You can then configure the permissions on the control file directory to allow access by the user starting the Informatica Server only. To configure the Informatica Server on UNIX to write the external loader control file to a separate directory, add the following entry to pmserver.cfg:

LoaderControlFileDirectory=<directory_name>

If you want to configure the Informatica Server on Windows to write the external loader control file to a separate directory, please contact Informatica Technical Support.

31

CR 38627: In sessions with multiple partitions, Oracle external loaders do not commit all rows when run in replace mode When you run a session with multiple partitions on a Windows system where you use an Oracle external loader connection in replace mode, the loader does not commit all of the rows to the target table. This occurs because replace mode truncates the target table and then inserts the rows. In sessions with multiple partitions, the process for the last partition truncates rows that the previous processes inserted. This problem occurs on Windows systems, but not on UNIX systems. Workaround: Perform the truncate operation as a pre-session SQL command, and configure the Oracle external loader connection in append mode instead of replace mode. CR 5312: External loader does not maintain key relationships when loading External loading does not recognize key constraints when loading target files to relational tables. If you run an external loader session with target tables with key relationships, and the tables are loaded in the wrong order, error messages appear in the external loader log, and rejected data appears in the external loader reject file. Errors encountered by external loaders are not reported in the session log.

External Procedures and Stored Procedures CR 24457, 23923: Sessions with DB2 stored procedures fail if the IN/OUT parameters are defined with Date or Time datatypes When you import DB2 stored procedures with IN/OUT parameters defined with Date or Time datatypes, the Designer imports them as Date/Time datatype. The session fails due to datatype incompatibility. You will see error messages similar to the following in the session log:

TRANSF_1_1_1_1> ODL_26027 DB2 Fatal Error ODL_26027 [FnName: ExecuteSP -- SQLSTATE=42815 [IBM][CLI Driver][DB2/NT] SQL0171N The data type, length or value of argument " 2" of function "GET_TIMESTAMP0" is incorrect. SQLSTATE=42815

Workaround: The DB2 datatype Timestamp is a superset of Date and Time datatypes. In DB2 stored procedures, use the Timestamp datatype to declare Date or Time datatypes for IN/OUT parameters. CR 7730: Advanced External Procedure project files cannot be created in source file directory (Windows servers only) When you use the Designer to generate source files for the External Procedure or Advanced External Procedure transformations, two of the files created are readme.txt and stdafx.h. To build the DLL for use on the Informatica Server on Windows, you need to use Visual Studio to create a project. However, as part of creating a new project, Visual Studio tries to generate the same two files, readme.txt and stdafx.h. If you try to create the project file in the same directory as the source files, Visual Studio displays an error message stating that a project already exists in that directory. Workaround: Create the project file in a different directory from the source files. or Rename the readme.txt file and delete the stdafx.h file before creating the project in Visual Studio. The readme.txt file contains information you might require. The stdafx.h file is a stub file that can be deleted. Visual Studio generates a replacement stdafx.h file when compiling the project.

Flat Files and COBOL CR 7843, 3537: Concatenating data from a Normalizer transformation If you concatenate data from a Normalizer transformation, the ports you concatenate cannot include OCCURS.

32

Informatica Server CR 50742: Informatica Server fails session with an unsorted Aggregator transformation connected to a multigroup target, such as an XML target The Informatica Server fails a session when the mapping contains an unsorted Aggregator transformation connected to a multigroup target, such as an XML target. The Informatica Server writes the following message to the session log:

TM_6203 [ERROR: Session or its instance is not Valid...Need to revalidate in Workflow Manager. [Summary for Aggregator AGGTRANS] Is no longer a repartition point. Was moved across stages. This may effect its partitioning information. Partition type changed from Hash Auto Keys to None.

Workaround: Close the folder and then open it. Validate the session and save it. Run the session again. CR 46365, 46146: The Informatica Server fails to match a lookup value using ROUND(TO_DECIMAL(string)) in a string lookup port expression in low precision mode The upgrade process to PowerCenter 6.1/PowerMart 6.1 replaces TO_INTEGER() with ROUND(TO_DECIMAL()). When you have ROUND(TO_DECIMAL()) in a lookup port with a String datatype, the Informatica Server does not match the port value with a string integer value in the lookup cache or table in low precision mode. For example, suppose you have the following expression in a previous version of PowerCenter or PowerMart:

TO_INTEGER(�5.18�) The upgrade process changes this expression to:

ROUND(TO_DECIMAL(�5.18�)) ROUND(TO_DECIMAL()) returns values as a Double with trailing zeros in low precision mode. Workaround: Manually change expressions in string lookup ports of a Lookup transformations. Change ROUND(TO_DECIMAL()) to TO_INTEGER(). CR 41184: Session hangs if Sybase repository database shuts down and restarts If the Sybase repository database server shuts down unexpectedly during a session run, the session hangs when you restart the Sybase database server. When this happens, abort the session and restart it. CR 38542: Informatica Server does not read rows from Oracle sources when query override contains a question mark (?) When you use a question mark (?) in an SQL override query against Oracle, the Informatica Server does not read the source rows. In PowerCenter/PowerMart, the question mark (?) is a reserved character. Workaround: Create a query using characters other than question marks. CR 28774: Informatica Server cannot read or write Blob datatype columns on IBM DB2 databases on AS/400 The Informatica Server cannot read from or write to Blob datatype columns for IBM DB2 databases installed on AS/400 machines.

33

CR 20729: Informatica Server truncates data greater than 2,000 characters When you import a column with more than 2,000 characters from relational source or target, the Designer sets the column size to 2,000. When you run a session, the Informatica Server might load truncated data or generate an overflow error. This behavior occurs when you import Microsoft SQL Server Text, Sybase Text, Informix Text, Oracle Long, or DB2 LongVarchar columns. Workaround: To ensure that the Informatica Server loads all the data in columns with more than 2,000 characters, manually increase the column size for the source and target definitions in Designer. CR 19751: Error occurs when you send post-session email notifications using Outlook 2000 When you configure a session to send an email notification, the Informatica Server encounters an Extended Mapi Error and does not send the email. This occurs only when Informatica Server is installed on Windows 2000.

Workaround: Stop the Informatica Server. Copy the file mapi32.dll from winnt\system32 to the bin directory where the Informatica Server is installed, overwriting the existing mapi32.dll in that directory. Restart the Informatica Server so that the Informatica Server can use the new mapi32.dll. CR 17128: Session may fail when sourcing very large indirect files If you run a session using a very large indirect file list (greater than 500 MB), depending on the memory size of the machine server, the session may fail. CR 16601: Update Else Insert fails when source and target columns have different widths If you run a session with the target option Update Else Insert selected, one or more source Char(n) columns are compared to one or more target Varchar2(m) columns without blank padding, the session fails and the Informatica Server issues a unique constraint violation to the session log. Since the source and target columns are a different width, the columns do not match exactly and the update fails. When the update fails, the Informatica Server attempts to insert into the target column. Since the record already exists in the target column, the insert fails and the Informatica Server issues the constraint violation error. Workaround: In the Designer, use the RPAD function in the WHERE clause of the target update override. By including an RPAD function in the WHERE clause, the Informatica Server can allow for extra spaces to the right when comparing the char source field to the varchar2 target field. For details on using the WHERE clause or the target update override, see �Mappings� in the Designer Guide. CR 12074: PowerCenter does not correctly detect newline or linefeed characters with IBM930 codepage Compared to previous versions of Global C, the IBM930 locale file in Global C versions 3.1 and later reversed the byte values for newline and linefeed characters. Effective with PowerCenter 5.0 and PowerMart 5.0, the Informatica Server uses the Global C 3.0 locale file with the IBM930 (Japanese EBCDIC) code page. As a result, the Informatica Server may not detect newline characters properly if your data is encoded according to the Global C 3.1 format. To determine the format of your data, refer to the following table: Global C 3.0 Global C 3.1 byte value byte value newline (Unicode U+0085) 0x25 0x15 linefeed (Unicode U+000A) 0x15 0x25 Workaround: The Informatica Server includes three locale files for the IBM930 code page in the

34

Informatica Server \bin\locale directory: • cp_0930.nls. The locale file currently in use. By default, the Informatica Server uses the Global C 3.0

version of this file. • cp_0930.nls.1. The Global C 3.0 version of the IBM930 locale file. • cp_0930.nls.2. The Global C 3.1 version of the IBM930 locale file. If your data is encoded according to the Global C 3.1 format, rename cp_0930.nls.2 to cp_0930.nls. CR 11196: Informatica Server generates a Dr. Watson error when you run a test load for a session that has multiple Redefines in the Normalizer transformation If you are working with multibyte data and run a test load session that has multiple Redefines in the Normalizer transformation, the Informatica Server generates a Dr. Watson error. CR 10584: On a Japanese operating system, a session hangs when the Informatica Server code page and the database client code page are not identical When you load data from a Shift-JIS source into an EUC or UTF8 relational target database, the session hangs. This is because the database client code page used by the Informatica Server and the database connection code page are not identical. Workaround: Make sure the database client and database connection code pages are identical. Then run the session again. CR 10246: Server variables on Windows are not accessible when variable assignment contains spaces A server variable on Windows causes an error during pre-session or post-session shell command execution if the variable is assigned to a directory name or path containing spaces. For example, when the server variable $PMRootDir is assigned with the value c:\temp temp, the command referencing this variable fails. Workaround: When assigning values to server variables, which are referenced in pre-session or post-session shell commands, make sure the directory names or paths do not contain spaces. CR 10151: Informatica Server always performs case-sensitive string comparisons in the Joiner transformation The Informatica Server always performs case-sensitive string comparisons in the Joiner transformation. The Case Sensitive String Comparison Joiner transformation option is checked by default. If you clear this option, the Informatica Server still performs case-sensitive string comparisons. Workaround: If you want the Informatica Server to perform case-insensitive string comparisons in the Joiner transformation, use an Expression transformation to convert data to the same case before passing data to Joiner transformation. CR 8864: Sessions complete when targets do not exist When you run a session that writes to a target table on Microsoft SQL Server, Sybase, or Oracle the Informatica Server may complete the session even if the target table does not exist. In this case, the Informatica Server writes an error in the session log for each row of data that belongs to the non-existent table and writes each row into the reject file. CR 4649: Non-printable ASCII characters handling If a fixed-width flat file contains non-printable ASCII characters, the Informatica Server can read and propagate those characters through the session. However, if the file contains ASCII NULLs, you may get unexpected results. In addition, the Flat File Wizard does not display non-printable ASCII characters.

35

Installation CR 34887: Repository Agent process on HP-UX does not start when connecting to repository database through Oracle 9i client The Repository Agent process on an HP-UX system does not start when it connects to an Oracle repository database through Oracle 9i client connectivity software. Workaround: Add $ORACLE_HOME/lib32 to the SHLIB_PATH shared library environment variable. CR 9218: Access denied to start Informatica Service on Windows If you install the Informatica Server in a directory with a long path, you may get the following message from Microsoft in the Event Viewer:

Error 0005: Access is Denied Workaround: Uninstall PowerCenter/PowerMart and reinstall in a shorter path.

Metadata Reporter CR 35494: Metadata Reporter cannot connect to Sybase Repository using jConnect JDBC drivers The Metadata Reporter cannot connect to the repository using Sybase jConnect JDBC driver version 5.x. The Metadata Reporter returns the following message when you run the test option from the XMXConfigServlet:

Connecting to the repository Sybase_C63125 Repository Charset:ISO-8859-1 Status:Connection failed with the following error: java.sql.SQLException: JZ0I5: An unrecognized CHARSET property was specified: ISO-8859-1.

The Metadata reporter uses a Unicode CHARSET and Sybase jConnect JDBC drivers do not support Unicode. Workaround: Specify the following parameter on the JDBC URL:

CHARSET_CONVERTER_CLASS=com.sybase.jdbc2.utils.TruncationConverter CR 29700: XMXProperties file created on the root directory When you configure the Metadata Reporter by running XMXConfigServlet, the file containing properties for the Metadata Reporter, XMXProperties, is created in the bin or root directory rather than within the imr directory. Workaround: Modify the web.xml file to use the configFile parameter. Modify the web.xml file located in the WEB-INF directory of the Metadata Reporter installation. Add the following sections to the web.xml file where imr_root represents the location of the imr directory:

<servlet> <servlet-name>XMXConfigServlet</servlet-name> <servlet-class>XMXConfigServlet</servlet-class> <init-param> <param-name>configFile</param-name> <param-value>/home/imr_root/XMXProperties.xml</param-value> </init-param> </servlet> <servlet>

36

<servlet-name>XMXServlet</servlet-name> <servlet-class>XMXServlet</servlet-class> <init-param> <param-name>configFile</param-name> <param-value>/home/imr_root/XMXProperties.xml</param-value> </init-param> </servlet>

If you are using IBM WebSphere Application Server with the Metadata Reporter, you must modify the imr directory files and create an imr.ear file. IBM WebSphere Application Server requires an .ear format for deployment. To create the imr.ear file, complete the following steps: 1. Install the Metadata Reporter directory files to a temporary location. For example, install the Metadata Reporter in the following directory:

C:\temp\imr 2. Verify that you install the Metadata Reporter directory files rather than the imr.ear file. This allows you access to the files you need to modify. 3. Verify that you installed Java Runtime Environment version 1.3.1 or higher. 4. Modify the web.xml file as described in the workaround above. 5. From the command line, switch to the temporary directory where you installed the Metadata Reporter, and enter the following command to create an imr.war file:

jar cf imr.war �C imr 6. Create a temporary ear subdirectory and copy the imr.war file to this directory. For example, create the following path:

C:\temp\ear\imr.war

7. Create a META-INF subdirectory under the ear directory. For example, create the following path:

C:\temp\ear\META-INF

8. Within the META-INF directory, create an application.xml files with the following contents:

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE application PUBLIC "-//Sun Microsystems, Inc.//DTD J2EE Application 1.2//EN" "http://java.sun.com/j2ee/dtds/application_1_2.dtd"> <application> <display-name>Informatica Metadata Reporter</display-name> <description>Informatica Metadata Reporter</description> <module> <web> <web-uri>imr.war</web-uri> <context-root>/imr</context-root> </web> </module> </application>

9. From the command line, go to the parent directory of the war file you copied. For example, if you copied the war file into the temp directory, enter the following path:

C:\temp\

37

10. Enter the following command:

jar cf imr.ear �C ear

An imr.ear file displays in the temporary directory: 11. Install the imr.ear file into the applications directory of the IBM WebSphere Application Server following the Metadata Reporter installation instructions provided in the Supplemental Guide. CR 24815, 17472: Reports in Metadata Reporter for Informix repositories do not display properly The Metadata Reporter displays some reports incorrectly for Informix repositories: • In the Source Schema Report and the Target Schema Report, the Description column always displays

�N/A�. • In the Transformation Report, the Comments column for the transformation always displays �N/A�.

The Comments column for each port in the transformation displays correctly. • In the Mapping Report, the Comments column for the mapping and for each object in the mapping

always displays �N/A�. • In the Mapplet Report, the Comments column for the mapplet always displays �N/A�. The Comments

column for each port in the mapplet displays correctly. • The Source to Target Dependency Report does not display correctly for Informix repositories. CR 12069: Global shortcuts not available for some reports in Metadata Reporter The Metadata Reporter does not display global shortcuts for the following reports: • Source to Target Dependency Report • Lookup Table Dependency Report

Partitioning CR 17163: Informatica Server fails partitioned sessions with a Microsoft SQL Server source if the partition key is of datatype Smallint If you use partition keys of Smallint or Money datatype with a Microsoft SQL Server source, the Informatica Server fails the session. Workaround: In the partition properties, instead of using a key range to select data, use an SQL query. CR 13914: Additional disk space required to realign incremental aggregation files If you change the partitioning after you run an incremental aggregation session, the Informatica Server realigns the aggregate files the next time you run the session. The Informatica Server requires disk space at least twice the size of the original cache files to realign the files. CR 12581: Associated sources do not display with partitioning keys When you partition a Source Qualifier with an associated source that is not connected to the Source Qualifier, you cannot create partition keys on the associated source. The Keys for Partition dialog box does not display the associated source. Workaround: Connect the associated source to the Source Qualifier transformation, and you can create partition keys on that source in the session properties. You do not need to connect the output ports in the Source Qualifier transformation to another transformation.

38

Repository Agent and Repository Server CR 50262: Repository database password exposed during Bulkrestore operation When you restore a Teradata repository using pmrepagent Bulkrestore, the Repository Agent creates a control file that contains the unencrypted repository database password. Workaround: To maintain repository security, delete the fastload.ctl file after the Bulkrestore operation completes. You can locate the fastload.ctl file in the directory where you install the Repository Server. CR 49383: Repository Server will not start on UNIX The Repository Server on UNIX does not start if the soft limit for the number of files a process can have open simultaneously is greater than the hard limit. Workaround: Configure the hard limit for the number of files a process can have open simultaneously to a value greater than or equal to the soft limit. Informatica also recommends configuring the maximum number of semaphores per ID to a value greater than both limits. Configure the following kernel parameters with the specified values: • Maxfiles. The soft limit for the number of files a process can have open simultaneously. Configure this

parameter for 1024 files. • Maxfiles_lim. The hard limit for the number of files a process can have open simultaneously. The hard

limit should be greater than or equal to the value specified for maxfiles. Configure this parameter for 1024 files.

• Semmsl. The maximum number of semaphores per ID. You can configure this parameter in /usr/include/sys/sem.h. Configure this parameter for 2048 semaphores.

CR 46331: Repository Agent process cannot restore lost connection to repository database If the repository database server stops unexpectedly while the Repository Agent process is running and connected to it, the Repository Agent process may not restore the repository database connection after you restart the database server. Workaround: Shut down the Repository Agent process by stopping the repository, and then start the repository to restart the Repository Agent process and reestablish the connection to the repository database. CR 44575: Deadlocks may occur when using Teradata for repository database You may experience deadlocks when running queries or updating metadata on a Teradata repository database. Any database access, such as queries or updates, can cause deadlock. When deadlock occurs, the Repository Agent posts an error message to the Repository Agent log similar to the following message:

ERROR : OBJM_54543 [Tue Sep 17 16:48:42 2002] : (11203|130) DataBase error: FnName: Execute -- [NCR][ODBC Teradata][Teradata RDBMS] Transaction ABORTed due to deadlock.

When deadlocks occur, the client accessing the repository may hang. Typically, the Repository Agent continues to serve other clients. Workaround: Retry the operation. If your client hangs, stop and restart the client. CR 44084: Repository Server may run slowly when performing restore or copy operations on Teradata repository database The Repository Server may run slowly when restoring a repository backup to a Teradata database or when copying a repository to a Teradata database. Workaround: Use the Repository Manager to truncate the workflow logs in the repository before backing up or copying the repository.

39

CR 41325, 41047: Repository Agent process might stop responding during repository startup or shutdown on slower databases If you are running a repository on a slow database, the Repository Agent process might stop responding when you start or shut down the repository. If you shut down the Repository Server, you may not be able to restart it. Workaround: To restart the Repository Server, you must restart the Repository Server system.

Workflow Monitor CR 51913: Workflow Monitor hangs when it reads a session log greater than 1 GB When you use the Workflow Monitor to open a session log greater than 1 GB, the Workflow Monitor hangs. Workaround: Open the session log from a text editor.

XML CR 17278: Japanese XML targets cannot use user-defined code pages For Japanese XML targets, you can use only the following code pages: • JapanEUC (Japanese Extended UNIX Code, incl. JIS X 0212) • MS932 (Microsoft Windows Japanese, superset of Shift JIS) You cannot use user-defined code pages such as the following: • JEF (Japanese EBCDIC Fujitsu) • JIPSE (NEC ACOS JIPSE Japanese) • KEIS (Hitachi KEIS Japanese) • MELCOM (Mitsubishi MELCOM Japanese) • UNISYS (UNISYS Japanese) In a session, if you select a Japanese user-defined code page for an XML target, the Informatica Server ignores the code page. It writes a blank character encoding tag in the XML target file, as in the following example:

<?xml version=�1.0� encoding=��?> Since the encoding tag is required in an XML file, the target file is an invalid XML file.

Installation

PowerCenter/PowerMart Platform Components Use the Informatica Platform Products Setup program to install PowerCenter 6.2 and PowerMart 6.2 components When you install Informatica PowerCenter 6.2/PowerMart 6.2 components, Informatica recommends you use the Informatica Platform Products setup.exe program located in the \pc directory on the PowerCenter/PowerMart installation CD. You might get unexpected results if you install a platform component using the setup program in the component subdirectory on the installation CD.

40

Client Displaying Help Files To properly display the online help files on a non-U.S. English operating system, change the system locale settings to U.S. English before installing the Informatica Server. To change the system locale, set the Locale setting on the General tab of the Windows Regional Options control panel to English (United States). After installation, you can change the Locale to the previous setting.

Informatica Server Working with Null Values in Boolean Expressions In the Designer and Workflow Manager, you may pass a null value to an expression that contains logical operators. Effective with version 6.1, in expressions that contain the logical AND operator, combining a null value with a Boolean expression produces the following results: • NULL AND TRUE = NULL. This expression no longer returns FALSE. • NULL AND FALSE = FALSE. This expression no longer returns NULL. Note: If you want to configure the Informatica Server to use PowerCenter 6.0 and PowerMart 6.0 functionality when it evaluates null values in comparison operations, contact Informatica Technical Support. Displaying Help Files To properly display the online help files on a non-U.S. English operating system, change the system locale settings to U.S. English before installing the Informatica Server. To change the system locale, set the Locale setting on the General tab of the Windows Regional Options control panel to English (United States). After installation, you can change the Locale to the previous setting. Installing the Informatica Server on HP-UX If you want to run the Informatica Server on HP-UX, install HP patch PHSS_24303. Installing the Informatica Server on Solaris If you want to run the Informatica Server on Solaris 2.6, install patches 107733 and 105591. If you want to run the Informatica Server on Solaris 2.7, install patches 106950 and 106327. Installing the Informatica Server on Windows • The name of the server in the Windows Services dialog box is called Informatica. • Before you install or upgrade the server, make sure you have a list of all the database platform keys the

Informatica Server needs to access each source, target, and repository database. • You must set the short date format to MM/DD/YYYY on Windows. To verify this, select Start-Settings-

Control Panel, double-click the Regional Settings icon, and then click the Date tab. Setting Windows to boot the database before the Informatica Server For Informatica Servers installed on Windows, you can configure the system to start the database server before the Informatica Server during system boot. To do so, create a value DependOnService in the registry to define the services or groups of services on which the PowerMart service depends. The value should be of datatype REG_MULTI_SZ. To change the registry setting on Windows, contact Informatica Technical Support.

Repository Server Displaying Help Files To properly display the online help files on a non-U.S. English operating system, change the system locale settings to U.S. English before installing the Informatica Server. To change the system locale, set the

41

Locale setting on the General tab of the Windows Regional Options control panel to English (United States). After installation, you can change the Locale to the previous setting. Installing the Repository Server on UNIX To ensure the Repository Server correctly starts on UNIX, configure the following kernel parameters with the specified values: • Maxfiles. The soft limit for the number of files a process can have open simultaneously. Configure this

parameter for 1024 files. • Maxfiles_lim. The hard limit for the number of files a process can have open simultaneously. This

hard limit should be greater than or equal to the value specified for maxfiles. Configure this parameter for 1024 files.

• Semmsl. The maximum number of semaphores per ID. You can configure this parameter in /usr/include/sys/sem.h. Configure this parameter for 2048 semaphores.

Installing the Repository Server on HP-UX If you want to run the Repository Server on HP-UX, install HP patch PHSS_24303. Installing the Repository Server on Solaris If you want to run the Repository Server on Solaris 2.6, install patches 107733 and 105591. If you want to run the Repository Server on Solaris 2.7, install patches 106950 and 106327. Installing the Repository Server on Windows • The name of the server in the Windows Services dialog box is called Informatica Repository Server. • Before you install or upgrade the server, make sure you have a list of all the database platform keys the

Informatica Server needs to access each source, target, and repository database. • You must set the short date format to MM/DD/YYYY on Windows. To verify this, select Start-Settings-

Control Panel, double-click the Regional Settings icon, and then click the Date tab.

Database Connectivity Informatica Server guarantees 14 digits of precision when reading numeric values from Microsoft SQL Server To communicate with Microsoft SQL Server databases, the Informatica Server requires the Microsoft OLE DB Provider for SQL Server instead of the older DBLIB driver. These two drivers round numeric values differently. The DBLIB driver guaranteed 15 digits of precision for numeric values. The OLE DB driver guarantees 14 digits of precision for numeric values and rounds the 15th digit based on the following criteria: • If the 16th digit is greater than or equal to five, the Informatica Server rounds the 15th digit up. • If the 16th digit is less than five, the Informatica Server rounds the 15th digit down. Empty strings are no longer treated as null values in Microsoft SQL Server To communicate with Microsoft SQL Server databases, the Informatica Server requires the Microsoft OLE DB Provider for SQL Server instead of the older DBLIB driver. These two drivers handle empty strings differently. The DBLIB driver treated empty strings as null values in Microsoft SQL Server databases. The OLE DB driver treats empty strings as empty strings, not as null values. Native drivers recommended When possible, use native drivers rather than ODBC drivers. Informix transaction logging If an Informix database is used for either a repository or a target, it is important that transaction logging is enabled to avoid data inconsistencies. Enable transaction logging for each repository database. Perform a level-0 archive using ontape. The syntax is:

ontape -s -B <dbname>

42

This command performs the archive and turns buffered logging on at the same time. Microsoft SQL Server Service Pack If you use Microsoft SQL Server 7.0, you must install the Microsoft SQL Server 7.0 client and the Microsoft SQL Server Service Pack 1 or above on each client, server, and repository machine. If you do not install SQL Server Service Pack 1 or above, you can cause repository inconsistencies.

Upgrading Unlock all Repository Objects Before upgrading to PowerCenter 6.2 or PowerMart 6.2, make sure no sessions, workflows, or batches are running on the Informatica Server and no users are connected to the repository, then unlock all repository objects. Repository Upgrade Duration If you are upgrading from PowerCenter 5.0/5.1/6.0 or PowerMart 5.0/5.1/6.0, the upgrade process must fetch, examine, and modify a large number of objects in the repository in order to make existing expressions compatible with updates to the transformation language. Also, if you are upgrading from PowerCenter 5.0/5.1 or PowerMart 5.0/5.1, the upgrade process must fetch each session and batch and upgrade it to the workflow model. Depending on the size of your repository, these processes can take significant time to complete. During the upgrade process, you can monitor the progression of incremental changes to the repository in the Activity Log. The Activity Log window refreshes periodically during the upgrade process. Beta Repositories Repositories created with a Beta release should not be used after the completion of the program. You should use the final release to create new repositories. Do not continue to use Beta repositories in either production or development. CR 39802: Upgrade process does not upgrade server names When you upgrade from a version prior to PowerCenter 6.0/PowerMart 6.0, the upgrade process does not upgrade the Informatica Server name if it contains one of the following characters:

! @ # $ % ^ & ( ) { } [ ] < > , ? | \ " ; : ~ ' * / - <space> After you upgrade, you must edit the Informatica Server name in the Workflow Manager to remove the special characters.

Documentation Addenda The following section contains additional information not included in the printed version of the PowerCenter and PowerMart manuals, versions 6.0, 6.1, and 6.2. This section also contains information about new features or changes in functionality introduced in PowerCenter/PowerMart versions 6.1 and 6.2 that is not included in the printed version of the manuals.

All Manuals Copyright Page Additional information for the copyright page of each PowerCenter 6.0 and PowerMart 6.0 manual: Informatica PowerCenter products contain ACE (TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University and University of California, Irvine, Copyright (c) 1993-2002, all rights reserved.

43

Designer Guide Chapter 4: Working with Flat Files (Defining Default Datetime and Numeric Formats) The following text adds to the information for defining default datetime and numeric formats. When you edit flat file source definitions in the Source Analyzer and flat file target definitions in the Warehouse Designer, you can define formats for datetime values. Use the Datetime Format field on the Properties tab to define formats for datetime values. Chapter 5: XML Concepts (Metadata from XML, DTD, and XML Schema Files) The following text adds to the information on creating metadata for source and target definitions from XML, DTD, or XML schema files. Note: If you have problems importing an .xsd file, you can create metadata for source or target definitions by creating an XML file that fully represents and conforms to the .xsd file. After you create the sample XML file, you can import it into the Designer. Chapter 6: Working with XML Sources (Importing an XML Source Definition) The following text adds to the information on importing an XML source definition. Note: If you import circular references in an XML file, verify that you do not specify a circular reference count lower than the number of circular references in the source file. If you specify a lower count, you may lose data. Appendix A: Datatype Reference (Comparing Native and Transformation Datatypes) The following text replaces the information on XML binary datatype support: Table A-15. XML and Transformation Datatypes Datatype Transformation Range binary Text 1 to 65,535 characters

Installation and Configuration Guide Chapter 4: Installing and Configuring the Informatica Client (Step 1. Installing ODBC Drivers) The PowerCenter 6.2/PowerMart 6.2 ODBC installation program no longer installs Merant 3.7 closed ODBC drivers. It now installs DataDirect 4.1 closed ODBC drivers. Chapter 5: Installing and Configuring the Windows Repository Server (Installing the Repository Server) The following text provides additional information for the Repository Server installation instructions on page 82: If you want to reinstall the Repository Server, you must shut down the existing Repository Server service before you run the Repository Server installation program. Chapter 6: Installing and Configuring the UNIX Repository Server (Installing the Repository Server) The following text provides additional information for the Repository Server installation instructions on page 101: If you want to reinstall the Repository Server, you must shut down the existing Repository Server before you run the Repository Server installation program.

44

Chapter 6: Installing and Configuring the UNIX Repository Server (Step 2. Configuring the Repository Server on UNIX) Repository Server configuration parameters are case insensitive. Chapter 9: Installing and Configuring the Informatica UNIX Server (Step 2. Configuring the Informatica Server on UNIX) Informatica Server configuration parameters are case insensitive.

Metadata Reporter Guide Chapter 3: Installing on WebLogic Under UNIX (Step 2. Configuring the WebLogic Server) The following text replaces steps 4-7 for configuring the BEA WebLogic 6.1 installation to work with the Metadata Reporter. 4. Copy the database drivers associated with your PowerCenter/PowerMart repository into the library directory of the server hosting Metadata Reporter. The directory below shows the default location of the WebLogic library directory.

/<WebLogic_installation_path>/wlserver6.1

5. Locate the startWebLogic.sh file, and open the file for editing. The following path shows the location of the startWebLogic.sh file when you choose default settings during the WebLogic installation.

/<WebLogic_installation_path>/wlserver6.1/config/mydomain

6. Modify the classpath to include the .jar file and the JDBC drivers you copied into the WebLogic library directory. Place the .jar file at the beginning of the classpath. The following classpath shows the .jar file and the JDBC drivers:

CLASSPATH==.;./lib/CR064391_rel610sp2.jar;./lib/j2ee12.jar;./ lib/weblogic_sp.jar;./lib/weblogic.jar;./$WL_HOME:$WL_HOME/lib/weblogic_sp.jar:$WL_HOME/lib/weblogic.jar:$WL_HOME/lib/db2java.zip:$WL_HOME/lib/runtime.zip:$WL_HOME/lib/classes111.zip:$WL_HOME/lib/nls_charset11.zip:$WL_HOME/lib/ifxjdbc.jar:$WL_HOME/lib/ifxjdbc-g.jar:$WL_HOME/lib/jconn2.jar:

7. Save changes to the WebLogic.sh file. Chapter 4: Configuring the Metadata Reporter (Configuring Locations Settings) The following text adds to the information on specifying the URL for the Metadata Reporter document directory: 1. To start the Metadata Reporter setup, open the following URL in your web browser:

http://<host_name>:<webserver_port>/imr/XMXConfigServlet 2. In the Locations section, specify the URL for the Metadata Reporter document directory.

You can enter the Metadata Reporter document directory URL either as a full URL that includes the web server address or as a relative URL. Informatica recommends that you use the relative URL.

Make sure that the full or relative URL ends in a forward slash (�/).

• Full URL. Enter the web server address and the Metadata Reporter document directory using the

following syntax:

45

http://<host_name>:<webserver_port>/imr/ • Relative URL. Enter the Metadata Reporter document directory relative to the web server address:

/imr/ Chapter 6: Understanding the Report Details (Metadata Extensions Report) The Metadata Extensions Report provides information about metadata extensions associated with the objects in your repository. Informatica allows end users and partners to extend the metadata stored in the repository by associating information with individual objects in the repository. The Metadata Extensions Report contains the following sections: • Metadata Extension Domains. Lists and describes the metadata extension domains in the repository.

You can drill down on any domain to see the extensions defined for the domain. You can also view the extension�s values and where it is used in the repository.

• Target Extensions. Provides the metadata extension information associated with the target. • Transformation Extensions. Provides the metadata extension information associated with

transformations and mapplets. • Source Extensions. Provides the metadata extension information associated with the source. • Mapping Extensions. Provides the metadata extension information associated with the mapping. • Session/Workflow Extensions. Provides the metadata extension information associated with the

session, workflow, or worklet. Chapter 6: Understanding the Report Details The following text adds to the information on understanding report details in the Metadata Reporter: Custom Job Report. You can filter workflows by specifying start time and end time parameters in the custom Job Report. The report displays workflows run between the specified start and end time. Access the custom Job Report from the custom report menu. To run the custom Job Report, enter a start time and end time using the following format: YYYY-MM-DD HH:MM:SS. You must enter a start time that is prior to the start time for the workflows you want to display. For example, if you want to display workflows that ran starting on 2002-09-18 15:33:47, enter the following start time: 2002-09-18 15:33:46. You must enter an end time that is after the end time for the workflows you want to display. For example, if you want to display workflows that ran ending on 2002-09-18 15:33:47, enter the following end time: 2002-09-18 15:33:48.

Repository Guide Chapter 9: Using Metadata Exchange (MX) Views (MX Views Field-Level Summary) The following text adds to the field-level summaries of REP_SESS_LOG and REP_SESS_TBL_LOG. The following field definitions modify the summary of REP_SESS_LOG: Column Name Datatype Description SUCCESSFUL_ROWS NUMBER Number of successfully loaded target rows. FAILED_ROWS NUMBER Number of failed target rows. SUCCESSFUL_SOURCE_ROWS NUMBER Number of successfully read source rows. FAILED_SOURCE_ROWS NUMBER Number of failed source rows.

46

The following field definitions modify the summary of REP_SESS_TBL_LOG: Column Name Datatype Description SUCCESSFUL_ROWS NUMBER Number of successfully loaded target rows. SUCCESSFUL_AFFECTED_ROWS NUMBER Number of affected target rows. Chapter 10: Using pmrep (Specifying Options and Arguments) The following text replaces information about enclosing pmrep arguments in quotes: If any argument for an option or command contains more than one word, you must enclose the argument in double quotes. pmrep does not recognize back quotes. pmrep ignores quotes that do not enclose an argument. Chapter 10: Using pmrep (pmrep Repository Commands) The following text adds to the information about replacing connections using the Switchconnection command: To replace connections with pmrep, you must have Super User privilege. When you use Switchconnection, the Repository Server replaces the relational database connections for all sessions using the connection in one of the following locations: • Source connection • Target connection • Location Information property in Lookup transformations • Connection Information property in Stored Procedure transformations • $Source Connection Value session property • $Target Connection Value session property If the repository contains both relational and application connections with the same name, the Repository Server only replaces the relational connection when you specified the connection type as relational in all locations in the repository. For example, you have a relational and an application source, each called ITEMS. In a session, you specified the name ITEMS for a relational source connection instead of Relational:ITEMS. When you use Switchconnection to replace the relational connection ITEMS with another relational connection, pmrep does not replace any relational connection in the repository because it cannot determine the connection type for the source connection entered as ITEMS.

Supplemental Guide Chapter 2: Installing and Configuring PowerCenter and PowerMart The following text adds to information in Configuring the Informatica Server on UNIX: If you run a session configured to connect to both an ODBC and a Teradata source or target, you must specify the Teradata libraries after the ODBC libraries in the shared library environment variable. Chapter 7: Working with Teradata (Configuring Teradata Connectivity) The following text adds to information in Step 4 of the procedure for connecting the Informatica Server on UNIX to Teradata databases: If you also want to configure Informatica Server to read from ODBC sources or write to ODBC targets, specify the Teradata libraries after the ODBC libraries in the shared library environment variable.

47

Chapter 20: Error Messages The following text adds to error messages. Some of the following messages appear at the command line when you use pmrep and some appear in the session log when you run a session:

Please specify folder version in the valid format (e.g. 1.2.3).

Cause: In the pmrep Updateseqgenvals command or Listobjects command, you entered an invalid format for the folder version argument.

Action: Specify the folder version in the correct format. For example, you could specify version 1.0.0.

Failed to find sequence <Sequence Generator transformation name>.

Cause: The Sequence Generator transformation specified in the pmrep Updateseqgenvals command does not exist. Or, you specified a shortcut to a Sequence Generator transformation.

Action: When you use Updateseqgenvals, verify you specify a Sequence Generator transformation that exists in the specified mapping, folder, and folder version. Also, do not specify a shortcut to a Sequence Generator transformation.

Failed to find mapping <mapping name>.

Cause: The mapping specified in the pmrep Updateseqgenvals command does not exist. Or, you specified a shortcut to a mapping.

Action: When you use Updateseqgenvals, verify you specify a mapping that exists in the specified folder and folder version. Also, do not specify a shortcut to a mapping.

Failed to update sequence <Sequence Generator transformation name>.

Cause: pmrep failed to update the sequence values for the Sequence Generator transformation specified in the Updateseqgenvals command.

Action: View the other error messages to find the cause of the error.

Please specify a reusable or non-reusable sequence. Do not specify an instance of a reusable sequence.

Cause: In the pmrep Updateseqgenvals command, you entered an instance of a reusable Sequence Generator transformation.

Action: Specify a reusable Sequence Generator transformation or a non-reusable Sequence Generator transformation. You cannot update an instance of a reusable Sequence Generator transformation.

48

The specified object type <object type> is not recognized by listobjects.

Cause: In the pmrep Listobjects command, you entered an invalid value for the object type argument.

Action: Specify a valid object type in the Listobjects command. You can specify folder, transformation, or session.

The specified transformation type <transformation type> is not recognized by listobjects.

Cause: In the pmrep Listobjects command, you entered an invalid value for the transformation type argument.

Action: Specify a valid transformation type in the Listobjects command. For a list of transformation types, see �Using pmrep and pmrepagent Commands� in the Supplemental Guide.

The object type <object type> requires some options to be specified but they are missing.

Cause: In the pmrep Listobjects command, you did not specify some required arguments.

Action: Enter all required arguments for the specified object type in the Listobjects command. For a list of required arguments, see �Using pmrep and pmrepagent Commands� in the Supplemental Guide.

Failed to list the objects requested.

Cause: pmrep failed to list the objects specified in Listobjects.

Action: View the other error messages to find the cause of the error.

The specified table type <table type> is not recognized by listtablesbysess.

Cause: In the pmrep Listtablesbysess command, you entered an invalid value for the table type argument.

Action: Specify source to list sources, or specify target to list targets.

CMN_1769 Inconsistent recovery cache.

Cause: The Informatica Server cannot run the session enabled for recovery because the recovery cache file does not contain valid data.

Action: Delete all recovery cache files associated with the session and run the session normally to create a new cache file. To determine which recovery cache file is associated with the session, compare the time at which the file was last modified with the time the session failed. If the times are the approximately the same, you can associate the cache file with the session.

You can also refer to the cache file names to determine which files are associated with the session. Recovery cache file names use the following format: pmgmd_metadata_<repository ID>_<workflow ID>_<folder ID>_<session ID>_<transformation ID>_<partition ID>_<group ID>_<checkpoint ID>_<sequence number>.dat

49

For example, in the following file name, the session ID is 102: pmgmd_metadata_7661f424_379f_11d7_947e_f63b53abfef7_103_2_102_0_0_0_1_1.dat

Use the REP_LOAD_SESSIONS MX View on the repository database to determine the name of the session associated with the session ID. You can use REP_LOAD_SESSIONS to view information about reusable sessions.

ODL_26071 Graphic/vargraphic partition key types are supported only on servers with UNICODE data movement enabled.

Cause: You ran a session using database partitioning on an Informatica Server running in ASCII mode and the IBM DB2 target table uses a partitioning key with either a Graphic or Vargraphic column.

Action: Run the session on an Informatica Server in Unicode mode.

TM_6326 Connection <connection name> is an invalid database partition connection type.

Cause: The Informatica Server failed the session because it cannot load to the target type using database partitioning.

Action: Use pass-through partitioning for targets that do not support database partitioning.

Transformation Guide Chapter 4: External Procedure Transformation (Developing Informatica External Procedures) The following text adds to information about the runtime location when developing Informatica-style external procedures: You must copy all DLLs or shared libraries to the runtime location or to the environment variable defined on the Informatica Server machine. The Informatica Server fails to load the external procedure when it cannot locate the DLL, shared library, or a reference file.

Transformation Language Reference Chapter 6: Functions (SQRT, INSTR, and SUBSTR) The following text replaces text in the SQRT(), INSTR() and SUBSTR() sections of the chapter: SQRT() The following text replaces the description of SQRT(). SQRT() returns the square root of a non-negative numeric value. INSTR() The following text replaces the example using nested INSTR() functions in SUBSTR(). The following expression strips out the character �#� from a string:

SUBSTR( CUST_ID, 1, INSTR(CUST_ID, �#�)-1 ) || SUBSTR( CUST_ID, INSTR(CUST_ID, �#�)+1 )

SUBSTR() The following text replaces the example using nested INSTR() functions in SUBSTR().

50

The following expression strips out the character �#� from a string:

SUBSTR( CUST_ID, 1, INSTR(CUST_ID, �#�)-1 ) || SUBSTR( CUST_ID, INSTR(CUST_ID, �#�)+1 )

Troubleshooting Guide For updated troubleshooting messages, please refer to �Error Messages� in the PowerCenter 6.2/PowerMart 6.2 Supplemental Guide. Chapter 11: ES Messages All ES code messages are now RS code messages. Chapter 20: REP Messages The following information replaces the text for REP_12328: REP_12328 The repository at this location does not have the same name.

Cause: Either the database connection or the repository name entered is incorrect.

Action: The status bar displays the correct repository name. Correct the inaccurate information. or

Cause: You tried to connect to a repository on the network, but there was a network failure during the connect process.

Action: Verify that the Informatica Client and the repository are connected to the network. When you connect to the repository again, enter the host name and port number of the repository in the Connect to Repository dialog box.

Workflow Administration Guide Chapter 2: Configuring the Workflow Manager (Replacing a Relational Database Connection) The following text adds to the information about replacing relational database connections in the Workflow Manager: To replace connections in the Workflow Manager, you must have Super User privilege. When you replace database connections, the Workflow Manager replaces the relational database connections in the following locations for all sessions using the connection: • Source connection • Target connection • Location Information property in Lookup transformations • Connection Information property in Stored Procedure transformations • $Source Connection Value session property • $Target Connection Value session property If the repository contains both relational and application connections with the same name, the Workflow Manager only replaces the relational connection when you specified the connection type as relational in all locations in the repository.

51

For example, you have a relational and an application source, each called ITEMS. In one session, you specified the name ITEMS for a source connection instead of Relational:ITEMS. When you replace the relational connection ITEMS with another relational connection, the Workflow Manager does not replace any relational connection in the repository because it cannot determine the connection type for the source connection entered as ITEMS. Chapter 4: Working with Workflows (Running the Workflow) The following text adds to the information about assigning the Informatica Server to workflows in the Workflow Manager. To assign the Informatica Server to workflows, you must have Super User privilege. Chapter 10: Pipeline Partitioning (Pipeline Partitioning Overview) In previous releases of PowerCenter, you could create up to 16 partitions at any partition point in each pipeline in a mapping. In PowerCenter 6.2, you can create up to 32 partitions. For more information on the restrictions on the number of partitions, see �Pipeline Partitioning� in the Workflow Administration Guide. Chapter 12: Monitoring Workflows (Using the Workflow Monitor) The following text adds to the information on opening and closing folders in the Workflow Monitor. To view folder contents in the Workflow Monitor, you must have one of the following sets of permissions and privileges: • Super User privilege • Read permission Chapter 14: Log Files The following text replaces the text in the second and third rows of the workflow log options table on page 375 of the Workflow Administration Guide: • Workflow Log File Name. Optionally enter a file name, or a file name and directory.

If you leave this field blank, the Informatica Server does not create a workflow log. Instead, the Informatica Server writes workflow log messages to the server log or Windows Event Log, depending on how you configure the Informatica Server. If you fill in this field, the Informatica Server appends information in this field to that entered in the Workflow Log File Directory field. For example, if you have �C:\workflow_logs\� in the Workflow Log File Directory field, then enter �logname.txt� in the Workflow Log File Name field, the Informatica Server writes logname.txt to the C:\workflow_logs\ directory.

• Workflow Log File Directory. Designates a location for the workflow log file. By default, the Informatica Server writes the log file in the server variable directory, $PMWorkflowLogDir. If you enter a full directory and file name in the Workflow Log File Name field, clear this field.

Chapter 17: External Loading (Loading to Teradata) The following information applies to Teradata external loaders: You cannot use Teradata external loaders to load binary data. You can use the Teradata external loaders to load multibyte data. Appendix B: Workflow Properties Reference The following text replaces the text in the second and third rows of Table B-2 on pages 594-95 of the Workflow Administration Guide:

52

• Workflow Log File Name. Optional. Enter a file name, or a file name and directory. If you leave this field blank, the Informatica Server does not create a workflow log. Instead, the Informatica Server writes workflow log messages to the server log or Windows Event Log, depending on how you configure the Informatica Server. If you fill in this field, the Informatica Server appends information in this field to that entered in the Workflow Log File Directory field. For example, if you have �C:\workflow_logs\� in the Workflow Log File Directory field, then enter �logname.txt� in the Workflow Log File Name field, the Informatica Server writes logname.txt to the C:\workflow_logs\ directory.

• Workflow Log File Directory. Required. Designates a location for the workflow log file. By default, the Informatica Server writes the log file in the server variable directory, $PMWorkflowLogDir. If you enter a full directory and file name in the Workflow Log File Name field, clear this field.

Contacting Informatica Mailing Address Informatica Corporation 2100 Seaport Boulevard Redwood City, California 94063 General Phone and Fax 800.653.3871 650.385.5000 650.385.5500 (fax) Technical Support North America / South America [email protected] 866.563.6332 650.213.9489 (fax) Africa / Asia / Australia / Europe 6 Waltham Park Waltham Road, White Waltham Maidenhead, Berkshire SL6 3TN Phone: 44 870 606 1525 Fax: +44 1628 511 411 Hours: 9 a.m. - 5:30 p.m. (GMT) email: [email protected] Belgium Phone: +32 15 281 702 Hours: 9 a.m. - 5:30 p.m. (local time) France Phone: +33 1 41 38 92 26 Hours: 9 a.m. - 5:30 p.m. (local time) Germany Phone: +49 1805 702 702 Hours: 9 a.m. - 5:30 p.m. (local time)

53

Netherlands Phone: +31 306 082 089 Hours: 9 a.m. - 5:30 p.m. (local time) Singapore Phone: +65 322 8589 Hours: 9 a.m. - 5 p.m. (local time) Switzerland Phone: +41 800 81 80 70 Hours: 8 a.m. - 5 p.m. (local time) UK +44 870 606 1525 [email protected] Germany +49 1805 702 702 Switzerland +41 800 81 80 70 Website Address http://www.informatica.com Informatica Webzine Address and Email http://my.Informatica.com [email protected] (email)

PMPC-62_release Notes for 6.2

Documents

Transcript of PMPC-62_release Notes for 6.2