PI96785: TCPIP GLOBAL STATISTICS SOG_PEAK_OUTB_SOCKETS IS INCREMENTED BUT NOT DECREMENTED WITH SOCKET POOLING ACTIVE.

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible.

Error description

• TCPIP Global statistics SOG_PEAK_OUTB_SOCKETS appears to be
  incremented but not decremented as expected
  SOG_PEAK_OUTB_SOCKETS is reset to
  'current outbound sockets' (SOG_CURR_OUTB_SOCKETS)
  and this field is not reset at the statisics interval.
  As a result of it never being reset or decremented the count
  value just keeps increasing by the number of outbound sockets
  created.
  An example of the incorrect statistics follows :
  System: SYSTEMnn Type:INT 2017/01/30 00:50 01:50  2:50  3:50
  Current MAXSOCKETS Limit   . . . .    500    500   500   500
  Current Inbound Sockets . .  . . .      0      0     0     0
  Peak Inbound Sockets  . . .  . . .      0      0     0     0
  Current Outbound Sockets  . .  . .  3,450  3,462 3,474 3,487
  Peak Outbound Sockets . . . .  . .  3,450  3,462 3,474 3,487
  Current Perst Outbound Sockets          0      0     0     0
  Peak Persistent Outbound Sockets   .    0      0     0     0
  Inbound Sockets Created . . . . .  .    0      0     0     0
  Outbound Sockets Created  .  . . . .   13     12    12    13
  .
  We are using outbound socket pooling on the client URIMAPs, for
  info. eg SOCKETCLOSE=003000 in the URIMAP.
  With CICS socket pooling, sockets are returned to the pool
  for reuse until the SOCKETCLOSE timeout value is reached.
  The problem is that when pooled sockets are closed the routine
  to decrement SOG_CURR_OUTB_SOCKETS is not driven.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: TCPIP global statistics for outbound    *
  *                      sockets are incorrect.                  *
  ****************************************************************
  A URIMAP has been defined with a non-zero SOCKETCLOSE value.
  This causes CICS to use outbound connection pooling. When a
  socket in the pool gets closed the global statistics fields
  "Current number of non-persistent outbound sockets", "Number of
  outbound sockets closed" are not updated. This also causes
  "Peak number of non-persistent outbound sockets" to be
  incorrect.
  

Problem conclusion

Temporary fix

Comments

• DFHSOPL has been modified to update the TCPIP global
  statistics after pooled socket closed.
  

APAR Information

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

  PI76577

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

  UI57064

Modules/Macros

• DFHSOAD  DFHSOCK  DFHSODM  DFHSODUF DFHSOIS  DFHSOL   DFHSOLI
  DFHSOLS  DFHSOLX  DFHSOM01 DFHSOM02 DFHSOM03 DFHSOPL  DFHSORD
  DFHSOS00 DFHSOS01 DFHSOS02 DFHSOS03 DFHSOS04 DFHSOS05 DFHSOS06
  DFHSOS07 DFHSOS08 DFHSOS09 DFHSOS10 DFHSOS11 DFHSOS12 DFHSOS13
  DFHSOS14 DFHSOS15 DFHSOS16 DFHSOS17 DFHSOS18 DFHSOS19 DFHSOS20
  DFHSOS21 DFHSOS22 DFHSOS23 DFHSOSE  DFHSOST  DFHSOTB  DFHSOTI
  DFHSOTRI DFHSOUE  DFHSOXM
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R900 PSY UI57064

     UP18/07/10 P F807

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.