PK94534: DFHPI0002 (CODE X'0F09') DFHPIII 09/08/24 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• DFHPI0002 A severe error (Code x'0F09') has occurred n module
  DFHPIII. It's happening during the output phase of an ATOM
  service request against a TSQ.
  .
  This is actually a problem in DFHPIII. After doing the
  CONVERT_DATA call the code can go on and make a call to
  DFHPGCH to get hold of the channel token.  However, if
  DFHPIII was passed in CONT_POOL_TOKEN then it just uses
  that directly without maing the PGCH call.  Afterwards,
  the PCGH_RESPONSE is checked even though the may not have
  been made. The PGCH parameter list shares the same storage
  as the CCNV parameter list so the code really checks the
  CCNV_RESPONSE which is set to CCNV_EXCEPTION
  (CONVERSION_NOT_REQUIRED). This causes the internal error
  and the messages to be issued.
  .
  Additional Keywords: DFHPI0002 CONVERSION_NOT_REQUIRED DFHPIII
  KIXREVRJS
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users with UK47877 applied.         *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHPI0002 issued with severe error      *
  *                      code x'0F09' and task abends AEXZ       *
  *                      when performing XML transform and       *
  *                      the local code page is CCSID 37.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS is processing Web Service requests. DFHPIII has been called
  to convert the application data structure into XML. The data
  structure contains an abstract data type so DFHPIII makes a call
  to itself to convert just this abstract data type into XML.
  
  This second call to the PARSE_ICM function passes in a
  CHANNEL_TOKEN. The presence of this token means that DFHPIII
  does not have to make a call to DFHPGCH to obtain the token.
  However, the response from DFHPGCH is still checked even though
  the call was never made. This actually ends up checking the
  response to the DFHCCNV CONVERT_ADS call that was added by APAR
  PK83912. When the LOCALCCSID is set to 037 the DFHCCNV call will
  have returned with a response of CCNV_EXCEPTION and reason
  CCNV_CONVERSION_NOT_REQUIRED. The value of CCNV_EXCEPTION is
  handled as if it were PGCH_EXCEPTION. DFHPIII was not expecting
  that exception so it is processed as a severe error.
  
  Message DFHPI0002 with code x'0F09' is issued. If CICS is a
  provider then a SOAP Fault will be returned. If CICS is a
  requester then the application will abend AEXZ.
  

Problem conclusion

• UK47877
  DFHPIII has been altered to only check responses from
  PGCH domain calls, so that a conversion not required
  exception is not handled as an internal error.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK93804

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

  UK50289

Modules/Macros

•    DESPIII  DFHPIII
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK50289

     UP09/09/29 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.