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 that is 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 that is 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.

Call the CICS® VR panel interface.
Select option 4, Automatic deregister criteria, from the CICS® VR main menu and press enter, the CICS® VR automatic deregister criteria menu opens.
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 that relates 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 0 - 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 values.

An example of the CICS® VR automatic log stream deregister secondary window after retention periods are 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 that are shown in CICS® VR automatic log stream deregister secondary window with those values entered, CICS® VR automatic deregistration performs the following actions:

Deletes information from the RCDS that relates to information on MVS™ log stream blocks that are older than five days.
Deletes MVS™ log stream blocks that are older than five days.
Deletes information from the RCDS that relates to log stream copies where the latest information in the log stream copy is older than seven days.
Uncatalogs and deletes all registered log stream copies where the latest information in the log stream copy is older than seven days.