Setting automatic log stream deregistration criteria

Using the CICS® VR panel interface, you can set separate retention periods for MVS™ log streams and log stream copies.

MVS log streams
A retention period specified for MVS log streams applies to all forward recovery and log of logs log streams that are registered to CICS VR.
Log stream copies
A retention period specified for log stream copies applies to all sequential data set log stream copies that were registered to CICS VR during execution of the CICS VR log stream copy utility.
You can set the retention period for log streams or log stream copies by carrying out the following steps.
  1. Call the CICS VR panel interface.
  2. Select option 4, Automatic deregister criteria, from the "CICS VR main menu" and press enter, the "CICS VR automatic deregister criteria menu" opens.
  3. Select option 1, Automatic log stream deregister, and press enter. The "CICS VR automatic log stream deregister" secondary window opens:
Figure 1. CICS VR automatic log stream deregister secondary window with default values
                  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  . . . .: OFF

  Retention period for blocks    ___  (Number of days)

  Retention period for copies    ___  (Number of days)

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

  Automatic individual deregister . . : OFF

 F1=Help       F11=IndDereg   F12=Cancel

The IBM® default values for the log stream blocks and log stream copies retention periods are blanks. Therefore, automatic log stream deregistration is initially turned off. While the automatic log stream deregistration setting remains OFF, no information relating to log streams or log stream copies is deregistered periodically by CICS VR.

The Automatic individual deregister field shows whether an individual retention period is specified for any log stream. If set to ON, a log stream does have an individual retention period specified. If set to OFF, no log streams registered to CICS VR have individual deregistration criteria specified.

You can change the automatic log stream deregistration setting to ON by specifying a value between 0 and 999 for one or both of the retention period settings and pressing enter. Once the automatic log stream deregistration setting is changed to ON, CICS VR periodically deregisters, and optionally uncatalogs and deletes, information that is older than the specified retention period value(s).

An example of the "CICS VR automatic log stream deregister" secondary window after retention periods have been entered:
Figure 2. CICS VR automatic log stream deregister secondary window with values entered
                  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 . . : OFF

 F1=Help       F11=IndDereg   F12=Cancel
If you entered the values shown in "CICS VR automatic log stream deregister" secondary window with values entered above, CICS VR automatic deregistration performs the following actions: