PK90169: CICS SHUTDOWN HANGS WAITING IN DFHDBAT AT LABEL IQUIESCE , WAITING FOR CHAIN OF LOCLAREAS CHAINED AT GCOFORWD TO GO AWAY.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS shutdown hangs while calling the DBCTL TRUE for
  shutdown.  DFHDBAT , near label IQUIESCE , is waiting for the
  chain of LOCLAREAs anchored at GCOFORWD to be zero .  But
  the LOCLAREA pointed to by GCOFORWD points to itself at
  LCOFORWD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS hangs during shutdown.             *
  *                      The CEMT Shutdown task is stuck while   *
  *                      calling the DBCTL TRUE.                 *
  *                      GCOFORWD is non zero.                   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The shutdown task continually suspends out of DFHDBSPX waiting
  for DBCTL requests to complete. The final task completes from
  DBCTL but GCOFORWD is non zero which suggests another task has
  yet to complete. The shutdown task is stuck in wait DLSUSPND.
  The GCOFORWD has been corrupted when a task schedules a PSB
  then a checkpoint freeze is issued. This allows the task to
  complete to a TERM call and IMS terminates. A subsequent
  schedule of a PSB fails rc x'28' but its local workarea
  address remained chained on GCOFORWD, even after task
  termination. If IMS is restarted, the area can be reused and
  is chained to itself.
  Additional keywords
  LOCLAREA IQUIESCE TIE GWA
  

Problem conclusion

• DFHDBAT has been amended to ensure GCOFORWD is always set
  to binary zeros during the connection logic. This will
  ensure no residual value remains from a previous
  disconnect.
  

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:

  PK94308 UK50436 UK50437

Modules/Macros

•    DFHDBAT
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK50436

     UP09/09/29 P F909

• R500 PSY UK50437

     UP09/09/29 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.