IBM Support

PH51565: FTB NEW FUNCTION

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • New function to add the FTB Factor for DISPLAY STATS(ITC)
    command and IFCID 389
    
    Additional keywords: IFCID0389 IFCID389 0389 DB2FTB/K
                         INDEXTRAVERSECOUNT
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All Db2 V13 for z/OS users with in-memory                    *
    * index optimization function switched on                      *
    * (Index Fast Traverse Block - FTB).                           *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * This apar adds a new field to the                            *
    * "DISPLAY STATS (INDEXTRAVERSECOUNT)"                         *
    * command - FTB factor.                                        *
    * Also, the new field QW0389FF                                 *
    * (FTB Factor) was added to the IFCID                          *
    * 389 record.                                                  *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    This apar adds a new field "FTB FACTOR" to the "DISPLAY STATS
    (ITC)" command. "FTB FACTOR" - a calculated value that Db2 uses
    to identify indexes that might benefit from fast index
    traversal.
    The updated command allows
    1. Display traverse count and FTB factor for specific index.
    2. Display first N indexes with the highest FTB factor in
    descending order.
    EXAMPLES
    1.
    -DISPLAY STATS(INDEXTRAVERSECOUNT) DBNAME(DB1) SPACENAM(IX1)
    PART(1)
    Output
    DBID PSID DBNAME   IX-SPACE LVL PART TRAV. COUNT FTB FACTOR
    ---- ---- -------- -------- --- ---- ----------- -----------
    0017 0005 DB1      IX1      003 0001 00000000999 -0000000001
    ******* DISPLAY OF STATS ENDED *****************************
    2.
    -DIS STATS(ITC) DB(DB1) LIMIT(5)
    Output (FTB factor values are in descending order)
    DBID PSID DBNAME   IX-SPACE LVL PART TRAV. COUNT FTB FACTOR
    ---- ---- -------- -------- --- ---- ----------- -----------
    0017 0005 DB1      IX2.     003 0008 00000030021 00000030021
    0017 0005 DB1      IX2      003 0016 00000029999 00000029999
    0017 0005 DB1      IX3      003 0001 00000000999 00000000999
    0017 0005 DB1      IX1      003 0001 00000050099 00000000000
    0017 0005 DB1      IX2      003 0010 00000050001 -0000000001
    ******* DISPLAY OF STATS ENDED *****************************
    IFCID 389 records all indexes that use fast index traversal
    (FTB) in the system. The following field was added to this
    record trace:
    QW0389FF - FTB Factor.
    

Problem conclusion

Temporary fix

Comments

  • More information can be found in "IBM Knowledge Center"
    Additional key words:
    FTB, IFCID389, QW0389, DB2FTB/K
    ×**** PE23/02/27 FIX IN ERROR. SEE APAR PH52893  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PH51565

  • Reported component name

    DB2 OS/390 & Z/

  • Reported component ID

    5740XYR00

  • Reported release

    D10

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2022-12-19

  • Closed date

    2023-02-13

  • Last modified date

    2023-06-19

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

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

    UI90510 PH55255

Modules/Macros

  • DSNFIDIR DSNKULTH DSNDQW05 DSNB1PPP DSNKUSET DSNKUNR2 DSNKDPG
    DSNKFEXT DSNFCDIR DSNKINSL DSNB1SWD DSNTDSTE DSNKINSN DSNKMDEL
    DSNKISPL DSNKISPN DSNKTRAV DSNKFTOM DSNKIXDB DSNKFTIN DSNKLOD2
    DSNFTDIR DSNK1CNE DSNKFTDL DSNKFTBU DSNKFTOB DSNB1CPP DSNKFLOK
    

Fix information

  • Fixed component name

    DB2 OS/390 & Z/

  • Fixed component ID

    5740XYR00

Applicable component levels

  • RD10 PSY UI90510

       UP23/02/22 P F302

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":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19O","label":"DB2 for z\/OS"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"D10"}]

Document Information

Modified date:
20 June 2023