IBM Support

PI24496: CSQX191I MESSAGES FOR CLUSTER CHANNELS DURING CHINIT SHUTDOWN

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CSQX191I messages following a STOP QMGR command for cluster
    channels.
    Looks like CSQXADPC should be getting invoked to post the
    get-waiters, but that isn't happening.
    
    Additional symptoms:
    CSQX208E & CSQx206E messages with TRPTYPE=TCP RC=00000480
    .
    Cluster channels that experience the problem may be in the
    STOPPED status when the CHIN restarts, requiring manual
    intervention to restart the channel.
     This also applies non-cluster channels.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
    *                 Release 1 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: When a STOP QMGR command is issued,     *
    *                      CSQX191I messages are issued for        *
    *                      cluster-sender channels indicating      *
    *                      that the channel is entering message    *
    *                      reallocation, accompanied by either     *
    *                      message CSQX208E or CSQX206E with       *
    *                      TRPTYPE=TCP RC=00000480.                *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When a channel initiator is stopping because the queue manager
    is quiescing after a STOP QMGR command has been issued, sender
    channels that are in a get-wait are not posted until after
    TCP/IP calls have been cancelled for the process. This means
    that when the channel attempts to send a heartbeat, the send()
    fails with RC=00000480 (ECANCELED) and message CSQX206E is
    issued. Alternatively, if a get-wait expires before TCP/IP
    calls have been cancelled, the channel's attempt to receive a
    reply to a heartbeat may fail as uninitialized storage in
    CSQXADPO can cause the sender channel to be treated as a
    receiver channel, resulting in the recv() call failing with
    RC=00000480 (ECANCELED) and message CSQX208E being issued.
    Either of these failures cause message reallocation to be
    started for cluster-sender channels and message CSQX191I to be
    issued.
    

Problem conclusion

  • CSQXSPRT has been updated to call CSQXADPC to post channels
    in a get-wait earlier during channel initiator shutdown when
    the connection to the queue manager is quiescing.
    CSQXADPO has been updated to initialize the storage used to
    indicate whether a sender or a receiver channel is being
    processed.
    100Y
    CSQXADPC
    CSQXADPO
    CSQXSPRT
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI24496

  • Reported component name

    WMQ Z/OS V7

  • Reported component ID

    5655R3600

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-08-22

  • Closed date

    2014-12-19

  • Last modified date

    2016-05-16

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

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

    PI30429 UI24061

Modules/Macros

  • CSQXADPC CSQXADPO CSQXSPRT
    

Fix information

  • Fixed component name

    WMQ Z/OS V7

  • Fixed component ID

    5655R3600

Applicable component levels

  • R100 PSY UI24061

       UP15/01/16 P F501

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
16 May 2016