PI98137: DFHSO1001 AN ERROR(CODE X'043A') IN MODULE DFHSOIS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running CICS Transaction server 5.4 using IPIC
  connections and receive the following  message
  reporting an ABEND0C4:
  IEA995I SYMPTOM DUMP OUTPUT
          SYSTEM COMPLETION CODE=0C4  REASON CODE=00000011
          ACTIVE LOAD MODULE NAME=DFHSOSVC
  This is followed by:
  DFHSO1001  A Communications Server TCP/IP callable NMI error
             (code X'043A') has occurred in module DFHSOIS.
  
  In the dump from the SO1001, you will see the following
  exception trace entry:
  SO 043A SOIS  *EXC* - SVC_ABENDED FUNCTION(2)
                 R15_RETURN_CODE(-1) RESPONSE(0) RETURN_VALUE(0)
                 RETURN_CODE(0) REASON_CODE(00000000)
  the program check - 0C4 occurred in module DFHSOSVC offset 6DA
  on an MVC instruction.
  Additional symptoms: kixrevscb
  dumpcode so0002
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: ABEND0C4 in DFHSOSVC when collecting    *
  *                      TCPIPSERVICE statistics.                *
  ****************************************************************
  CICS is collecting statistics.  DFHSOIS is called to collect
  statistics for each TCPIPSERVICE.  For every TCP/IP stack that
  a TCPIPSERVICE is connected to, a call is made to DFHSOSVC.
  
  DFHSOSVC makes a EZBNMIFR call to obtain statistics from the
  specific TCP/IP stack relating to the listener port for this
  TCPIPSERVICE.  DFHSOSVC is only expecting a single result record
  to be returned.  However, if the stack owns multiple IP
  addresses or the SHAREPORT option is being used, then multiple
  result records can be returned.
  
  If multiple result records are returned then DFHSOSVC has to
  obtain a larger buffer and make a second EZBNMIFR call.  On
  return from the call a copy of the buffer is made.  This copy
  uses a fixed 1K length instead of the actual buffer length.
  If the storage that follows the buffer is unallocated then an
  0C4 abend will occur.  If the storage is allocated then there
  will not be an abend, but the returned statistics may not be
  correct.  The statistics values returned are always from the
  first result record.
  
  Additional keywords:
  msgDFHSO1001  SO1001  msgDFHSO0002  S0C4  ABENDS0C4
  

Problem conclusion

• DFHSOSVC has been changed to copy the correct buffer length
  of data after the second EZBNMIFR call.  DFHSOSVC has also been
  changed to return the correct statistics values for the
  specified TCPIPSERVICE when multiple IP addresses or SHAREPORT
  are being used.
  
  For the TCPIPSERVICE statistics information to be correct the
  PTF for TCPIP APAR PI98770 is required.  Without that PTF the
  values relating to the backlog and dropped connections;
  
  sor_curr_backlog
  sor_conns_dropped
  sor_conn_last_dropped
  sor_curr_max_backlog
  
  will be zero.
  

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:

  UI56922

Modules/Macros

• DFHSOIS  DFHSOLS  DFHSOSVC DFHSOTRI
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI56922

     UP18/06/29 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.