PK21593: IMPROVEMENT OF UPDATE PERFORMANCE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This is a performance enhancement of the prefix update function
  with DBIL.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Prefix Resolution   *
  *                 for z/OS Version 3 Release 1 users           *
  *                 (FMID=H1IP310).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: HP Prefix Resolution enhances           *
  *                      performance of the Prefix Update        *
  *                      function.                               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the better performance of the Prefix Update
  function by saving the number of I/O operations in the following
  cases;
  1. HPPR is run for databases with zero counter values in logical
  parents on the conditions that the DBIL is specified in the
  Prereorganization utility, and that UPDLPC=NO is specified in
  FABYIN or a site default table.
  2. HPPR is run with DBIL though the prefixes of the logical
  parent segments with logical children are not affected during
  reorganization.
  3. HPPR is run for databases with zero LC pointer values in
  logical parents.
  
  This APAR also enables HP Prefix Resolution to support the
  following control statements by the site default table
  (FABYGBT0);
  
   o ALLOWLC
   o ALLOCLP
   o DBRC
   o OPRTLC
   o OPRTLP
   o UPDATE
   o UPDLPC
  

Problem conclusion

• Code changes have been made to improve performance of the Prefix
  Update function and to support the control statements described
  above.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Prefix Resolution for z/OS Version 3
  Release 1 User's Guide (Document Number: SC18-9230-00) should
  be changed as follows.
  ================================================================
   2.5 FABYIN Control Statement
   2.5.10 UPDLPC Control Statement
    :
    ___________________________________________________________
   |                                                           |
   |               _YES_                                       |
   | >>__UPDLPC=__|_NO__|___________________________________>< |
   |                                                           |
   |___________________________________________________________|
  
   YES
    Specifies to update counter fields of the logical parents
  | also when they have no logical children. When you delete
  | all of the logical children of a logical parent during the
  | DBIL-type reorganization process, you must specify this
  | parameter.
  
  | Note: The performance of the Prefix Update function will
  | decline by specifying this parameter.
  
   NO
    Specifies not to update counter fields of the logical parents
  | that have no logical children.
  
  |Note: The default value of the UPDLPC control statement can be
  |changed. For details, see "Site Default Option" in topic 4.0.
  ================================================================
   3.0 Reports
   3.5 Update Processing Summary Report
   :
   <<Add a new reason code.>>
   The meanings of the reason codes are:
   Reason Code
    Meanings
  |04
  | The prefixes of the logical parent were not updated because
  | the logical parent had no pointer fields that had to be
  | changed.
  ================================================================
   4.0 Site Default Option
  |You can change the default values for some options by creating
   a site default table (FABYGBT0) for your site.
  
   4.1 Setting a Site Default Table
   You can create a site default table (FABYGBT0) to change the
  |default values of some options. ...
  
   4.2 Generating a Site Default Table
   :
  |The default values for the following options can be changed by
   creating FABYGBT0:
  | o ALLOWLC
  | o ALLOCLP
  | o DBRC
    o HPPRBH
  | o OPRTLC
  | o OPRTLP
  | o UPDATE
  | o UPDLPC
  

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:

  UK12760

Modules/Macros

• FABYDSCT FABYGOPT FABYISI0 FABYRGP7 FABYRGP8
  FABYRGP9 FABYTGEN FABYUBH0 FABYUOS0 FABYUP00 FABYURGP FABYUVS0
  

Fix information

• Fixed component name

  IMSPREFIXRESOLU

• Fixed component ID

  5655I1500

Applicable component levels

• R310 PSY UK12760

     UP06/03/23 P F603

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.