Tag - 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-11-25
Published on
2024-11-25T15:17:45.575795

Injects a User "Message" into a zOS System Logstream. Tag can be useful for indicating the "End of a Process" or any other condition that might be useful to a subscribing Apply Engine.

The "Message" can be only 80 bytes in length and cannot be identified by the engine using a CASE statement or any other construct. It therefore cannot be used to control any processing in the engine. It only results in the "Message" being written to Standard Out.

Syntax

sqdutil tag zlog:///<logstream_name> -m "<message>"

Keyword and Parameter Descriptions
Keyword Description
zlog:///<logstream_name> Must be a valid zOS logstream.
<message> Text string that will be written to Standard Out.

Example 1

Insert a message into a zOS logstream indicating the End of an IMS Unload utility execution.
//IMSPROC  JCLLIB ORDER=&IMSPROC                                      
//*                                                                    
//SQDIMSU  EXEC PROC=DLIBMPD,SOUT='*',MBR=SQDIMSU,PSB=&PSB,IMSID=&SSID
//DFSSTAT  DD SYSOUT=*                                                
//PRINTDD  DD SYSOUT=*                                                
//SYSPRINT DD SYSOUT=*                                                
//SYSOUT   DD SYSOUT=*                                                
//SQDLOG   DD SYSOUT=*                                                
//*SQDLOG  DD DUMMY                                                    
//*                                                                    
//DBDSRC   DD DISP=SHR,DSN=&DBDSRC(&DBDMEM)                            
//SQDPARMS DD *                                                        
--database=IVPDB2                                                      
--dbd=DD:DBDSRC                                                        
--zlog=SQDATA.IMSCDC.LOG1                                              
/*                        
sqdutil copy cdc://ZOS10:2626/DB2CDC/ENGINE1 /home/sqdata/db2out.dat --uow --max=3 --wait=10
//SQDUTIL  JOB 1,MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID
/*JOBPARM L=300,S=ZOS3                                    
//*                                                      
//*-------------------------------------------------------
//JOBLIB   DD DISP=SHR,DSN=WWCMJM.SQDATA.V4PROD.LOADLIB  
//*                                                      
//SQDUTIL  EXEC PGM=SQDUTIL                              
//SQDPUBL  DD DSN=WWCMJM.NACL.PUBLIC,DISP=SHR            
//SQDPKEY  DD DSN=WWCMJM.NACL.PRIVATE,DISP=SHR            
//SQDPARMS DD *                                          
tag -m 'Tag from ZOS3' zlog:///WWCMJM.IMSCDC.LOG          
//SYSPRINT DD SYSOUT=*                                    
//SYSOUT   DD SYSOUT=*                                    
//SQDLOG   DD SYSOUT=*
Note: The file target can also be specified using URL syntax, file:///db2out.dat indicating in this example the current working directory.