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.

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

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 that CICS VR writes the after-image log records to 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, then defined to CICS VR. See CICS VR undo logging for more information.

ALL
Indicates that CICS VR forward recovery logging and undo logging is 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 is logged by batch logging.

If FRLOG(ALL) is specified, the name of the forward recovery log stream that CICS VR writes the after-image log records to must be specified in the LOGSTREAMID parameter of the catalog entry for the VSAM base cluster. Also, the undo log stream must be created, 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 be SMS-managed
    • 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:

Information Information

Feedback


Timestamp icon Last updated: Friday, 29 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///dwwig/enblog.html