PH38991: CSQM095I MESSAGE FOR A SVRCONN CHANNEL WHEN DOING A BACKWARD MIGRATION FROM V9.2

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When doing a backward migration from MQ v9.2 the code does not
  account for the extra 2 bytes that were increased in 9.2 for
  the channel object. This resulted in the CSQM095I message and
  also a MQRC 2008, MQRC_CHAR_ATTRS_TOO_SHORT.
  KEYWORD : BACKMIG START QMGR
  .
  Additional symptoms:
  Backward and forward migration without this fix can lead to a
  channel control block (MCHL) with an inconsistent state. One
  result is that the start of a SVRCONN results in
    CSQX298E CSQXRESP AMS not available, required for channel
  PH42018 has been created to address the missing channel name.
  .
  The sequence of events leading to this situation is:
   - Forward migrate from a pre-V913 release to V920.
   - Alter any field in a SVRCONN channel definition.
   - Backwards migrate without APAR PH38991 applied.
   - Alter any field in the SVRCONN channel definition.
   - Re-migrate to V920. The state will now be inconsistent, and
  the CSQX298E problem might occur.
  .
  In this situation, altering the channel again at V9.2.0, for
  instance in the description field, will repair the MCHL control
  block.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 2 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: After migrating backwards from V9.2     *
  *                      to an earlier release, attempts to      *
  *                      start client connections failed with    *
  *                      CSQX519E 'Channel x not defined'.       *
  *                                                              *
  *                      The same error is issued when           *
  *                      attempting to delete the channel.       *
  ****************************************************************
  During START QMGR BACKMIG(xxx) processing channel objects are
  processed, converting them from the V920 internal representation
  to an earlier representation. An error in this processing caused
  svrconn channels that had been modified while running at V920 to
  be omitted.
  When these channels are used at the earlier release, the
  incorrect format causes the reported error to be issued.
  

Problem conclusion

• CSQIERS3 is changed to correctly process affected svrconn
  channels during backwards migration processing.
  

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:

  UI76835

Modules/Macros

• CSQIERS3
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R200 PSY UI76835

     UP21/09/29 P F109 ¢

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.