PI17557: THIS APAR ENABLES THE POST-REORGANIZATION UTILITY TO SUPPORT OSAM LARGE FORMAT.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables the Post-reorganization utility to support
  OSAM large format.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Database Reorganization     *
  *                 Expert for z/OS Version 4 Release 1          *
  *                 (FMID=H25N410).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables the                   *
  *                      Post-reorganization utility to support  *
  *                      OSAM large format data sets.            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables the Pre-reorganization utility and
  the Post-reorganization utility to support OSAM large format
  data sets.
  
  The following APARs are also required for the related products:
  - PI17770 IMS High Performance Prefix Resolution V3R1
            (FMID: H1IP310)
  - PI16689 IMS High Performance Image Copy V4R2
            (FMID: H1J0420)
  
  Add the control statement 'HPPRBH=NO' in the PREFIXRES block
  in the HPSIN data set for the Pre-reorganization utility
  as below.
  
   //RGEPRE   EXEC PGM=HPSCMAIN,PARM='FUNC=PR'
   :
   //HPSIN DD *
   :
   (PREFIXRES)
     HPPRBH=NO
   /*
  
  If the control statement 'HPPRBH=NO' is specified, the IMS DL/I
  buffer handler is used to update the OSAM data sets.
  The required DD statements, DFSVSAMP DD and DFSCTL DD, are
  dynamically allocated by IMS High Performance Prefix Resolution.
  
  If an OSAM large format data set is to be updated and
  'HPPRBH=NO' is not specified, MSGFABY112A is printed in the
  messages report produced by IMS High Performance Prefix
  Resolution:
   FABY112A  UNABLE TO HANDLE A LARGE FORMAT DATA SET
  
  
  In the Environment report of the Post-reorganization utility,
  the list of databases to be processed is added. The database
  name, the database organization, the access method, and process
  type (REORG/BUILD/SCAN) are printed.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's
  Guide Version 4 Release 1 Suffix 3 (SC19-1137-03) should be
  changed as follows:
  
  ---------------------------------------------------------------
  > Reorganizing databases that have external logical
  relationships
  >> Pre-reorganization utility and Post-reorganization utility
  >>> Restrictions for the Pre-reorganization utility
      and the Post-reorganization utility
  
  ( The following restriction has been removed.)
  D- Databases that are using OSAM large format sequential data
  D  sets are not supported.
  ---------------------------------------------------------------
  > Reorganizing databases that have external logical
  relationships
  >> JCL requirements for reorganizing databases that have
  external logical relationships
  >>> Pre-reorganization utility JCL statements
  >>>> Control statements for the Pre-reorganization utility
  >>>>> Control statements for the PREFIXRES block
  
   Table 1. Control statements for Prefix Resolution task
   +--------+-----------+--------+-----------------------------+
   |Keyword |Acceptable |Default | Description                 |
   |        | values    |        |                             |
   +--------+-----------+--------+-----------------------------+
   |        :           :        :                             |
   +--------+-----------+--------+-----------------------------+
  ||HPPRBH  | YES or NO | YES    |Specifies whether to use the |
  ||        |           |        |HPPR buffer handler to update|
  ||        |           |        |the OSAM data sets.          |
  ||        |           |        |If OSAM large format is to be|
  ||        |           |        |updated,  HPPRBH=NO must be  |
  ||        |           |        |specified.                   |
   +--------+-----------+--------+-----------------------------+
   |        :           :        :                             |
  ---------------------------------------------------------------
  > Reorganizing databases that have external logical
    relationships
  >> JCL requirements for reorganizing databases that have
     external logical relationships
  >>> Post-reorganization utility JCL statements
  
  :
   DD statements
  
   Table 1. DD statements and record format for the
   Post-reorganization utility
   +---------+------+------------+----------------------------+
   |DDNAME   |Use   |Format      |Need                        |
   +---------+------+------------+----------------------------+
   |         :      :            :                            |
   +---------+------+------------+----------------------------+
  ||DFSCTL   |Input |Same as IMS |Optional (See Note 5)       |
   +---------+------+------------+----------------------------+
  ||DFSVSAMP |Input |Same as IMS |Optional (See Note 5)       |
   +---------+------+------------+----------------------------+
   |         :      :            :                            |
   Notes:
  | 5.  It is used when HPPRBH=NO is specified in the PREFIXRES
  | block of the HPSIN data set for the Pre-reorganization
  | utility.
  :
  | DFSCTL DD
  |  This data set is used as input of IMS OSAM sequential
  |  buffering when HPPRBH=NO is specified in the PREFIXRES block
  |  of the HPSIN data set for the Pre-reorganization utility.
  |  If HPPRBH=NO is specified but DFSCTL DD is not provided,
  |  a DFSCTL data set is dynamically allocated by IMS HP Prefix
  |  Resolution.
  |  For the contents, see 'IMS High Performance Prefix
  |  Resolution for z/OS, User's Guide'.
  |
  | DFSVSAMP DD
  |  Describes the data set that contains the buffer pool
  |  information required by the IMS DL/I buffer handler.
  |  If HPPRBH=NO is specified in the PREFIXRES block of the
  |  HPSIN data set for the Pre-reorganization utility,
  |  this data set is required.  If  HPPRBH=NO is specified
  |  but this DD statement is not coded, a DFSVSAMP data set
  |  is dynamically allocated by IMS HP Prefix Resolution.
  |  For the contents, see  'IMS High Performance Prefix
  |  Resolution for z/OS, User's Guide'.
  
  ---------------------------------------------------------------
   > Reorganizing databases that have external logical
     relationships
   >> Pre-reorganization utility and Post-reorganization utility
      reports
   >>> Post-reorganization utility reports
  
    Table 1. Reports produced by the Post-reorganization utility
  
    Output data set: HPSOUT
    Report name: Environment
    Description:
  |  Contains the EXEC parameters that were specified for the job,
     the release levels of the operating system and IMS,
  |  and the list of databases to be processed.
  
  ---------------------------------------------------------------
   > Post-reorganization utility reports
   >> HPSOUT data set (Post-reorganization utility)
   >>> Environment report (Post-reorganization utility)
  
    The Environment report contains the EXEC parameters that were
  | specified for the job, the release levels of the operating
  | system and IMS, and the list of databases to be processed.
  
    The following figure is an example of the Environment report.
    Figure 1. Environment report (Post-reorganization utility)
    :
  |
  |  DATABASES
  |    DBD NAME  DB-ORG     ACCESS   PROCESS
  |    --------  ---------  -------  --------
  |    HDAMDB01  HDAM       OSAM     REORG
  |    HDAMSX01  INDEX(S)   VSAM     BUILD
  |    HIDAMDB1  HIDAM      OSAM     REORG
  |    HIDAMIX1  INDEX(P)   VSAM     REORG
  |    HDAMDB02  HDAM       OSAM     SCAN
  |    HIDAMDB2  HIDAM      OSAM     SCAN
  |    HIDAMIX2  INDEX(P)   VSAM     SCAN
  
  ============= End of Documentation Change ==================
  

APAR Information

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

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

  UI18712

Modules/Macros

•    BBEAEEM0 BBEAMSG0 BBEAMST0 BBEARHI0 BBEARHR0
  BBEASHE0 BBEASHM0 BBESDCOL BBESITKB BBESPMST HPSCLAC0 HPSCOPTS
  HPSGCM10 HPSGCSC1 HPSGGIO0 HPSGGIT0 HPSGGRG0 HPSGGRM0 HPSGGVM0
  HPSGITKB HPSGRS10 HPSGTJ00 HPSPTM00 HPSPTU00
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI18712

     UP14/06/17 P F406

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.