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

WebSphere MQ V6.0 for iSeries Fix Pack 6.0.2.3
WebSphere MQ V6.0 Fix Pack 6.0.2.3
WebSphere MQ 6.0 for HP OpenVMS Alpha and Itanium - Fix Pack 6.0.2.7
WebSphere MQ 6.0 for HP OpenVMS Alpha and Itanium - Fix Pack 6.0.2.10 (FP03)

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 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