OA65715: MSGIEC331I 004-31 AFTER IDCAMS ALTER OF A CATALOG WHICH CAUSES A MOVE OF THE CATALOG VVR

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An IDCAMS ALTER of a user catalog increased the size of the
  catalog VVR. The VVR did not fit anymore into the same CI in the
  
  VVDS and had to be moved. In the particular case it was an ALTER
  
  with LOG(NONE) which added an RLS cell to the VVR.
  
  When a VVCN exists in the VVDS, there are different situations
  where the RBAs for the catalog in either the VVCR or VVCN are
  not updated. These RBAs are needed to open the catalog.
  
  As a result, another ALTER for the same catalog failed to locate
  
  the catalog VVR for the data component and the catalog became
  inaccessible.
  
  The following messages were seen:
  
  IEC251I 205(050,007,IGG0CLHV)-132 (RC50 RSN7)
  IEC331I 004-31 (RC4 RSN31)
  IEC161I 004-080 (RC4 RSN80)
  
  ANALYSIS:
  Looks like when a VVR is moved, the RBA values are not
  immediately updated in a normal case but the next OPEN should
  update them.
  
  1) When it is moved to a different place before the VVCN and the
  
  catalog name is in the VVCR, the next open will update the RBAs
  in the VVCR and the open proceeds.
  
  2) When it is moved to a different place before the VVCN and the
  
  catalog name is in the VVCN, the next open fails.
  
  3) When it is moved to a different place after the VVCN and the
  catalog name is in the VVCR, the next open fails.
  
  4) When it is moved to a different place after the VVCN and the
  catalog name is in the VVCN, the next open fails.
  
  KNOWN IMPACT:
  Catalog becomes inaccessible
  
  
  CATKEYS: CAT2023 CATVVDS CATALLOC CATRLS IDCALTER
  

Local fix

• BYPASS/CIRCUMVENTION:
  Before the ALTER take a DSS PRINT of the VVDS of the catalog
  volume and ensure that the CI which contains the Catalog VVR
  does not contain any other data.
  
  RECOVERY ACTION:
  IBM support may provide a zap to correct the RBA values.
  If the zap does not work, restore the catalog from a backup.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Catalog user HDZ2250 and above.          *
  ****************************************************************
  * PROBLEM DESCRIPTION: An IDCAMS ALTER of a user catalog       *
  *                      increased the size of the               *
  *                      catalog VVR. The VVR did not fit        *
  *                      anymore into the same CI in the         *
  *                      VVDS and had to be moved. In the        *
  *                      particular case it was an ALTER         *
  *                      with LOG(NONE) which added an RLS       *
  *                      cell to the VVR.                        *
  *                                                              *
  *                      When a VVCN exists in the VVDS, there   *
  *                      are different situations                *
  *                      where the RBAs for the catalog in       *
  *                      either the VVCR or VVCN are             *
  *                      not updated. These RBAs are needed to   *
  *                      open the catalog.                       *
  *                                                              *
  *                      As a result, another ALTER for the      *
  *                      same catalog failed to locate           *
  *                                                              *
  *                      the catalog VVR for the data component  *
  *                      and the catalog became                  *
  *                      inaccessible.                           *
  *                                                              *
  *                      The following messages were seen:       *
  *                                                              *
  *                      IEC251I 205(050,007,IGG0CLHV)-132       *
  *                      (RC50 RSN7)                             *
  *                      IEC331I 004-31 (RC4 RSN31)              *
  *                      IEC161I 004-080 (RC4 RSN80)             *
  ****************************************************************
  * RECOMMENDATION: Apply PTF                                    *
  ****************************************************************
  See Error Description.
  

Problem conclusion

• Catalog VVDS code was modified to rectify the issue.
  

Temporary fix

Comments

APAR Information

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

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

  UJ97166 UJ97168 UJ97191

Modules/Macros

• IGG0CLFJ IGG0CLKV
  

Fix information

• Fixed component name

  ICF CATALOG & I

• Fixed component ID

  5695DF105

Applicable component levels

• R250 PSY UJ97166

     UP25/06/26 P F506

• R310 PSY UJ97168

     UP25/06/26 P F506

• R320 PSY UJ97191

     UP25/06/26 P F506

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.