|
Prepare CDCzLog Publisher JCL |
Scroll |
Once the CDCzLog configuration CAB file has been created, JCL similar to sample member SQDZLOGC included in the distribution is used to Mount and optionally Start the CDCzLog Publisher Agent process.
//SQDZLOGC JOB 1,MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID
//*
//*--------------------------------------------------------------------
//* Execute zLOGC Publisher Agent for IMS or VSAM CDC
//*--------------------------------------------------------------------
//* Required parameters (lower case):
//* config_file - Specifies the fully qualified name of the
//* predefined IMS or VSAM Publisher agent CAB file
//* (see JCL members SQDCONIP or SQDCONVP)
//*--------------------------------------------------------------------
//* Optional parameters (lower case):
//* --apply - Specifies that ALL pending changes to the config (cab)
//* file should be applied before the Publisher Agent is
//* Started
//* ** NOTE - This is normally NOT used in this job
//* ** REMOVE if the status of pending changes is NOT
//* ** known. Instead use SQDCONF to apply changes
//*
//* --start - Instructs the Publisher Agent to Start processing
//* ** NOTE - This is often used in this job but can
//* ** be performed by a separate SQDCONF command
//*
//* --ziip - Instructs the Publisher to utilize zIIP engines for
//* LogStream reads and encryption (if specified in the
//* Publisher agent CAB file)
//*
//* --wait - Specifies the number of milliseconds to wait before
//* checking for more cdc data in the LogStream
//*
//*********************************************************************
//*
//JOBLIB DD DISP=SHR,DSN=SQDATA.V400.LOADLIB
//*
//SQDZLOGC EXEC PGM=SQDZLOGC,REGION=0M
//*XQDZLOGC EXEC PGM=XQDZLOGC,REGION=0M
//SQDPUBL DD DSN=SQDATA.NACL.PUBLIC,DISP=SHR
//SQDPKEY DD DSN=SQDATA.NACL.PRIVATE,DISP=SHR
//SYSPRINT DD SYSOUT=*
//SYSOUT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SQDLOG DD SYSOUT=*
//*SQDLOG8 DD DUMMY
//SQDPARMS DD *
--start --ziip --wait=100
/home/sqdata/vsampub1/VSAMPUB1.cab
//*
//
--apply --start --ziip --wait=100
--high-threshold=<seconds>
--low-threshold=<seconds>
/home/sqdata/imspub1/IMSPUB1.cab
//SQDLOGL DD *
*=2
*=8
OPTIONS=NET_ACTIVITY,
MESSAGE,
PARSE,
UOW,
TIME | TS,
Notes:
1.Precisely recommends zIIP processors be used to enhance CPU cycle efficiency and reduce CPU cost associated with LogStream I/O and NaCL software encryption.
2.The first time this Job is run you may choose to include both the --apply and --start commands. After the initial creation, --apply should not be used unless you want all changes made since the agent was last Stopped to take effect immediately upon the Start. The purpose of --apply is to make it possible to add/modify the configuration while preparing for an implementation of changes without affecting the current configuration. Note, --apply and --start can and frequently will be separated into different SQDATACONF jobs.
3.The Controller Daemon uses a Public / Private key mechanism to ensure component communications are valid and secure. While it is critical to use unique key pairs when communicating between platforms, it is common to use the same key pair for components running together on the same platform. Consequently, the key pair used by a CDCzLog Agent may be the same pair used by it's Controller Daemon.
4.--high-threshold and --low-threshold Display Capture Latency alerts (in seconds), in a WTO (write to operator) message on the console and system log. These parms may be specified either at runtime using SQDPARMS DD or using sqdconf modify.
SQDZ005W Latency for capture ( 274 sec.) is high
SQDZ006I Latency for capture is back to normal
5.The SQDLOGL parm OPTIONS=TIME | TS adds either the system Storeclock (STCK) in Miliseconds or it's human readable TimeStamp to all SQDLOG messages:
OPTIONS=TIME the system Storeclock in Miliseconds
3882279447104 [ MSGS] :SQDZLOGC 4.1.39-dev (zOS-370) ccsid:1047 - 0x21
3882279447104 [ MSGS] :Build-id:a93d3e38230049d11ebb7c229360042d7b098407
3882279447106 [ NET] :net_init_module
3882279447108 [ MESSAGE] :overload proc for type 0x20a0003(AGENT_MESSAGE_T_PING)
3882279447108 [ CNVFT] :cnvft_init_module <-- 0x0
3882279447109 [ MESSAGE] :overload proc for type 0x2020002(CDCCONF_MESSAGE_T_ACTION)
OPTIONS=TS
2023-01-09.14.33.14.748758 [ MSGS] :SQDZLOGC 4.1.39-rel (zOS-370) ccsid:1047 - 0x21
2023-01-09.14.33.14.749565 [ MSGS] :Build-id:a93d3e38230049d11ebb7c229360042d7b098407
2023-01-09.14.33.14.751236 [ NET] :net_init_module
2023-01-09.14.33.14.753076 [ MESSAGE] :overload proc for type 0x20a0003(AGENT_MESSAGE_T_PING)
2023-01-09.14.33.14.753076 [ CNVFT] :cnvft_init_module <-- 0x0
2023-01-09.14.33.14.753202 [ MESSAGE] :overload proc for type 0x2020002(CDCCONF_MESSAGE_T_ACTION)
