IV51770: THE MQ_LCLADDR ENVIRONMENT VARIABLE BEHAVES INCONSISTENTLY

WebSphere MQ V7.0 Fix Pack 7.0.1.12
Fix Pack 7.1.0.5 for WebSphere MQ V7.1
WebSphere MQ V7.5 Fix Pack 7.5.0.4

APAR status

• Closed as program error.

Error description

• The MQ_LCLADDR environment variable has inconsistent behaviour.
  
  The first time a channel is started, the input is parsed and
  if LoclAddr is not set then the environment variable
  MQ_LCLADDR is used. The next time when parsing is done,
  WebSphere MQ uses the cached values for channel. This does not
  include the LoclAddr and so the MQ_LCLADDR environment
  variable is not checked. This results in channels not using
  the MQ_LCLADDR variable.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users who use MQ_LCLADDR environment variable to make use of a
  particular local address while establishing channel connections
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM SUMMARY:
  The environment variable MQ_LCLADDR helps set the local
  communication address on a channel that has the transport type
  as TCP/IP. It is used as an alternative to the channel attribute
  LoclAddr and is used only when LoclAddr is not specified on
  the channel.
  
  When a channel is started in first attempt, it checks the
  presence of LoclAddr value and only if the LoclAddr value is not
  set, the channel uses the value set in MQ_LCLADDR variable.
  The next time when the channel is started, it uses the cached
  values. Since the LoclAddr was not cached during the first
  attempt, the channel will start without using MQ_LCLADDR
  variable as it will only be used when a check on LoclAddr is
  made during channel start and it is not found to be set.
  So MQ_LCLADDR variable will only be used on the first attempt
  and will be left unused on the successive attempts of channel
  start.
  

Problem conclusion

• The LoclAddr attribute of channel is now cached so that when the
  channel retries, it uses the cached values and finds that
  LoclAddr is not set which makes the channel to use the
  MQ_LCLADDR variable's value. This ensures that the usage of
  MQ_LCLADDR environment variable has a consistent behaviour.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.1       7.1.0.5
  v7.5       7.5.0.4
  v7.0       7.0.1.12
  
  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 AIX V7

• Fixed component ID

  5724H7221

Applicable component levels

• R701 PSY

     UP