PH58381: CSQX298E AMS NOT AVAILABLE FOR SVRCONN CHANNELS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Development finds that if there is a delay between when one (or
  more) queue managers within a queue-sharing group is/are
  upgraded while a subset is not then : if, during that time, an
  ALTER CHL of the GROUP object runs on one of the 9.3 queue
  managers, the COPY disposition object on each queue manager
  (including those still at 9.1) will have a flag set indicating
  the presence of a SPLPROT value (defaulting to MQSPL_PASSTHRU).
  When the 9.1 objects are subsequently migrated, and the channel
  is started CSQXRCDX checks this flag, and based on it attempts
  to read the value of SPLPROT from beyond the 9.1. length MCHL.
  Depending on the residual contents of CSQXRCDX's stack storage,
  this can result in the reported error occurring.
  

Local fix

• Altering the channel definition resolves the problem, as this
  will update the MCHL to the 9.3. length
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version         *
  *                 9 Release 3 Modification 0.                  *
  ****************************************************************
  * PROBLEM DESCRIPTION: When trying to connect to a queue       *
  *                      manager that has been migrated from     *
  *                      version 9.1.0 through a SVRCONN channel *
  *                      the connection may fail and a CSQX298E  *
  *                      message may be erroneously issued.      *
  ****************************************************************
  The code that handles the forward migration of queue managers
  does not clear the flag indicating that a value required for
  facilitating Advanced Message Security interception, which is
  not supported for SVRCONN channels, is present on the channel
  object. This causes the code to search for that value outside
  the scope of the channel object where it might encounter
  unexpected values that may cause an error message to be issued
  and any connection attempts to fail.
  

Problem conclusion

• The forward migration code has been changed to clear the flag
  indicating the presence of an AMS-related field on SVRCONN
  channels. It will stop the code from encountering incorrect
  values outside the channel object scope. To stop the issues from
  occurring in already migrated queue managers, the code will now
  clear the memory being looked up to avoid encountering
  unexpected values, which would cause the CSQX298E error to be
  issued.
  

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:

  UI95915

Modules/Macros

• CSQIERS3 CSQXRCDX
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R300 PSY UI95915

     UP24/03/19 P F403

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.