PK87435: DFHAP0002 ISSUED WITH CODE X'4E0D' DURING IMPORT_ALL PROCESSING

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible.

Error description

• DFHAP0002 A severe error (code x'4E0D') is issued out of
  DFHAPCR during IMPORT_ALL processing for an IPCONN connection.
  IMPORT_ALL calls IMPORT_CHANNEL which eventually falls into the
  DFHAPCR_EXTRACT_L8 routine to determine the overall length and
  buffer position. During calculation of free space, buffer_used
  is subtracted from buffer_size and we end up with a negative
  value of FFFFFFFA for buffer_left. This is due to buffer_used
  being larger than buffer_size.
    Eventually, routine dfhapcr_extract_channel_header is entered
  and we end up at routine dfhapcr_too_little_data where exception
  trace entry 4E0D APCR is output.
  4E0D APCR  *EXC* - Extract_channel_header FUNCTION(IMPORT_ALL)
  COMMAND(IPCONN) IS_TOKEN(1B1D2020) IS_USED(48D)
  IS_BUFFER(1B23F000, 0000048D)  TIOA Remaining FFFFFFFA
    The real problem is due to DFHAPCR being called invalidly by
  DFHISIS as the DPL request, sent by the client over an IPIC
  connection, did not have CHANNEL data (IS44).
  .
  Additional keywords:
  KIXREVxxx
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHAP0002 for severe error code *
  *                      x'4E0D' issued from DFHAPCR.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In this customer's case a CTG client had issued a Distributed
  Program Link (DPL) over an IPIC connection. The LINK included a
  COMMAREA. DFHMIRS issues a DFHISISM receive_request, and the
  first and only IS field is a type IS43, api request. Refstep
  dfhisis_process_isfld_type_api is called and attempts to
  determine if and where the channel is. The calculation to
  determine the channel results in the location containing a half
  word value of x'0044', isfld_type_channel. The LINK did not
  include a channel, so the following DFHAPCRM IMPORT_ALL call
  abends.
  
  Keywords: msgDFHAP0002 AP0002
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• DFHISIS has been changed to ensure DFHAPCR IMPORT_ALL is only
  called when the data length is larger than the field length and
  it is a channel.
  

APAR Information

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

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

  UK49003

Modules/Macros

•    DESISIS  DFHISIS
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK49003

     UP09/08/12 P F908

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.