PH14919: EIBRESP2 FOR DFHFC0952 DIFFERENT FOR NON-RLS AND RLS FILES 040210 FOR NON RLS FILES, AND 040000 FOR RLS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS TS 5.4 and applications are
  receiving different values for EIBRESP2 when attempting to
  open files.
  When attempting to open a file, where the dataset is owned by
  another CICS region you will receive message :
  DFHFC0952 Dynamic allocation of file failed.
  if it is an Non-RLS the return code is:Return code
     Return code X'0004',X'0210'  --> this is correct.
  But for an RLS file the return code is:
     Return code X'0004',X'0000'  --> this is *not* correct
  
  Additional symptoms:KIXREVRJL
  EIBRESP2 RESP2 Set file OPEN
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: EIBRESP2 does not contain the error     *
  *                      code after an SVC 99 failure to         *
  *                      allocate a data set to an RLS file.     *
  ****************************************************************
  If CICS cannot dynamically allocate a data set to a file then
  the open fails with an IOERR and EIBRESP2 should report the type
  of error returned from the SVC99. This is moved in hex into the
  bottom half of the field. This works correctly for non-RLS
  files but is incorrect for RLS files.
    In the customer's case the data set is allocated to another
  job which is defragmenting it when CICS tries to open an RLS
  file and dynamically allocate it to the data set. CICS issues
  message "DFHFC0952 Dynamic allocation of RLS file failed. Return
  code X'0004',X'0210' in module DFHFCRO." However, the x0210
  error code returned from the allocation failure is not passed
  back to the application within the second half of EIBRESP2 when
  the IOERR condition is returned to it. This leads to incorrect
  application behaviour when attempting to interpret the cause
  of the allocation failure.
  KEYWORDS: msgdfhfc0952 fc0952 fc 0952 952 dynalloc VSAM
  00040210 00040000
  

Problem conclusion

• DFHFCRO has been changed to save the value from S99ERROR into
  fcfs_vsam_return_code, and so in turn have it propagated into
  the second half of EIBRESP2 when IOERR is being returned.
  

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:

  UI64973 UI64974

Modules/Macros

• DFHFCRO
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI64973

     UP19/09/05 P F909

• R200 PSY UI64974

     UP19/09/04 P F909

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.