CDC Guide for z/OS

10.5.3
- 10.5.8
- 10.5.6
- 10.5.5
- 10.5.4
- 10.5.2
- 10.5.1
- 10.5
- 10.4.1
- 10.4.0 HotFix 1
- 10.4.0

Back Next

Configuring the IMS Log-Based ECCR Parameters

Configure the IMS log-based ECCR parameters in the RUNLIB(CAPTIMS) member to which the DTLCACFG DD in the ECCR JCL points.

Based on your input during installation, the z/OS Installation Assistant adds values for some parameters to the CAPTIMS member. You can change these values if necessary.

The CAPTIMS member can contain the following parameters:

DBID=imsregn
DB_TYPE=IMS
ECCRNAME=IMSEC
[RECID=A0]
IMSID=(subsystem,dbd,
       RECON=(imsrecon1,
              imsrecon2,
              imsrecon3))
[NO_DATA_WAIT=seconds]
[NO_DATA_WAIT2=seconds]
[BYPASS_VERSION_CHECKING={Y|N}]
[CAPT_STATS={Y|N}]
[CAPT_STATS_INTVL=minutes]
[CAPT_STATS_TERSE={Y|N}]
[COLDSTART={Y|N}]
[ERROR_LOG={ABEND|SKIP|WAIT|WTOR|No response}]
[MSGLVL={0|1}]
[ON_SUSPENSION_ERROR_CONTINUE={N|Y}]
[REFRESH_ALLOWED={Y|N}]
[STARTTIME="YY/MM/DD hh:mm:ss[.nnnnnn]"]
[WRITE_RESTART_SECS=seconds]

The following table summarizes the IMS log-based ECCR parameters:

Parameter	Required or Optional	Description
DBID	Required	The RECON identifier that is specified in the registration group for the IMS source from which the ECCR captures changes. This parameter is customized by the z/OS Installation Assistant.
DB_TYPE	Required	The database type, which must be IMS.
ECCRNAME	Required	The ECCR name.
RECID	Optional	A hexadecimal value that corresponds to the record type of user-defined records that the DTLCUIML utility writes to the IMS SLDS. You can use these record IDs to define a start marker for the IMS log-based ECCR in the IMS SLDS.
IMSID	Required	The IMS subsystem ID, the DBDLIB data set, and the RECON data sets. This parameter is customized by the z/OS Installation Assistant.
NO_DATA_WAIT	Optional	The number of seconds that the ECCR waits after an end-of-log condition before starting the next log read. During the next read operation, if the ECCR receives another end-of-log condition without having processed new changes, the NO_DATA_WAIT_2 parameter takes effect. This parameter can be customized by the z/OS Installation Assistant.
NO_DATA_WAIT2	Optional	After the NO_DATA_WAIT interval is no longer in effect, the number of seconds that the ECCR waits after an end-of-log condition before trying another log read. The NO_DATA_WAIT2 wait and retry cycle remains in effect as long as no changes are received. This parameter can be customized by the z/OS Installation Assistant.
BYPASS_VERSION_CHECKING	Optional	Controls whether the ECCR checks that the IMS version matches the IMS version of the DBRC RECON data sets.
CAPT_STATS	Optional	Controls whether PowerExchange writes ECCR statistics messages to the DTLLOG and DTLOUT data sets and WTO messages to the system operator console when the IMS log-based ECCR finishes processing a SLDS.
CAPT_STATS_INTVL	Optional	The interval, in minutes, for which the IMS log-based ECCR collects and reports the number of inserts, deletes, updates, and commits that were captured. The ECCR also reports the log position up to which changes were processed.
CAPT_STATS_TERSE	Optional	Controls whether the IMS log-based ECCR prints PWX-06153 statistics messages only for registered sources for which the ECCR captured changes.
COLDSTART	Optional	Controls whether the ECCR cold starts or warm starts.
ERROR_LOG	Optional	Controls how the ECCR behaves when it encounters an IMS log in the RECON data set that is marked as in error or is otherwise unavailable.
MSGLVL	Optional	Controls whether PowerExchange issues detailed messages that indicate the status of ECCR processing of IMS logs that are recorded in the RECON data sets and that contain CDC statistics.
ON_SUSPENSION_ERROR_CONTINUE	Optional	If you use the PWXUCREG utility to suspend and reactivate capture registrations, controls whether the ECCR ends or continues when a UOW that contains change records to be discarded or captured started at an invalid point in the change stream relative to the suspension window.
REFRESH_ALLOWED	Optional	Controls whether you can use the REFRESH command after adding or deleting capture registrations or after suspending or reactivating capture registrations with the PWXUCREG utilty. The REFRESH command refreshes the list of registered IMS segments that the ECCR uses for change capture processing.
STARTTIME	Optional	The date and time when the ECCR starts processing change records from IMS logs after a cold start.
WRITE_RESTART_SECS	Optional	Controls how often, in seconds, a special restart UOW is written to the PowerExchange Logger when nothing of interest has occurred since the last special restart UOW was written.

If a parameter has a default value or is not required, it is marked as optional. A default value is the value that PowerExchange uses if the parameter is not defined. For some parameters, the

z/OS

Installation Assistant provides recommended values, which you can accept or change.

More detailed parameter descriptions follow.

Configuring the IMS Log-Based ECCR

BYPASS_VERSION_CHECKING Parameter

CAPT_STATS Parameter

CAPT_STATS_INTVL Parameter

CAPT_STATS_TERSE Parameter