PQ96412: FIX PROBLEMS FOUND BETWEEN CODE FREEZE AND 'GA'.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR provides fixes for all problems found between code
  freeze and 'GA'.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Parallel Reorganization for *
  *                 z/OS Version 3 Release 1 (FMID=H25N310).     *
  ****************************************************************
  * PROBLEM DESCRIPTION: The following problems of IPR Driver    *
  *                      are fixed by the maintenance provided   *
  *                      by this APAR:                           *
  *                      1. When an error occurs in the Image    *
  *                         Copy task (IMGCPY task) and no other *
  *                         task got an error, the action        *
  *                         message HPSG0016A ( MSGHPSG0016A )   *
  *                         should be issued and the IPR Driver  *
  *                         should end with a return code of 12  *
  *                         ( RC12 ).                            *
  *                      2. The DBRC Notification Processing     *
  *                         report is not printed if an error    *
  *                         occurs in a DBRC command processing  *
  *                         when IC=YES is specified.            *
  *                      3. If IPR Driver runs with ILDSBLD=YES  *
  *                         when a lot of ILEs are contained in  *
  *                         a HALDB ILDS, the random read to     *
  *                         original ILDS occurs in large        *
  *                         quantities and the elapsed time      *
  *                         surges.                              *
  *                      4. IPR Driver gets to ABEND U0102 when  *
  *                         the following conditions are met:    *
  *                         - INDEXBLD=YES is specified          *
  *                         - ICTYPE=B or PREFIXRES=YES is       *
  *                           specified                          *
  *                         - One of secondary indexes is empty  *
  *                      5. In some cases, IPR Driver ends with  *
  *                         a return code of zero although a sub *
  *                         task got an abend.                   *
  *                      6. The REUSE parameter for VSAM         *
  *                         clusters is not respected for shadow *
  *                         data sets and the error message      *
  *                         HPSG0385E ( MSGHPSG0385E ) is        *
  *                         issued.                              *
  *                      7. The REUSE parameter for VSAM         *
  *                         clusters for the shadow data sets of *
  *                         HALDB is not checked although the    *
  *                         REUSE parameter should be forced for *
  *                         HALDB data sets other than ILDS.     *
  *                      8. The automated post-reorganization    *
  *                         processing that is activated by      *
  *                         NAMESWAP=YES should be done even     *
  *                         if the original or reorganized       *
  *                         database is empty.                   *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The problems listed in the Problem Description section are
  fixed. For the changes that might have an affect on your
  existing IPR Driver jobs, see the Problem Conclusion section.
  

Problem conclusion

• The problems listed in the Problem Description section are
  fixed. The following changes in IPR Driver that will be made by
  this APAR should be noted before you apply the maintenance
  provided by the APAR:
  - The ILE record that are created by the IPR Driver when
  ILDSBLD=YES is specified are different from those created
  by IPR Driver V3 without this APAR and IPR Driver V2.
  With this APAR applied, the ILE records that are created
  by the IPR Driver become same as those created by DFSPREC0.
  This change has been made so that the elapsed time for
  building ILDS records can be reduced significantly.
  - IPR Driver has been modified so that the REUSE parameter
  specified for the VSAM cluster for shadow data sets will
  be checked and respected:
   (1) The error message HPSG0385E ( MSGHPSG0385E ) will
       not be issued if the REUSE parameter is specified
       for the VSAM cluster of a shadow data set that
       is not empty.
   (2) The error message HPSG0396E ( MSGHPSG0396E ) will
       be issued if the REUSE parameter is not specified
       for the VSAM cluster of a shadow data set other
       than ILDS.
  - After applying this APAR, the automated post-reorganization
  processing that is activated by the NAMESWAP=YES control
  statement will be performed for non-HALDB even if the
  reorganized database is empty. Before this APAR and in IPR V2,
  the automated post-reorganization processing was not performed
  for non-HALDB if the reorganized database was empty.
                             * * *
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS Version 3 Release 1 User's
  Guide (Document Number: SC18-9228-00) should be changed as
  follows.
  ================================================================
  1.2 Processing Environments
  1.2.1 Software Requirements
                            :
    The following software is required:
    - IMS High Performance Unload for OS/390, Release 1 with APAR
      PQ93668 or later.
    - IMS High Performance Load for z/OS, Version 2 Release 1 or
      later.
  |   - The maintenance provided by APAR PQ96282 must be applied.
    - IMS Library Integrity Utilities for z/OS, Release 1 or later
      if DECODEDBD=YES.
  ================================================================
  2.7.8 Description of Control Statements for Reorganization
        Manager
  2.7.8.13 ILDSBLD Control Statement
                            :
    If you specify ILDSBLD=NO, no shadow ILDS is built. If the
    HALDB has ILDS and ILDSBLD=NO is specified, you must rebuild
    ILDS after the name swapping of the shadow database. To do
    this, scan the reorganized database by using DFSPREC0.
  | Note: The ILE records that are created by the IPR Driver with
  | ILDSBLD=YES are same as those created by DFSPREC0.
  ================================================================
  Appendix E. Messages and Codes
  E.3 Messages
  E.3.2 HPSG Messages
  *
    HPSG0111E PRE-PRODUCT ERROR (reason); PROD=prodname
                            :
    Reason Code   Meaning
    01000001      IMS High Performance Unload is not installed or
                  its release or maintenance level is not enough
                  high to be run under IPR V3
    02000001      IMS High Performance Load V2 is not installed
  | 02000002      The maintenance that is provided by APAR PQ96282
  |               must be applied to IMS High Performance Load V2.
    03000001      IMS Index Builder V2R3 is not installed or not
                  in the required maintenance level to be run
                  under IPR V3
                            :
  *
  | HPSG0396E HALDB VSAM CLUSTER MUST BE DEFINED AS REUSABLE;
  |           DDN=ddname
  | Explanation: The VSAM cluster for the HALDB data set, which
  | is specified on the DD statement ddname, must be defined with
  | the REUSE parameter.
  | System Action: IPR Driver ends with a return code of 8.
  | Programmer Response: Specify the REUSE parameter when you
  | allocate the space for the shadow data set by using the DEFINE
  | CLUSTER command.
  

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:

  UQ95041

Modules/Macros

• HPSGCM00 HPSGGDLB HPSGGRGB HPSGGRG0 HPSGGSTB
  HPSGGVM0 HPSGGVT0 HPSGICS  HPSGICSD HPSGICS0 HPSGMAIN HPSGMSGT
  HPSGRA00 HPSGRA40 HPSGRP00 HPSGRR00 HPSGRS00 HPSGTJ00 HPSGTM00
  HPSGTM30 HPSGTR00
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R310 PSY UQ95041

     UP04/12/07 P F412

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.