Capture service

The capture service is assigned to the CAP service class. The task name for the CAP service class is CECCAP.

The capture service manages change data capture. Those operations include management of the log reader service, change streams, and communication with the target server.

The log reader service reports stream-related errors to the capture service that initiates end-of-replication for the affected subscriptions. The log reader service can also report other types of errors such as Classic data server or non-stream related errors that end replication for all active subscriptions and cause the capture service to stop.

Restriction: Only a single service of service class CAP can be configured in a single Classic data server. A single instance of this service runs in the address space of a Classic data server.
The following table lists the configuration parameters that apply to the CAP service class.
Table 1. Configuration parameters for the CAP service class
Parameter Default value Description  
APPLYBUFFERSIZE 252K Size of the buffer that Data Replication for VSAM uses to send changes from the source server to the target server.  
BOOKMARKQUEUE* None Name of the MQ local queue that stores restart information for use in delimited publishing.  
CACHEINDICATOR 2 Controls what kind of memory is used by the capture cache.  
COLDELIMITER* , Defines the character to use for delimiting columns.  
COMMITINTERVAL 500 MS Defines how often delimited format messages should be committed to MQ.  
CONNECTRETRYLMT 0 The maximum number of times that the capture service tries to connect to the target server to restart replication for a persistent subscription before giving up.  
CSDATAVALIDATEAC* 0 Invalid data handling: 0 (no validation), 1 (repair), or 2 (repair and report)  
CSREPORTLOGCOUNT* 0 Limit for the number of messages logged when CSDATAVALIDATEAC = 2.  
HEARTBEATTIMEOUT 15M The interval at which the source sends heartbeat messages to detect communication problems during periods of inactivity in replication for a subscription.  
IMSJCFOPTIONS* 0

Allows you to control the information that is populated in the journal control fields that are sent to a CDC target engine when capturing IMS changes.

 
IMSRECID* none IMS table identification exit.  
IMSRECSELECT* none Record selection exit to define criteria for accepting, rejecting or changing contents of records for IMS tables.  
PUBBDACTION* TRUE Identifies the action for the capture service to take when badly formed data is encountered. The action controls whether replication for a subscription continues or stops.  
PUBBDCOMPAT* 0 Identifies product compatiblity options for the format in which badly formed data is published.  
PUBBDDIAGLIMIT* 100 Controls the number of diagnostic messages generated when badly formed data is encountered.  
PUBBDWTOLIMIT* 1000 Controls the number of CACJ080W messages generated when badly formed data is encountered.  
PUBUTF8* FALSE Identifies whether delimited messages are published in the host code page or converted to UTF-8 before writing to MQ.  
QUEUEMGRNAME* CHAR(4) Name of the MQ queue manager that is used for delimited publishing  
ROWDELIMITER* /n Defines the character to use for delimiting rows.  
SEQUENCE 0 Sequence number assigned to services  
STREAMMGRDELAY 0H Time to delay change stream assignment to help group multiple subscriptions on a change stream.  
STRINGDELIMITER* " Defines the character to use for delimiting strings.  
TIMEZONE* Atlantic/Reykjavik The Olson database name for the time zone of the source server  
TRACELEVEL 4 Trace level  
UORDISCARDOPT 0 (stop server) Identifies the action to be taken if the capture service detects a regression in the commit timestamp when source UOR changes are being discarded.  
UORGROUPCOUNT 1 The number of messages to group into a common unit of recovery (UOR) during replication.  
VSAMRECID* none VSAM table identification exit  
VSAMRECSELECT* none Record selection exit to define criteria for accepting, rejecting or changing contents of records for VSAM tables.  
* The CSDATAVALIDATEAC, CSREPORTLOGCOUNT, BOOKMARKQUEUE, COLDELIMITER, IMSJCFOPTIONS, IMSRECID, IMSRECSELECT, PUBBDACTION, PUBBDCOMPAT, PUBBDDIAGLIMIT, PUBBDWTOLIMIT, PUBUTF8, QUEUEMGRNAME, ROWDELIMITER, STRINGDELIMITER, VSAMRECID, VSAMRECSELECT, and TIMEZONE parameters do not apply to Data Replication for VSAM.