OA45413: DELETE SYS1.VVDS.VVOLSER NOSCRATCH LEADS TO UNOPENABLE CATALOG

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When a DELETE SYS1.VVDS.Vvolser NOSCRATCH CATALOG(catname) is
  used to remove a VVDS's bcs record and the volume contains a
  user catalog, that catalog's reference in the VVCR can be
  removed rendering the catalog unopenable.  There are several
  factors that lead into this error which makes it rare:
  
  1) The VVDS is a special data set which does not require an
  entry in a user catalog.  However when a VVDS is first built, an
  entry in the BCS will be made in whichever catalog was oriented
  to.  Though these entries are non-consequential, some
  prefer to remove these with DELETE NOSCRATCH when volumes are
  offlined to remove warnings from listcat or diagnose results.
  OEM products also can perform this service.
  
  2) The VVDS contains a list of every catalog that has owned a
  data set on it's volume in it's VVCR record.  When more than 35
  catalogs are referenced, the overflow goes into a new record
  called the VVCN.  This problem only occurs when the catalog
  referenced in the DELETE is listed in the VVCN and that catalog
  resides on the volume of the VVDS.  Due to misorientation of
  control records, the catalog name at the corresponding offset in
  the VVCR is removed instead.  Again, this is only a problem if
  this is the VVDS for the catalog volume.
  
  
  
  Once these conditions are met and the catalog name reference in
  the VVCR is removed from the volume that catalog resides on, the
  catalog will not be openable.
  
  IDC3300I  ERROR OPENING MY.USER.CATALOG
  IDC3351I ** VSAM OPEN RETURN CODE IS 145
  IDC31700I VSAM OPEN ERROR
  IDC3003I FUNCTION TERMINATED. CONDITION CODE IS 12
  
  IEC331I 004-34,CATALOG ,ALLOCATE,OPN VSM ACB,IFG0191X
  IEF196I IEC331I 004-34,CATALOG ,ALLOCATE,OPN VSM ACB,IFG0191X
  IEC331I MY.USER.CATALOG
  IEF196I IEC331I MY.USER.CATALOG
  IEC161I 004-080,CATALOG,ALLOCATE,SYS00004
  IEF196I IEC161I 004-080,CATALOG,ALLOCATE,SYS00004
  IEC331I 004-86,CATALOG ,ALLOCATE,OPN CATALOG,IDACAT11
  IEF196I IEC331I 004-86,CATALOG ,ALLOCATE,OPN CATALOG,IDACAT11
  IEC331I MY.USER.CATALOG
  IEF196I IEC331I MY.USER.CATALOG
  IEF196I IGD104I MY.USER.CATALOG     RETAINED,
  
  IEC161I 205(050,007,IGG0CLHV)
  
  These messages can be issued for a variety of reason from
  physically broken catalogs to incorrect device types (usually
  esoterics) in the ucat connector record.  To confirm this
  problem, DSS (or IDCAMS) PRINT the VVDS for the user catalog's
  volume and confirm if the name is present in either a VVCR or
  VVCN record.  If it is not there, then this apar applies
  
   VVCR with MY.USER.CATALOG ref. :
   *.8..VVCR................MY.USER.*
   *CATALOG                         *
   *    ............MY.USER.CATALOG2*
   *                            ....*
   *........MY.USER.CATALOG3        *
   *                    ............*
   *                                *
   *            ............MY.USER.*
  
  
   VVCR with catalog name missing :
   *.8..VVCR................        *
   *                                *
   *    ............MY.USER.CATALOG2*
   *                            ....*
   *........MY.USER.CATALOG3        *
   *                    ............*
   *                                *
   *            ............MY.USER.*
  
  
  CATKEYS: CAT2014 CATALLOC CATBREAKER CATVVDS IDCDEL
  

Local fix

• The Catalog will continue to function without issue until it is
  closed.  Attempts to open will fail.  Provide support a DSS
  PRINT of the catalog volume's VVDS for a zap (note that zap must
  also include catalog's rba values, not just name).  Otherwise,
  recover catalog
  
  It is safer to cease issuing DELETE NOSCRATCH for a
  SYS1.VVDS.Vvolser entry where the volume contains a catalog
  until a fix is provided
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: User at HDZ1D10 and above.                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Please see Error Description.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  SUMMARY: Code designed to locate the position of a catalog name
  entry in the VVCN only passed back that position to calling
  routine which instead used that possition in the VVCR.  This
  resulted in the wrong catalog entry being removed from the VVCR,
  rather than the correct entry from the VVCN..
  

Problem conclusion

• Code has been corrected to remove the proper entry from the
  VVCN.
  

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:

  UA74658 UA74659

Modules/Macros

• IGG0CLE1 IGG0CLE2
  

Fix information

• Fixed component name

  ICF CATALOG & I

• Fixed component ID

  5695DF105

Applicable component levels

• RD10 PSY UA74658

     UP14/09/30 P F409

• R210 PSY UA74659

     UP14/09/30 P F409

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.