PH12674: ERROR MESSAGE IS GENERATED FOR A VALID TEMPLATE NAME DURING ONLINE VALIDATION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Problem: Image Copy Template in a Utility profile incorrectly
  generates an error message for a potentially valid Template
  which has qualifier codes.
  Solution: Online validation before Build time can be
  unpredictable for template names which may have qualifier
  codes in it. Since we don't have the actual value of those
  qualifier codes before Build time, a warning message is
  generated for this scenario during online validation.
  Later during Build time, the actual length is calculated
  by replacing qualifier code field with the actual value.
  If its greater than 8, an error message is generated during
  Build time.
  Example:
   ISPF panel HAA$UCPN
   Template =
   &VCATNAME.Z.IF.&DB..&SN..P&PA(2)..&UNIQ.
  During the Build, &VCATNAME is replaced with SAPBP0(which is 6
  characters) and Z is one character. This produces a length of 7
  characters for the first dataset name qualifier.
  Result before this fix:
  Just specifying &VCATNAME does not generate the error.
  As soon as the literal ".Z" is appended to &VCATNAME, below
  error message is generated.
  Error message:
  HAAM249E - Invalid data set node detected length greater
  than 8 characters
  Result after this fix:
  A new warning message is generated during online validation.
  Once the qualifier code(&VCATNAME) is replaced with SAPBP0
  during Build time, build validation is performed and no error
  message is generated during the Build since the dataset name
  qualifier length is 7 characters.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of Db2 Automation Tool for z/OS        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Image Copy Template in a Utility        *
  *                      profile incorrectly generates an error  *
  *                      message for a potentially valid         *
  *                      Template which has qualifier codes.     *
  *                      Solution: Online validation before      *
  *                      Build time can be unpredictable for     *
  *                      template names which may have qualifier *
  *                      codes in it. Since we don't have the    *
  *                      actual value of those qualifier codes   *
  *                      before Build time, a warning message is *
  *                      generated for this scenario during      *
  *                      online validation.                      *
  *                      Later during Build time, the actual     *
  *                      length is calculated by replacing       *
  *                      qualifier code field with the actual    *
  *                      value. If its greater than 8, an error  *
  *                      message is generated during Build time. *
  *                      Example:                                *
  *                       ISPF panel HAA$UCPN                    *
  *                       Template =                             *
  *                      &VCATNAME.Z.IF.&DB..&SN..P&PA(2)..&UNIQ *
  *                      During the Build, &VCATNAME is replaced *
  *                      with SAPBP0(which is 6 characters) and  *
  *                      Z is one character. This produces a     *
  *                      length of 7 characters for the first    *
  *                      dataset name qualifier.                 *
  *                      Result before this fix:                 *
  *                      Just specifying &VCATNAME does not      *
  *                      generate the error.                     *
  *                      As soon as the literal ".Z" is appended *
  *                      to &VCATNAME, below error message is    *
  *                      generated.                              *
  *                      Error message:                          *
  *                      HAAM249E - Invalid data set node        *
  *                      detected length greater than 8          *
  *                      characters                              *
  *                      Result after this fix:                  *
  *                      A new warning message is generated      *
  *                      during online validation.               *
  *                      Once the qualifier code(&VCATNAME) is   *
  *                      replaced with SAPBP0 during Build time, *
  *                      build validation is performed and no    *
  *                      error message is generated during the   *
  *                      Build since the dataset name qualifier  *
  *                      length is 7 characters.                 *
  ****************************************************************
  * RECOMMENDATION: Apply the PTF.                               *
  ****************************************************************
  Code has been changed to fix this problem.
  

Problem conclusion

• Apply the PTF.
  

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:

Modules/Macros

• HAA#NTFI HAA#OBEX HAA$BDSN HAA$CALL HAA$EXCP HAA$HPDN HAA$JBRK
  HAA$JPRU HAA$UCPN HAAM42   HAAM426W HAAREORC
  

Fix information

• Fixed component name

  DB2 AUTOMATION

• Fixed component ID

  5697G6300

Applicable component levels

• R430 PSY UI64649

     UP19/08/10 P F908

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.