A fix is available
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 number
OA63568
Reported component name
DFSMSRMM
Reported component ID
5695DF186
Reported release
240
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2022-07-25
Closed date
2023-09-07
Last modified date
2023-11-01
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.
[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"240"}]
Document Information
Modified date:
01 November 2023