Refreshes the list of IMS segments with active capture registrations that the IMS log-based ECCR uses to capture change data.
Issue this command in the following situations to update the list of registered sources without shutting down the ECCR:
After you add a capture registration.
After you delete a capture registration.
After you issue a PWXUCREG utility command that changes the registration status, such as the SUSPEND_REGISTRATION or ACTIVATE_REGISTRATION command. For more information, see the
PowerExchange Utilities Guide
.
To use this command, you must specify REFRESH_ALLOWED=Y in the RUNLIB(CAPTIMS) member to which the DTLCACFG DD statement in the ECCR JCL points.
When you issue the command, the ECCR begins shutdown processing but does not end. The ECCR rebuilds the list of registered sources and initiates a special warm start. The ECCR reprocesses any UOWs that were open when the command was issued, beginning with the earliest open UOW. After the ECCR has reprocessed all of the open UOWs up to the current log read position, it resumes normal processing.
Syntax
Use the following command syntax:
F
eccr_task_name
,REFRESH
The
eccr_task_name
variable is the name of the IMS log-based ECCR job or started task.
Usage Notes
For a REFRESH operation, the ECCR reprocesses all of the open UOWs so that it can capture data for any registration that was added or avoid capturing data for any registration that was deleted.
For each registration that you add, you can control the point from which change capture begins for the new source. Before you issue the REFRESH command, stop change activity on the source, add the registration, and synchronize the source and target. Then issue REFRESH command and resume change activity on the source.
For each registration that you delete, ensure that all in-flight changes have been captured and that extraction processing has caught up to the current ECCR position of the SLDSs before you issue the REFRESH command.