PH06678: Performance tuning on KC index rebuilding

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• On small system which could have less MIPS or is simulation
  system such as zPDT,
  the startup time of z/OSMF will take more time and CPU which
  customers are not able to tolerate.
  After investigating, one of facts stalling the startup of z/OSMF
  is help index rebuilding.
  
  With this APAR, we intend to provide a ability for customer to
  control if the index rebuilding will happen.
  a new option "KCINDEX" is provided in z/OSMF server process
  IZUSVR1 and IZUSVR2.
  If "KCINDEX=N" is specified, the index rebuilding won't happen
  which is able to low CPU usage as expected.
  By default, KCINDEX is specified as Y, the index rebuilding
  takes place.
  
  It's recommended to restart z/OSMF server with index rebuilding
  disabled building after the very first time start of z/OSMF.
  This is because all of indice needed for z/OSMF helps have been
  built in the very first time start of z/OSMF. Later on, if new
  help file introduced, it is recommended to rebuild index with
  index rebuilding enabled in order for the new help file to be
  able to be searched.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  *  All users of IBM z/OS Management Facility                   *
  *                 Version 2 Release 2 and 3                    *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  *  Performance tuning on KC index                              *
  *                      rebuilding                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  On small system which could have less MIPS or is simulation
  system such as zPDT, the startup time of z/OSMF will take more
  time and CPU which customers are not able to tolerate. After
  investigating, one of facts stalling the startup of z/OSMF is
  help index rebuilding. With this APAR, we intend to provide
  a ability for customer to control if the index rebuilding will
  happen.
  
  A new parameter KCINDEX is added in z/OSMF server process
  IZUSVR1 and IZUSVR2. If KCINDEX is specified as N, the index
  rebuilding won't happen which is able to low CPU usage as
  expected. By default, KCINDEX is not specified as N, the index
  rebuilding always takes place.
  
  It's recommended to restart z/OSMF server with index rebuilding
  disabled after the very first time start of z/OSMF. This is
  because all of indices needed for z/OSMF helps have been built
  in the very first time start of z/OSMF. Later on, if new help
  file is introduced, it is recommended to rebuild index in order
  for the new help file to be able to be searched.
  
  Example of starting server without index rebuilding:
  S IZUSVR1,KCINDEX=N
  

Problem conclusion

• Change the code to make the improvement.
  

Temporary fix

Comments

APAR Information

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

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

  UI62005 UI62006

Modules/Macros

• IZUGNAAS IZUSVR2  IZUGNABS IZUSVR1  IZUGNAGF IZUGNAGE
  

Fix information

• Fixed component name

  Z/OSMF CORE

• Fixed component ID

  5655S28SM

Applicable component levels

• R230 PSY UI62005

     UP19/04/03 P F904

• R220 PSY UI62006

     UP19/04/03 P F904

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.