Within the CICS® VR
server address space, the log of logs scan utility can take place
automatically, or when started manually.
The log of logs scan utility scans all the log of logs that are
registered in the RCDS. Information is gathered for recovery, and
the RCDS is updated with this information. If a scan has not run recently,
it might take some time to finish the forward recovery. It is helpful
to set up a scan as a batch job that can be run at regularly scheduled
times to keep the RCDS as up-to-date as possible.
CICS® VR can run the log
of logs scan automatically, at regularly scheduled times. CICS® VR can also run the log of
logs scan manually, at more convenient times.
Automatic log of logs scanning
The log of
logs scan can be run automatically at regularly scheduled times, once
a day. If specified, the first automatic log of logs scan starts twenty-four
hours after the CICS® VR server
is activated. The LOLSCAN function can be specified in one of three
ways.
As a CICSVR_GENERAL_CONTROL parameter in the active IGDSMSxx member
of SYS1.PARMLIB, where it takes effect during system initialization.
In the SETSMS CICSVR_GENERAL_CONTROL operator command, the CICS® VR address space is notified
immediately to refresh control defaults. The first automatic log of
logs scan starts twenty-four hours after the CICS® VR is activated and continues to run every
twenty-four hours.
(OR)
Use CICS VR Panel to customize log of log scan schedule. For more information, see
Automatic log of log scan schedule in the User Guide.
CICS® VR uses a customized version of the log
of logs scan JCL skeleton to run the log of logs scan at regularly
scheduled times and to run the scan manually at convenient times.
The skeleton is located in member DWWARSCA of the CICS® VR library SDWWCNTL. An example is shown
in Log of logs scan JCL skeleton.
Modify the log of logs scan JCL skeleton to conform to the environment standards
by commenting out JOB statement, symbolic parameters and keep “LOGOFLOGS SCAN” command in DWWIN.
Copy the updated DWWARSCA member into
PROCLIB library. If RACF® or
a similar security product is in place, define the DWWARSCA started
task to RACF® and assign it
to a user ID with the appropriate authorization to browse the output
of the log of logs scan job.Figure 1. Log of logs scan JCL skeleton
//DWWARSCA JOB (ACCOUNT),MSGLEVEL=(1,1),MSGCLASS=H,REGION=4M
//********************************************************************/
//* */
//* @BANNER_START */
//* Licensed Materials - Property of IBM */
//* */
//* 5655-GY1 DWWARSCA */
//* */
//* Copyright IBM Corp. 2014 */
//* Copyright HCL Technologies Ltd. 2025 */
//* @BANNER_END */
//* */
//********************************************************************/
//* */
//* CHANGE ACTIVITY: */
//* */
//* $AL= CVR420 420 060914 KVV @ALA*/
//* LOG OF LOGS SCAN AUTOMATION @ALA*/
//* */
//********************************************************************/
//*
//* SET SYMBOLIC PARAMETERS
//*
//SETPREF SET PREF=DWW ! CICSVR RCDS NAME PREFIX
//SETSUFF SET SUFF=PROD ! CICSVR XCF GROUP NAME SUFFIX
//*
//SETDEREG SET DEREG=NO ! AUTOMATIC DEREGISTRATION
//SETREP SET REP=NO ! RECOVERY REPORT PRODUCING
//*
//* INVOKE CICSVR LOG OF LOGS SCAN UTILITY TO SCAN
//* ALL LOG OF LOGS THAT ARE REGISTERED IN RCDS
//* AND UPDATE RCDS WITH INFORMATION
//* FROM THOSE LOG OF LOGS
//*
//LOLSCAN EXEC PGM=DWWAR,PARM='AUTODEREG(&DEREG) RECOVERYREPORT(&REP)'
//DWWMSG DD SYSOUT=* ! MESSAGE DATA SET
//DWWPRINT DD SYSOUT=* ! REPORT DATA SET
//DWWCON1 DD DISP=SHR,DSN=&PREF..DWWCON1.GRP&SUFF ! RCDS DATA SET
//DWWCON2 DD DISP=SHR,DSN=&PREF..DWWCON2.GRP&SUFF ! RCDS DATA SET
//DWWCON3 DD DISP=SHR,DSN=&PREF..DWWCON3.GRP&SUFF ! RCDS DATA SET
//DWWIN DD * ! COMMAND DATA SET
LOGOFLOGS SCAN AUTODEREG(NO) RECOVERYREPORT(NO)