PH33675: BPLMAIN OUTPUTS INCORRECT VALUES FOR DATABASE BUFFER POOLS TO SPLRPT AND MDLRPT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• BPLMAIN, the reporting component of the IMS Buffer Pool Analyzer
  can output incorrect values for the database buffer pool, such
  as pool name and pool size to the Database Buffer Subpool
  reports in SPLRPT and to the model subpool reports in MDLRPT DD.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Buffer Pool Analyzer        *
  *                 for z/OS Version 1 Release 4 (FMID=H28A140)  *
  ****************************************************************
  * PROBLEM DESCRIPTION: BPLMAIN, the reporting component of     *
  *                      the IMS Buffer Pool Analyzer may output *
  *                      incorrect values for the database       *
  *                      buffer pool, such as pool name and pool *
  *                      size, to the Database Buffer Subpool    *
  *                      reports in the SPLRPT DD and to the     *
  *                      model subpool reports in the MDLRPT DD. *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR          *
  ****************************************************************
  This APAR fixes the following problems with the User's Guide and
  BPLMAIN reporting program.
  1.The following BPL687E message for DEDB is not described in the
    user's guide.
    BPL687E UNKNOWN SUBPOOL FOUND IN DEDB GTF RECORD - xxxxxxxx
  2.If Fast Path DEDB buffer pools in IMS are used, unnecessary
    DEDB information is output at the end of the SPLRPT DD.
  3.Unnecessary blank lines are no longer output at the end of
    the SPLRPT DD when the VSAM buffer pools are used by IMS.
  4.If Fast Path DEDB buffer pools in IMS are not specified
    correctly, the DEDB buffer pool size is always reported as 32K
    bytes in the MDLRPT DD.
  5.The SUBPOOL name used by OSAM DB and DEDB are reported as
    X'0000' in the "THE BUFFER SIZE USED BY THE FOLLOWING
    DATABASES EXCEEDS THE MOST EFFICIENT SIZE" report output to
    the MDLRPT DD.
  6.If CI size change is not specified by CHANGE DBD control
    statement in the SYSIN DD of BPLMAIN JCL, incorrect values are
    reported in the "THE BUFFER SIZE USED BY THE FOLLOWING
    DATABASES EXCEEDS THE MOST EFFICIENT SIZE" report output to
    the MDLRPT DD as follows:
    - The CI size of DEDB is reported as 0.
    - The best buffer size is always reported as 512.
  7.If Fast Path DEDB buffer pools in IMS are not specified
    correctly, the following problems occur to the SPLRPT DD:
    - BPL687E is incorrectly reported.
    - The first subheader for the error message consists of the
      invalid character x'00'.
    - All DEDB buffer sizes are reported as 32K bytes.
    - The buffer pool used by DEDB is reported with invalid
      characters such as X'00'.
  8.In the case of Fast Path DEDB buffer pool, database
    information is not output to "DATABASES WITH ACTIVITY IN THIS
    SUBPOOL:" in the "DETAIL" report output to the MDLRPT DD.
  9.If the size of SUBPOOL used in IMS is changed by DFSVSAMP
    specification in the BPLMAIN JCL to be larger than the
    CI/block size, the buffer pool will not be used for modeling
    an alternate buffer pool configuration with the specified
    size.
  
  KEYWORDS:SUBPOOL
  

Problem conclusion

• The BPLTRACE program, which is a data gathering component, and
  the BPLMAIN program, which is one of the batch reporting
  components, have been changed.
  Therefore, to resolve these issues, you must run the BPLTRACE
  program to get the GTF trace again and then run the BPLMAIN
  program.
  .
  This APAR fixes problems as follows:
  1.The following BPL687E message for DEDB has been described in
    the user's guide.
    BPL687E UNKNOWN SUBPOOL FOUND IN DEDB GTF RECORD - xxxxxxxx
  2.Unnecessary DEDB information at the end of the SPLRPT DD has
    been removed.
  3.Unnecessary blank lines are no longer output at the end of
    the SPLRPT DD when the VSAM buffer pool was used by IMS.
  4.Even if Fast Path DEDB buffer pools in IMS are not specified
    correctly, the DEDB buffer pool size in the MDLRPT DD is
    reported correctly with the value of the pool created by IMS.
  5.The SUBPOOL name used by OSAM DB or DEDB in the "THE BUFFER
    SIZE USED BY THE FOLLOWING DATABASES EXCEEDS THE MOST
    EFFICIENT SIZE" report output to the MDLRPT is reported
    correctly.
  6.Even if CI size change is not specified by CHANGE DBD control
    statement in the SYSIN DD of BPLMAIN JCL, correct values are
    reported for the followng values in the "THE BUFFER SIZE USED
    BY THE FOLLOWING DATABASES EXCEEDS THE MOST EFFICIENT SIZE"
    report output to the MDLRPT DD:
    - The CI size of DEDB
    - The best buffer size
  7.The problems with the SPLRPT DD when the IMS Fast Path DEDB
    buffer pool was not specified correctly has been resolved as
    follows:
    - Unnecessary BPL687E is no longer reported.
    - The first subheader no longer contains the invalid
      character x'00'and a new subheader "BUFFER SUBPOOL ERROR
      MESSAGE" is output.
    - The DEDB buffer size is now reported as the correct size.
    - The buffer pool name used by DEDB is reported correctly.
  8.Even in the case of the Fast Path DEDB buffer pool, the
    database information is output to "DATABASES WITH ACTIVITY IN
    THIS SUBPOOL:" in the "DETAIL" report that is output to the
    MDLRPT DD.
  9.By changing the size of the SUBPOOL used by IMS to be larger
    than the CI/block size by DFSVSAMP specification in the
    BPLMAIN JCL, the buffer pool is used for modeling an alternate
    buffer pool configuration with the specified size.
  .
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Buffer Pool Analyzer for z/OS Version 1 Release 4 User's
  Guide (SC19-3980-00)
  ----------------------------------------------------------------
  For updates to the user's guide by this APAR, refer to
  "Tech docs" ("See updates to this information!") on the
  IMS Tools Product Documentation web page.
  .
  

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:

  UI73950

Modules/Macros

• BPLDBRP2 BPLDBRP3 BPLDEDB  BPLOSAM  BPLPOOL4 BPLPOOL5 BPLSMRP1
  BPLSMRP2 BPLSPRP3
  

Fix information

• Fixed component name

  IMS BUFFER POOL

• Fixed component ID

  5697H7700

Applicable component levels

• R140 PSY UI73950

     UP21/02/16 P F102

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.