Hi, I'm Bolo!
What would you like to know?
ASK BOLOPreview
Please to access Bolo.

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 MVS 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:
10/28/15 E D M M E S S A G E L O G PAGE 1 20:19:04.66 L O G S T A R T 20:19:04.64 PWXEDM172852I Options in effect: 20:19:04.64 Load Library containing EDMSDIR. . . . . : INFA9.PWX.V100.A10L.USERLIB 20:19:04.64 EDMSDIR assembly date/time . . . . . . . : 20151008 15.53 20:19:04.64 Product distribution date. . . . . . . . : 20151014 20:19:04.64 Product distribution level . . . . . . . : 2.4.05 20:19:04.64 Agent Id . . . . . . . . . . . . . . . . : A10A 20:19:04.64 Logger Id. . . . . . . . . . . . . . . . : A10L 20:19:04.64 SYSOUT class . . . . . . . . . . . . . . : * 20:19:04.64 Action if ECCR error encountered . . . . : Continue 20:19:04.64 PWXEDM172886I The following Load Module replacements have been installed: ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+----0 $$+$$$$+$$$$$$$$$$$$$$$$$$$$$$+$+$$$$+$$$$$$$$$$+$$$$$$$$$$$$$$$$$+$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+$$$ 101---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8----+----9----+----0 $$$$$$$$$$$$$$+$$$$$$$$$$$$+$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$+$+++++++++++++++++++ 201---+----1----+----2----+----3----+----4----+----5----+- + +++++++++++++++++++++++++++++++++++++++++++++++ ++++++ 20:19:04.73 PWXEDM172818I Joined XCF group 'A10L' as member 'ECCRCT41' 20:19:04.82 PWXEDM172841I EDM ECCR ECCRCT41 connected to EDM Logger A10L, Log RBA=X'0000019DC70B0000' 20:19:04.89 PWXEDM172820I Change Capture initialized for CICS/VSAM on CICS/TS V4.1.0 20:19:05.08 PWXEDM172808I Change Capture active for VSAM file EDM.ABC.EDMVES05 20:19:05.08 Edition=C4E3D30000000001, EDMNAME=VSAMEDM.ABC.EDMVES05 20:19:05.08 PWXEDM172808I Change Capture active for VSAM file EDM.ABC.EDMVKS04 20:19:05.08 Edition=C4E3D30000000001, EDMNAME=VSAMEDM.ABC.EDMVKS04 20:19:05.08 PWXEDM172808I Change Capture active for VSAM file EDM.ABC.EDMVRS04 20:19:05.08 Edition=C4E3D30000000001, EDMNAME=VSAMEDM.ABC.EDMVRS04 20:19:05.08 PWXEDM172808I Change Capture active for VSAM file EDM.ABC.EDMVRS07 20:19:05.08 Edition=C4E3D30000000001, EDMNAME=VSAMEDM.ABC.EDMVRS07

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!