PH55255: FTB NEW FUNCTION

Obtain the fix for this APAR.

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 V12 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:                                              *
  * Apply corrective PTF when available                          *
  ****************************************************************
  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

APAR Information

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

  PH51565

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

  UI93292

Modules/Macros

• DSNKULTH DSNDQW05 DSNB1PPP DSNKUSET DSNKUNR2 DSNKDPG  DSNKFEXT
  DSNKINSL DSNB1SWD DSNTDSTE DSNKINSN DSNKMDEL DSNKISPL 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

• RC10 PSY UI93292

     UP23/08/31 P F308

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.