PH69432: DFHSO1001 CODE X'043C' OCCURS WHEN COLLECT STATISTICS IS ISSUED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When EXEC CICS COLLECT STATISTICS issued for TCPIPSERVICEs,
  message
  DFHSO1001 A Communications Server TCP/IP callable NMI
  error (code X'043C') has occurred in module DFHSOIS is issued
  and COLLECT STATISTICS fails.
  This is due to when CICS called Comms Server function EZBNMIFR
  which returned the ENOBUFS / JRBuffTooSmall return codes and
  CICS does not handle those return codes correctly.
  You will see z/OS UNIX return code 7735006B(JRBuffTooSmall )
  returned for COLLECT STATISTICS in CICS trace entry.
  
  Trace entries report the problem:
  
  00054 QR    SO 0438 SOIS  EVENT SVC_NMI_STATS_ENTRY
  
  
  00054 QR    SO 043C SOIS  *EXC* SVC_NMI_INQUIRE_FAILED
  2,0,4,-1,1122,7735006B
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS issues MSGDFHSO1001 CODE X'043C'   *
  *                      when collecting sockets statistics.     *
  ****************************************************************
  When CICS is collecting sockets statistics, it calls
  Communications Server function `EZBNMIFR` passing a buffer.
  If `EZBNMIFR` finds that the buffer is too small then it returns
  a signed integer value of '-1' to CICS.
  CICS does not handle the '-1' value correctly and issues
  message:
      DFHSO1001 A Communications Server TCP/IP callable
      NMI error (code X'043C') has occurred in module DFHSOIS.
  

Problem conclusion

• CICS has been modified to handle the '-1' return value
  correctly.
  

Temporary fix

Comments

APAR Information

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

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

  PH70542 PH70543 UO07428 UO07429

Modules/Macros

• DFHSOSVC
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R500 PSY UO07429

     UP26/04/17 P F604

• R600 PSY UO07428

     UP26/04/17 P F604

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.