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.
Format

>>-LOGOFLOGS----SCAN-------------------------------------------->
>--+--------------------------------------+--------------------->
| .-,--------------------. |
| V | |
'-NAME--(------log of logs name---+--)-'
>--+--------------------------+--------------------------------->
'-AUTODEREG--(--+-YES-+--)-'
'-NO--'
>--+-------------------------------+---------------------------><
| .-YES-. |
'-RECOVERYREPORT--(--+-NO--+--)-'
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)
- 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. If
the NAME keyword has not been specified, the default value is YES.
If the NAME keyword has been specified, the default value is NO.
- NO
- Specifies that automatic deregistration must not be started.
If the NAME keyword has not been specified, the default value is YES.
If the NAME keyword has been specified, the default value is NO.
Note: AUTODEREG is an optional keyword. The default
value is determined by the presence or absence of the optional NAME
keyword.
- 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.
Format

>>-LOGOFLOGS--+----------------------------------+-------------->
'-REGISTER--(--log of logs name--)-'
>--+------------------------------------+----------------------><
'-DEREGISTER--(--log of logs name--)-'
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.
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 SynonymsCommand, keyword or value |
Synonyms |
LOGOFLOGS |
LOL |
RECOVERYREPORT |
RECREP |
AUTODEREG |
DEREG |
REGISTER |
REG |
DEREGISTER |
DEREG |