IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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 number

    IT20363

  • Reported component name

    WMQ BASE MULTIP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-04-26

  • Closed date

    2017-05-30

  • Last modified date

    2017-05-30

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
30 May 2017