IT28981: STOP CHANNEL MODE(TERMINATE) leaves channel hung and may permanently display "STOPPING"

APAR status

• Closed as program error.

Error description

• Issuing STOP CHANNEL MODE(TERMINATE) on a channel that has ended
  abruptly causes the channel to hang. The channel may
  permanently display STOPPING status on Windows.
  
  There is not way to end the channel in question at this point,
  neither using FORCE or TERMINATE options.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users issuing STOP CHANNEL MODE(TERMINATE) on any distributed
  platform.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  If a channel thread is unresponsive, users may resort to STOP
  CHANNEL MODE(TERMINATE) to forcibly end the thread. On all
  distributed platforms the progression to stop the channel may be
  delayed indefinitely due to a logic error. In addition, on the
  Windows platform, the termination of the thread occurs but it
  does not cause the cleanup routines for MQ resources to be
  called, this can cause the channel status entry to remain
  permanently in STOPPING state.
  

Problem conclusion

• The logic used to terminate a channel thread on the Windows
  platform is modified to ensure thread cleanup routines will
  execute. Additionally the logic on all distributed platforms is
  corrected to wait for a short period of time for the target
  channel thread to move in a safe code block to terminate the
  thread.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.1 CD    9.1.3
  v9.1 LTS   9.1.0.4
  
  The latest available maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

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:

Fix information

• Fixed component name

  IBM MQ BASE MP

• Fixed component ID

  5724H7271

Applicable component levels