IT37205: MULTIPLE XA SWITCH LIBRARIES INCORRECTLY DEPEND ON THE LIBNSL.SO.1 SYSTEM LIBRARY ON LINUX IN ACE 11.0.0.12 AND ABOVE

APAR status

• Closed as program error.

Error description

• The following libraries that are included in the ACE runtime
  incorrectly depend on the libnsl.so.1 system library on Linux:
  * libDynJMSSwitch.so
  * libJDBCSwitch.so
  * libJMSSwitch.so
  * libXAJdbcJni.so
  * libXAJmsJni.so
  
  If the libnsl.so.1 library is not available on the installed
  system then parts of the product that depend on these libraries,
  such as JDBC and JMS XA, may fail to load correctly. This may
  present itself with a variety of different error messages, such
  as
  
  
  BIP2112E: IBM App Connect Enterprise internal error:
  diagnostic information 'Cannot load XAJmsJni library',
  'java.lang.UnsatisfiedLinkError: XAJmsJni (Not found in
  java.library.path) ....
  
  or
  
  BIP2801E: Unable to load implementation file 'libXAJdbcJni.so',
  rc=Null pointer.
  

Local fix

• Install the libnsl.so.1 library from the Linux distribution's
  package manager.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM App Connect Enterprise 12.0.1, and 11.0.0.13 or
  above on Linux.
  
  
  Platforms affected:
  Linux on zSeries platform, Linux on x86-64 platform, Linux on
  Power platform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The following libraries that are included in the ACE runtime
  incorrectly depend on the libnsl.so.1 system library on Linux:
  
  * libDynJMSSwitch.so
  * libJDBCSwitch.so
  * libJMSSwitch.so
  * libXAJdbcJni.so
  * libXAJmsJni.so
  
  If the libnsl.so.1 library is not available on the installed
  system then parts of the product that depend on these libraries,
  such as JDBC and JMS XA, may fail to load correctly. This may
  present itself with a variety of different error messages, such
  as
  
  BIP2112E: IBM App Connect Enterprise internal error: diagnostic
  information 'Cannot load XAJmsJni library',
  'java.lang.UnsatisfiedLinkError: XAJmsJni (Not found in
  java.library.path)
  
  or
  
  BIP2801E: Unable to load implementation file 'libXAJdbcJni.so',
  rc=Null pointer.
  

Problem conclusion

• These libraries no longer depend on this system library.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v11.0      11.0.0.14
  v12.0      12.0.2.0
  
  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

  APP CONNECT ENT

• Fixed component ID

  5724J0550

Applicable component levels