IBM Support

PH06678: Performance tuning on KC index rebuilding

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PH06678

  • Reported component name

    Z/OSMF CORE

  • Reported component ID

    5655S28SM

  • Reported release

    220

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-12-20

  • Closed date

    2019-03-20

  • Last modified date

    2019-05-02

  • 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.

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"220","Edition":""},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"220","Edition":""}]

Document Information

Modified date:
02 May 2019