PI35738: DFHIS1051 UNABLE TO ACCEPT CONNECTION FOR IPCONN XXX. IPCONN CLIENT SESSION STATE IS INVALID (CODE X'0515')

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the IPCONN is in OBTAINING state and the SOCKET get closed,
  ie. for a timeout, no attempt is made to close the IPCONN in
  the CICS/TS side.
  This results in the IPCONN being in an ACQUIRED state in CICS/TS
  and in a RELEASED state in CICS TG.
  When CICS TG send another CAPEX it is rejected with message
  DFHIS1015 because the IPCONN is in ACQUIRED state.
  

Local fix

• The only way to get out of this situation is to re-cycle the
  CICS region.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: MsgDFHIS1015 issued after a CICS client *
  *                      closes the session to CICS during       *
  *                      IPIC connection initialisation.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A CICS client initiates a request to connect to a CICS region.
  The first capability_exchange request comes into CICS and task
  CISS calls DFHISCO for INITIALIZE_CONNECTION.
  This sets the IPCONN status to OBTAINING, sends a capability
  exchange response to the client, and issues message
  DFHIS2001 ('Client web session n from applid xxxxxxxx
  accepted for IPCONN xxxx').
  The CISS task then loses control when an MVS GETMAIN is
  issued by DFHMEME.
  At the client end of the IPCONN the connection times out
  waiting for a response from CICS. This results in a
  SESSION_CLOSED error being sent to CICS. The error is
  processed by task CISR (DFHISRR) on a different TCB from
  CISS. CISR takes no action for this error because the
  IPCONN is in 'obtaining' state so it knows that CISS is
  running and expects that task to catch the error.
  However, CISS has reached a point in the processing
  where it has no more socket i/o to process and so does not
  notice the error and continues on to incorrectly set the IPCONN
  to 'acquired' state.
  At the client end the IPCONN is 'released'. The client attempts
  to reconnect to CICS, but this is rejected because the CICS
  end is not 'released'. CICS returns error
  INVALID_PARTNER_STATE and issues message DFHIS1015 'Unable to
  accept connection for IPCONN xxxxxxxx. IPCONN client session
  state is invalid. Error code is (code X'0515').'
  This error can be cleared by closing and re-opening the
  TCPIPSERVICE named in the IPCONN definition.
  

Problem conclusion

• DFHISRR has been altered to set a new indicator bit in the ISCB
  if it is notified that the session is closed whilst the
  IPCONN is in 'obtaining' state.
  DFHISCO has been altered to check the new bit before updating
  the IPCONN status to 'acquired'. If the bit is on it will
  backout any changes and set the IPCONN to 'released'.
  
  The CICS Transaction Server for z/OS Version 5 Release 1
  Trace Entries SC34-2873-00 manual will be changed to add the
  following trace point to Chapter 17. IS domain trace points:
  
  IS 059A  DFHISCO  Exc   SESSION CLOSED 1 ISCO parameter list
                                         2 ISCB
  
  The CICS Transaction Server for z/OS Version 5 Release 2
  Trace Entries SC34-7295-00 manual will be changed to add the
  following trace point to Chapter 17. IS domain trace points:
  
  IS 059A  DFHISCO  Exc   SESSION CLOSED 1 ISCO parameter list
                                         2 ISCB
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PI34221

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

  UI26392 UI26393

Modules/Macros

• DFHCIS4  DFHISAL  DFHISCO  DFHISCOP DFHISCOT DFHISCU  DFHISDM
  DFHISDUF DFHISEM  DFHISEMP DFHISFS  DFHISIC  DFHISIF  DFHISIS
  DFHISJU  DFHISLQ  DFHISLQP DFHISPH  DFHISPHP DFHISPRP DFHISRE
  DFHISREU DFHISREX DFHISRR  DFHISRRP DFHISRS  DFHISRSP DFHISSR
  DFHISST  DFHISTRI DFHISUE  DFHISXF  DFHISXM  DFHISXS  DFHISZA
  DFHMIRS
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI26392

     UP15/04/09 P F504

• R900 PSY UI26393

     UP15/04/09 P F504

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.