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":"LOB45","label":"Automation"}}]
Document Information
Modified date:
30 May 2017