Table of Contents

Search

  1. Preface
  2. Introduction to PowerExchange Commands
  3. Adabas Log-Based ECCR Commands
  4. Batch VSAM ECCR Commands
  5. CICS/VSAM ECCR Commands
  6. Datacom Table-Based ECCR Commands
  7. DB2 for z/OS ECCR Commands
  8. IDMS Log-Based ECCR Commands
  9. IMS Synchronous ECCR Commands
  10. IMS Log-Based ECCR Commands
  11. PowerExchange Agent Commands
  12. PowerExchange Condense Commands
  13. PowerExchange Listener Commands
  14. PowerExchange Logger for z/OS Commands
  15. PowerExchange Logger for Linux, UNIX, and Windows Commands
  16. pwxcmd Commands

Command Reference

Command Reference

INITIALIZE Command

INITIALIZE Command

Initializes the CICS/VSAM ECCR in the CICS region. Also dynamically adds the PowerExchange exit programs that run at the CICS task-related user exit point and global user exit points that PowerExchange uses for CICS/VSAM CDC.
Informatica recommends that you do not use the EDMC INITIALIZE command to manually initialize and activate the CICS/VSAM ECCR. Instead, add the EDMKOPER module name to the CICS PLTI initialization list. The ECCR then initializes whenever you start the CICS/VSAM control region. This method of initializing the ECCR helps prevent potential change data capture problems that can occur if the PowerExchange exit programs at the CICS global exit points get control in the improper order.

Syntax

Use the following command syntax:
EDMC INITIALIZE
Short form:
EDMC INIT

Example Output

The following example output is written to the console log:
Log start PWXEDM172852I Options in effect: Load Library containing EDMSDIR. . . . . : PWXUMB1.DEV.PWXL.USERLIB EDMSDIR assembly date/time . . . . . . . : 20131205 20.43 EDP Rollup . . . . . . . . . . . . . . . : V1020_HF1B05_20180606 Product distribution date. . . . . . . . : 20180515 Agent Id . . . . . . . . . . . . . . . . : PWXA Logger Id. . . . . . . . . . . . . . . . : PWXL SYSOUT class . . . . . . . . . . . . . . : * Action if ECCR error encountered . . . . : Continue PWXEDM172886I The following Load Module replacements have been installed: 0----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+---- $$+$$$$+$$$$$$$$$$$$$$$$$$$$$$+$+$$$$+$$$$$$$$$$+$$$$$$$$$$$$$$$$$+$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+$$$ 100----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+---- $$$$$$$$$$$$$$+$$$$$$$$$$$$+$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ 200----+----1----+----2----+----3----+----4----+----5----+ $ $+$+$$$$$$+$$$$$$$$$$$$$+$$$$$$$$$$$$$$$$+$++++ ++++++ PWXEDM172818I Joined XCF group 'PWXL' as member 'WB54' PWXEDM172841I EDM ECCR WB54 connected to EDM Logger PWXL, Log RBA=X'0000040C2E340000' PWXEDM172820I Change Capture initialized for CICS/VSAM on CICS/TS V5.4.0 PWXEDM172808I Change Capture active for Tag VSAMPWXUMB1.VSAM.EDMVES02 VSAM file PWXUMB1.VSAM.EDMVES02 PWXEDM172808I Change Capture active for Tag VSAMPWXUMB1.VSAM.EDMVES03 VSAM file PWXUMB1.VSAM.EDMVES03 PWXEDM172808I Change Capture active for Tag VSAMPWXUMB1.VSAM.EDMVES04 VSAM file WBRUMB1.VSAM.EDMVES04 PWXEDM172808I Change Capture active for Tag VSAMPWXUMB1.VSAM.EDMVES05 VSAM file WBRUMB1.VSAM.EDMVES05 PWXEDM172841I EDM ECCR WB54 disconnected from EDM Logger PWXL, Log RBA=X'0000040C34A00000' PWXEDM172818I Left XCF group 'PWXL' as member 'WB54' PWXEDM172829I EDM ECCR sent 0 records to Logger PWXL (0 change records) Log end

Usage Notes

  • If you activate the CICS/VSAM ECCR and open a VSAM data set before you activate the PowerExchange Agent, you must close and re-open the data set to start capturing changes.
  • If you specified CCERR=ABEND in the EDMSDIR options module and the CICS/VSAM ECCR encounters a serious error or ends abnormally during initialization, the ECCR immediately terminates the CICS region to prevent data loss. This process aborts current tasks and backs out in-flight transactions. The ECCR operates as if you had issued the CICS command
    CEMT PERFORM SHUTDOWN IMMEDIATE
    . This action ensures change data integrity.
    If you did not specify CCERR=ABEND in the EDMSDIR options module, after the ECCR ends abnormally during initialization, you can issue the EDMC RESTART command. This command issues a TERMINATE command followed by an INITIALIZE command. However, on a busy system, this method might cause change data loss because data is not captured during the period between ECCR termination and re-initialization.
  • If you need to begin capturing changes for an additional VSAM file after the ECCR is running, verify that the capture registration is active and then close and reopen the VSAM file in CICS.
  • CICS/VSAM CDC uses exit programs defined at multiple CICS global exit points to capture changes to VSAM data sets. The INIT command causes the exit programs to be dynamically added, and the TERM command causes the exit programs to be dynamically removed. If other exit programs are active at the same global exit points on the system where the CICS/VSAM ECCR runs, change data capture problems can occur if the CICS/VSAM CDC exit programs get control in the improper order. For more information, see the
    PowerExchange CDC Guide for z/OS
    .

0 COMMENTS

We’d like to hear from you!