Informatica® Cloud Data Integration

DB2 Loader Connector

Informatica Cloud Data Integration DB2 Loader Connector
October 2023
© Copyright Informatica LLC 2023

This software and documentation are provided only under a separate license agreement containing restrictions on use and disclosure. No part of this document may be
reproduced or transmitted in any form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica LLC.

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial
computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such,
the use, duplication, disclosure, modification, and adaptation is subject to the restrictions and license terms set forth in the applicable Government contract, and, to the
extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License.

Informatica, the Informatica logo, Informatica Cloud, and PowerCenter are trademarks or registered trademarks of Informatica LLC in the United States and many
jurisdictions throughout the world. A current list of Informatica trademarks is available on the web at https://www.informatica.com/trademarks.html. Other company
and product names may be trade names or trademarks of their respective owners.

Portions of this software and/or documentation are subject to copyright held by third parties. Required third party notices are included with the product.

See patents at https://www.informatica.com/legal/patents.html.

DISCLAIMER: Informatica LLC provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied
warranties of noninfringement, merchantability, or use for a particular purpose. Informatica LLC does not warrant that this software or documentation is error free. The
information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation
is subject to change at any time without notice.

NOTICES

This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software
Corporation ("DataDirect") which are subject to the following terms and conditions:

1. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT INFORMED OF THE POSSIBILITIES
OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT LIMITATION, BREACH OF CONTRACT, BREACH
OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.

The information in this documentation is subject to change without notice. If you find any problems in this documentation, report them to us at
[email protected].

Informatica products are warranted according to the terms and conditions of the agreements under which they are provided. INFORMATICA PROVIDES THE
INFORMATION IN THIS DOCUMENT "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT ANY WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY OR CONDITION OF NON-INFRINGEMENT.

Publication Date: 2023-10-08

Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Informatica Intelligent Cloud Services web site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Informatica Intelligent Cloud Services Communities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Informatica Intelligent Cloud Services Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Data Integration connector documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Intelligent Cloud Services Trust Center. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Chapter 1: Introduction to DB2 Loader Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

DB2 Loader Connector assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Administration of DB2 Loader Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installing the DB2 Loader JDBC driver and DB2 client on Linux. . . . . . . . . . . . . . . . . . . . . . . 7
Installing the DB2 Loader JDBC driver and DB2 client on Windows. . . . . . . . . . . . . . . . . . . . 7

Chapter 2: DB2 Loader connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

DB2 Loader connection properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Chapter 3: Mappings and mapping tasks with DB2 Loader Connector. . . . . . . . . 11

DB2 Loader targets in mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Rules and guidelines for DB2 Loader objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Chapter 4: Data type reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

DB2 Loader and transformation data types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Table of Contents 3
Preface
Use DB2 Loader Connector to learn how to write to DB2 database by using Data Integration. Learn to create a
DB2 Loader connection, develop, and run mappings and mapping tasks in Data Integration.

Informatica Resources
Informatica provides you with a range of product resources through the Informatica Network and other online
portals. Use the resources to get the most from your Informatica products and solutions and to learn from
other Informatica users and subject matter experts.

Informatica Documentation
Use the Informatica Documentation Portal to explore an extensive library of documentation for current and
recent product releases. To explore the Documentation Portal, visit https://docs.informatica.com.

If you have questions, comments, or ideas about the product documentation, contact the Informatica
Documentation team at [email protected].

Informatica Intelligent Cloud Services web site

You can access the Informatica Intelligent Cloud Services web site at http://www.informatica.com/cloud.
This site contains information about Informatica Cloud integration services.

Informatica Intelligent Cloud Services Communities

Use the Informatica Intelligent Cloud Services Community to discuss and resolve technical issues. You can
also find technical tips, documentation updates, and answers to frequently asked questions.

Access the Informatica Intelligent Cloud Services Community at:

https://network.informatica.com/community/informatica-network/products/cloud-integration

Developers can learn more and share tips at the Cloud Developer community:

https://network.informatica.com/community/informatica-network/products/cloud-integration/cloud-
developers

Informatica Intelligent Cloud Services Marketplace

Visit the Informatica Marketplace to try and buy Data Integration Connectors, templates, and mapplets:

https://marketplace.informatica.com/

4
Data Integration connector documentation
You can access documentation for Data Integration Connectors at the Documentation Portal. To explore the
Documentation Portal, visit https://docs.informatica.com.

Informatica Knowledge Base

Use the Informatica Knowledge Base to find product resources such as how-to articles, best practices, video
tutorials, and answers to frequently asked questions.

To search the Knowledge Base, visit https://search.informatica.com. If you have questions, comments, or
ideas about the Knowledge Base, contact the Informatica Knowledge Base team at
[email protected].

Informatica Intelligent Cloud Services Trust Center

The Informatica Intelligent Cloud Services Trust Center provides information about Informatica security
policies and real-time system availability.

You can access the trust center at https://www.informatica.com/trust-center.html.

Subscribe to the Informatica Intelligent Cloud Services Trust Center to receive upgrade, maintenance, and
incident notifications. The Informatica Intelligent Cloud Services Status page displays the production status
of all the Informatica cloud products. All maintenance updates are posted to this page, and during an outage,
it will have the most current information. To ensure you are notified of updates and outages, you can
subscribe to receive updates for a single component or all Informatica Intelligent Cloud Services
components. Subscribing to all components is the best way to be certain you never miss an update.

To subscribe, on the Informatica Intelligent Cloud Services Status page, click SUBSCRIBE TO UPDATES. You
can choose to receive notifications sent as emails, SMS text messages, webhooks, RSS feeds, or any
combination of the four.

Informatica Global Customer Support

You can contact a Global Support Center through the Informatica Network or by telephone.

To find online support resources on the Informatica Network, click Contact Support in the Informatica
Intelligent Cloud Services Help menu to go to the Cloud Support page. The Cloud Support page includes
system status information and community discussions. Log in to Informatica Network and click Need Help to
find additional resources and to contact Informatica Global Customer Support through email.

The telephone numbers for Informatica Global Customer Support are available from the Informatica web site
at https://www.informatica.com/services-and-training/support-services/contact-us.html.

Preface 5
Chapter 1

Introduction to DB2 Loader

Connector
You can use DB2 Loader Connector to connect to DB2 from Data Integration. Use the DB2 Loader connection
to securely write data to a DB2 database.

You can use DB2 Loader objects as targets in mappings and mapping tasks. When you use these objects in
mappings, you must configure properties specific to DB2.

You can use DB2 Loader Connector to insert records to DB2 databases.

DB2 Loader Connector assets

Create assets in Data Integration to integrate data using DB2 Loader Connector.

When you use DB2 Loader Connector, you can include the following Data Integration assets:

• Mapping
• Mapping task

For more information about configuring assets and transformations, see Mappings, Transformations, and
Tasks in the Data Integration documentation.

Administration of DB2 Loader Connector

Before you use DB2 Loader Connector to load data to a DB2 Loader target table, the organization
administrator must perform prerequisite tasks.

• Install the DB2 Loader JDBC driver and DB2 client on the Secure Agent machine based on the operating
system.
• Verify that you have one of the following authorities and database privileges on the DB2 database:
- SYSADM authority

- DBADM authority

6
 - LOAD authority on the database and one of the following privileges when the load utility is invoked in
insert, terminate, or restart mode:
- Insert privilege on the table

- Insert and delete privileges on the table

Installing the DB2 Loader JDBC driver and DB2 client on Linux
Before you establish a DB2 Loader connection to connect to DB2 on Linux, you need to install the DB2 Loader
JDBC driver and DB2 client on the Secure Agent machine.

1. To get the DB2 Loader JDBC driver, contact Informatica Global Customer Support.
2. Copy the DB2 Loader JDBC driver to the following directory on the Secure Agent machine:
<Secure Agent installation directory>/ext/connectors/thirdparty/informatica.db2loader
Note: You must create the informatica.db2loader folder manually.
3. Download and install the DB2 LUW client and instance from the IBM website.
4. Set the following environmental variables:
• setenv DB2INSTANCE <DB2 instance directory>
• setenv DB2CLP DB20FADE
• setenv PATH <DB2 client directory>/bin
• setenv LD_LIBRARY_PATH <DB2 client directory>/lib64
5. Restart the Secure Agent.

Installing the DB2 Loader JDBC driver and DB2 client on Windows
Before you establish a DB2 Loader connection to connect to DB2 on Windows, you need to install the DB2
Loader JDBC driver and DB2 client on the Secure Agent machine.

1. To get the DB2 Loader JDBC driver, contact Informatica Global Customer Support.
2. Copy the DB2 Loader JDBC driver to the following directory on the Secure Agent machine:
<Secure Agent installation directory>\ext\connectors\thirdparty\informatica.db2loader
Note: You must create the informatica.db2loader folder manually.
3. Download and install the DB2 LUW client and instance from the IBM website.
4. Set the setenv DB2CLP DB20FADE environmental variable.
5. Restart the Secure Agent.

Administration of DB2 Loader Connector 7

Chapter 2

DB2 Loader connections

Create a DB2 Loader connection to connect to DB2 so that the Secure Agent can write data to DB2.

You create a DB2 Loader connection on the Connections page. After you create a connection, it becomes
available to all users who have access to the organization.

Use the connection to specify targets in mappings or mapping tasks.

DB2 Loader connection properties

When you set up a DB2 Loader connection, configure the connection properties.

The following table describes the DB2 Loader connection properties:

Property Description

Connection Name Name of the connection.

Each connection name must be unique within the organization.
Connection names can contain alphanumeric characters, spaces,
and the following special characters: _ . + -,
Maximum length is 255 characters.

Description Description of the connection. Maximum length is 4000 characters.

Type Type of connection.

Select db2loader from the list.

Runtime Environment The name of the runtime environment where you want to run the
tasks.
Select the Secure Agent from the list as the runtime environment.

Host Name Name of the machine that hosts the DB2 database server.

Database The DB2 database name.

Port The port number that connects to the DB2 database server.
Default is 50000.

Schema Not applicable.

User Name User name for the DB2 database login.

8
Property Description

Password Password for the DB2 database login.

Encryption Method Encrypts data exchanged between the Secure Agent and the
database server.
Select one of the following encryption methods from the list:
- No Encryption. Establishes a connection without using SSL. Data
is not encrypted.
- SSL. Establishes a connection using SSL. Data is encrypted using
SSL.
Default is No Encryption.

Validate Server Certificate Determines whether the Secure Agent validates the certificate that
is sent by the database server.
This property appears only if you select the encryption method as
SSL.
Select one of the following options from the list:
- False. The Secure Agent does not validate the certificate.
- True. The Secure Agent validates the certificate.
Default is False.

TrustStore Absolute path and file name of the truststore file that contains the
SSL certificate to connect to DB2.
This property appears only if you select the encryption method as
SSL and validate server certificate as True.
Specify both the directory and file name in the following format:
/root/<folder name>/<truststore file name>.p12

TrustStore Password The password to access the truststore file that contains the SSL
certificate.
This property appears only if you select the encryption method as
SSL and validate server certificate as True.

Host name in Certificate Name of the machine that hosts the secure database.
This property appears only if you select the encryption method as
SSL and validate server certificate as True.
The Secure Agent validates the host name specified in this property
with the host name in the SSL certificate.

Connection String Alias name to connect to the DB2 database.

Operation Mode Operation mode of the DB2 external loader.

Select one of the following operation modes based on the mode
that you selected in the DB2 external loader:
- Insert. Adds data to the table.
- Replace. Deletes all existing data from the table and then adds
data to the table.
- Restart. Restarts a previously interrupted load operation.
- Terminate. Terminates a previously interrupted load operation
and rolls back the operation to the starting point, even if
consistency points are passed.
Default is Insert.

DB2 Loader connection properties 9

 Property Description

Is Staged Method to load data.

Select Is Staged to load data to a flat file staging area before
loading to the DB2 database.
Default is disabled.

Recoverable Sets the DB2 tablespace in backup pending state.

Before you enable the Recoverable option and run a mapping, you
need to fully back up the database to perform any other operation
on the tablespace.
Default is enabled.

DB2 Server Location Location of the DB2 database server relative to the Secure Agent
machine.
Select one of the following locations from the list:
- Remote. The DB2 database server resides on another machine.
- Local. The DB2 database server resides on the Secure Agent
machine.
Default is Remote.

External Loader Executable File name of the DB2 external loader executable file of the IBM data
server client 9.5 version and later.
Default is db2load.

10 Chapter 2: DB2 Loader connections

Chapter 3

Mappings and mapping tasks

with DB2 Loader Connector
Use the Data Integration Mapping Designer to create a mapping. When you create a mapping, configure a
target to represent a DB2 Loader object.

Describe the flow of data from the source to the target along with the required transformations before the
agent writes data to the DB2 target. When you create a mapping task, select the configured mapping that you
want to use. Use the Mapping Task wizard to create a mapping task. Validate and run the mapping to write to
a target. The mapping task processes data based on the data flow logic you define in the mapping.

DB2 Loader targets in mappings

To write data to a DB2 database, configure a DB2 Loader object as the target in a mapping.

Specify the name and description of the DB2 target. Configure the target and advanced properties for the
target object.

The following table describes the target properties that you can configure for a DB2 Loader target:

Property Description

Connection Name of the target connection.

You can select an existing connection, create a new connection, or define parameter values for the
target connection property.
To overwrite the target connection properties at runtime, select the Allow parameter to be overridden
at run time option.

Target Type Type of the DB2 Loader target object.

Select one the following target types:
- Single
- Parameter

Object Name of the DB2 Loader target object.

Specify the target object that you want to create. You can also select an existing object from the list.

11
 Property Description

Parameter A parameter file where you define values that you want to update without having to edit the task.
Select an existing parameter for the target object or click New Parameter to define a new parameter for
the target object.
The Parameter property appears only if you select parameter as the target type.
If you want to overwrite the target object at runtime, select the Allow parameter to be overridden at run
time option. When the task runs, the agent uses the parameters from the file that you specify in the
advanced session properties.

Operation Type of the target operation.

You can perform only the insert operation on a DB2 Loader target.

The following table describes the advanced target properties that you can configure for a DB2 Loader target:

Property Description

Append if Appends the output data to the target files and reject files.
exists Default is disabled.

Create Target Creates a directory to store the output files.

Directory Default is disabled. Do not change the default value.

Header The header row in the DB2 Loader target table.

Options Select one of the following header options from the list:
- No Header. Does not create a header row in the target table.
- Output Field Names. Creates a header row in the target table with the output field names.
- Use header command output. Not applicable.
Default is No Header.

Output File The directory that stores the output files.

Directory Specify the directory where you want to store the output files.
Ensure that the specified directory is accessible from the Secure Agent machine.
Default is $PMTargetFileDir.
Note: Do not use double spaces in the directory name of the output file.

Output File Creates the output file in the output file directory with the name you specify.
Name Specify the output file name.
To write to multiple target tables, enter a unique output file name for each target.
Default is output1.out.

Reject File The directory that stores the rejected files.

Directory Specify the directory where you want to store the rejected files.
Default is $PMBadFileDir.

Reject File Creates the rejected file in the reject file directory with the name you specify.
Name Specify the reject file name.
Default is Output1.bad.

File Delimiter The delimiter to use to separate columns of data in a delimited flat file.
Default is comma (,). Do not change the default value.

12 Chapter 3: Mappings and mapping tasks with DB2 Loader Connector

 Property Description

Table Name Prefix that the Secure Agent adds to the target table name.
Prefix Enter a schema name to add as a prefix to the table name that you load to the target.
When you add a prefix in this field, the target table name appears in the control file in the following
format:
<table name prefix>.table name

Target Table The target table name that you want to override in a mapping.
Name

Code Page The code page that the Secure Agent uses to write data to a delimited flat file.
Select one of the following code pages from the list:
- MS Windows Latin 1 (ANSI), superset of Latin 1
- Unicode Transformation Format, multibyte
Default is MS Windows Latin 1 (ANSI), superset of Latin 1.

Optional Quote characters that define the boundaries of data in a delimited flat file.
Quotes Select one of the following quotes from the list:
- None
- Single
- Double
Default is None.

Forward Determines whether the transformation passes rejected rows to the next transformation or drops
Rejected Rows rejected rows. By default, the mapping task forwards rejected rows to the next transformation.
If you select the Forward Rejected Rows option, the Secure Agent flags the rows for reject and
writes them to the reject file.
If you do not select the Forward Rejected Rows option, the Secure Agent drops the rejected rows
and writes them to the session log file. The Secure Agent does not write the rejected rows to the
reject file.

Rules and guidelines for DB2 Loader objects

Consider the following rules and guidelines for DB2 Loader objects used as targets in mappings and mapping
tasks:
General guidelines

• When you write to a DB2 Loader target table and some rows are rejected due to constraint violation
errors, the session log shows incorrect number of rows that are written to the target.
• To load data from a delimited flat file, ensure that the precision of each target table column matches
the corresponding source column precision to write all data.

Data types

When you load blank spaces to a DB2 Loader target, the blank spaces are loaded as null values in the
Char data type field.

Partitioning

You can't load data to a DB2 target in a mapping enabled for the source partitioning.

Rules and guidelines for DB2 Loader objects 13

 Data preview

You can't preview data of a DB2 Loader target object.

14 Chapter 3: Mappings and mapping tasks with DB2 Loader Connector

Chapter 4

Data type reference

Data Integration uses the following data types in mappings and mapping tasks with DB2:

DB2 native data types

DB2 data types appear in the Target Fields tab of the Target transformation when you choose to edit
metadata for the fields.

Transformation data types

Set of data types that appear in the transformations. They are internal data types based on ANSI SQL-92
generic data types, which the Secure Agent uses to move data across platforms. Transformation data
types appear in all transformations in a mapping.

When Data Integration writes to a target, it converts the transformation data types to the comparable
native data types.

DB2 Loader and transformation data types

Use only the supported DB2 data types in a mapping to write to DB2.

The following table lists the DB2 data types that Data Integration supports and the corresponding
transformation data types:

DB2 data Range and Description Transformation Range and Description

type data type

Bigint -9,223,372,036,854,775,808 to Bigint -9,223,372,036,854,775,808 to

9,223,372,036,854,775,807 9,223,372,036,854,775,807
Precision 19, scale 0

Char 1 to 254 characters String 1 to 104,857,600 characters

Date 0001 to 9999 A.D. Date/Time Jan 1, 0001 A.D. to Dec 31, 9999 A.D.
Precision 19; scale 0 (precision to (precision to the nanosecond)
the day)

Decimal Precision 1 to 31, scale 0 to 31 Decimal Precision 1 to 28, scale 0 to 28

Double Precision 15 Double Precision 15

Float Precision 1 to 15 Double Precision 15

15
 DB2 data Range and Description Transformation Range and Description
type data type

Integer -2,147,483,648 to 2,147,483,647 Integer -2,147,483,648 to 2,147,483,647

Precision 10, scale 0

Numeric Precision 1 to 31, scale 0 to 31 Decimal Precision 1 to 28, scale 0 to 28

Real Precision 7, scale 0 Real Precision 7, scale 0

Smallint -32,768 to 32,767 Small Integer Precision 5, scale 0

Time 24-hour time period Date/Time Jan 1, 0001 A.D. to Dec 31, 9999 A.D.
Precision 19, scale 0 (precision to the nanosecond)
(precision to the second)

Timestamp 26 bytes Date/Time Jan 1, 0001 A.D. to Dec 31, 9999 A.D.
Precision 26, scale 6 (precision to the nanosecond)
(precision to the microsecond)

Varchar Up to 4,000 characters String 1 to 104,857,600 characters

16 Chapter 4: Data type reference

Index

C Informatica Intelligent Cloud Services

web site 4
Cloud Application Integration community
URL 4
Cloud Developer community
URL 4
M
connections maintenance outages 5
DB2 Loader 8

S
D status
Data Integration community Informatica Intelligent Cloud Services 5
URL 4 system status 5
data type reference
overview 15
data types
DB2 15
T
DB2 Loader trust site
assets 6 description 5
connection properties 8
DB2 Loader connection
overview 8
DB2 Loader Connector
U
mapping 11 upgrade notifications 5
overview 6
rules and guidelines 13
DB2 targets
mappings 11
W
web site 4

I
Informatica Global Customer Support
contact information 5

17