PH59888: BACKUP SYSTEM FAILS WITH DSNU030I IF UTILS_HSM_MSGDS_HLQ ZPARM IS CODED AND DB2 LOCATION NAME CONTAINS THE UNDERSCORE CHARACTER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer has coded UTILS_HSM_MSGDS_HLQ in his DSNZPARM in order
  to receive messages from HSM and DFDSS in a dataset when running
  BACKUP SYSTEM and/or RESTORE SYSTEM utilities.
  He has a Db2 Location name which contains the underscore
  character and this special character causes the BACKUP SYSTEM
  utility to fail with the following message:
  DSNU030I 327 12:31:15.15 DSNUVBLC - UNABLE TO ALLOCATE
  STGREP.FB.CTEST_DB.D0L.D23327.T123104.S, RC=12, CODE=X'0000'
  The name of the dataset being allocated by Db2 must not contain
  the underscore character which is invalid in z/Os.
  The BACKUP SYSTEM should substitute an hyphen (-) in place of
  the underscore character (_).
  

Local fix

• BYPASS/CIRCUMVENTION:
  Do not code the DSNZPARM parameter UTILS_HSM_MSGDS_HLQ .
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Db2 12 for z/OS and Db2 13 for z/OS      *
  *                 users of the BACKUP SYSTEM and RESTORE       *
  *                 SYSTEM utilities when a copy pool name       *
  *                 contains an _ (underscore) and subsystem     *
  *                 parameter UTILS_HSM_MSGDS_HLQ is specified.  *
  ****************************************************************
  * PROBLEM DESCRIPTION: DSNU030I - UNABLE TO ALLOCATE dsn,      *
  *                      RC=12, CODE=X'0000' followed by         *
  *                      an unreadable message issued during     *
  *                      BACKUP SYSTEM when trying to allocate   *
  *                      and read from the DFSMShsm messages     *
  *                      data set and the copy pool name         *
  *                      contains an _ (underscore) character    *
  *                      and subsystem parameter                 *
  *                      UTILS_HSM_MSGDS_HLQ is specified.       *
  ****************************************************************
  * RECOMMENDATION: Apply corrective PTF when available          *
  ****************************************************************
  DSNU030I was issued and the utility ended with Return Code=8
  because BACKUP SYSTEM was not able to allocate the HSM message
  file and read from it, causing an unreadable message to be
  printed.
  
  RESTORE SYSTEM has the same problem.
  

Problem conclusion

• BACKUP SYSTEM and RESTORE SYSTEM code is modified to mimic HSM
  handling of an _ in the copy pool name by replacing it with a
  -, a dash or minus sign, allowing the allocation to be
  successful and the messages from HSM are correctly printed.
  

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:

  UI97219 UI97220

Modules/Macros

• DSNUVBLC
  

Fix information

• Fixed component name

  DB2 OS/390 & Z/

• Fixed component ID

  5740XYR00

Applicable component levels

• RC10 PSY UI97219

     UP24/06/15 P F406

• RD10 PSY UI97220

     UP24/06/15 P F406

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.