IBM Support

PH32899: ADBTEP2: SQLCODE -305 WHEN REFERENCING SYSIBM.TEMPORAL_LOGICAL_TRANSACTION_TIME

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When running ADBTEP2, an attempt is made to use the
    value of SYSIBM. TEMPORAL_LOGICAL_TRANSACTION_TIME. However
    a null indicator is not present to handle the null value. As
    a result, a monitoring tool may record a SQLCODE = -305 error,
    pointing to the following statement:
    
    SET : H = SYSIBM . TEMPORAL_LOGICAL_TRANSACTION_TIME
    
    
    
    
    
    KEYWORD:  SQLCODE305N
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of the Db2 Administration Tool for     *
    *                 z/OS.                                        *
    ****************************************************************
    * PROBLEM DESCRIPTION: ADBTEP2: SQLCODE -305 is returned when  *
    *                      referencing                             *
    *                      SYSIBM.                                 *
    *                      TEMPORAL_LOGICAL_TRANSACTION_TIME       *
    ****************************************************************
    ADBTEPR (using ADBTEP2) does not handle situations where
    SYSIBM.TEMPORAL_LOGICAL_TRANSACTION_TIME is null.
    
    This situation results in an SQLCODE -305 error within ADBTEP2.
    However, the job is successful, and the SQLCODE -305 is not
    reported without the aid of a query monitoring tool.
    
    After applying this APAR, in addition to handling the null
    value, if the result of ADBTEP2 querying
    SYSIBM.TEMPORAL_LOGICAL_TRANSACTION_TIME is a negative
    return code, it will be included in the ADBTEP2
    output.
    

Problem conclusion

  • The problems have been resolved.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH32899

  • 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-12-22

  • Closed date

    2021-04-02

  • Last modified date

    2021-05-03

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

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

    UI74736

Modules/Macros

  • ADBTEPR
    

Fix information

  • Fixed component name

    DB2 ADMIN TOOL

  • Fixed component ID

    568851500

Applicable component levels

  • RC10 PSY UI74736

       UP21/04/06 P F104

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:
04 May 2021