Table of Contents

Search

  1. Preface
  2. Part 1: Introduction
  3. Part 2: PowerExchange Client for PowerCenter (PWXPC)
  4. Part 3: PowerExchange ODBC
  5. Appendix A: PowerExchange Interfaces for PowerCenter Tips
  6. Appendix B: Datatypes and Code Pages
  7. Appendix C: PowerExchange Interfaces for PowerCenter Troubleshooting

PowerExchange Interfaces for PowerCenter

PowerExchange Interfaces for PowerCenter

Db2 CDC Application Connections

Db2 CDC Application Connections

Configure CDC application connections to extract change data from Db2 for z/OS, Db2 for i5/OS, or Db2 for Linux, UNIX, and Windows sources in real-time extraction mode. Also configure CDC application connections to extract change data from PowerExchange Condense files in batch extraction mode or from PowerExchange Logger for Linux, UNIX, and Windows log files in batch or continuous extraction mode.
Depending on the Db2 source type, you can configure the following types of application connections:
  • PWX DB2zOS CDC Change
  • PWX DB2zOS CDC Real Time
  • PWX DB2i5OS CDC Change
  • PWX DB2i5OS CDC Real Time
  • PWX DB2LUW CDC Change
  • PWX DB2LUW CDC Real Time
The following table describes the connection attributes:
Connection Attribute
Required?
Change or Real Time
Description
Name
Yes
Both
The name of the application connection.
Code Page
Yes
Both
The code page that the PowerCenter Integration Service uses to extract data from the source database.
In Unicode mode, you must select UTF-8 for DB2LUW CDC connections.
In Unicode mode, PWXPC sets the code page with this value overriding any code page specification in the PowerExchange configuration file.
Location
Yes
Both
The location of the source or target database as specified in a NODE statement in the PowerExchange dbmover.cfg configuration file.
User Name
Yes
Both
A user name that can be used to access the Db2 database.
For a database on a supported Linux, UNIX, or Windows system, if you have enabled PowerExchange LDAP user authentication, the user name is the enterprise user name. For more information, see the
PowerExchange Reference Manual
.
Password
Yes
Both
A password for the specified user. Passwords that are less than nine characters in length are not validated.
To avoid errors that might arise due to code page differences, Informatica recommends that the password includes only those characters that are allowed for passphrases.
For PWX DB2i5OS and DB2zOS CDC, you can enter a valid PowerExchange passphrase instead of a password. An i5/OS passphrase can be from 9 to 31 characters in length. A z/OS passphrase can be from 9 to 128 characters in length when you use a PWXPC connection. A passphrase can contain the following characters:
  • Uppercase and lowercase letters
  • The numbers 0 to 9
  • Spaces
  • The following special characters:
    ’ - ; # \ , . / ! % & * ( ) _ + { } : @ | < > ?
    The first character is an apostrophe.
Passphrases cannot include single quotation marks (‘), double quotation marks (“), or currency symbols.
On z/OS, the allowable characters in the IBM IRRPHREX exit do not affect the allowable characters in PowerExchange passphrases.
On z/OS, a valid RACF passphrase can be up to 100 characters in length. PowerExchange truncates passphrases longer than 100 characters when passing them to RACF for validation.
To use passphrases, ensure that the PowerExchange Listener runs with a security setting of SECURITY=(1,N) or higher in the DBMOVER member. For more information, see "SECURITY Statement" in the
PowerExchange Reference Manual
.
Compression
No
Both
Select this option to compress source data during the PowerCenter session.
Encryption Type
Yes
Both
The encryption type. For information about encryption types, see Configuring Encryption and Compression.
Default is None.
Encryption Level
No
Both
The encryption level. For information about encryption levels, see Configuring Encryption and Compression.
Default is 1.
Pacing Size
Yes
Both
The pacing size. For information about setting the pacing size, see Configuring Pacing.
Default is 0.
Interpret as Rows
No
Both
Controls whether the pacing size is in number of rows.
Image Type
No
Both
Indicates whether PWXPC passes captured Update operations to CDC sessions as Updates, or as Deletes followed by Inserts.
Default is BA, which processes Updates as Deletes followed by Inserts.
For more information, see Configuring Image Type.
Application Name
No
Both
The application name.
RestartToken File Folder
Yes
Both
The restart token folder.
Default is $PMRootDir/Restart.
For more information, see Configuring CDC Restart Attributes.
RestartToken File Name
No
Both
The restart token file name.
Number of Runs to Keep RestartToken File
No
Both
The maximum number of backup copies of the restart token file to keep.
Default is 0.
Recovery Cache Folder
No
Both
The file cache folder to enable recovery for the session.
Default is $PMRootDir/Cache.
UOW Count
No
Both
The number of units of work (UOWs) that PWXPC processes before it sends a commit request to PowerCenter to commit data to all targets in the CDC session.
Valid values:
-1
. Disables this attribute.
0
. Disables this attribute.
n
. Specifies the number of UOWs that PWXPC processes before sending a commit request.
Default is 1.
For more information, see Configuring UOW Count.
Reader Time Limit
No
Real Time
The number of seconds that the PowerCenter Integration Service reads data from the source before stopping.
If you enter 0, the
Reader Time Limit
attribute does not limit the reader time. This attribute is intended for testing purposes only.
Use
Idle Time
instead of
Reader Time Limit
.
Default is 0.
Idle Time
No
Real Time
The number of seconds the PowerExchange Listener remains idle after reaching the end of the change log, as indicated by message PWX-09967, before returning an end-of-file (EOF).
Valid values:
-1
. The EOF is not returned. The session runs continuously.
0
. The EOF is returned at the end of log. The session ends successfully.
n
. The number of seconds after which the EOF is returned.
Default is -1.
For more information, see Configuring Idle Time.
Real-Time Flush Latency in milli-seconds
No
Real Time
The number of milliseconds that must elapse before PWXPC sends a commit request to PowerCenter. When this period elapses, PWXPC continues to read the changes in the current UOW until it reaches the end of the UOW. Then PWXPC sends a commit request to PowerCenter so that the data can be committed to the targets.
Valid values:
-1
. Disables this attribute.
0 to 86400
. Specifies the number of milliseconds that must elapse before PWXPC sends a commit request to PowerCenter. If you specify a value from 0 through 2000, PWXPC uses 2000 milliseconds (2 seconds).
Default is 0.
PWX Latency in seconds
No
Real Time
The maximum number of seconds that PowerExchange extraction processing on the source platform waits for more change data before it returns control to PWXPC on the PowerCenter Integration Service machine.
Default is 2.
Maximum Rows Per commit
No
Both
The maximum number of change records that PWXPC processes before it sends a commit request to PowerCenter to commit data to all targets in the CDC session. PWXPC does not wait for a UOW boundary to commit the change data.
Default is 0, which disables this attribute.
For more information, see Configuring Maximum Rows per Commit.
Minimum Rows Per commit
No
Real Time
The minimum number of change records that the PowerExchange Listener must read from the change stream before it passes a commit record to PWXPC. Before reaching this minimum, the PowerExchange Listener passes only change records to PWXPC and discards any commit records.
Default is 0, which disables this attribute.
For more information, see Configuring Minimum Rows per Commit.
Journal Name
For PWX DB2i5OS CDC Real Time application connections only.
No
Both
Overrides the library and journal name in the PowerExchange CAPI_CONNECTION.
Specify complete library and journal names in the format:
library
/
journal
Library/File Override
For PWX DB2i5OS CDC Real Time application connections only.
No
Both
Overrides the library and file name in the extraction maps of all sources that use the connection.
Specify a single library and file name in the format:
library
/
file
If specifying asterisk for the library name, use the session properties Library/File Override attribute.
This attribute is overridden by the Library/File Override value on the session properties.
Convert character data to string
No
Both
Controls whether to convert character fields to string fields so that embedded nulls in data are processed as spaces.
By default, this attribute is not selected.
For more information, see Converting Character Data to Strings.
Event Table
No
Real Time
The PowerExchange extraction map name that is used for event processing.
For more information, see Configuring Event Table Processing.
Offload Processing
No
Real Time
Controls whether PowerExchange uses CDC offload processing. When offload processing is enabled, PowerExchange transfers column-level processing of the change data from the source system to the PowerCenter Integration Service machine.
Valid values:
  • No
    . Disables offload processing.
  • Yes
    . Enables offload processing.
  • Auto
    . PowerExchange determines whether to use offload processing.
Default is No.
For more information about offload processing, see the
PowerExchange CDC Guide for Linux, UNIX, and Windows
.
Worker Threads
No
Real Time
If you use CDC offload processing, the number of threads that PowerExchange uses on the PowerCenter Integration Service machine to process change data.
For optimal performance, this value should not exceed the number of installed or available processors on the Integration Service machine.
Valid values are from 1 through 64.
Default is 0.
Array Size
No
Real Time
If the
Worker Threads
value is greater than 0, specifies the size of the storage array, in number of records, for the threads.
Valid values are from 1 through 5000.
Default is 25.
Map Location
No
Real Time
If you use remote logging to a PowerExchange Logger for Linux, UNIX, and Windows, the location of the source extraction maps. This value must be the node name of the location, as specified in a NODE statement in the PowerExchange dbmover.cfg configuration file on the Integration Service machine.
For more information about remote logging, see the
PowerExchange CDC Guide for Linux, UNIX, and Windows
.
Map Location User
No
Real Time
If you specify a
Map Location
value, a valid user ID for the map location.
Map Location Password
No
Real Time
If you specify a
Map Location
value, a valid password for the specified map location user.
CAPI Connection Name Override
No
Real Time
Overrides the default CAPI connection name.
Retrieve PWX Log Entries
No
Both
Controls whether PWXPC writes PowerExchange informational messages related to a CDC session in the PowerCenter session log.
Default is to write PowerExchange error and warning messages but not informational messages to the session log.
PWX Override
No
Both
PowerExchange connection overrides, separated by a semicolon. You can enter one or more of the following optional overrides:
  • APPBUFSIZE=
    app_buf_size.
    Specifies the initial size of the application buffer for the connection. Overrides the APPBUFSIZE statement in the DBMOVER configuration file.
  • CONNECTSTRINGCODEPAGE=
    code_page
    . Code page of the characters in the connection string. Enter this override if PowerExchange issues message PWX-07610.
  • LOWVALUES={Y|
    N
    }. Indicates whether PowerExchange preserves hexadecimal '0' values, called
    low values
    , in source character fields when passing these values to a PowerCenter session. Enter Y to preserve low values. When the session runs, PWXPC can write these values to a VSAM target on z/OS or to a sequential file target on Linux, UNIX, Windows, or z/OS. Overrides the LOWVALUES statement in the DBMOVER configuration file.
  • PWXNOQUOTES={Y|
    N
    }. By default, in the SQL SELECT statements that PWXPC uses to select data for session processing, PWXPC adds double-quotation marks (") around every table name and field name that includes spaces or special characters. These special characters are
    /+-=~`!%^&*()[]{}';?,< >\\|
    . If a table is identified by both a schema name and table name in the format
    schema
    .
    table_name
    , PWXPC places the quotation marks only around the "
    table_name
    " value.
    If for any reason, you cannot use quoted table names or field names in your environment, set PWXNOQUOTES to Y to override the default behavior.
  • QAQQINILIB=
    library_name
    Specify the library name on the IBM i (i5/OS) system that contains the QAQQINI query options file. If the DBMOVER configuration file on the IBM i system includes the optional QAQQINILIB statement, this override takes precedence over the value specified in the DBMOVER file. This override only applies to IBM i systems.
  • RETLOGINFOMSG={
    N
    |Y}. By default, PWXPC writes PowerExchange error and warning messages but not informational messages to the session log. If you specify RETLOGINFOMSG=Y, PWXPC writes informational messages as well as error and warning messages to the session log.
    The RETLOGINFOMSG connection override is equivalent to the Retrieve PWX Log Entries connection attribute.
  • TCPIP_OP_TIMEOUT=
    network_operation_timeout
    . A network operation timeout interval in seconds. For more information about this timeout override, see Asynchronous Network Communication.
  • TCPIP_CON_TIMEOUT=
    connection_timeout
    . A connection timeout interval in seconds. For more information about this timeout override, see Asynchronous Network Communication.
Connection Retry Period
No
Both
The number of seconds the PowerCenter Integration Service attempts to reconnect to the PowerExchange Listener after the initial connection attempt fails. If the Integration Service cannot connect to the PowerExchange Listener within the retry period, the session fails.
Default value is 0, which disables connection retries based on this PWXPC connection attribute.
PowerExchange Listener connections to source databases do not have connection resilience.

0 COMMENTS

We’d like to hear from you!