PI12942: ENHANCEMENT TO IMPROVE THE USABILITY AND PERFORMANCE WHEN HPPRBH=NO IS SPECIFIED

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR improves the usability and performance when HPPRBH=NO
  is specified to update OSAM data sets.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Prefix Resolution   *
  *                 for z/OS Version 3 Release 1 users           *
  *                 (FMID=H1IP310).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the following        *
  *                      enhancements to the Prefix Update       *
  *                      function with HPPRBH=NO:                *
  *                                                              *
  *                      1. Change the default timeout value to  *
  *                      prevent the PIPE.#04 timeout.           *
  *                                                              *
  *                      2. Dynamically allocate a DFSVSAMP      *
  *                      data set.                               *
  *                                                              *
  *                      3. Activate IMS OSAM sequential         *
  *                      buffering by dynamically allocating     *
  *                      a DFSCTL data set.                      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the following enhancements while OSAM data
  sets are updated with HPPRBH=NO:
  
  1. Change the default value of the PIPEWAIT control statement
  for PIPE.#04 read and write from 15 minutes to 1440 minutes.
  PIPE.#04 is used for OSAM data sets when HPPRBH=NO is
  specified. By this change, PIPE.#04 properly waits for VSAM
  data sets to be updated without a timeout.
  
  2. If HPPRBH=NO is specified but DFSVSAMP DD is not provided,
  a DFSVSAMP data set is dynamically allocated. The allocated
  DFSVSAMP data set contains the following statement:
  IOBF=(32K,10)
  
  3. If HPPRBH=NO is specified but DFSCTL DD is not provided,
  a DFSCTL data set is dynamically allocated to activate OSAM
  sequential buffering (SB). The allocated DFSCTL data set
  contains the following statement:
  SBPARM ACTIV=COND
  
  If you specify DFSCTL DD with the SBPARM ACTIV=NO statement,
  OSAM SB is disabled just like the default setting before this
  APAR.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Prefix Resolution for z/OS Version 3
  Release 1 User's Guide SC18-9230-03 ( SC18923003 ) should be
  changed as follows:
  ================================================================
  The changes apply to the following topics:
  
  > 3.0 Running IMS High Performance Prefix Resolution
  >> 3.2 Concurrent Prefix Update
  >>> 3.2.2 DD statements for Concurrent Prefix Update
  and
  >>> 3.3.2 DD statements for Stand-Alone Prefix Update
  
  | DDNAME: DFSCTL
  |  Use: Input
  |  Format: LRECL=80
  |  Need: Optional
  |  Description:
  |   Describes the data set that contains the OSAM sequential
  |   buffering (SB) control statements.
  |   By using OSAM SB, the IMS DL/I buffer handler can process
  |   OSAM data sets faster.
  |   For more information about control statement format and
  |   the OSAM SB, see IMS Database Administration and IMS
  |   System Definition.
  |
  |   If HPPRBH=NO is specified but DFSCTL DD is not provided,
  |   a DFSCTL data set is dynamically allocated to activate
  |   OSAM SB. The allocated DFSCTL data set contains the
  |   following statement:
  |   SBPARM ACTIV=COND
  |
  |   Recommendation: If you do not use the HPPR buffer handler
  |    (HPPRBH=NO), consider using OSAM SB.
  
    DDNAME: DFSVSAMP
     Use: Input
     Format: LRECL=80
     Need: Optional
     Description:
      :
      This DD statement is required when HPPRBH=NO is specified.
  
  |   If HPPRBH=NO is specified but DFSVSAMP DD is not provided,
  |   a DFSVSAMP data set is dynamically allocated. The allocated
  |   DFSVSAMP data set contains the following statement:
  |   IOBF=(32K,10)
  
  >>> 3.2.3 Control statements for Concurrent Prefix Update
  and
  >>> 3.3.3 Control statements for Stand-Alone Prefix Update
  
   HPPRBH
    HPPRBH specifies whether the Prefix Update function uses the
    HPPR buffer handler to update OSAM data sets.
    This control statement is optional. If you do not explicitly
    specify this control statement, HPPRBH=YES will be used.
     :
    NO
     Specifies to use the IMS DL/I buffer handler to update OSAM
     data sets. If OSAM data sets to be updated are large format
     data sets, you must specify HPPRBH=NO.
  |
  |  If the DFSCTL DD statement is not specified in the JCL,
  |  the data set is allocated dynamically to activate IMS OSAM
  |  sequential buffering.
  |
  |  Requirements:
  |   - IMS.SDFSRESL must be concatenated behind the DD statement
  |     that contains the IMS HP Prefix Resolution load library.
  |   - If JOBLIB or STEPLIB is not authorized by having
  |     unauthorized libraries that are concatenated to
  |     IMS.SDFSRESL, the DFSRESLB DD statement must be included.
  |   - OSAM subpools must be defined in the DFSVSAMP data set.
  
   PIPEWAIT
     :
    RDWR
     :
  D  The default is 1440 minutes for pipe ID 1, and 15 minutes
  D  for pipe ID 2, 3, and 4.
  
  |  The default is 1440 minutes for pipe ID 1 and 4, and 15
  |  minutes for pipe ID 2 and 3.
  

APAR Information

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

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

  UI16716

Modules/Macros

• FABYBRIA FABYBRIB FABYBRIC FABYBRID FABYBRLA FABYBRLB FABYBRLC
  FABYBRLD FABYBRL7 FABYBRL8 FABYBRL9 FABYINI0 FABYIN10 FABYIPR0
  FABYISI0 FABYIT10 FABYIT20 FABYMAIN FABYPI00 FABYRGPA FABYRGPB
  FABYRGPC FABYRGPD FABYRGP0 FABYRGP7 FABYRGP8 FABYRGP9 FABYTE00
  FABYTRM0 FABYUBD0 FABYUBH0 FABYUDY0 FABYUOS0 FABYUP00 FABYURG0
  FABYURI0 FABYURP0 FABYUTC0 FABYUVS0 FABYWM0  FABYWM1  FABY0040
  

Fix information

• Fixed component name

  IMSPREFIXRESOLU

• Fixed component ID

  5655I1500

Applicable component levels

• R310 PSY UI16716

     UP14/04/05 P F404

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.