LOGOFLOGS: Process a log of logs

Use the LOGOFLOGS command to scan a CICS® TS log of logs, register the VSAM spheres in the RCDS, and store other essential recovery information in the RCDS.

See Defining the log of logs for a description of the information in a log of logs.

Format

Read syntax diagramSkip visual syntax diagram LOGOFLOGS SCANNAME(,log of logs name)AUTODEREG(YESNORCDSONLY)RECOVERYREPORT(YESNO)ALL31

Keywords

SCAN
Scans all log of logs that are registered in the RCDS and updates the RCDS with the information from those log of logs.
NAME(log of logs name)
Specifies that only the listed log of logs must be scanned. The NAME keyword is optional. If the NAME keyword is not specified, all of the log of logs registered to CICS VR is scanned. The NAME keyword is only valid when the SCAN keyword is specified on the LOGOFLOGS command.
(log of logs name)
Specifies the name of the log of logs to be scanned. Up to 256 log of logs names can be specified. Each listed log of logs name must be registered to CICS VR.
AUTODEREG(YES | NO | RCDSONLY)
Specifies if the automatic deregistration function must be started. The automatic deregistration parameters must be set in the CICS VR dialog if you want automatic deregistration of RCDS entries that are older than the specified retention criteria.
YES
Specifies that automatic deregistration is to be started.
NO
Specifies that automatic deregistration must not be started.
RCDSONLY
Specifies that the automatic deregistration is to be started, but MVS log blocks will not be deleted.
Note: AUTODEREG is an optional keyword. The default value is determined by the presence or absence of the optional NAME keyword. If the NAME keyword has not been specified the default value is YES. If the NAME keyword is specified the default value is NO.
RECOVERYREPORT(YES | NO)
Specifies if the recovery report must be printed. The RECOVERYREPORT keyword is only valid when the SCAN keyword is specified on the LOGOFLOGS command.
NO
Specifies no report is required.
YES
Specifies that a recovery report is produced for all the spheres on all the log of logs that are also registered in the RCDS. The report contains all the changes to the spheres since the last LOGOFLOGS SCAN was run. Yes is the default value.
ALL31
This is an optional parameter. It specifies that the report utility can carve memory up to the bar i.e., up to 2GB storage to generate the report. It’s recommended using this parameter to avoid S878 abend during the process.

Format

Read syntax diagramSkip visual syntax diagram LOGOFLOGS REGISTER(log of logs name)DEREGISTER(log of logs name)
Read syntax diagramSkip visual syntax diagramRECOVERYREPORT(YESNO)ALL31

Keywords

REGISTER(log of logs name)
Registers a log of logs in the RCDS
log of logs name
Is the name of the log of logs. The name is 1–26 characters.
DEREGISTER(log of logs name)
Deregisters the log of logs from the RCDS. DEREGISTER removes all information about the log of logs from the RCDS.
log of logs name
Is the name of the log of logs. The name is 1–26 characters.
ALL31
This is an optional parameter, specifies the report utility can carve memory up to the bar i.e., up to 2GB storage to generate the report. It’s recommended using this parameter to avoid S878 abend during the process.

Usage Notes

Consider these points when using the LOGOFLOGS command:

  • The LOGOFLOGS command is started by the CICS VR module DWWAR. Each time that scan is run, CICS VR begins at the point in which the last scan ended.
  • Never run scan at your disaster recovery site unless your disaster recovery site has been converted to your primary site and CICS is actively running and recording open and close information in the log of logs.
  • You can also process a log of logs using the ISPF dialog interface. For more information about processing the log of logs using the ISPF dialog interface, refer to CICS VR User's Guide.
  • For more information about log of logs, see Defining the log of logs.
  • To keep your RCDS up-to-date, set up a batch log of logs scan job so that it is submitted regularly with a production planning system, such as Tivoli® Workload Scheduler for z/OS®. See Setting up the log of logs scan utility (scan) for more information on log of logs scan.
  • You must register a log of logs in the RCDS the first time it is used by CICS VR. You can register, or deregister, log of logs entries in the RCDS through the ISPF dialog interface or through a batch job.
  • If the log of logs is switched to another log stream, ensure that you have completed the scan on all the records in the previous log stream before you change the scan to run on the new log stream. If the scan is not completed on the previous log stream, log record changes might be skipped on VSAM data set forward recovery.

Examples

LOGOFLOGS SCAN                                  1
LOGOFLOGS SCAN AUTODEREG(NO)     -            2
          RECOVERYREPORT(YES)
LOGOFLOGS SCAN NAME(LOGOFLOG.J01,LOGOFLOG.J02)     3

Here is an explanation of each of these LOGOFLOGS commands:

1
Scan all the log of logs that are registered in the RCDS.
2
Scan all the log of logs registered in the RCDS. Because AUTODEREG is set to NO, CICS VR automatic deregistration does not occur. A recovery report is produced for all the log of logs that are scanned and registered in the RCDS.
3
Only the LOGOFLOG.J01 and LOGOFLOG.J02 log of logs is scanned.

Synonyms

The LOGOFLOGS Synonyms table provides LOGOFLOGS commands or keywords along with acceptable synonyms to use in place of the commands or keywords:

Table 1. LOGOFLOGS Synonyms
Command, keyword or value Synonyms
LOGOFLOGS LOL
RECOVERYREPORT RECREP
AUTODEREG DEREG
REGISTER REG
DEREGISTER DEREG