IT31111: USING ENV VARIABLE MQSI_TCPIP_DONT_STOP_ALL_CLIENTS_ON_REFRESH MAY CAUSE BIP3555E IN 10.0.0.18.

APAR status

• Closed as program error.

Error description

• If mqsichangeproperties is run more than once against a TCP
  configurable service, you may hit the following error when
  MQSI_TCPIP_DONT_STOP_ALL_CLIENTS_ON_REFRESH environment
  variable is set.
  
  BIP3555E: Failed to load TCPIPClient
  configurable service 'xyz' (which uses hostname 'localhost' and
  port '4444') because the hostname and port are already in use
  by the configurable service 'xyz'.
  
  The error will prevent the
  configurable property changes being reflected in the associated
  flows.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM Integration Bus version v10 using <span
  style="background-color:rgb(255, 255, 255)">M</span><span
  style="background-color:rgb(255, 255,
  255)">QSI_TCPIP_DONT_STOP_ALL_CLIENTS_ON_REFRESH </span>
  environment variable.
  
  
  Platforms affected:
  z/OS, MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  <span style="background-color:rgb(255, 255, 255)">If
  mqsichangeproperties is run more than once against a TCP
  </span><span style="background-color:rgb(255, 255,
  255)">configurable service, you may hit the following error when
  M</span><span style="background-color:rgb(255, 255,
  255)">QSI_TCPIP_DONT_STOP_ALL_CLIENTS_ON_REFRESH environment
  </span><span style="background-color:rgb(255, 255,
  255)">variable is set.
                                             </span>
  <span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255, 255)">BIP3555E:
  Failed to load TCPIPClient </span><span
  style="background-color:rgb(255, 255, 255)">configurable service
  'xyz' (which uses hostname 'localhost' and</span>
  <span style="background-color:rgb(255, 255, 255)">port '4444')
  because the hostname and port are already in use </span><span
  style="background-color:rgb(255, 255, 255)">by the configurable
  service 'xyz'.                             </span>
  <span style="background-color:rgb(255, 255, 255)">
  
  </span>
  <span style="background-color:rgb(255, 255, 255)">The error will
  prevent the </span><span style="background-color:rgb(255, 255,
  255)">configurable property changes from being reflected in the
  associated flows.
  
  Note: The environment variable is used to refresh only the
  connections of the flows that use the particular configurable
  service whose values are changed.  it is introduced as part of
  APAR </span>IT29378. <span style="background-color:rgb(255, 255,
  255)">                   </span>
  

Problem conclusion

• The product no longer fails to reflect the changes of TCP
  configurable service in their associated flows when
  mqsichangeproperties is run more than once.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v10.0      10.0.0.19
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

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

  INTEGRATION BUS

• Fixed component ID

  5724J0540

Applicable component levels