Welcome
Working with logs
Setting automatic deregistration criteria
CICS® VR provides automatic deregistration to stop the RCDS from filling up. Periodically automatic deregistration removes outdated information from the RCDS, based on retention criteria you set. CICS VR can delete and uncatalog certain entities when they are deregistered from the RCDS.
Setting automatic log stream deregistration
Use the CICS® VR automatic log stream deregister secondary window to specify the parameters to be used by the CICS VR automatic deregistration.

What's new in CICS VR 6.1
CICS® VR 6.1 contains these changes.
Operating environment
CICS® VR uses logs to recover your VSAM data.
CICS VR Overview
Getting Started
CICS® VR and CICS® TS
CICS VR Exits
Running CICS® VR forward recovery
CICS® VR forward recovery consists of a restore and then forward recovery.
Running CICS® VR backup
The information in the following topics describe how to take a backup using CICS® VR. The panels and secondary windows are in the sequence that they are displayed during a backup job generation.
Running CICS® VR reorganization
You can reorganize a VSAM sphere using CICS® VR. VSAM sphere reorganization can increase the space of a sphere and its alternate indexes. It can also change the control interval sizes for a sphere's components.
Working with other VSAM sphere list pull-down menus
The CICS® VR recovery and backup functions are typically accessed using the Utilities pull-down menu after selecting VSAM spheres.
Working with CICS® Backout Failed spheres
The CICS® Backout Failed sphere list shows the CICS spheres registered for manual recovery or reorganization after CICS notification of a backout failure.
Working with logs
- Selecting from the log stream list
  On the CICS® VR log stream list panel, a list of all MVS™ log streams and SAM copies of log streams that are registered in the recovery control data set (RCDS) are displayed.
- Selecting from the log of logs list
  Use the CICS® VR log of logs list panel pull-down menu to re-display the log stream list by specifying search or sort criteria. This panel lists all the log of logs that are registered in the recovery control data set (RCDS).
- Setting automatic deregistration criteria
  CICS® VR provides automatic deregistration to stop the RCDS from filling up. Periodically automatic deregistration removes outdated information from the RCDS, based on retention criteria you set. CICS VR can delete and uncatalog certain entities when they are deregistered from the RCDS.
  - Setting automatic log stream deregistration
    Use the CICS® VR automatic log stream deregister secondary window to specify the parameters to be used by the CICS VR automatic deregistration.
  - Setting automatic backup deregistration
    Use the CICS® VR automatic backup deregister secondary window to view and update the deregistration settings.
  - Setting automatic change accumulation deregistration
    CICS® VR provides a separate retention period support for change accumulation (CA) data sets.
- Browsing messages
  At various locations throughout the CICS® VR panel interface, CICS VR writes messages to the data set allocated to the DWWMSG ddname when the specific error conditions are detected.
- CICS® VR settings
  Use the CICS® VR main menu to customize all CICS VR settings, such as Undo logs.
Using ISMF data set lists with CICS® VR
CICS® VR is integrated with ISMF so that you can create a CICS VR recovery job for the data sets in an ISMF data set list by entering the VSAMREC line operator or list command. When you enter the VSAMREC line operator or list command, the necessary CICS VR panels are called and you can create a recovery job for the VSAM sphere.
Running CICS® VR manually
IBM® recommends that you use the CICS® VR panel interface to create recovery jobs for your VSAM spheres. Using the CICS VR panel interface eliminates the need for you to manually keep track of daily update activity, logs, backups, etc. Also, the CICS VR panel interface automatically creates the recovery JCL for you.
Running CICS® VR batch backout
The CICS® VR batch backout utility allows you to remove updates that were made to KSDS, ESDS, RRDS, and VRRDS VSAM spheres by steps in a batch job. This section describes how to run the CICS VR batch backout utility.
Understanding CICS® VR reports
The CICS® VR forward recovery and batch backout utilities produce a set of reports upon successful completion. The reports are written to the data set allocated to the DWWPRINT ddname. However, the set of reports written for the forward recovery backout utilities differ from the set of reports written for the batch backout utilities.
Understanding IBM® program support
The IBM® Customer Engineering Program Support structure helps you resolve problems with IBM products, and ensures that you can make the best use of your IBM computing systems.
Problem determination procedures
If you have to contact IBM® personnel about a CICS® VR problem, you must classify and describe the problem.
Diagnosing the causes of abends
You can determine the cause of a CICS® VR abend in a number of ways.
Reference information
The reference sections of the information contain reference information that you need when you use CICS® VR.
Glossary
The terms in this glossary are defined as they pertain to the CICS VSAM Recovery documentation.
Edition notice
This is the information for CICS VSAM Recovery for z/OS. It applies to CICS VSAM Recovery for z/OS Version 6.1, and to all subsequent versions, releases, and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product.
Download PDF
Download the PDF format documentation for CICS VSAM Recovery for z/OS 6.1

Setting automatic log stream deregistration

Use the CICS® VR automatic log stream deregister secondary window to specify the parameters to be used by the CICS® VR automatic deregistration.

Select option 1, Automatic log stream deregister, from the CICS® VR automatic deregister criteria menu to open the secondary window:

Figure 1. Automatic log stream deregister secondary window

                  CICSVR automatic log stream deregister
Command ===>

Specify the automatic deregister criteria for log stream blocks and log
stream copies, then press ENTER. Or, leave all fields blank, then press
ENTER to turn off the automatic deregister function. Press F11 to view or
specify individual deregistration criteria for logstreams.

  Automatic deregister  . . . .: ON

  Retention period for blocks    099  (Number of days)

  Retention period for copies         (Number of days)

  Uncatalog and delete . . . . . .    (1=Yes, 2=No)

  Automatic individual deregister . . : ON

 F1=Help       F11=IndDereg   F12=Cancel

This figure displays sample user-entered values, but the default values for this secondary window are as follows:

OFF for Automatic deregister
Blank for the Retention period for blocks
Blank for the Retention period for copies
Blank for the Uncatalog and delete
OFF for Automatic individual deregister

For information about setting and using CICS® VR automatic deregistration, see Understanding CICS VR automatic deregistration"Understanding CICS® VR automatic deregistration" in the CICS® VR Implementation Guide and Reference .

For help information, press F1