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:
- Using ISMF Data Class Define panel
- Using NaviQuest batch job to define a data class
- Using IDCAMS DEFINE CLUSTER
- Using IDCAMS ALTER
- Using the AMP JCL DD parameter