PQ82450: ABEND0C4 WILL OCCUR IN MODULE FRXCBI0$ NEAR OFFSET X'554' IF NO BPE CONFIG MEMBER IS SPECIFIED WHEN CQS IS STARTED.

APAR status

• Closed as program error.

Error description

• An ABEND0C4 occurs in module BPECBI00 when CQS is started
  without specifying a BPE config member.When no config member
  specified no CFGB is built. The code in BPECBI00 assumes the
  CFGB parameter is always in the CSCD Control Block.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Database Recovery Facility  *
  *                 V2R1 who do not specify a BPE                *
  *                 configuration PROCLIB member on their        *
  *                 startup JCL (BPECFG=).                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: ABEND0C4 in module FRXCBI0$ when IMS    *
  *                      DRF is started without specifying a BPE *
  *                      configuration PROCLIB member on the     *
  *                      region startup JCL.                     *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  An ABEND0C4 occurs in module FRXCBI0$ when IMS DRF is started
  without a BPE configuration PROCLIB member specified on the EXEC
  card PARM= parameter.
  
  BPE control parameters (for example, trace table level settings)
  are specified in a BPE configuration PROCLIB member.  The name
  of the PROCLIB member is specified on the region startup JCL on
  the PARM= parameter of the EXEC card.  For example:
  
    //STEP1  EXEC  PGM=FRXSDR00,PARM='BPECFG=BPECFDRF'
  
  The BPECFG= parameter is optional.  When the parameter is coded,
  BPE builds an internal control block called a CFGB, into which
  it places the data from the parameters specified in the BPE
  configuration PROCLIB member.  The CFGB is used later on in BPE
  functions to determine what configuration data was passed to
  BPE.
  
  When the parameter is not coded, BPE does not build the CFGB,
  and the pointer to the CFGB is zero in the BPE CSCD block.
  
  Module FRXCBI0$ does not check for a zero CFGB address before
  using the value in the CSCD field cscd_cfgb.  This leads to an
  0C4 abend due to using low core as the CFGB block.
  
  Circumvention:
  
    Define a member in a data set pointed to by the PROCLIB DD
    card in the DRF JCL.  The member should consist of a single
    blank line.  Then start DRF, and add the parm BPECFG=xxxxxxxx
    to the EXEC card PARM statement in the DRF JCL, where
    xxxxxxxx is the name of the blank-line PROCLIB member.
  

Problem conclusion

•  AIDS: RIDS/SYS RIDS/CNTRL SYS CNTRL
    DEP: NONE
    GEN:
  
  *** END IMS KEYWORDS ***
  Module FRXPCFG$ is changed to always build a CFGB, even if the
  BPE configuration PROCLIB member is not specified.  When there
  is no configuration member, FRXPCFG$ now builds a minimal CFGB
  with default configuration values filled in.  This allows
  modules like FRXCBI0$ to always use the CFGB without having to
  test to see if its pointer is zero.
  
  A new bit, cfgb_f1_noCfgMbr, is added to the CFGB block.  This
  bit is turned on by FRXPCFG$ when a CFGB is built and there is
  no configuration member specified.  The bit is provided solely
  for diagnostics, so that it can be easily determined from a dump
  that the system is using the default configuration values.
  
  Dump formatter module FRXFM09$ is recompiled to pick up changes
  to the CFGB dump format list for the new flag.
  

Temporary fix

Comments

APAR Information

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

  PQ82368

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

  UQ84405

Modules/Macros

•    BPECFGB  FRXFM09$ FRXPCFG$
  

Fix information

• Fixed component name

  IMS DB RECOVERY

• Fixed component ID

  5655I4400

Applicable component levels

• R210 PSY UQ84405

     UP04/02/25 P F402