PK89238: IPCONN REMAINS IN FREEING STATE WHEN CONNECTION TO CICS TRANSACTION GATEWAY FAILS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An IPIC connection, used by the CICS Transaction Gateway to
  route work into a CICS TS region, suffers a communications
  failure. This causes those tasks that are in-doubt, waiting on a
  decision from the Gateway, to be shunted. CICS then attempts to
  release the associated IPCONN, which then becomes stuck in a
  FREEING state.  This prevents the Gateway from re-establishing
  the connection once the network has been restored.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: An IPIC connection between the CICS TG  *
  *                      and CICS TS is left in a FREEING state  *
  *                      following a connection failure. The     *
  *                      IPCONN in the CICS region cannot be     *
  *                      released, preventing the connection     *
  *                      from being re-established.              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A unit of work, started in response to an IPIC request from a
  Gateway client, is in-doubt when the connection is lost. The
  IS domain detects the network error and attempts to release
  the IPCONN associated with the connection. All suspended
  tasks that are waiting on messages over the connection are
  purged. Any that are in an in-doubt state are shunted but
  their IPIC receive sessions are not freed, and this prevents
  the release operation from succeeding, and leaves the IPCONN
  in a freeing state.
  

Problem conclusion

• Code is added to the DFHISJU Resource Management Connector so
  that it frees the receive session when an outstanding attempt
  to receive a message is purged by the IS domain.
  

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:

  UK49554

Modules/Macros

• DESISUOW DFHISBU  DFHISCU  DFHISJU
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK49554

     UP09/09/05 P F909

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.