IT20363: xa_open call failed with XAER_RMERR (-3) when configuring IBM MQ extended transactional client with IBM TXSeries

APAR status

• Closed as program error.

Error description

• After configuring the MQ extended transaction client with the
  TXSeries region,  XAOPEN call failed with XAER_RMERR '-3'
  during the process of TXSeries region start.
  The MQ trace shows  that  MQ attempt to load libEncServer.so
  from dir "/opt/encina/lib/"  however the library is present in
  the path  /opt/ibm/cics/lib , and hence getting ErrorNumber(2)
  meaning ENOENT file "NO SUCH FILE OR DIRECTORY."
  .
  XAOpen
    __________
    xa_open >>
    Xa_info:
  
  channel=CICS.SVRCONN,trptype=tcp,conname=9.195.16.128(4714),qmna
  me=QMGR,tpm=cics
    Rmid:
      0x0000:  00000000                             |....
             |    Rmid : 0
    Flags:
      0x0000:  00000000                             |....
             |    Flags : 0
    Called in dynamic registration mode
   zstcParseXAOpenInfo
  
  xaInfo=channel=CICS.SVRCONN,trptype=tcp,conname=9.195.16.128(471
  4),qmname=QMGR,tpm=cics
  )--{  reqFindAXFuncsAddr
  )---{  xcsLoadFunction
    LibName(/opt/encina/lib/libEncServer.so) LoadType(1048696)
  )----{  xcsGetEnv
    xcsGetEnv[LD_LIBRARY_PATH] =
  )----}  xcsGetEnv rc=OK FunctionTime=4
    FullPathLibName(/opt/encina/lib/libEncServer.so) RC(24948)
  ErrorNumber(2) ErrorString(No such file or directory)
  

Local fix

• Copy or link the MQ library "libEncServer.so" from
  "/opt/ibm/cics/lib/" to "/opt/encina/lib/"
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All MQ users who configure IBM MQ v8 or v9 with IBM TXseries
  (extended transaction client) installed in /opt/ibm/cics/lib/
  will be affected.
  
  
  Platforms affected:
  Linux on S390, Linux on x86, Linux on x86-64, Linux on zSeries,
  Solaris SPARC, Solaris x86-64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When using MQ with CICS TXseries for transaction coordination on
  Linux or Solaris, MQ attempts to load the CICS XA switchload
  file - libEncServer.so - from /opt/encina/lib/. If using a
  TXseries version which is installed in /opt/ibm/cics/lib/, this
  operation failed.
  

Problem conclusion

• The MQ client's XA open logic on Linux and Solaris platforms has
  been modified to additionally attempt to load libEncServer.so
  from /opt/ibm/cics/lib if the library is not present in
  /opt/encina/lib/.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v8.0       8.0.0.8
  v9.0 CD    9.0.4
  v9.0 LTS   9.0.0.2
  
  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