PK58586: MSGDFHFC0952 DYNAMIC ALLOCATION OF RLS FILE FAILED. RETURN CODE X'0004',X'0210' IN MODULE DFHFCRO.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• MSGDFHFC0952 Dynamic allocation of RLS file failed. Return Code
  X'0004' RC4 RC04 Reason code X'0210' RSN210 RSN0210 in module
  DFHFCRO. A batch job Quiesced the RLS dataset which is
  broadcast to every CICS region in the Sysplex that has the
  dataset open. Before another batch job Unquiesced the dataset
  a CICS region tried to open in RLS mode and received the
  Allocation error.
  Additional Symptom(s) Search Keyword(s):
  KIXREVEAA DFHFC0952
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message "DFHFC0952 dynamic allocation   *
  *                      of RLS file failed", followed by the    *
  *                      file remaining in a closed,unenabled    *
  *                      state.                                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A quiesce was issued against a dynamically allocated dataset
  opened in RLS mode. The connected CICS systems deallocated the
  dataset during the quiesce processing, and left the associated
  files in closed,unenabled state with FCTUNQEA set on in the FCT.
  (A subsequent unquiesce would drive all CICS systems registered
  with RLS, and the files with FCTUNQEA set on would be reset to
  closed,enabled once more).
    Between the quiesce and unquiesce, a batch job ran and
  scratched and redefined the dataset. During this period, a CICS
  system (which had not had the file open) tried to open it. The
  dynamic allocation failed due to the batch job owning the
  dataset. DFHFCRO then called DFHFCAT to issue an IGWARLS call to
  SMSVSAM. This appears to have returned dataset not quiesced
  (once it had been redefined). This resulted in FCTUNQEA not
  being set on for the file. When the subsequent unquiesce was
  issued, this meant that the file remained in a closed,unenabled
  state.
  

Problem conclusion

• DFHFCRO has been changed in the dynamic allocation error path.
  It now ensures that FCTUNQEA is set on in the FCT, following a
  successful DFHFCAT invocation. If the underlying IGWARLS call
  has led to a fcat_quiescestate = fcat_quiesced then a
  DATASET QUIESCED error will be returned to the OPEN FILE
  request. If the underlying IGWARLS does not lead to
  fcat_quiesced, then a DATASET_QUIESCED_LOST will be returned
  to the OPEN FILE request. This will be converted into an
  IOERR and in the case of CEMT this will be an OPEN/CLOSED
  FAILED.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK34400 UK34401

Modules/Macros

•    DESFCO1  DESFCRO  DFHFCFS  DFHFCFSA DFHFCFSM
  DFHFCFSR DFHFCFST DFHFCRO
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK34400

     UP08/03/14 P F803

• R500 PSY UK34401

     UP08/03/14 P F803

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.