IBM Support

PH31507: DB2 ADMIN COMPARE GENERATES WRONG UTILITY LOAD CARDS AT EXECUTION TIME.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • DB2 ADMIN COMPARE generates wrong utility load cards at
    execution time.
    
    For example:
    
    A COLUMN in a table was changed from
    
    CHANGED_DATE TIMESTAMP (6) WITHOUT TIME ZONE NOT NULL
    GENERATED ALWAYS FOR EACH ROW ON UPDATE AS ROW CHANGE TIMESTAMP
    
    to
    
    CHANGED_DATE TIMESTAMP (6) WITHOUT TIME ZONE NOT NULL
    GENERATED BY DEFAULT FOR EACH ROW ON UPDATE AS ROW CHANGE
    TIMESTAMP,
    
    If UNLOAD options are NOPAD or/and SPANNED the load utilty cards
    look like:
    
    LOAD DATA INDDN HUJSMZZ8 LOG NO RESUME YES
    EBCDIC CCSID(00277,00000,00000)
    INTO TABLE "PMRCHAR1"."PP_CONF_SERVER"
    WHEN(00001:00002) = X'0003'
    NUMRECS 0
    IGNOREFIELDS YES
    (
    SERVER_ID POSITION( 3: 6)
    INTEGER ,
    .
    .
    CREATED_DATE POSITION(* )
    TIMESTAMP EXTERNAL(026) ,
    CHANGED_BY POSITION(* )
    VARCHAR ,
    CHANGED_DATE POSITION(* )
    TIMESTAMP EXTERNAL(001)
    )
    
    Which gives the following error at execution time:
    
    DSNUGPRS - VARCHAR ,
    DSNUGPRS - CREATED_DATE POSITION(* )
    DSNUGPRS - TIMESTAMP EXTERNAL(026) ,
    DSNUGPRS - CHANGED_BY POSITION(* )
    DSNUGPRS - VARCHAR ,
    DSNUGPRS - CHANGED_DATE POSITION(* )
    DSNUGPRS - TIMESTAMP EXTERNAL(001)
    DSNUGPRS - INVALID OPERAND '1' FOR KEYWORD 'TIMESTAMP'
    DSNUGPRS - )
    DSNUGPRS - SORTNUM
    DSNUGPRS - 8
    DSNUGPRS - SORTDEVT
    DSNUGPRS - SYSDA
    DSNUGPRS - REPLACE
    DSNUGPRS - ENFORCE
    DSNUGPRS - NO
    DSNUGPRS - DISCARDS
    DSNUGPRS - 1
    DSNUGPRS - ERRDDN(ERR)
    DSNUGPRS - MAPDDN(MAP)
    DSNUGPRS - WORKDDN(UT1,SOUT)
    DSNUGPRS - DISCARDDN DISC
    DSNUGBAC - UTILITY EXECUTION TERMINATED, HIGHEST RETURN CODE=8
    
    
    ADBT015I Failure attempting to execute ADB2UTIL
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of the Db2 Object Comparison Tool for  *
    *                 z/OS that change timestamp attributes        *
    ****************************************************************
    * PROBLEM DESCRIPTION: When running a change, the user gets an *
    *                      error during the LOAD operation due to  *
    *                      the invalid timestamp attribute         *
    *                      EXTERNAL(001). The user was changing    *
    *                      the timestamp attributes in the         *
    *                      change.                                 *
    ****************************************************************
    Db2 Object Comparison Tool generates an incorrect LOAD utility
    statement at execution time.
    
    A column in a table was changed from
    
    CHANGED_DATE TIMESTAMP (6) WITHOUT TIME ZONE NOT NULL
    GENERATED ALWAYS FOR EACH ROW ON UPDATE AS ROW CHANGE
    TIMESTAMP
    
    to
    
    CHANGED_DATE TIMESTAMP (6) WITHOUT TIME ZONE NOT NULL
    GENERATED BY DEFAULT FOR EACH ROW ON UPDATE AS ROW CHANGE
    TIMESTAMP
    
    If the UNLOAD options include NOPAD, SPANNED or both, the
    following LOAD utility statement is generated:
    
    LOAD DATA INDDN TESTDD LOG NO RESUME YES
    EBCDIC CCSID(00277,00000,00000)
    INTO TABLE "CREATOR"."TABLE_NAME"
    WHEN(00001:00002) = X'0003'
    NUMRECS 0 IGNOREFIELDS YES
    ( SERVER_ID POSITION( 3: 6)
    INTEGER , . .  CREATED_DATE POSITION(* )
    TIMESTAMP EXTERNAL(026) ,
    CHANGED_BY POSITION(* )
    VARCHAR , CHANGED_DATE POSITION(* )
    TIMESTAMP EXTERNAL(001) ) where
    EXTERNAL(001) is invalid.
    

Problem conclusion

  • The problem has been resolved.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH31507

  • 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

    2020-11-12

  • Closed date

    2021-02-18

  • Last modified date

    2021-03-05

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

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

    UI74051

Modules/Macros

  • ADB27AC
    

Fix information

  • Fixed component name

    DB2 ADMIN TOOL

  • Fixed component ID

    568851500

Applicable component levels

  • RC10 PSY UI74051

       UP21/02/23 P F102

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.

[{"Line of Business":{"code":"LOB10","label":"Data and AI"},"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":"12.1.0"}]

Document Information

Modified date:
06 March 2021