PK58631: DFHEX0002 CODE 0613 HAS OCCURRED IN MODULE DFHXCPRH. INVREQ FROM ONLINE CICS REGION REPORTED INCORRECTLY TO EXCI REGION.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An EXCI job issues EXEC CICS LINK to do a EXCI call to an online
  CICS region.  That call receives an INVREQ response, x'E0'.
  This is propagated back to the EXCI job properly, but is
  incorrectly interpreted by DFHXCPRH as a severe error, resulting
  in the following trace entry:
  EX 0613 XCPRH  *EXC* - TRANSFORMER_4_ERROR RC(000000E0)
  USER(xxxxxxxx)
  and the following message is seen in the EXCI job:
  DFHEX0002  A severe error (code X'0613') has occurred in module
  DFHXCPRH
  DFHXCPRH needs to handle the INVREQ and pass that along to the
  application program instead of reporting it as a severe error.
  Additional Symptom(s) Search Keyword(s):
  EX0002 MSGDFHEX0002 DPL SVCDUMP INVALID REQUEST
  KIXREVBDB
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message "DFHEX0002  A severe error      *
  *                      (code X'0613') has occurred in module   *
  *                      DFHXCPRH." is issued when linking       *
  *                      from a batch EXCI program to CICS.      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A batch program is using the external CICS interface (EXCI) to
  do an EXEC CICS LINK command to a Java program in CICS.
  However, the Java program requires the shared class cache which
  has been STOPPED and has autostart disabled. This results in a
  response of INVREQ from the LINK command.
  The response from the LINK is processed by the program request
  handler, DFHXCPRH. This checks for all the possible responses
  from a LINK, issuing appropriate return codes, but it does not
  include an INVREQ in the list. As the response is not recognised
  it issues a DFHEX0002 message for code 0613 and takes a system
  dump.
  Additional keywords: msgDFHEX0002 EX0002 abendEX0002
  XCPRH_TRANSFORM_4_ERR TRANSFORMER_4_ERROR AUTOSTART_DISABLED
  CLASSCACHE JVM DPL
  

Problem conclusion

• DFHXCPRH has been altered to include a check for an INVREQ
  response from the LINK command. If INVREQ is returned
  it will set the EXCI response to INVREQ (decimal 16) and
  issue an 0801 exception trace entry (INVREQ_DETECTED).
  DFHEXTRI has been altered so that the EX 0801 trace entry
  now traces the program name from the failed LINK as DATA4
  and the target CICS applid as DATA5.
  
  The CICS Transaction Server for z/OS External Interfaces Guide,
  Version 3 Release 1, SC34-6449-04, will be altered in
  Chapter 10, 'The EXCI EXEC CICS interface', page 152, to add
  INVREQ to the list of error codes which may be returned from
  a LINK command as follows:
  
        INVREQ     16
  
  The CICS Transaction Server for z/OS External Interfaces Guide,
  Version 3 Release 2, SC34-6830-01, will be altered to make the
  same change on page 144.
  
  The CICS Transaction Server for z/OS Trace Entries manual,
  Version 3 Release 1, SC34-6443-04, will be altered in
  Chapter 13 ('External CICS interface trace points'). Trace
  entry EX 0801 will be changed to replace the existing
  explanations for DATA4 and DATA5 with the following:
  
  4 Program name
  5 Target CICS applid
  
  The CICS Transaction Server for z/OS Trace Entries manual,
  Version 3 Release 2, SC34-6828-01 will be altered to make
  the same change in Chapter 14.
  

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:

  UK37558 UK37559

Modules/Macros

•    DFHEXTRI DFHXCPRH DFHXCTRC DFHXCTRD
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK37558

     UP08/06/25 P F806

• R500 PSY UK37559

     UP08/06/25 P F806

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.