IBM Support

PI69808: WMQ prevent setting of incorrect INDXTYPE value for a shared transmission queue

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • For shared transmit queues an incorrect INDXTYPE value may cause
    a manual RESOLVE CHANNEL ACTION(COMMIT) to fail because it will
    attempt an MQGET-by-MsgID process which will not work properly
    against a shared queue that is indexed by CorrelId. As well,
    issuing a RESOLVE CHANNEL ACTION(BACKOUT) will attempt to remedy
    a failed channel that has gone in-doubt however this would
    result in duplication of messages retrieved from earlier an
    batch. Such messages might require reprocessing.
    .
    ***NOTE***
    SYSTEM.QSG.TRANSMIT.QUEUE is an exception to the change in this
    APAR because it is only used by an internal queue manager
    process, not by a channel. This queue manager process requires
    it to be indexed by correlid to operate efficiently.
    

Local fix

  • When the shared transmission queue is not in use the INDXTYPE
    should be altered from the incorrect value.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
    *                 Release 1 Modification 0.                    *
    ****************************************************************
    * PROBLEM DESCRIPTION: Sender channels using a shared          *
    *                      transmission queue configured with      *
    *                      INDXTYPE that is not NONE or MSGID can  *
    *                      fail to recover in-doubt messages and   *
    *                      the channel remains in retry status.    *
    *                      Message CSQX037E reports MQGET failure  *
    *                      with MQRC 2206 (MQRC_MSG_ID_ERROR).     *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Shared transmission queues that are configured with INDXTYPE
    that is not NONE or MSGID cause that sender channel cannot
    recover when messages are in-doubt. The RESOLVE CHANNEL
    ACTION(COMMIT) tries to get messages from the transmission queue
    by message ID but due to incorrect index type the MQGET fails
    with MQRC 2206 (MQRC_MSG_ID_ERROR) leaving the channel in
    retrying status.
    

Problem conclusion

  • DEFINE QLOCAL and ALTER QLOCAL commands now check that attribute
    INDXTYPE is NONE or MSGID for shared transmission queues. The
    command returns an error message saying the INDXTYPE has an
    invalid value preventing an incorrect configuration of the
    queue.
    
    A new warning message CSQM062I is issued during sender channel
    start indicating that the shared transmission queue has been
    configured with an invalid INDXTYPE. This helps to detect shared
    transmission queues configured incorrectly before this APAR has
    been applied.
    
    ========== Documentation Change ==================
    Add new message CSQM062I description to V710 knowledge center:
    
    WebSphere MQ > Reference > Messages
     > IBM WebSphere MQ for z/OS messages, completion,
       and reason codes
     > Messages for WebSphere MQ for z/OS
     > Message manager messages (CSQM...)
    
     CSQM062I csect-name INDXTYPE(index-type) not allowed for shared
    
    Severity
    
    4
    
    Explanation
    
    A shared transmission queue is a queue that is defined with both
    USAGE(XMITQ) and QSGDISP(SHARED). To support recovery of
    messages that are in-doubt after a channel failure the index
    type (INDXTYPE) for shared transmission queues must be either
    NONE or MSGID.
    
    System action
    
    Processing continues.
    
    System programmer response
    
    Modify the INDXTYPE attribute for the shared transmission queue
    to NONE or MSGID.
    
    =======================================================
    Add the following reference to message CSQM062I to the Console
    message monitoring page in the V710 knowledge center:
    
    WebSphere MQ > Configuring > Availability, recovery
      and restart
    
    CSQM062I: INDXTYPE(index-type) not allowed for shared
    transmission queue shared-xmitq
    
      . Use command ALTER QLOCAL(shared-xmitq) INDXTYPE(MSGID
        or NONE) to change the configuration of the
        shared transmission queue.
    
    ==============================================
    Add the following NOTE to the description of INDXTYPE(MSGID) in
    the following page in the knowledge center:
    
    WebSphere MQ > Reference
     > Administration reference
     > MQSC reference > The MQSC commands
    
     Note
    
     You can only set INDXTYPE to NONE or MSGID if
     the queue is a shared transmission queue.
    100Y
    101Y
    102Y
    103Y
    104Y
    105Y
    CSQFMDIC
    CSQFMDIE
    CSQFMDIF
    CSQFMDIK
    CSQFMDIU
    CSQFMTXC
    CSQFMTXE
    CSQFMTXF
    CSQFMTXK
    CSQFMTXU
    CSQFXTXC
    CSQFXTXE
    CSQFXTXF
    CSQFXTXK
    CSQFXTXU
    CSQMCNA1
    CSQMOSQ1
    

Temporary fix

  • *********
    * HIPER *
    *********
    

Comments

APAR Information

  • APAR number

    PI69808

  • Reported component name

    WMQ Z/OS V7

  • Reported component ID

    5655R3600

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-09-27

  • Closed date

    2017-11-27

  • Last modified date

    2019-03-14

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

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

    PI71810 PI71811 UI52123 UI52124 UI52125 UI52129 UI52130 UI52131

Modules/Macros

  • CSQFMDIC CSQFMDIE CSQFMDIF CSQFMDIK CSQFMDIU CSQFMTXC CSQFMTXE
    CSQFMTXF CSQFMTXK CSQFMTXU CSQFXTXC CSQFXTXE CSQFXTXF CSQFXTXK
    CSQFXTXU CSQMCNA1 CSQMOSQ1
    

Fix information

  • Fixed component name

    WMQ Z/OS V7

  • Fixed component ID

    5655R3600

Applicable component levels

  • R100 PSY UI52129

       UP17/12/19 P F712 ¢

  • R101 PSY UI52123

       UP17/12/19 P F712 ¢

  • R102 PSY UI52125

       UP17/12/19 P F712 ¢

  • R103 PSY UI52130

       UP17/12/19 P F712 ¢

  • R104 PSY UI52131

       UP17/12/19 P F712 ¢

  • R105 PSY UI52124

       UP17/12/19 P F712 ¢

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:
14 March 2019