PH30457: HALDB SUBPOOL IDS AREN'T REPORTED TO DBDRPT / DSNRPT AND CI RESIZING IS NOT REFLECTED IN MDLRPT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR fixes the following problems:
  - The IMS Buffer Pool Analyzer does not report subpool IDs
    directed to HALDB partitions in DBDRPT and DSNRPT.
  - The DBD keyword description in the CHANGE DBD statement in the
    IMS Buffer Pool Analyzer for z/OS User's Guide is incorrect
    for HALDB. For HALDB, specify the partition name and partition
    dataset number (typically A through J, L, and X).
  - When a dataset number (DSID) is specified with the DBD keyword
    in the CHANGE DBD statement and AM=VSAM is specified along
    with CI resizing, the specified CI size is not used for
    modeling in MDLRPT.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Buffer Pool Analyzer        *
  *                 for z/OS Version 1 Release 4 (FMID=H28A140)  *
  ****************************************************************
  * PROBLEM DESCRIPTION: - Subpool IDs for HALDB may not be      *
  *                        reported in DBDRPT and DSNRPT.        *
  *                      - The DBD keyword description in the    *
  *                        CHANGE DBD statement in the IMS       *
  *                        Buffer Pool Analyzer for z/OS User's  *
  *                        Guide is incorrect.                   *
  *                      - CI resizing does not work when a      *
  *                        dataset number (DSID) for the DBD     *
  *                        keyword and AM=VSAM are specified in  *
  *                        the CHANGE DBD statement.             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR          *
  ****************************************************************
  This APAR fixes the following problems:
  - In DBDRPT and DSNRPT, the IMS Buffer Pool Analyzer does not
    report subpool IDs directed to HALDB partitions which are
    defined by DBD control statement in IMS subpool definition
    (DFSVSMxx or DFSVSAMP DD statement).
  - The DBD keyword description in the CHANGE DBD statement in the
    IMS Buffer Pool Analyzer for z/OS User's Guide is incorrect
    for HALDB. For HALDB, specify the partition name and partition
    data set number (typically A through J, L, and X).
  - When a dataset number (DSID) for the DBD keyword and AM=VSAM
    is specified in the CHANGE DBD statement along with CI
    resizing, the specified CI size is not used for modeling in
    MDLRPT.
  
  KEYWORDS:SUBPOOL
  

Problem conclusion

• This APAR fixes problems as follows:
  - The IMS Buffer Pool Analyzer enables to report subpool IDs
    directed to HALDB partitions in DBDRPT and DSNRPT.
  - The DBD keyword description in the CHANGE DBD statement in the
    IMS Buffer Pool Analyzer for z/OS User's Guide is corected so
    that the partition name and partition data set number
    (typically A through J, L, and X) have to be specified in the
    case of HALDB.
  - The IMS Buffer Pool Analyzer enables to use the specified CI
    size for modeling in MDLRPT if a dataset number (DSID) for the
    DBD keyword and AM=VSAM are specified in the CHANGE DBD
    statement.
  .
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IBM IMS Buffer Pool Analyzer for z/OS Version 1 Release 4 User's
  Guide (SC19-3980-00)
  ----------------------------------------------------------------
  Topic: IMS buffer pool reports > Customizing the buffer pool
   reports using SYSIN statements > CHANGE DBD statements > DBD
  ----------------------------------------------------------------
  The description of DBD keyword for the CHANGE DBD statement has
  been changed as follows:
  DBD
  This keyword specifies the database name and, optionally, the
  data set number. For HALDB, specify the partition name and,
  optionally, the partition data set number (typically A through
  J, L, and X).
  For example, DBD=DI21PART will cause all data sets that are
  associated with the DI21PART database to be changed.
  Specifying DBD=(DI21PART,1) will cause only the first data set
  to be changed.
  .
  ----------------------------------------------------------------
  Topic: IMS buffer pool reports > Viewing the buffer pool reports
       > Data set information reports > DCB NUM
  ----------------------------------------------------------------
  The description of DCB NUM field has been changed as follows:
  DCB NUM
  The DCB number indicates the data set number within the database
  or the HALDB partition for this data set.
  ----------------------------------------------------------------
  Topic: IMS buffer pool reports > Viewing the buffer pool reports
       > Database statistics reports > DCB NUM
  ----------------------------------------------------------------
  The description of DCB NUM field has been changed as follows:
  DCB NUM
  The DCB number indicates the data set number within the database
  or the HALDB partition for this data set.
  ----------------------------------------------------------------
  Topic: IMS buffer pool reports > Viewing the buffer pool reports
     > Subpool statistics reports > Inefficient buffer size report
     > DCB
  ----------------------------------------------------------------
  The description of DCB field has been changed as follows:
  DCB
  The DCB indicates the data set number within the database
  or the HALDB partition for this data set.
  ----------------------------------------------------------------
  Topic: IMS buffer pool reports > Viewing the buffer pool reports
       > Subpool statistics reports > Varied hit ratio report
       > DCB
  ----------------------------------------------------------------
  The description of DCB field has been changed as follows:
  DCB
  The DCB indicates the data set number within the database
  or the HALDB partition for this data set.
  .
  

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:

  UI72317

Modules/Macros

• BPLPOOL4 BPLPOOL5 BPLRCN24 BPLRCN25 BPLVSAM
  

Fix information

• Fixed component name

  IMS BUFFER POOL

• Fixed component ID

  5697H7700

Applicable component levels

• R140 PSY UI72317

     UP20/10/31 P F010

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.