Enabling CICS VR VSAM batch logging

To enable CICS® VR VSAM batch logging for a VSAM sphere, you must update the FRLOG parameter in the ICF catalog definition of the base cluster to an appropriate value.

The FRLOG parameter can contain one of the following values:
FRLOG(value)
NULL
Indicates the data set is not eligible for VSAM batch logging. Changes made to the data set by batch applications are not logged by batch logging.

If the FRLOG parameter is omitted when the data set is defined, a value of NULL is assumed.

NONE
Indicates the data set is eligible for VSAM batch logging, but batch logging is currently disabled for the VSAM data set. Changes made to the data set by batch applications are not logged by batch logging. However, if LOGREPLICATE and FRLOG(NONE) are specified, batch replication logging is performed for the VSAM sphere.

If FRLOG(NONE) is specified, the data set must conform to the listed VSAM batch logging restrictions.

REDO
Indicates that CICS VR forward recovery logging is enabled for the VSAM data set. An after-image log record for every update made to the data set by batch jobs is logged by batch logging.

If FRLOG(REDO) is specified, the name of the forward recovery log stream to which CICS VR writes the after-image log records must be specified in the LOGSTREAMID parameter of the catalog entry for the VSAM base cluster.

UNDO
Indicates that CICS VR undo logging is enabled for the VSAM data set. A before-image log record for every update made to the data set by batch jobs is logged by batch logging.

If FRLOG(UNDO) is specified, the undo log stream must be created and then defined to CICS VR. See CICS VR undo logging for more information.

ALL
Indicates that CICS VR forward recovery logging and undo logging are enabled for the VSAM data set. An after-image log record and a before-image log record for every update made to the VSAM data set by batch jobs are logged by batch logging.

If FRLOG(ALL) is specified, the name of the forward recovery log stream to which CICS VR writes the after-image log records must be specified in the LOGSTREAMID parameter of the catalog entry for the VSAM base cluster. Also, the undo log stream must be created and then defined to CICS VR. See CICS VR undo logging for more information.

Restrictions:
  • A VSAM data set that is eligible for batch logging (FRLOG NONE, REDO, UNDO, or ALL) must meet the following conditions:
    • The data set must be SMS-managed.
    • The data set cannot be LINEAR, KEYRANGE, or a temporary data set.
  • Batch logging cannot be performed when the VSAM data set is empty.
  • CICS VR VSAM batch logging provides logging for non-RLS data sets. The VSAM data sets must be opened with the ACB setting MACRF=NSR or LSR or GSR. The RLS JCL parameter must not be set.
There are five different ways that you can enable CICS VR VSAM batch logging:
  • Using the ISMF Data Class Define panel
  • Using the NaviQuest batch job to define a data class
  • Using IDCAMS DEFINE CLUSTER
  • Using IDCAMS ALTER
  • Using the AMP JCL DD parameter