IT12164: User program cannot find libimqb23gl_r.so and libimqs23gl_r.so when MQ V8.0.0.3 is the primary installation

APAR status

• Closed as program error.

Error description

• When IBM MQ 8.0 is set as the primary Installation, the runtime
  linker/loader for a 32bit program cannot find libimqb23gl_r.so
  and libimqs23gl_r.so.
  
  Example error output:
    ./mypgm: error while loading shared libraries:
    libimqb23gl_r.so: cannot open shared object file:
    No such file or directory
  
  When trying to debug this using "ldd":
    $ldd ./mypgm
    libimqb23gl_r.so => not found
    libimqs23gl_r.so => not found
  
  This worked in WebSphere MQ 7.5.
  
  MQ 7.5 install had the following symlinks:
    /usr/lib/libimqb23gl.so -> /opt/mqm/lib/4.1/libimqb23gl.so
    /usr/lib/libimqs23gl.so -> /opt/mqm/lib/4.1/libimqs23gl.so
  
  In MQ 8.0, the 4.1 directory no longer exists. It was replaced
  with a 4.1 suffix at the end of the filename:
    /usr/lib/libimqb23gl.so.4.1 -> /opt/mqm/lib/libimqb23gl.so.4.1
    /usr/lib/libimqs23gl.so.4.1 -> /opt/mqm/lib/libimqs23gl.so.4.1
  
  Symlinks for the simple .so filenames are not present, but these
  are needed by apps that for some reason must obtain their libs
  this way.
  

Local fix

• The first workaround is to use LD_LIBRARY_PATH (maybe via use of
  setmqenv) to ensure runtime libs are obtained direct from the MQ
  installation lib and lib64 directories.
  
  If for some reason you must obtain the MQ C++ libs from the
  default MQ installation on the system, via symlinks in /usr/lib
  and /usr/lib64, then the following workaround should also work:
  
  1. Stop all MQ activity in the installation, including ending
  all queue managers and MQ applications.
  2. Unset the MQ installation as primary.  This will remove all
  MQ symbolic links from /usr/lib.
  3. Keep a backup of the current instinfo.tsk.
  4. Alter instinfo.tsk to change the "Name" field for all
  libraries ending in ".so.4.1" to end with just ".so", e. g.:
  
       FROM:  Name=/usr/lib/libimqb23gl_r.so.4.1
       TO:    Name=/usr/lib/libimqb23gl_r.so
  
     The instinfo.tsk file can be found in the root installation
  directory of the MQ installation. For example, /opt/mqm is the
  default MQ root installation directory on Linux.
  
  5. Set the installation as primary to create the right links.
  6. Start your queue managers and applications.  MQ C++ programs
  should now run normally.
  7. Before installing your next fix pack, unset the installation
  as primary, then restore the original instinfo.tsk ensuring the
  ownership+permissions are unchanged from the original.  If the
  fix pack contains a fix for this APAR then it will overwrite the
  instinfo.tsk with a fixed version.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  Users with applications that use MQ C++ API libraries from
  /usr/lib or /usr/lib64 on Linux, who are upgrading to MQ 8.0
  from earlier releases.
  
  Note that in most cases a reasonable workaround is to use
  LD_LIBRARY_PATH (maybe via use of setmqenv) to ensure runtime
  libs are obtained direct from the MQ installation lib and lib64
  directories.
  
  
  Platforms affected:
  Linux on Power, Linux on x86, Linux on x86-64, Linux on zSeries
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The symlinks needed in /usr/lib and /usr/lib64 were not being
  created by MQ when the setmqinst program ran.  This is because
  the entries needed in instinfo.tsk were not present.
  
  The "instinfo.tsk" file (located in the top-level MQ
  installation directory, e.g. /opt/mqm) tells MQ's setmqinst
  program what it must do to make or unmake a primary
  installation).
  
  On a 7.5 system it shows:
    SymLink:
      Name=/usr/lib/libimqb23gl_r.so
      Target=+MQ_INSTALLATION_PATH+/lib/4.1/libimqb23gl_r.so
      Activity=PRIMARY
  
  On an 8.0 system it shows:
    SymLink:
      Name=/usr/lib/libimqb23gl_r.so.4.1
      Target=+MQ_INSTALLATION_PATH+/lib/libimqb23gl_r.so.4.1
      Activity=PRIMARY
  

Problem conclusion

• The needed entries in instinfo.tsk have been added.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.6
  
  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 BASE MULTIP

• Fixed component ID

  5724H7251

Applicable component levels

• R800 PSY

     UP