IBM Support

PH70602: DB2 ADMIN REPORTS HPU LINE COMMAND AS INVALID IF USED WITH TABLE, VIEW, TEMPORARY TABLE OR MATERIALIZED TABLE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • In Db2 Admin Tool, attempting to use the HPU command on a line
    describing a table, a view, a temporary table or a materialized
    table fails with the error "Invalid line cmd" despite Db2 HPU
    having been successfully integrated into Db2 Admin Tool
    following the instructions from the INZDB21X member generated by
    the Db2 HPU customization.
    
    This occurs because the following instructions are missing from
    the INZDB21X member from the SINZCLST Library.
    
    (remove the spaces between "*" and "/", the spaces were included
    to avoid SYSMOD install errors)
    
    ** //*                                                       * /
    /* If DB2 Admin Tools is in version 8.1 and later or in
       version 7.1  * /
    /* with the APAR PK15597 applied, replace the above '"TBADD"
       table'  * /
    /* statement with the following 4 statements:                * /
    /*
    "TBADD" tableT
    "TBADD" tableM
    "TBADD" tableV
    * /
    
    These instructions should be placed in the "3) ,THIRD PART :
    update the ADB21T table." section after the Following lines:
    ISPF='SELECT CMD(INZHPU D TB &DB2N &DBNAME &TSNAME &CREATOR
    &NAME)
    "TBADD" table
    
    Local fix: Consider applying the missing instructions mentioned
    above.
    

Local fix

  • Consider applying the missing instructions mentioned above.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of Db2 High Performance Unload for     *
    *                 z/OS                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: In Db2 Admin Tool, attempting to use    *
    *                      the HPU command on a line describing a  *
    *                      table, a view, a temporary table or a   *
    *                      materialized table fails with the error *
    *                      "Invalid line cmd" despite Db2 HPU      *
    *                      having been successfully integrated     *
    *                      into Db2 Admin Tool following the       *
    *                      instructions from the INZDB21X member   *
    *                      generated by the Db2 HPU customization. *
    *                                                              *
    *                      This occurs because the following       *
    *                      instructions are missing from the       *
    *                      INZDB21X member from the SINZCLST       *
    *                      Library.                                *
    *                                                              *
    *                      (remove the spaces between "*" and "/", *
    *                      the spaces were included to avoid       *
    *                      SYSMOD install errors)                  *
    *                                                              *
    *                      ** //*                              * / *
    *                      /* If DB2 Admin Tools is in version 8.1 *
    *                         and later or in version 7.1  * /     *
    *                      /* with the APAR PK15597 applied,       *
    *                        replace the above '"TBADD" table' * / *
    *                      /* statement with the following 4       *
    *                      statements:                        * /  *
    *                      /*                                      *
    *                      "TBADD" tableT                          *
    *                      "TBADD" tableM                          *
    *                      "TBADD" tableV                          *
    *                      * /                                     *
    *                                                              *
    *                      These instructions should be placed in  *
    *                      the "3) ,THIRD PART : update the ADB21T *
    *                      table." section after the Following     *
    *                      lines:                                  *
    *                      ISPF='SELECT CMD(INZHPU D TB &DB2N      *
    *                      &DBNAME &TSNAME &CREATOR &NAME)         *
    *                      "TBADD" table                           *
    *                                                              *
    *                      Local fix: Consider applying the        *
    *                      missing instructions mentioned above.   *
    ****************************************************************
    * RECOMMENDATION: Apply the PTF                                *
    ****************************************************************
    Db2 Admin Tool reports HPU line command as invalid if used with
    table, view, temporary table or materialized table
    

Problem conclusion

  • Code has been changed to fix this problem
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH70602

  • Reported component name

    DB2 HI PERF UNL

  • Reported component ID

    5697F4400

  • Reported release

    520

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2026-03-19

  • Closed date

    2026-04-16

  • Last modified date

    2026-05-02

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

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

Modules/Macros

  • INZADTOO INZUTILK
    

Fix information

  • Fixed component name

    DB2 HI PERF UNL

  • Fixed component ID

    5697F4400

Applicable component levels

  • R520 PSY UO07520

       UP26/04/18 P F604

  • R610 PSY UO07521

       UP26/04/18 P F604

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJXP","label":"DB2 Tools for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"520","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
02 May 2026