Table of Contents

Search

  1. Preface
  2. Summary of PowerExchange New Features and Changes
  3. PowerExchange Installation and Upgrade
  4. PowerExchange Agent
  5. PowerExchange Client for PowerCenter
  6. PowerExchange Condense
  7. PowerExchange Listener
  8. PowerExchange Logger for Linux, UNIX, and Windows
  9. PowerExchange Navigator
  10. PowerExchange Monitoring and Tuning
  11. PowerExchange Utilities
  12. PowerExchange for Adabas
  13. PowerExchange for CA Datacom
  14. PowerExchange for DB2 for i
  15. PowerExchange for DB2 for Linux, UNIX, and Windows
  16. PowerExchange for DB2 for z/OS
  17. PowerExchange for CA IDMS
  18. PowerExchange for IMS
  19. PowerExchange for Microsoft SQL Server
  20. PowerExchange for MySQL
  21. PowerExchange for Oracle
  22. PowerExchange for PostgreSQL
  23. PowerExchange for VSAM and Flat Files
  24. PowerExchange ODBC

PowerExchange Express CDC for Oracle Configuration File

PowerExchange Express CDC for Oracle Configuration File

PowerExchange 10.1 introduces new parameters in the OPTIONS statement of the PowerExchange Express CDC for Oracle configuration file, pwxorad.cfg.
OPTIONS Statement
The OPTIONS statement can now include the following optional parameters:
LOGARCHIVEWAIT
New
. After an Oracle online redo log starts being overwritten, the number of seconds that PowerExchange Express CDC waits for the copy of the log to become available as a new archived redo log for change data capture processing. In an Oracle Data Guard environment, if Express CDC captures change data from a physical standby database, this parameter specifies the number of seconds that Express CDC waits for the next archived redo log to be transported from the primary database to the standby database.
Valid values are 0 through 86400. Default is 30. If you use any value less than the value of the STATUSCHECKINTERVAL parameter in the READER statement, Express CDC waits for the STATUSCHECKINTERVAL period.
This parameter is also available in 9.6.1 HotFix 4. It is not available in 10.0.
PARTITION_DROP_FAIL
New
. Controls whether PowerExchange Express CDC for Oracle ends with an error or continues processing when the log reader encounters an ALTER TABLE DROP PARTITION operation for a registered Oracle source table.
Options:
  • Y
    . Express CDC processing ends with error message PWX-36332, which reports the log position of the DROP PARTITION operation that caused the failure.
  • N
    . Express CDC ignores the DROP PARTITION operation and continues change capture processing. Message PWX-36390 reports that Express CDC encountered a DROP PARTITION operation for a source table.
Default is Y.
RETRYONKILLSESSION
New
. Controls whether PowerExchange Express CDC can detect when an Oracle KILL SESSION event occurs for a specific PowerExchange connection to an Oracle source instance and then retry the connection so that the Express CDC log reader and PowerExchange Logger for Linux, UNIX, and Windows process do not end abnormally. A KILL SESSION event occurs when a user issues the following SQL statement:
ALTER SYSTEM KILL SESSION ‘
sid
,
serial_number
’ [IMMEDIATE]
In this statement, the variable
sid
is the session ID and the variable
serial_number
is the session serial number, as shown in the V$SESSION view.
Options:
  • N
    . PowerExchange does not try to re-establish killed sessions for Express CDC processes. If a KILL SESSION event occurs, the PowerExchange Express CDC log reader and PowerExchange Logger end abnormally.
  • Y
    . PowerExchange tries to re-establish killed sessions for Express CDC processes. Also set the CONNRETRYMAX parameter to a value greater than 0 to indicate the maximum number of times that PowerExchange retries the connection to the source instance.
    The RETRYONKILLSESSION, CONNRETRYMAX, and CONNRETRYWAIT parameters help improve connection resiliency.
Default is N.
Before setting this parameter to Y, consult with your Oracle database administrator to ensure that no unintended consequences occur.
This parameter is also available in 9.6.1 HotFix 4. It is not available in 10.0.
SUPPORT_DIRECT_PATH_OPS
New
. Controls whether Express CDC captures or ignores Oracle direct-path operations, such as direct-path INSERT operations, on registered source tables.
Options:
  • N
    . Disables the capture of direct-path operations. If the log reader encounters a redo log record for a direct-path operation, Express CDC ignores the direct-path operation with an informational message and continues.
  • Y.
    Enables the capture of direct-path operations.
    Express CDC does not capture direct-path operations for tables that use Oracle Exadata Columnar Compression (EHCC).
Default is N.
This parameter is also available in 9.6.1 HotFix 4. It is not available in 10.0.
READER Statement
The READER statement can now include the following optional parameters:
MODE=ARCHIVECOPY
New
. Allows the PowerExchange Express CDC log reader to read archived redo logs that have been copied to an alternate file system. Use this option in the following situations:
  • You do not have the authority to access the Oracle archived redo logs directly.
  • The archived redo logs are written to ASM, but you do not have access to ASM.
  • An aggressive archived log retention policy is in effect on the database server, which might cause the archived logs to not be retained long enough.
You must implement a script to copy the archived redo logs from their primary location to the alternate location. To copy the archived logs, you can use any method that does not corrupt them, for example, FTP in binary mode. You must also specify the DIR parameter to indicate the name of base directory that the log reader scans for the copies of the archived logs. Optionally, you can use the FILE parameter to filter the copies of the archived logs that reside under the base directory.
Unlike the other MODE options, ARCHIVECOPY identifies candidate archived redo logs by scanning the file system directories. This process ignores the ARCHIVEDEST
n
parameters and does not filter candidate logs by their DELETED status in
v$archived_log
.
Default option is still ACTIVE.
DIR
New
. When MODE parameter is set to ARCHIVECOPY, this parameter is required. It specifies the name of the base directory that PowerExchange Express CDC log reader scans for the copies of the archived redo logs to read. To filter the copies of the logs that reside under this base directory, you can also specify the FILE parameter.
FILE
New
. Optional. When the MODE parameter is set to ARCHIVECOPY, you can use this parameter to specify a mask for filtering the copies of the archived redo logs that the PowerExchange Express CDC log reader reads. PowerExchange matches the mask against the subdirectories and files under the base directory that is specified in the DIR parameter. Enter a mask for the subdirectory name, log file names, or both.
For more information, see the "Express CDC for Oracle" chapter in the
PowerExchange CDC Guide for Linux, UNIX, and Windows
.

0 COMMENTS

We’d like to hear from you!