PH44659: DRF JOBS USING CUSTPARM(BPECFGNN) MAY END ABNORMALLY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The CUSTPARM(BPECFGnn) generated by IMS Tools Setup is shared
  among multiple products. If CUSTPARM(BPECFGnn) contains
  parameters for other products, IMS Database Recovery Facility
  jobs end abnormally because DRF does not allow sharing of the
  BPE member.
  Additional symptoms:
  

Local fix

• Copy parm member FRXBPECF from SFRXSAMP into the CUSTPARM
  dataset, and change the call to DRF / DRF-XF to use FRXBPCEF.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM Tools Base for z/OS         *
  *                 Version 1 Release 6 (FMID: HAHN160) who use  *
  *                 IMS Tools Setup.                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: DRF jobs that use the BPE configuration *
  *                      member CUSTPARM(BPECFGnn) generated by  *
  *                      IMS Tools Setup may terminate           *
  *                      abnormally.                             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The CUSTPARM(BPECFGnn) generated by IMS Tools Setup is shared
  among multiple products. Therefore, it may contain BPE
  parameters for multiple products. If CUSTPARM (BPECFGnn)
  contains parameters for other products, DRF jobs end abnormally
  because the DRF does not allow sharing of BPE member.
  

Problem conclusion

• IMS Tools Setup has been modified to create a BPE configuration
  member dedicated to DRF and allow DRF jobs to reference this
  member. In addition, IMS Tools Setup has been modified to
  correctly generate a JCL that enables the BMP pause feature by
  adding the ORF modules to IMS SDFSRESL data set. The previous
  JCL used the older versions of the ORF module.
  The following members have changed in this APAR:
    - CUSTJCL(#A7BMPUM)
    - CUSTJCL(#C7INIT1)
    - CUSTJCL(#C7INIT2)
    - CUSTJCL(#F2IVP0)
    - CUSTJCL(#F3IVP2)
    - CUSTJPDS(BSYDRF)
    - CUSTPARM(BSY#PARM)
    - CUSTPARM(FRXBPECF)
    - CUSTPROC(DRFXF)
    - CUSTPROC(FRXIAX00)
    - CUSTPROC(FRXMAS00)
    - CUSTPROC(FRXRSS00)
  

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:

  UI79755

Modules/Macros

• HKTQBSG1 HKTQHATY HKTQHBSY HKTQHDBS HKTQHFAB HKTQHFPS HKTQHGCL
  HKTQHGLX HKTQHHCO HKTQHHKT HKTQHIDL HKTQHIHC HKTQHIRP HKTQHIRT
  HKTQHSH1 HKTQSETV
  

Fix information

• Fixed component name

  IMS TOOLS BASE

• Fixed component ID

  5655V9300

Applicable component levels

• R160 PSY UI79755

     UP22/03/17 P F203

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.