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.