PK19395: IPR DRIVER SHOULD TURN OFF PARTITION INIT NEEDED FLAG

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• After reorganizing a HALDB, the Partition Init Needed flag is
  not turned off for each partition in DBRC.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Driver of IMS Parallel      *
  *                 Reorganization for z/OS Version 3 Release 1  *
  *                 (FMID=H25N310)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: After reorganizing HALDB, the Partition *
  *                      Init Needed flag is not turned off for  *
  *                      each partition in RECON.                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  IPR Driver does not turn off the PARTITION INIT NEEDED flag for
  HALDB partitions on RECON.
  

Problem conclusion

Temporary fix

Comments

• IPR Driver has been modified so that IPR Driver turn off the
  Partition Init Needed flag for each partition in RECON.
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS Version 3 Release 1
  User's Guide (SC18922801) should be changed as follows:
  ================================================================
   Chapter 2. IMS Parallel Reorganization Driver
   2.7   Control statements
   2.7.8 Description of control statements for Reorganization
         Manager
   2.7.8.17 NAMESWAP control statement
  
   :
   If you specify NAMESWAP=YES and the data set name swapping
   succeeds, Reorganization Manager issues DBRC NOTIFY.REORG
   commands for the reorganized database and the primary index.
  |For each HALDB partition, if the PARTITION INIT NEEDED flag
  |in RECON is on, the DBRC command CHANGE.DB NOPINIT is issued
  |before NOTIFY.REORG commands.
  |If the active DBDS is the M-through-V and Y side, the DBRC
   command CHANGE.DB OLRDBDS(A) is issued. If you specify
   INDEXBLD=YES, the NOTIFY.REORG command is also issued for each
   secondary index.
   :
  ================================================================
   2.9 Post-reorganization processing
   2.9.3 Manual DBRC notification processing
  
   The DBRC notification processing must be done after the data
   set name swapping. If you specified ILDSBLD=NO in the preceding
   IPR Driver job for a HALDB and it should have non-empty ILDSs,
   you must rebuild ILDS for each partition that has been
   reorganized by the IPR Driver job before doing the DBRC
   notification processing explained below. You can use IMS HALDB
   Index/ILDS Rebuild Utility (DFSPREC0) to rebuild ILDSs.
   The way the DBRC notification processing is done varies at
   installations, but a typical sequence of steps is:
  
  | 1. For a HALDB, you need to issue the command to turn off
  |    the PARTITION INIT NEEDED flag for each partition,
  |    because all the specified partitions have been
  |    initialized before reloading segments.
  |       CHANGE.DB DBD(part_name) NOPINIT
  |
  | 2 Notify DBRC that the reorganization has taken place.
      For a non-HALDB, issue the following commands for all DD
      names of the reorganized database and primary index.
      For a HALDB, issue the command for each partition
      and each DD name of the partition except the DD name
      for ILDS and the primary index of PHIDAM.
          NOTIFY.REORG DBD(dbd_or_part_name) DDN(ddname)
  
   :
  ================================================================
   Chapter 10. Messages and Codes
   10.3 Messages
   10.3.2 HPSG Messages
  ----------------------------------------------------------------
  HPSG0316I CHANGE.DB DBD(dbdname) parameter
   Explanation: The CHANGE.DB command has been successfully
   completed for the database or HALDB partition dbdname.
   parameter is one of the following:
   -OLRDBDS(A)
   -READON
   -NOAUTH
   -AUTH READOFF
   -NOAUTH READOFF
   -AUTH READON
   -NOAUTH READON
  |-NOPINIT
  System Action: The IPR Driver continues processing.
  Programmer Response: None.
  ----------------------------------------------------------------
   HPSG0316E CHANGE.DB DBD(dbdname) parameter --- ERROR (CC=xx)
   Explanation: An error occurred when the IPR Driver issued the
   CHANGE.DB command for the database or a HALDB partition
   dbdname. The condition code returned from DSPURX00 is xx.
   parameter Report of Reference
   -OLRDBDS(A)
     DBRC AUTHORIZATION PROCESSING FOR NAME SWAPPING
   -READON
     DBRC AUTHORIZATION PROCESSING FOR REORGANIZATION
   -NOAUTH
     DBRC AUTHORIZATION PROCESSING FOR REORGANIZATION
     or
     DBRC AUTHORIZATION PROCESSING FOR NAME SWAPPING
   -AUTH READOFF
     DBRC NOTIFICATION PROCESSING
  |-NOPINIT
  |  DBRC NOTIFICATION PROCESSING
   If the preceding HPSG0410I message was issued, see the report
   titled "DBRC PROCESSING FOR RESTORING AUTHORIZATION FLAGS."
   System Action: The IPR Driver ends with a return code of 8.
   Programmer Response: Refer to the messages issued from the DBRC
   utility, and identify the cause of the error. The messages are
   printed in the HPSOUT2 data set.
  ======================= End of Doc-Change ======================
  

APAR Information

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

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

  UK12234

Modules/Macros

•    HPSGGRMB HPSGRS00 HPSGRS30
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R310 PSY UK12234

     UP06/03/03 P F603

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.