PI66075: SYSPLEX DISTRIBUTOR MAINTAINS CRHTE ENTRIES AFTER CONNECTIONS TERMINATE. 16/07/22 PTF PECHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A sysplex distributor stack that distributes connections to a
  target using QDIOACCELERATOR will not delete the associated
  Connection Route Hash Table Entry (CRHTE) when the connection
  ends.The obsolete CRHTE entries will be reused and therefore
  limit sysplex distribution.
  
  Verification Steps:
  Is QDIOACCELERATOR configured?
  D TCPIP,,N,CONFIG
   output:   QDIOACCEL:  YES
  
  D TCPIP,,N,VPDT,DETAIL
   output ACTCONN: xxxx
  The active connections to a target does not match the ACTCONN
  value.
  
  Do you have CRHTEs using QDIOACCELERATOR?
  D TCPIP,,N,VCRT,DETAIL
   output:   ACCELERATOR: YES
  
  Do you have an active matching connection for each CRHTE?
  D TCPIP,,N,CONN
  If not you may have obsolete CRHTEs.
  
  Is a CRHTE in a state that it will not be deleted?
  A dump of TCPIP and the TCPIPCS XCF DETAIL report
  will show CRHTEs. If the Connection Route Hash entry Flags2:
  has bits C0200000 turned ON, the CRHTE may not be deleted
  when the connection ends.
  

Local fix

• Remove QDIOACCELERATOR from the PROFILE in the sysplex
  distributor stack. Recycle TCPIP distributor stack to recover.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of the IBM Communications Server for z/OS Version  *
  * 2 Release 1 and Release 2 IP: Sysplex Distributor with QDIO  *
  * Accelerator (QDIOACCELERATOR)                                *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Syeplex Distributor maintains CRHTE (netstat VCRT display)   *
  * entries after the connections have terminated.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply the PTF                                                *
  ****************************************************************
  Sysplex distributed connections are maintained in the CRHT table
  as CRHTE entries and should be deleted when the connection
  terminates. However, some of these entries are not being removed
  during termination processing because the XFCRHTE_DelayDelete is
  incorrectly set.
  

Problem conclusion

• Code has been updated to ensure the XFCRHTE_DelayDelete is only
  set in the correct circumstances.
  

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:

  PI66357 UI39657 UI39658

Modules/Macros

• EZBXFTMR EZBIFQDR
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R220 PSY UI39658

     UP16/09/12 P F609 {

• R210 PSY UI39657

     UP16/09/12 P F609 {

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.