PowerExchange for CDC and Mainframe
- PowerExchange for CDC and Mainframe 10.5.4
- All Products
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:
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 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
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.
For more information, see
Configuring PWX Latency and Real-Time Flush Latency.
|
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/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:
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:
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.
For more information, see
Configuring the CAPI Connection Name Override.
|
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:
|
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.
|