IBM Support

PM96339: WEBSPHERE MQ, CHANNELS BEING UNEXPECTEDLY STARTED WHEN THE CHIN IS RESTARTED

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When "Channel start" commands are added in CSQ4INPX definition,
    there are CSQX477E when CHIN restarts which means Channel is
    active.
    
    At V710 (and V701 after PM46019), CSQXADPM (Check_connections)
    will always fail any MQGETs with MQRC_CONNECTION_QUIESCING,
    2202, when the CHIN is being stopped, which results in the
    problem seen here (previously the MQGET would have failed
    with MQRC_GET_INHIBITED and rriSendData would have detected
    that the channel was being put into an inactive state and hence
    it would not have started when the CHIN was restarted). This
    problem with CSQX037E with MQRC=2202 being issued when the CHIN
    is being stopped followed by channels being unexpectedly
    started when the CHIN is restarted, causing the CSQX477E
    messages.
    
    
    Additional Symptom(s) Search Keyword(s): CSQX477E, CSQX037E,
    2202, CHIN, double start on a channel at startup
    CSQX514E CSQ1 CSQXRCTL Channel CSQ1.TO.CSQ2 is active on CSQ1
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
    *                 Release 1 Modification 0                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: On CHINIT termination active channels   *
    *                      end issuing message CSQX037E with       *
    *                      MQRC=2202 (MQRC_CONNECTION_QUIESCING)   *
    *                      When CHINIT restarts they will go into  *
    *                      RETRY state.                            *
    *                      CSQX477E will be issued if there is a   *
    *                      start command in CSQINPX for those      *
    *                      channels.                               *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    At V710 CSQXADPM Check_Connection will return
    MQRC_CONNECTION_QUIESCING, 2202 when doing an MQGET on the
    transmission queue if the CHINIT is quiescing. rriSendData
    doesn't specifically react to that return code and ends up in
    the default case, which causes the channel status to be set to
    RETRY and error message CSQX037E to be issued.
    On CHINIT restart the channel will go into RETRY state and will
    start after the retry interval has elapsed. If there is a START
    CHANNEL command for that channel in CSQINPX then error message
    CSQX477E is issued indicating that the channel is already
    active.
    

Problem conclusion

  • rriSendData now detects if the MQGET on the transmission queue
    has failed with MQRC_CONNECTION_QUIESCING, and if the CHINIT is
    terminating will set the channel status to CLOSING.
    100Y
    CSQXRMTR
    

Temporary fix

Comments

  • ×**** PE14/11/24 FIX IN ERROR. SEE APAR PI26861  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PM96339

  • 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

    2013-09-03

  • Closed date

    2013-11-05

  • Last modified date

    2014-12-17

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

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

    UI12183 PI13179

Modules/Macros

  • CSQXRMTR
    

Fix information

  • Fixed component name

    WMQ Z/OS V7

  • Fixed component ID

    5655R3600

Applicable component levels

  • R100 PSY UI12183

       UP13/11/20 P F311

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:
17 December 2014