End DPR Capture (ENDDPRCAP)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The End DPR Capture (ENDDPRCAP) command ends the DataPropagator for iSeries Capture process for registered source tables (both local and remote). The ENDDPRCAP command fails if the Capture process is not active, or if another request for the same ending type (*IMMED, *CNTRLD) is made.

You should run this command to end the Capture process before shutting down the system. Also, you might want to end the process during periods of peak system use to increase the performance of other programs running on the system.

Note: The ENDDPRCAP command may take a longer time to end the Capture process when the *CNTRLD option is specified. This is because the Capture process completes all of its subordinate processes before ending.

Note: If you use the ENDJOB command, temporary objects might be left in the QDP4 library. These objects have the types *DTAQ and are named QDPRnnnnnn where nnnnnn is the job number of the job that used them. You can delete these objects when the job that used them (identified by the job number in the object name) is not active.

Error Messages for ENDDPRCAP

*ESCAPE Messages

ASN2563
Capture instance is not active.
ASN2564
Capture instance is already ending with option .
ASN2565
Capture instance is ending with option .
Top

Parameters

Keyword Description Choices Notes
OPTION How to end *CNTRLD, *IMMED Optional, Positional 1
CAPCTLLIB Capture control library Name, ASN Optional, Positional 2
RGZCTLTBL Reorganize control tables *NO, *YES Optional, Positional 3
Top

How to end (OPTION)

Specifies how to end the Capture process.

*CNTRLD
The Capture process completes all of its tasks and then ends normally.
*IMMED
The Capture process completes all of its tasks with the ENDJOB OPTION(*IMMED) command and ends normally.
Top

Capture control library (CAPCTLLIB)

Specifies the name of the Capture Instance to end.

ASN
Specifies the default capture instance provided with the DataPropagator product for iSeries and defined as a first capture instance.
capture-instance-name
Specifies the library where the capture control tables resides.
Top

Reorganize control tables (REZCTLTBL)

Specifies whether to do Reorganize Physical File Member (RGZPFM) on the control tables which includes CD and UOW tables when ending Capture. After pruning, disk space is not recovered unless RGZPFM is performed on the table. Provided this will be done only when ENDDPRCAP gets exclusive lock on the CD tables.

*NO (default)
Specifies that RGZPFM is not performed.
*YES
Specifies that RGZPFM will be performed. Allowed only for OPTION(*CNTRLD).
Top

Examples

None
Top

Error messages

*ESCAPE Messages

ASN2563
Capture instance is not active.
ASN2564
Capture instance is already ending with option .
ASN2565
Capture instance is ending with option .
Top