PM22979: VTAM GENERIC RESOURCE AFFINITY NOT DELETED AFTER CICS NORMAL SHUTDOWN

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A TOR region is member of a VTAM GENERIC RESOURCE ( VGR ) and
  has some LU6.2 connections with other CICS partner.
  At TOR shutdown not all the VTAM AFFINITY are terminated between
  TOR and LU62 partner.
  When the connection were acquired message DFHZC0177 (affinity
  created) were issued against all the connections, but at TOR
  shutdown a lower number of message DFHZC0180 ( end affinity)
  were issued.
  The CNOS message DFHZC4900 to 0 indicates that the connection
  have terminated normally, but because message DFHZC0180
  was not issued indicates that the connection quiesce transaction
  (CQPO/CQPI) did not run correctly preventing the affinity to
  be terminated.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A TOR that is a member of a VTAM        *
  *                      GENERIC RESOURCE does not terminate all *
  *                      VTAM AFFINITIES with partner LU6.2      *
  *                      regions during a normal shutdown.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A TOR is a member of a VTAM GENERIC RESOURCE, and uses LU6.2 to
  connect to its partners. It establishes many VTAM AFFINITIES
  with these partners. Each such AFFINITY established causes
  message DFHZC0177 to be issued.
  At CICS shutdown, all these connections are released, but not
  all have their AFFINITY ended. During a normal shutdown CICS
  issues a terminate request for all sessions. This can take some
  time to complete. DFHCLS5 then runs, and sets tcse_endaffin_reqd
  for all sessions which are completely closed. If any sessions
  have not been released then this bit will not be turned on, and
  the AFFINITY will not be ended when DFHZGCH ENDAFFIN runs.
  

Problem conclusion

• DFHCLS5 has been changed to wait up to 5 seconds for any
  active user sessions to be unbound before setting
  tcse_endaffin_reqd, which will cause DFHZGCH ENDAFFIN
  to run and terminate the affinities for a connection.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PM20516

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

  UK60931

Modules/Macros

•    DESCLS5  DFHCLS5
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R600 PSY UK60931

     UP10/10/06 P F010

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.