PI63366: AFCZ ABENDAFCZ DISASTROUS RESPONSE OPENING BDAM FILE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• AFCZ abend due to CICS thinking local BDAM fils is part of a
  Bundle. DFHFCFS is checking bits in the FCT as if this were a
  local VSAM file. These bits are outside the limits of a BDAM
  File Control Table ( FCT ).
  
   Token being checked is FCT_BUNDLE_TOKEN at FCT+x'210' and
   FCTBUNDL at FCT + x'108'.
  Additional symptoms:
  During initialization of a CICS TS 5.3 region, transaction
  CPLT program checks with the following message:
  DFHRL0001  An abend (code 0C4/AKEA) has occurred at
            offset X'DE70' in  module DFHRLPM.
  We are trying to open a BDAM file and incorrectly do an
  INQUIRE_BUNDLE passing an incorrect BUNDLE_TOKEN, which
  leads to the program check.
  .
  PLT 0C4 ABEN0C4 RL0001 AKEA
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All.                                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * The opening of a BDAM file can lead to an OPEN_FILE/DISASTER *
  * response as it is believed that it is contained within a     *
  * bundle.                                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * .                                                            *
  ****************************************************************
  When opening a BDAM file, DFHFCFS will first check to see if the
  file is contained within a bundle. The logic tested FCTE fields
  fctbundl and fct_bundle_token to decide whether to inquire on
  the bundle or not before processing the open. It failed to test
  that the file was VSAM. Since a BDAM file has an FCT with a
  smaller extension than a VSAM file, these VSAM-specific FCTE
  fields were mapped over undefined storage. If the bit mapped by
  fctbundl happened to be on, and the area mapped by
  fct_bundle_token happened to contain data, then DFHFCFS would
  inquire on a bundle token that does not exist and the task would
  abend.
  
  The same problem can occur when requesting that a file is
  enabled, disabled, discarded and closed.
  
  Additional Keyword: AKEA AEXZ INQUIRE_BUNDLE/DISASTER
  INCOMPATIBLE_BUNDLE_DELETE ABEND0C4 S0C4 0C4
  

Problem conclusion

• DFHFCFS and DFHFCMT has been altered to ensure that FCTVSAMI is
  also tested before processing a request for a BDAM file. Only
  VSAM files can be bundle-defined, so testing for FCTVSAMI
  prevents BDAM files being mistaken for being within a bundle.
  

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:

  UI40031

Modules/Macros

• DFHDTLX  DFHFCCA  DFHFCDN  DFHFCFR  DFHFCFS  DFHFCIR  DFHFCLJ
  DFHFCMT  DFHFCQU  DFHFCRC  DFHFCRD  DFHFCRO  DFHFCRP  DFHFCRR
  DFHFCRS  DFHFCSD  DFHFCST  DFHFCU   DFHFCVR  DFHFCVS  DFHFCXDF
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI40031

     UP16/08/18 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.