IBM Support

PH67216: CSQX514E - CHANNEL FAILING TO ADOPT

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • rriAdoptMCA calls rrxStopChannel, it passes it the status entry
    in a handle. rrxStopChannel checks the ChanSeqNo, but
    rriAdoptMCA passes an incorrect sequence number in the handle.
    This results in rriAdoptMCA thinking that the channel has been
    stopped, when it hasn't been.
    

Local fix

  • Stop the receiver channel with MODE(FORCE) STATUS(INACTIVE).
    Then start the sender channel.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
    *                 Release 4 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Running channels cannot be adopted by a *
    *                      newer instance, and any other attempt   *
    *                      to do so will fail with CSQX514E.       *
    ****************************************************************
    The code which handles the channel adoption tries to stop the
    running instance with an uninitialised sequence number in the
    handle, which results in the channel not being stopped. The
    incoming channel will then continue to wait for the running
    channel to stop. As there is already one channel waiting for the
    running instance to end, if another channel attempts to adopt
    it, it will fail with CSQX514E.
    

Problem conclusion

  • The code has been changed to set the sequence number in the
    handle to the Channel Status's sequence number before attempting
    to stop the channel with rrxStopChannel.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH67216

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-07-04

  • Closed date

    2025-08-07

  • Last modified date

    2025-10-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UO04433

Modules/Macros

  • CSQXRCSI
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R400 PSY UO04433

       UP25/09/13 P F509

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.

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"400","Line of Business":{"code":"LOB77","label":"Automation Platform"}}]

Document Information

Modified date:
02 October 2025