PI68964: ILDSBLD CONTROL STATEMENT EHHANCEMENT

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides ILDS control statement enhancements:
  
    - Add a new keyword COND to select DSPR or INITONLY
      automatically:  ILDSBLD=(YES,COND)
    - Change the system default from DSPR to COND
    - Eliminate the check of HPSG0234E
      HPSG0234E ILDSBLD IS VALID ONLY FOR HALDB
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS Database Reorganization Expert for   *
  *                 z/OS V4.1 (FMID=H25N410) users.              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables a new COND option     *
  *                      of the ILDSBLD control statement for    *
  *                      the Smart Reorg utility and the IPR     *
  *                      Reload utility.                         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables a new option of the ILDSBLD control statement
  for the Smart Reorg utility and the IPR Reload utility:
   ILDSBLD=(YES,COND)
  If the ILDSBLD statement is not specified in either
  an Installation Default Option Table (HPSCOPTI) or the HPSIN
  data set, ILDSBLD=(YES,COND) is applied. If PSINDEXBLD=YES is
  specified, no ILE records are built in each ILDS data set.
  This enhancement requires APAR PI69221 for IMS High Performance
  Load (FMID=H1IM210).
  
  Some control statement checks are changed. The following error
  messages will be disabled and the invalid specifications will be
  ignored and the processing will continue.
  -HPSG0234E for ILDSBLD and PARTITION control statements
    HPSG0234E keyword IS VALID ONLY FOR HALDB
  -HPSG0237E for DDNMAP and PREFIXRES control statements
    HPSG0237E keyword CANNOT BE SPECIFIED FOR HALDB
  -HPSG0236E for PARTITION control statement
    HPSG0236E PARTITION STATEMENT CANNOT BE SPECIFIED IN
             UNLOAD BLOCK
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's
  Guide Version 4 Release 1 Suffix 5 (SC19-1137-05) should be
  changed as follows:
  ---------------------------------------------------------------
   > Control statements for the Smart Reorg Driver
   >> ILDSBLD Control statement
  
    Specifies whether to build the Indirect List data set (ILDS)
    for the HALDB in the Smart Reorg job step. This statement is
    applicable only to HALDBs.This control statement is optional.
  | The default is ILDSBLD=YES,COND.
  
  |             +-YES,COND-----+
   >>-ILDSBLD=--+-YES,DSPR-----+--------------------------><
                +-YES,INITONLY-+
                +-NO-----------+
  
  |YES,COND
  | Applies either YES,DSPR or YES,INITONLY. If both of
  | the following conditions are met, YES,INITONLY is applied.
  | Otherwise, YES,DSPR is applied.
  | - Either PSINDEXBLD=YES is specified in the REORG block
  |   or the WFPHLQ=hlq is specified in the RELOAD block.
  | - HALDB has no logical relationships define
  :
  Notes:
   - The ILE records that are created by the Smart Reorg utility
     with ILDSBLD=YES,DSPR are the same as the records created
     by DFSPREC0.
   - ILDSBLD=YES is obsolete. If you specify ILDSBLD=YES,
  |  ILDSBLD=YES,COND is applied.
  
  |Tip: You can change the default value of this control statement
  |by creating an Installation Default Option Table (HPSCOPTI).
  |For more information, see Setting installation default options.
  ---------------------------------------------------------------
   > Reloading a database
   >> IPR Reload control statements
   >>> ILDSBLD control statement
  
  
    Specifies whether to build ILDS and how to build the ILDS.
    This control statement is optional. The default is
  | ILDSBLD=YES,COND
  
  |             +-YES,COND-----+
   >>-ILDSBLD=--+-YES,DSPR-----+--------------------------><
                +-YES,INITONLY-+
                +-C------------+
                +-NO-----------+
  
  | YES,COND
  | Applies either YES,DSPR or YES,INITONLY. If both of
  | the following conditions are met, YES,INITONLY is applied.
  | Otherwise, YES,DSPR is applied.
  | - The WFPHLQ=hlq is specified.
  | - HALDB has no logical relationships defined.
  :
  
    Note: ILDSBLD=YES is obsolete. If you specify ILDSBLD=YES,
  | ILDSBLD=YES,COND is used.
  
  |Tip: You can change the default value of this control statement
  |by creating an Installation Default Option Table (HPSCOPTI).
  |For more information, see Setting installation default options.
  ---------------------------------------------------------------
  > Setting installation default options
  >> How to code HPSCOPT macro statements
  
  DRIVER
  
              .-,-------------------------------------.
              V                                       |
    |--DRIVER---+-----------------------------------+-+---------|
                :                                   :
   |            |          .-(YES,COND)------.      |
                +-ILDSBLD=-+-(YES,DSPR)------+------+
                |          +-(YEWS,INITONLY)-+      |
                |          '-NO-------------'       |
  
  :
  
  RELOAD
  
              .-,-------------------------------------.
              V                                       |
    |--RELOAD---+-----------------------------------+-+---------|
                :                                   :
   |            |          .-(YES,COND)-----.       |
                +-ILDSBLD=-+-(YES,DSPR)-----+-------+
                |          +-(YES,INITONLY)-+       |
                |          +-C--------------+       |
                |          '-NO-------------'       |
  
  ---------------------------------------------------------------
  ================ 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:

  UI41852

Modules/Macros

• HPSGCSC1
  

Fix information

• Fixed component name

  IMS DB REORG EX

• Fixed component ID

  5655F7400

Applicable component levels

• R410 PSY UI41852

     UP16/10/21 P F610

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.