OA63568: RMM LEAVES WHILECATALOG UNTILEXPIRED ATTRIBUTE OFF FOR THE FIRST VOLUME IN A MULTIVOLUME SET UNDER RM(EXPDT) RETAINBY(VOLUME)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Under the EXPDT Retention Method with WHILECATALOG(UNTILEXPIRED)
  and RETAINBY(VOLUME), there is a scenario where RMM does not
  correctly leave the WHILECATALOG(UNTILEXPIRED) attribute in
  place for the first volume in a multivolume set. In the reported
  case, the first volume contains a dataset entirely, the second
  dataset spans the first and second volume, and the third dataset
  spans the second and third volume in the set. When the third
  dataset extends to the third volume in the set, the WC(UX)
  attribute is properly turned off on volume two but erroneously
  turned off on volume one where the third dataset does not
  reside. Then when this third dataset is finished being written
  and catalog calls RMM to indicate CATALOG=YES, the WC(UX)
  attribute is turned on for volumes two and three, but left off
  for volume one. This can lead to volume one being retained by
  expiration date alone instead of properly considering the
  catalog entry of the datasets on the volume with OrUncatlg.
  Under RETAINBY(SET) all volumes are consistently retained
  properly as the expiration date and attributes of all volumes in
  a set are kept the same.
  
  DSN1 VOL1 has WC(UX)
  DSN2 VOL1,VOL2 have WC(UX)
  DSN3 VOL2,VOL3 have WC(UX)
  
  VOL1 does NOT have OrUncatlg
  VOL2 does have OrUncatlg
  VOL3 does have OrUncatlg
  
  The results of this error could be that volumes are retained
  longer than intended, which could lead to out of scratch or out
  of cache conditions(VTS).
  

Local fix

• BYPASS/CIRCUMVENTION:
  Use RETAINBY(SET) instead of RETAINBY(VOLUME) in EDGRMMxx,
  Volume Set Management Level in MC class definition, and/or
  RETAINBY value in DEFAULT TABLE entries as appropriate.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * ALL DFSMSrmm clients using the RMM EXPDT retention method    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * In a Multivolume set retained by volume under EXPDT          *
  * retention method                                             *
  * the WHILECATALOG(UNTILEXPIRED) attribute is not set          *
  * correctly for                                                *
  * some of the volumes in the chain. This can cause the         *
  * impacted volumes                                             *
  * to be retained longer than required.                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• EDGMFIO is updated to fix the missing WHILECATALOG(UNTILEXPIRED)
   flag for Initial volumes.
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UJ93653 UJ93663 UJ93664

Modules/Macros

• EDGMFIO
  

Fix information

• Fixed component name

  DFSMSRMM

• Fixed component ID

  5695DF186

Applicable component levels

• R250 PSY UJ93664

     UP23/10/04 P F310 ¢

• R240 PSY UJ93663

     UP23/10/04 P F310 ¢

• R310 PSY UJ93653

     UP23/10/04 P F310 ¢

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.