Use the MVSLOG command to specify the name of an MVS™ log
stream to CICS® VR.
Format

.-CATALOG---------------------.
>>-MVSLOG--+-NAME--(--log stream name--)-+---------------------><
+-COPY------------------------+
'-CA--------------------------'
Keywords
- CATALOG
- Specifies
that the MVS log stream name must be obtained from the MVS catalog.
All data sets to be recovered in one step must have the same MVS log
stream name. The CATALOG keyword is the default.
- NAME(log stream name)
- Identifies
the data set name of the MVS log stream for this recovery
step.
- log stream name
- Specifies the name of the MVS log stream. The name is 1–26
characters. The NAME keyword is optional.
- COPY
- Indicates
that the logs specified as input by the CICS VR
ALLOCATE command, or the logs specified by the DWWLOG ddname, are
QSAM copies of MVS log streams. The COPY keyword is optional.
- CA
- Specifies
that CICS VR must use only the change accumulation
data sets specified in the DWWLOG DD statement during forward recovery
processing of the specified VSAM spheres.
Usage Notes
Consider
these points when using the MVSLOG command:
- You can specify only one MVSLOG command in a single recovery step.
The MVS log stream you specify must contain all relevant
records for all data sets to be recovered in this step.
- If you switch between a CICS log and an MVS log
stream, you must process these different log types in separate CICS VR
job steps.
- You can specify an active MVS log
stream or a QSAM copy of an MVS log stream in the MVSLOG command.
If you specify a QSAM copy, the data set name of the copy must be
specified in either the CICS VR ALLOCATE command, or by
the DWWLOG ddname.
- If the CA keyword is specified, one or more change
accumulation data sets must be listed in the DWWLOG DD statement of
the recovery job JCL.
- The CA keyword can only be specified when the
RECOVER command also is specified.
- If the CA keyword is specified, CICS VR
ignores the APPLYCA keyword of the RECOVER command if it also is specified.
- The name of the relevant undo log stream must be specified in
the MVSLOG NAME() command for a batch backout job that specifies RCDS(NO).
Examples
MVSLOG CATALOG 1
MVSLOG NAME(SYSA.MVSLOG1) 2
MVSLOG COPY 3
MVSLOG CA 4
Here is an explanation of each of these MVSLOG commands:
- 1
- The name of the MVS log stream for this CICS VR
step must be obtained from the MVS catalog.
- 2
- The name of the MVS log stream for this CICS VR
recovery step is SYSA.MVSLOG1.
- 3
- The MVS log stream specified for this CICS VR
step is a QSAM copy of an MVS log stream. The name of the QSAM
copy is specified in either the CICS VR
ALLOCATE command, or by the DWWLOG ddname.
- 4
- Only change accumulation data sets specified in the DWWLOG statement
of the recovery job JCL must be used during forward recovery processing
of the specified VSAM spheres.
Synonyms
The
MVSLOG synonyms table provides the MVSLOG commands or keywords along
with acceptable synonyms that can be used in place of the commands
or keyword:
Table 1. MVSLOG synonymsCommand or keyword |
Synonyms |
CATALOG |
CAT, CTLG |