IBM Support

PH34007: DB2 ADMIN TOOL: THE DIAGNOSE TYPE(XXX) UTILITY CONTROL STATEMENTMAY NOT FUNCTION PROPERLY IN ADBTEP2

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Db2 Admin Tool: The DIAGNOSE TYPE(xxx) statement used by Db2
    utilities can be used to control various behaviors when
    utilities such as LOAD or  REORG are invoked.  ADBTEP2 may
    process DIAGNOSE TYPE(xxx) statements as though they are
    complete utilities and, therefore,  the DIAGNOSE TYPE(xxx)
    statement is not active for the intended  utility.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All Db2 Administration Tool for z/OS users   *
    ****************************************************************
    * PROBLEM DESCRIPTION: Modifying Admin Tool-generated ADBTEP2  *
    *                      jobs with Db2 utilities statements to   *
    *                      include DIAGNOSE statements can result  *
    *                      in the DIAGNOSE statements not being    *
    *                      properly scoped and thereby made        *
    *                      ineffective.  The reported problem      *
    *                      involved the use of DIAGNOSE TYPE(xxx)  *
    *                      statements.                             *
    ****************************************************************
    DIAGNOSE statements added to an ADBTEP2 job that executes Db2
    utilities might be scoped improperly and executed as independent
    utilities, which is not the desired action.  ADBTEP2 logic has
    been enhanced to recognize situations that can cause this
    behavior and correct them automatically.
    
    For example:
    "DIAGNOSE TYPE(133)" is used to cause reorg to use DFSORT
    instead of DB2SORT
    This reorg syntax in ADBTEP2 will execute the DIAGNOSE as a
    separate utility, causing it not to be used for the REORG,
    
    DIAGNOSE TYPE(133);
    REORG TABLESPACE <tablespace name>
       SHRLEVEL CHANGE
       TIMEOUT  TERM
       DRAIN        ALL
       SORTDEVT     SYSDA
       FASTSWITCH   YES
       FORCE        NONE
       UNLDDN       UNLDTMPL
       COPYDDN(COPYLD)
       RETRY        2
       RETRY_DELAY  5
       SORTNPSI    AUTO
       MAPPINGTABLE <mapping table>
    

Problem conclusion

  • The reported problem has been fixed.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH34007

  • Reported component name

    DB2 ADMIN TOOL

  • Reported component ID

    568851500

  • Reported release

    C10

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-02-01

  • Closed date

    2021-06-28

  • Last modified date

    2021-07-02

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

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

    UI76116

Modules/Macros

  • ADBTEP2
    

Fix information

  • Fixed component name

    DB2 ADMIN TOOL

  • Fixed component ID

    568851500

Applicable component levels

  • RC10 PSY UI76116

       UP21/06/30 P F106

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.

[{"Type":"MASTER","Line of Business":{"code":"","label":""},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSZJXP","label":""},"Version":"All Versions"}]

Document Information

Modified date:
03 July 2021