DY47844: ALTER NEWNAME USERCATALOG

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Introduce new IDCAMS ALTER attribute USERCATALOG which in
  conjunction with NEWNAME parameter allows to change the User
  Catalog name. USERCATALOG/UCAT attribute can only be used
  together with NEWNAME parameter.
  

Local fix

Problem summary

• Currently IDCAMS ALTER command does not allow to use NEWNAME
  parameter for user Catalog itself. The following error message
  is displayed on the attempt to rename a Catalog:
  IDC3009I ** VSAM CATALOG RETURN CODE IS 48 -
                           REASON CODE IS IGG0CLBD-8
  Based on the customers' requirement, the process of
  rebuilding a Catalog can be rather time-consuming when a simple
  Catalog rename is required. This line item should add an extra
  ALTER parameter which would allow renaming an existing User
  Catalog on the system without rebuilding it from scratch.
  

Problem conclusion

Temporary fix

Comments

• Conclusion:
  -----------
  1. Introduce new IDCAMS ALTER attribute USERCATALOG which in
     conjunction with NEWNAME parameter allows to change the User
     Catalog name. USERCATALOG/UCAT attribute can only be used
     together with NEWNAME parameter.
  2. Modify ALTER function support routine (IDCAL01) and Catalog
     management code (IGG0CLBD) to be able to change the Catalog
     name in HKR entry and related LKR C-type entry in the User
     Catalog itself.
  3. Modify Alter FSR (IDCAL01) and catalog management (IGG0CLBD)
     to be able to update HKR entry and related U-type entry for
     specified Catalog in the Master Catalog.
  4. Introduce new error messages and reuse the existing ones for
     the following cases:
    - Catalog is Open in another partition
        IDC3028I DATA SET IN USE
        IDC3009I ** VSAM CATALOG RETURN CODE IS 184 -
                                 REASON CODE IS IGG0CLEX-4
    - Entryname specified is not a Catalog
        IDC3190I 'USERCATALOG' PARAMETER INVALID WITH ENTRY TYPE
    - Catalog name specified with NEWNAME parameter already exists
        IDC3013I DUPLICATE DATA SET NAME
    - Entryname or newname specified is restricted as a system
      catalog reserved name
        IDC3192I RENAMING MASTER CATALOG (IJSYSCT) OR SYSTEM USER
        CATALOG (VSESPUC) IS NOT ALLOWED
  Note:
  -----
  If the user catalog name is changed, all existing labels
  using the old catalog name will point a to non-existing catalog
  and thus fail when referred to by the application. The user
  should take care of such labels separately (ALTER does not
  perform this processing automatically).
  

APAR Information

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

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

  UD54395

Modules/Macros

• IDCAL01  IDCAMS   IDCBI01  IDCCDAL  IDCCDBI  IDCCDCL  IDCCDDE
  IDCCDDL  IDCCDLC  IDCCDMA  IDCCDMP  IDCCDPM  IDCCDPR  IDCCDRC
  IDCCDRM  IDCCDRP  IDCCDRS  IDCCDSN  IDCCDVY  IDCCDXP  IDCDE01
  IDCMP01  IDCRC01  IDCRI01  IDCRILT  IDCRM01  IDCRMAP  IDCRS01
  IDCSM01  IDCSNAP  IDCTSAL0 IDCXP01  IKQSMMON IKQVCAT  IKQVCT31
  IKQVDUMP IKQVTMX
  

Fix information

• Fixed component name

  VSE/VSAM

• Fixed component ID

  5686VS605

Applicable component levels

• R62C PSY UD54395

     UP21/07/09 I 1000

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.