Clean - connect_cdc_sqdata - Latest

Connect CDC (SQData) Utilities

Product type
Software
Portfolio
Integrate
Product family
Connect
Product
Connect > Connect CDC (SQData)
Version
Latest
Language
English
Product name
Connect CDC (SQData)
Title
Connect CDC (SQData) Utilities
Copyright
2024
First publish date
2000
Last updated
2024-07-30
Published on
2024-07-30T19:47:43.164598

Clean, meaning remove data from a z/OS LogStream source URL only. The action is destructive, the source records are permanently removed from the source.

Syntax

sqdutil clean zlog:///<logstream_name> [options]

Keyword and Parameter Descriptions
Keyword Description
zlog:///<logstream_name> The source URL for the z/OS LogStream to be cleaned.
Note: The logstream_name must not be enclosed in single or double quotes.
[options]
  • --bid=0x<bid_value> - Deletes all records with a Block ID (bid) lower than the value specified in <bid_value>.

  • --stck=0x<stck_value> - Deletes all log records with a Storeclock (STCK) lower than the value specified in <stck_value>.
  • --all - Deletes all log records from a logstream.
Warning: Use caution when running sqdutil clean to delete records from a z/OS LogStream. Cleaning records from an active LogStream (i.e. one being monitored by a publisher) may cause the publisher to terminate abnormally. You may also want to avoid cleaning CICS forward recovery logs unless they are only being used for changed data capture and not actual recovery purposes.
Warning: SQDutil knows nothing about the content of the LogStream specified. It can clean any LogStream the user has write access to, including possibly a VSAM forward recovery log or even a system zlog.

Example 1

Delete all of the records in z/OS LogStream SQDATA.VSAMCDC.LOGn
//SQDUTIL  EXEC PGM=SQDUTIL                                          
//SQDPUBL  DD DSN=&SYSUID.NACL.PUBLIC,DISP=SHR                      
//SQDPKEY  DD DSN=&SYSUID.NACL.PRIVATE,DISP=SHR                      
//SYSPRINT DD SYSOUT=*                                              \
//SYSOUT   DD SYSOUT=*                                              
//SQDPARMS DD *                                                      
clean zlog:///SQDATA.VSAMCDC.LOGn --all
/*
//

Example 2

Delete z/OS LogStream records that have an IMS Storeclock (STCK) value less than or equal to 0xd381de8e8b5ebbc0
//SQDUTIL  EXEC PGM=SQDUTIL                                          
//SQDPUBL  DD DSN=&SYSUID.NACL.PUBLIC,DISP=SHR                      
//SQDPKEY  DD DSN=&SYSUID.NACL.PRIVATE,DISP=SHR                      
//SYSPRINT DD SYSOUT=*                                              
//SYSOUT   DD SYSOUT=*                                              
//SQDPARMS DD *    
clean zlog:///SQDATA.IMSCDC.LOGn --stck=0xd381de8e8b5ebbc0
/*
//