PK57305: INQ FILE WILL CAUSE DFHEIQDS TO ABEND WITH AN 0C4 AT OFFSET 9FE WITH USER EXIT XFCAREQ ACTIVE, ARGUMENT LIST INCORRECT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• INQ File will cause DFHEIQDS to ABEND with an 0C4 at offset 9FE
  with user exit XFCAREQ active, argument list incorrect.
  This is done in routine INVOKE_XFCAREQ in DFHEIQDS. At offset
  X'3CA6 we are comparing the number of parameters being copied
  to 57 (X'39')
  This does not take into accout the new parameter IQS_RBATYPE
  IQS#58CV. This parameter does not get copied into the new
  argument
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: An inquire on an ESDS file may          *
  *                      result in an ASRA abend if              *
  *                      user exit XFCAREQ is active.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Issuing an inquire file using CEMT or EXEC CICS INQUIRE
  against an ESDS file may result in an abend ASRA. User exit
  XFCAREQ must be active for this to occur. The abend will be
  accompanied by a CICS JOBLOG message DFHAP0001 stating
  "An abend (code 0C4/AKEA) has occurred at offset X'000009FE'
  in module DFHEIQDS."
  An abend occurs if RBATYPE has been specified on the command.
  
  The local structure in DFHEIQDS that takes a copy of the
  argument list is now too small. CICS attempted to access
  a parameter in the argument list that was not available.
  
  Additional Keywords: 0C4 AKEA EIQDS 9FE XFCAREQC INQ CECI
  abend0C4 S0C4 abends0C4 MSGDFHAP0001 AP0001
  

Problem conclusion

• DFHEIQDS has been updated to ensure that the local copy of
  the arguments list is big enough for all arguments that are
  passed to DFHEIQDS.
  
  The CICS Transaction Server for z/OS Version 3 Release 2,
  Customization Guide, SC34-6814-00, Part 1:Customizing with user
  exit programs, Chapter 1: Global user exit programs, File
  control EXEC interface SPI exits XFCAREQ and XFCAREQC has a
  number of changes.
  
  Section: The command-level parameter structure; The UEPCLPS
  exit-specific parameter
  The following alterations have been made:-
  Under FCIS_BITS8 change the comment for  X'40' to "Set if the
  request contains the RBATYPE keyword."
  
  After FCIS_ADDR57 and corresponding comment add
  FCIS_ADDR58
     is the address of a 4-byte area containing the data from
     RBATYPE.
  
  Section: Modifying fields in the command-level parameter
  structure;
  Append an extra row to Table 1 (in infocenter and Table 5 in
  pdf): INQUIRE FILE requests
    Argument   Keyword         Data type   Input/Output
    Arg58       RBATYPE        BIN(31)     Output
  

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:

  UK32581

Modules/Macros

•    DFHEIQDS DFHFAUED
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK32581

     UP07/12/25 P F712

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.