PK48424: ENHANCEMENT FOR THE PARTINIT CONTROL STATEMENT OF THE IPR RELOADUTILITY

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• The PARTINIT control statement of the IPR Reload Utility is
  allowed to be specified in the installation default option.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IPR Reload utility of IMS       *
  *                 Parallel Reorganization for z/OS Version 3   *
  *                 Release 2 (FMID=H25N320)                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the availability of  *
  *                      the PARTINIT statement to the           *
  *                      installation default options for IPR    *
  *                      Reload.                                 *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the availability of the PARTINIT statement
  to the installation default options for IPR Reload.
  If you apply the following APARs, you can also use the new
  option PARTINIT=YES,UNLOAD for IPR Reload:
   - APAR PK48420 for IMS High Performance Load (FMID=H1IM210)
   - APAR PK48499 for IMS High Performance Unload (FMID=H1IN110)
  
  If you specify PARTINIT=YES,UNLOAD for IPR Reload,
  initialization of a HALDB partition is to be performed for the
  partition which remains empty after the reload and the partition
  information is included in the unloaded data set.
  The initialization is to be performed regardless of the
  PARTITION INIT NEEDED flag in the DBRC RECON record.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS Parallel Reorganization for z/OS User's Guide (SC18922802)
  should be changed as follows:
  
  4.7.2 Overview of IPR Reload control statements
  
  Table 37 shows IPR Reload control statements for a partitioned
  database.
  
    +-----------+---------------+-------+-----------------------+
    | Keyword   |Accepted values|Default| Description           |
    +-----------+---------------+-------+-----------------------+
    |PARTINFO=  | YES or NO     | YES   | Specifies whether to  |
    |           |               |       | generate the HALDB    |
    |           |               |       | Partition Definition  |
    |           |               |       | report. See "PARTINFO |
    |           |               |       | control statement" in |
    |           |               |       | topic 4.7.18.         |
    +-----------+---------------+-------+-----------------------+
    |PARTINIT=  ||NO            | NO    | Initializes partitions|
    |           ||YES           |       | not populated by any  |
    |           ||YES,PINITON   |       | segment during reload.|
    |           ||YES,UNLOAD    |       |                       |
    +-----------+---------------+-------+-----------------------+
  
  
  4.7.19        PARTINIT control statement
  
  | Specifies whether to initialize HALDB partitions after reload.
  | High Performance Load initializes a HALDB partition when a
  | HALDB partition does not contain any segment during reload.
  
   +-------------------------------------------------------------+
   |                                                             |
   |                     _NO_______________                      |
   |                    |      _,PINITON_  |                     |
   | >>____PARTINIT=____|_YES_|__________|_|_________________><  |
   |                          |_,UNLOAD__|                       |
   |                                                             |
   +-------------------------------------------------------------+
  
  NO
    Specifies that any initialization of a HALDB partition is not
    to be performed after reload.
  
  YES
    Specifies that initialization of a HALDB partition is to be
    performed for partitions not populated by any segment during
    reload.
  |    PINITON
  |       Specifies that initialization of a HALDB partition is to
  |       be done when the flag in the DBRC RECON record for the
  |       partition shows that the partition needs to be
  |       initialized (PINIT). If you only specify PARTINIT=YES,
  |       PARTINIT=YES,PINITON is assumed.
  |
  |    UNLOAD
  |       Specifies that initialization of a HALDB partition is to
  |       be done when the partition information is included in
  |       the input unloaded data set.  To use this option, the
  |       following conditions must be satisfied:
  |
  |         - APAR PK48420 is applied to HP Load.
  |         - The input unloaded data set has been created by HP
  |           Unload with APAR PK48499 and with the CHECKREC=YES
  |           option.
  |
  |         - The input unloaded data sets are not concatenated.
  
  If you want to use High Performance Load as a replacement for
  the HALDB partition data set initialization utility, specify
  the PARTINIT=YES control statement and DFSUINPT DD DUMMY for the
  High Performance Load JCL, and run it.
  
  | Note: You can add this option to the installation default
  | option table.  For details, see "Setting installation default
  | options" in topic 6.0.
  
  
  4.8.1.2       Default Option Tables report
  
  Figure 97 is an example of the Default Option Tables report.
  
      IMS HIGH PERFORMANCE LOAD                      PAGE:       1
      5655-M26                                08/15/2006  17.24.31
  
                                 "DEFAULT OPTION TABLES"
  
  
            SYSTEM DEFAULT: HPSCOPTS IN IPR310.SHPSLMD0
      INSTALLATION DEFAULT: HPSCOPTI IN IPR310.SHPSLMD0
  
      KEYWORD        SYSTEM DEFAULT         INSTALLATION DEFAULT
      ------------   --------------------   --------------------
      CHKUPDT        NO                     NO
      DECODEDBD      NO                     YES
      HPIO           N/A                    N/A
      OADSPR         NO                     NO
  |   PARTINIT       NO                     (YES,UNLOAD)
      PARTINFO       YES                    YES
  
  
  6.4           How to code HPSCOPT macro statements
  
    +------------------------------------------------------------+
    |                                                            |
    | >>__HPSCOPT=__ START___                                    |
    |  ;                                                         |
    |  ;                                                         |
  | |              |          _| ,M |_    _| ,P |_               |
  | |              |_DRIVRL__|________|__|________|_____________ |
    |  ;                                                         |
    |  ;                                                         |
    |              |          _| ,C |_    _| ,D |_    _| ,K |_   |
    |              |_RELOAD__|________|__|________|__|________|_ |
  | |                         _| ,L |_    _| ,M |_    _| ,P |_   |
  | |                      __|________|__|________|__|________|  |
    |  ;                                                         |
    |  ;                                                         |
  | | P:                                                         |
  | |                _NO________________________                 |
  | |               |             _PINITON_     |                |
  | | |__PARTINIT=__|_(__YES__,__|_________|__)_|________________|
    |                            |_UNLOAD__|                     |
    |                                                            |
    +------------------------------------------------------------+
  
  The identifier of each utility and the option keywords supported
  by the utility are as follows:
  ;
  ;
  - DRIVRL identifies the Reload task under IPR Driver
  |    OADSPR and PARTINIT
  ;
  ;
  - RELOAD identifies the IPR Reload utility
  |    DECODEDBD, PARTINFO, CHKUPDT, HPIO, OADSPR, and PARTINIT
  

APAR Information

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

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

  UK27475

Modules/Macros

• HPSCOPT  HPSCOPTD HPSCOPTS HPSGOPTR
  

Fix information

• Fixed component name

  IMS PARALLEL RE

• Fixed component ID

  5655F7400

Applicable component levels

• R320 PSY UK27475

     UP07/07/27 P F707

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.