Table of Contents

Search

  1. Preface
  2. PowerExchange Installation and Upgrade Overview
  3. Installation Planning
  4. Upgrade Planning
  5. Installing and Upgrading PowerExchange on IBM i
  6. Installing and Upgrading PowerExchange on Linux and UNIX
  7. Installing and Upgrading PowerExchange on Windows
  8. Installing and Upgrading PowerExchange on z/OS
  9. Appendix A: Upgrade Considerations
  10. Appendix B: PowerExchange Environment
  11. Appendix C: Manual Installation on IBM i

Installation and Upgrade Guide

Installation and Upgrade Guide

CDC Common Parameters Page

CDC Common Parameters Page

Enter or review information about the common parameters to use for CDC operations.
Logger ID
The PowerExchange Logger ID value.
This value must comply with the following rules:
  • Be from one to four characters in length
  • Begin with a letter or the #, @, or $ character
  • Contain only alphanumeric characters and the #, @, and $ characters
Default is PWXL.
The Logger ID value also maps to the LOGGER_NAME parameter in the PowerExchange Logger EDMUPARM options module and to the LOGGER parameter in the PowerExchange Agent EDMSDIR options module. For more information about these parameters, see the
PowerExchange CDC Guide for z/OS
.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <zlogger> variable in the INSTPARM file.
LOGGER Started Task ID
The name for the PowerExchange Logger started task, which can be the same as or different from the
Logger ID
value.
Default is PWXL.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <zllgname> variable in the INSTPARM file.
Agent Name
The PowerExchange Agent ID value.
This value must comply with the following rules:
  • Be four characters in length
  • Begin with an alphabetic character or the #, @, or $ character
  • Contain only alphanumeric characters and the #, @, and $ characters
  • Be different from any existing z/OS subsystem name
You can use the same Agent ID value for multiple PowerExchange Agents as long as each PowerExchange Agent runs on a separate z/OS system.
Default is PWXA.
The Agent Name value also maps to the AgentID option in the PowerExchange Agent AGENTCTL member and to the AGENTID parameter in the EDMSDIR options module. For more information about these parameters, see the
PowerExchange CDC Guide for z/OS
.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <zagent> variable in the INSTPARM file.
Agent Started Task ID
The name for the PowerExchange Agent started task proc, which can be the same as or different from the
Agent Name
value.
Default is PWXA.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <zagentstartid> variable in the INSTPARM file.
Logger Data Set Size (Cylinders)
The number of cylinders to allocate for the PowerExchange Logger primary log, the secondary log, and the primary space for the archive log data sets.
If the active log data set is larger than permitted by the DSPSERV CREATE function, the Log Format utility (EDMLUTL0) issues the PWXEDM172782E error message.
Maximum size is 2912 cylinders for a 3390 device, or 3495 cylinders for a 3380 device.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <zlogdssz> variable in the INSTPARM file.
Change Capture Error
Specifies the action that PowerExchange takes when a Db2, IMS synchronous, batch VSAM, or
CICS/VSAM
ECCR cannot capture changes for a source.
Select one of the following options:
  • Continue
    . Stops change capture but allows the job or transaction to continue. Changes to the source are not captured.
  • Abend
    . Causes the job or transaction to end abnormally. Transactions cannot update the source.
This option also maps to the CCERR parameter in the EDMSDIR options module. For more information about the EDMSDIR options, see the
PowerExchange CDC Guide for z/OS
.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <zccerr> variable in the INSTPARM file. Valid variable values are CONT and ABEND.
Use Post Log Merge
Enables the PowerExchange Logger Post-Log Merge environment.
For more information about configuring Post-Log Merge, see the
PowerExchange CDC Guide for z/OS
.
This field is read only for an upgrade with new data set names.
This setting corresponds to the <plm_logrgrp> variable in the INSTPARM file. Valid variable values are N and Y.
Suffix (1 to 9)
A unique suffix for a PowerExchange Logger member in a Post-Log Merge group.
The suffix is used as in the data set name for USERLIB and in the XCF members created by the PowerExchange Logger.
A valid value is a single numeric character from 1 to 9.
Default is 1.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <plm_suffix> variable in the INSTPARM file.
TIME_CHKPT_FREQ (5-60)
Defines the frequency at which the PowerExchange Logger creates time-based checkpoint records in a Post-Log Merge environment. This value is the number of TIMER_INTERVAL periods.
A valid value is from 5 to 60.
Default is 30.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <plm_time_chkpt_freq> variable in the INSTPARM file.
TIMER_INTERVAL (50-6000)
Defines the frequency at which the PowerExchange Logger completes internal management operations, such as freeing unused virtual storage or detecting inactive tasks that need to be reactivated. This value is specified in hundredths of seconds.
A valid value is from 50 (.5 seconds) to 6000 (1 minute).
Default is 100.
This field is read only for an upgrade using new data set names.
This setting corresponds to the <plm_timer_interval> variable in the INSTPARM file.

0 COMMENTS

We’d like to hear from you!