PM67105: ACBGEN UTILITY PARAMETER BLDPSB=NO DOESN'T WORK FOR FAST PATH DB

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the user specifies BLDPSB=NO for the Advanced ACBGEN
  utility BUILD DBD= statement, all the related PSBs referenced to
  the FAST PATH DBD will be re-built no matter whether the DBD
  changes its physical structure.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS Library Integrity Utilities for z/OS,    *
  *                 Version 2 Release 1 (FMID=H27P210) users     *
  *                 who use the Advanced ACBGEN utility under    *
  *                 IMS V10 or IMS V11.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: By this APAR, the Advanced ACBGEN       *
  *                      utility is corrected not to rebuild     *
  *                      PSBs which references the DBD(including *
  *                      Full Function database, Fast Path DEDB, *
  *                      Full Function primary index, secondary  *
  *                      index and shared secondary index        *
  *                      databases) that does not have a         *
  *                      physical database structure changes     *
  *                      under IMS V10 and IMS V11, when         *
  *                      parameter BLDPSB=NO is specified on     *
  *                      BUILD DBD= control statement in         *
  *                      Advanced ACBGEN utility jobs.           *
  *                      To enable this, Advanced ACBGEN need    *
  *                      the IMS environment with the following  *
  *                      IMS APARS.                              *
  *                       - PM54168 for IMS V10                  *
  *                       - PM64595 for IMS V11                  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When parameter BLDPSB=NO was specified on BUILD DBD= control
  statement in Advanced ACBGEN utility without this APAR, all the
  PSBs that referenced the FP DB or shared secondary index DB were
  rebuilt whether DBD had a physical database structure changes or
  not.
  
  By this APAR, Advanced ACBGEN utility is corrected not to
  rebuild PSBs which references the DBD(including Full Function
  database, Fast Path DEDB, Full Function primary index, secondary
  index and shared secondary index databases) that does not have a
  physical database structure changes under IMS V10 and IMS V11.
  Advanced ACBGEN utility will output same results as IMS ACBGEN
  does.
  
  To enable this, Advanced ACBGEN needs the IMS environment with
  the following IMS APARs.
   - IMS ACBGEN APAR PM54168 for IMS V10
   - IMS ACBGEN APAR PM64595 for IMS V11
  
  If Advanced ACBGEN utility with this APAR runs in the IMS
  environment that does not have APARs PM54168 or PM64595 applied,
  the results has changed. PSBs will not be always rebuild when
  BLDPSB=NO is specified on the BUILD DBD=dbdname control
  statement and whether DBD had a physical database structure
  changes or not. This result is not expected results for
  BLDPSB=NO parameter. So apply IMS APARs PM54168 or PM64595 when
  this APAR will be applied.
  
  Advanced ACBGEN utility under IMS V12 is not changed by this
  APAR.
  

Problem conclusion

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The documentation " IMS Library Integrity Utilities for
  z/OS, V2R1, User's Guide (SC19-2479-01)" is changed.
  ================================================================
  13.0 Troubleshooting
   13.4 IMS Library Integrity Utilities messages
    13.4.4 FABQ messages
  
  <<The explanation is updated>>
  
  13.4.4.85 FABQ9997I
  
    FABQ9997I nnnnnnn PSBS TO BE PROCESSED BY ACBGEN
  
    Explanation: This message is issued when the
    MONITOR=(PROGRESS=(Y,frequency_value)) operand is specified in
    the ACBSYSIN data set. nnnnnnn is the number of the members
    that was specified either explicitly or implicitly in the
  | SYSIN data set and that will be processed by the ACBGEN
  | utility.
  | If BUILD DBD=dbdname,BLDPSB=NO is specified and if PSBs
  | reference the DBDs for Fast Path DEDBs or shared secondary
  | index databases that do not change the physical structure of
  | database, the ACBGEN utility skips rebuilding such PSBs during
  | the PSB process. In this case, the number of members that are
  | actually processed will be fewer than nnnnnnn.
  
  13.4.4.86 FABQ9998I
  
    FABQ9998I mmmmmmm OF nnnnnnn PSBS PROCESSED BY ACBGEN
  
    Explanation: This message is issued when the
    MONITOR=(PROGRESS=(Y,frequency_value)) operand is specified in
  | the ACBSYSIN data set. mmmmmmm is the number of the members
  | that were just processed.
  | If BUILD DBD=dbdname,BLDPSB=NO is specified and if PSBs
  | reference the DBDs for Fast Path DEDBs or shared secondary
  | index databases that do not change the physical structure of
  | database, the ACBGEN utility skips rebuilding such PSBs during
  | the PSB process. In this case, the number of members that are
  | actually processed will be fewer than nnnnnnn.
  

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:

  UK80081

Modules/Macros

•    FABQDRIV FABQMAIN FABQRLVA FABQRLVB FABQRPT1
  FABQTASK
  

Fix information

• Fixed component name

  IMS LIBR INTEG

• Fixed component ID

  5655I4200

Applicable component levels

• R210 PSY UK80081

     UP12/07/08 P F207

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.