Table of Contents

Search

  1. Preface
  2. Part 1: PowerExchange Change Data Capture Introduction
  3. Part 2: CDC Components Configuration and Management
  4. Part 3: CDC Sources Configuration and Management
  5. Part 4: Change Data Extraction
  6. Part 5: Monitoring and Tuning
  7. Appendix A: CDC for z/OS Troubleshooting
  8. Appendix B: DTL__CAPXTIMESTAMP Time Stamps

Activating the IMS Synchronous ECCR

Activating the IMS Synchronous ECCR

You must activate the IMS synchronous ECCR to capture changes.
Before you activate the IMS synchronous ECCR, complete configuration of the IMS DBRC and IMS region JCL and activate the capture registrations.
If you activate the ECCR and open a database before you activate the capture registrations, you must close the database by using the IMS DBR command and then reopen it by using the IMS START command to capture changes.
The IMS synchronous ECCR is activated in IMS regions that contain the PowerExchange modules in the STEPLIB concatenation. You can prevent the ECCR from capturing changes for a specific job or region by adding the following DD statement to the JCL:
//EDMNOCAP DD DUMMY
  1. Start the PowerExchange Listener, PowerExchange Agent, and the PowerExchange Logger for z/OS tasks. These tasks must be active before the IMS subsystem is started. Otherwise, no change data is captured.
  2. Start the IMS external subsystem, if necessary. Normally, IMS starts the subsystem when the DB/DC or DBCTL region is started.
    During initialization of the IMS subsystem, the IMS synchronous ECCR starts and generates a report that begins with message PWXEDM172852I in the EDMMSG data set. The report lists the default options that are in effect. If the IMS synchronous ECCR is running in an online region, the report also contains allocation options for the DFSESL DD statement.
  3. To verify that the IMS synchronous ECCR is active, check the system messages.
    The following messages are issued when using the PowerExchange
    hlq
    .CRG.LOAD library. The messages differ slightly if you use the BMC Software IMS tools instead of the CRG library.
    • In the DBRC region, verify that the job log (JESMGLG) contains the following messages:
      BMC2700I NO VALID DBI PASSWORD FOUND DFS3613I - DRC TCB INITIALIZATION COMPLETE
      imsid
      The variable
      imsid
      is the IMS subsystem name.
      Message BMC44001I indicates that the DBRC modification that the IMS synchronous ECCR requires is installed.
    • In the IMS control region, verify that the job log (JESMSGLG) contains the following messages:
      *DFS0800I AWAITING NOTIFICATION FROM SUBSYS
      ssid
      imsid
      BMC250011I CRF V5100 RSL2307 04/07/23 INITIALIZATION COMPLETED, RC=0, RSN=00000000 PWXEDM172820I Change Capture initialized for IMS Online on
      imsid
      Vvv.r.m
      function level
      function_level
      F
      ims_job
      ,SSNOT
      imsid_ssid
      BMC90489I CHANGE RECORDING FACILITY INITIALIZATION COMPLETED
      The variable
      ssid
      is the IMS external subsystem and
      imsid
      is the IMS subsystem name.
      Message BMC250011I indicates the BMC AMI Online Reorg for IMS (formerly the CHANGE RECORDING FACILITY (, or CRF) product, which the IMS synchronous ECCR requires, has initialized. PowerExchange generates the MVS MODIFY command after CRF activation to notify IMS that the external subsystem is active and ready to connect. If message "BMC90489W CHANGE RECORDING FACILITY COMPONENT NOT INSTALLED" appears, instead of BMC90489I, you can ignore it.
    The following sample messages in the EDMMSG SYSOUT data set indicate that the IMS synchronous ECCR completed initialization and successfully connected to the PowerExchange Logger:
    PWXEDM172852I Options in effect: Load Library containing EDMSDIR. . . . . :
    HLQ
    .USERLIB EDMSDIR assembly date/time . . . . . . . : 20090513 16.46 PWX-EDP Rollup . . . . . . . . . . . . . : V1055_B03_20231009 Product distribution date. . . . . . . . : 20180621 Agent Id . . . . . . . . . . . . . . . . : AG2A Logger Id. . . . . . . . . . . . . . . . : LG2A 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 'LG2L' as member 'EDMA' PWXEDM172841I EDM ECCR EDMA connected to EDM Logger LG2L, Log RBA=X'0000001CBF6A0000'

0 COMMENTS

We’d like to hear from you!