PM74880: ADB2CUST TCZCUST WITH ADBHLQ1 PARAMETER FAILS WITH MSG UNRECOGNIZED KEYWORDS HLQ

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Installing DB2 Administration Tool for z/OS v10.2 batch job
  fails with message:
  .
    Unrecognized keywords:
    subsys keyword  invalid value.
    ------------------------------
      *    HLQ      <hlq.value>
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of the DB2 Administration Tool for     *
  *                 z/OS who submit a generated customization    *
  *                 IBM Tools Customizer for z/OS (TCz) job      *
  *                 (template name 'ADBCUST').                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: The TCz customization job ends with     *
  *                      return code 0 and issues the message:   *
  *                                                              *
  *                        Unrecognized keywords:                *
  *                        subsys keyword  invalid value.        *
  *                        ------------------------------        *
  *                          *    HLQ      >hlq.value<           *
  *                                                              *
  *                      when the field 'DB2 Admin               *
  *                      customization high-level qualifier'     *
  *                      on panel CCQPRRD 'Product               *
  *                      Parameters' is specified.               *
  *                      As a result of this error the HLQ       *
  *                      variable value is not stored in         *
  *                      ADBTPARM, and therefore would not       *
  *                      be retrieved in a DISCOVER              *
  *                      operation, although DB2 Admin           *
  *                      would still run.                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The EXEC ADB2CUST looked for the wrong tag value for the high
  level qualifier (HLQ) parameter value.
  

Problem conclusion

• ADB2CUST has been corrected to look for the :HLQ tag instead
  of the :ADBHLQ tag, and the return code is set to 4 for similar
  non-fatal customization errors.
  

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:

  UK83262

Modules/Macros

•    ADB2CUST
  

Fix information

• Fixed component name

  DB2 ADMIN TOOL

• Fixed component ID

  568851500

Applicable component levels

• RA20 PSY UK83262

     UP12/11/09 P F211

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.