MVSLOG: Specify an MVS™ Log Stream

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

Format

MVSLOG { CATALOG | 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 synonyms
Command or keyword	Synonyms
CATALOG	CAT, CTLG