Automatic and manual log of logs scanning

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. The LOLSCAN function can be specified in one of three ways.
  1. As a CICSVR_GENERAL_CONTROL parameter in the active IGDSMSxx member of SYS1.PARMLIB, where it takes effect during system initialization.
  2. In the SETSMS CICSVR_GENERAL_CONTROL operator command, where it takes effect immediately.
  3. Using the "CICS VR panel interface", see Setting CICS VR server address space defaults.
For more information, see Defining a CICS VR general control parameter.

Manual log of logs scanning

The log of logs scan can be run manually, when required. The SCAN function can be specified in one of three ways.
  1. As a CICSVR_GENERAL_CONTROL parameter in the active IGDSMSxx member of SYS1.PARMLIB, where it takes effect during system initialization.
  2. In the SETSMS CICSVR_GENERAL_CONTROL operator command, where it takes effect immediately.
  3. Using the "CICS VR panel interface", see Setting CICS VR server address space defaults.
For more information, see Defining a CICS VR general control parameter.

Log of logs scan JCL skeleton

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 Figure 1. Edit the JOB statement in the log of logs scan JCL skeleton to conform to the environment standards. 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-Y24              DWWARSCA                                   */
//*                                                                  */
//* Copyright IBM Corp. 2012                                         */
//* @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)