PK57426: DFHPI0997 AFTER A MAINTENANCE UPGRADE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Customer applied a lot of PTFs (CICS or zOS). Since then his web
  service implementation suffers a DFHPI0997 message telling about
  a TRANSACTION ABEND. There is no abend related message in the
  CICS log.
  The problem disappears when the PG component is traced ! (PG=1)
  From a trace DFHPIPM suffers a PGLE TRANSACTION_ABEND exception
  trace entry when PG is not traced.
  TRANSACTION_ABEND is returned because pitl_saved_abcode added by
  PK49155 is not zeroed as expected by DFHPIIS upon return from
  PGLE. Could be that a test of the PGLE return code is missing.
  

Local fix

• Set the INTERNAL TRACE ON and trace the PG comonent at level 1.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: Web Services Server transactions fail   *
  *                      with MSGDFHPI0997 reporting an abend    *
  *                      the code of which is invalid. No actual *
  *                      abend is reported in the CICS log.      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  MSGDFHPI0997 is invalidly issued reporting a transaction abend
  when processing a Webservice request. This only happens if PG
  level 1 tracing if off. The failure manifests itself as a
  spurious abend from DFHPIPM after DFHPITL returns a non-blank
  abend code. DFHPITL is employed in the running of the
  Webservices provider application code.
  
  Code in DFHPITL gathers abend information should it be run as an
  associated task, due to a context switch. All DFHPGLE calls that
  invoked Business Logic were amended to return abendcodes into a
  specific field. This field was always being set even if an
  abend had not occurred. It is this field that is eventually
  checked by DFHPIPM and in some cases found to be non-blank and
  is misinterpreted as an abend code.
  
  It was also found that for applications defined as remote or
  dynamic abend codes were not being collected. When using
  Websphere MQ as the transport this could result in incomplete
  recovery action.
  
  Additional Keywords: DFHPI0997
  

Problem conclusion

• DFHPITL has been amended to only return abend information when
  an abend has occurred. Also abend information will now be
  collected for applications defined as dynamic or remote.
  

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:

  PK59343 UK34077

Modules/Macros

•    DESPIDC  DESPITL  DFHPIDCC DFHPITL
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK34077

     UP08/03/06 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.