IBM Support

IZ04163: WMQ CHANNEL CONNECTION FAILS WITH AMQ9213 ERROR 22 OVER IPV6

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A customer using IPv6 to connect channels to a remote queue
    manager found that their channel would not start. Error
    AMQ9213 was recorded in the WMQ error logs.
    
    The error message reported that the TCP/IP connect function had
    returned error 22.
    

Local fix

  • na
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    WMQ customers using TCP channels over IPv6 networks.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    The AMQ9213 error occurred because the IPv6 sin6_scope_id had
    not been set by the initiating end of the channel. Some systems
    require a non-zero IPv6 scope ID to qualify an IPv6 address.
    

Problem conclusion

  • WMQ has been modified to allow both the initiating and
    responding ends of channels to initialise the IPv6 scope ID.
    
    Affected customers will need to apply the fix for this APAR and
    include the scope ID in the channel definition CONNAME field.
    The scope ID must be the last item in the field and must be
    separated from the hostname by a percent character (%).
    
    For example, a connection to host fe80::4567 on port 1415 which
    needs to use scope ID 1 should have a CONNAME of
    "fe80::4567(1415)%1".
    
    The same syntax can also be used in the channel definition
    LOCLADDR field. The runmqlsr -i parameter can also accept an
    optional scope ID, for example:
    
    runmqlsr -m QMGR -t tcp -p 1416 -i fe80::7890%1
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v6.0
    Platform           Fix Pack 6.0.2.3
    --------           --------------------
    Windows            U200279
    AIX                U811346
    HP-UX (PA-RISC)    U811630
    HP-UX (Itanium)    U811631
    Solaris (SPARC)    U811632
    Solaris (x86-64)   U811633
    iSeries            SI27288
    Linux (x86)        U811634
    Linux (x86-64)     U811635
    Linux (zSeries)    U811636
    Linux (Power)      U811637
    Linux (s390x)      U811638
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    
    If the maintenance level is not yet available, information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IZ04163

  • Reported component name

    WMQ LIN X86 V6

  • Reported component ID

    5724H7204

  • Reported release

    600

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2007-09-03

  • Closed date

    2007-09-10

  • Last modified date

    2007-09-10

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

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

Fix information

  • Fixed component name

    WMQ LIN X86 V6

  • Fixed component ID

    5724H7204

Applicable component levels

  • R600 PSY

       UP

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ5M","label":"APAR"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
10 September 2007