PI65714: CHANGE DBDS NORECOV COMMAND BEING ISSUED REGARDLESS OF RECOV_NEEDED STATUS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Currently, the CHANGE.DBDS DBD(xxxxxxxx) DDN(xxxxxxx) NORECOV
  commands are issued regardless of the RECOV_NEEDED flag status
  in RECON. The command should be issued only if RECOV_NEEDED flag
  is ON.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Index Builder for z/OS,     *
  *                 Version 3 Release 1 (FMID=H22O310)           *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR changes the followings:       *
  *                                                              *
  *                      1. CHANGE.DBDS DBD(xxxxxxxx)            *
  *                         DDN(xxxxxxx) NORECOV commands are    *
  *                         issued based on the RECOV_NEEDED     *
  *                         flag status.                         *
  *                      2. The IMS DD dynamic concatenation is  *
  *                         disabled. The IMS Index Builder      *
  *                         load library is no longer needed to  *
  *                         be concatenated to the IMS DD.       *
  *                      3. The PROGMON control statement is     *
  *                         added for monitoring the progress of *
  *                         the secondary index loading process. *
  *                                                              *
  *                      And the following problem is fixed:     *
  *                                                              *
  *                      4. ABENDS0C4 at IIUBDBD+2982 when       *
  *                         BLD_PRIMARY and BLD_SECONDARY is     *
  *                         specified for HIDAM.                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The changes described in the problem description field are
  added.
  
  After applying this APAR, the DBRC command
  CHANGE.DBDS DBD(xxxxxxxx) DDN(xxxxxxx) NORECOV
  is issued based on the status of the DBRC RECOV_NEEDED flag
  for each index and whether 'DBAUTH YES,RECOV' control statement
  is specified.
  

Problem conclusion

• ========================
  = Documentation Change =
  ========================
  IBM IMS Index Builder for z/OS, V3R1, User's Guide
  (SC18-9101-06) should be changed as follows:
  ================================================================
  (D indicates the line to be deleted. I indicates the line to be
  added.)
  ----------------------------------------------------------------
  > Using Index Builder
  >> JCL and input control statements
  >>> IMS Index Builder JCL
  >>>> DD statements
  
  
   IMS DD statement
  
   This DD statement is used to access the involved databases.
   The file points to one or more libraries that contain the DBDs
   of the physical database and its indexes.
  
  D The IMS Index Builder load library can be concatenated
  D to provide the generic IMS Index Builder reusable PSBs.
  D Otherwise, IMS Index Builder will dynamically concatenate
  D the IMS Index Builder load library to IMS DD if the Index
  D builder load library is in the STEPLIB concatenation.
  D If seven or more libraries are concatenated to IMS DD,
  D the IMS Index Builder load library must be concatenated
  D to the IMS DD.
  D Because IMS Index Builder might dynamically reallocate
  D the libraries allocated in the IMS DD statement, this DD
  D statement must not contain temporary data sets.
  
  This statement is required.
  ----------------------------------------------------------------
  >>> IMS Index Builder input control statements
  >>>> Optional control statements
  >>>>> PROGMON control statement
  
  | The PROGMON control statement specifies the interval of
  | the WTO IIUB119I messages for monitoring the load process
  | of each secondary index.
  | If this statement is not specified, the default value 0
  | is used.
  |
  | +---------------------------------------------------------+
  | |               .---- 0 ---.                              |
  | | >>- PROGMON --+- nnnnnn -+------------------------><    |
  | +---------------------------------------------------------+
  |
  | PROGMON
  |   Specifies that this is a PROGMON statement.
  | nnnnnn
  |   Is the interval number of the loaded records, in the range
  |   of 0 - 999999.
  |   If you specify 0, the IIUB119I message is not shown.
  |
  | Tips:
  | - You can override the default value in the runtime
  |   parameters module. See the explanation of the IIURDFLT
  |   PROGMON entry in Defining runtime parameters.
  ----------------------------------------------------------------
  >> Defining runtime parameters
  
  
   Figure 1. Example of an IMS Index Builder runtime parameters
   module (Part 2 of 2)
   :
  
    *        DC    CL52'IIURDFLT  MAXTASKS  02'
  | *        DC    CL52'IIURDFLT  PROGMON   100000'
  
  | IIURDFLT PROGMON entry
  |   Use the IIURDFLT PROGMON entry to specify the interval of
  | the WTO IIUB119I messages for monitoring the load process
  | of each secondary index.
  | For details, see PROGMON control statement.
  ----------------------------------------------------------------
  > Troubleshooting
   >> IMS Index Builder messages
  
  | IIUB119I INDEX  DBD|PART =xxxxxxxx- n,nnn,nnn,nnn RECORDS
  |          LOADED  *COMPLETED*
  |
  
  | Explanation: This WTO message shows the number of loaded index
  | records for an index or a partition for monitoring the
    process.
  | System action: Processing continues.
  | User response: None. This message is informational.
  ---------------------------------------------------------------
  ================ End of Documentation Change ===================
  

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:

  UI40179

Modules/Macros

•    IIUBDAPI IIUBDBD  IIUBE352 IIUBIBCD IIUBMSGS
  IIUBSCTL IIUBSTMS IIUDRVRX IIUNDXRC IIUPDBRC IIUPRLNT IIUSCA25
  IIUSE35P IIUSIBCD IIUSMP10
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels

• R310 PSY UI40179

     UP16/08/20 P F608

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.