PH63889: MQ Z/OS: MISLEADING CSQX630E WHEN CHINIT TERMINATING ALL ITS CHANNELS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the queue manager is shutdown, it causes the CHNIT to
  start terminating all its channels, part of that process is
  that the channels attempt to send a network flow to the remote
  partner systems indicating that the queue manager is shutting
  down. However, because the queue manager termination has also
  triggered the CHINIT to implicitly shutdown, it has itself
  requested that no new SSL/TLS channels be allowed to start,
  however this has the effect of blocking any new requests to the
  SSL tasks and prevents the data from being encrypted and this
  failed request results in the CSQX630E message being issued.
  The CSQX630E message that triggered the message in the above
  was caused by a channel . This is a SVRCONN channel that had
  been running previously. It was awaiting requests to be sent
  from the client at the time of queue manager termination. When
  it gets notified of the queue manager termination it attempts
  to let the client know and the SSL communication fails in the
  manner described above.
  To improve this process when the queue manager is terminated
  before the CHINIT, either the channels do not report this
  misleading CSQX630E error or are able to send the queue manager
  quiesce notification to clients.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 3 Modification 0 and                 *
  *                 Release 4 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: CSQX630E 'Channel requires SSL' is      *
  *                      issued when the channel initiator is    *
  *                      terminating.                            *
  ****************************************************************
  During Channel initiator termination, new requests to the
  SSL/TLS server tasks are prevented, causing channels using
  SSL/TLS and attempting to read/write to the socket to fail.
  This behaviour is expected, however the message issued to report
  the error incorrectly indicates that there a problem with the
  SSL/TLS configuration.
  

Problem conclusion

• CSQX630E is no longer issued due to errors queueing requests to
  the SSL/TLS server tasks during channel initiator termination.
  

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:

  UO03970 UO03971

Modules/Macros

• CSQXRSTM
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R300 PSY UO03971

     UP25/07/12 P F507

• R400 PSY UO03970

     UP25/07/12 P F507

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.