PI73140: A TUXEDO MQ XA CLIENT CAUSES AN ABEND 5C6-00D4007D.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An Oracle Tuxedo MQ client connects to MQ on z/OS via client
  connections and receives an ABEND5C6 reason code 00D4007D.
  
  CSQY291E CSQWDSDM SDUMPX FAILED, RC=00000B08,xxxx,
           ABN=5C6-00D4007D,LOC=CSQMLPLM.CSQMXARH+xxxxxxxx
  CSQY291E CSQXDMPS SDUMPX FAILED, RC=00000B08,xxxx,
           ABN= 5C6-00E7014F,LOC=CSQXADPM.CSQXADPM+xxxxx
  CSQX209E CSQ1 CSQXRESP Connection unexpectedly terminated
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of IBM MQ for z/OS Version 9 Release 0             *
  * Modification 0.                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When using Oracle Tuxedo as an external transaction manager, *
  * connecting to MQ z/OS over an XA client connection,          *
  * XA_PREPARE requests may fail with abend 5C6-00D4007D.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * None                                                         *
  ****************************************************************
  An MQ client application is running under the control of an
  external transaction manager which uses XA calls to perform
  transaction coordination.
  
  The application connects to MQ on z/OS and performs some
  in-syncpoint work. To register the work as part of an XA
  transaction, the transaction manager makes XA_START and XA_END
  calls on the application's connection to MQ.
  
  When the application requests that the transaction manager
  completes the transaction, the transaction manager may decide to
  use a different MQ connection to make the XA_PREPARE call.
  
  In these circumstances, MQ z/OS is not able to perform the
  necessary processing to prepare the XA transaction. The chinit
  task for the connection is abended 5C6-00D4007D, and the client
  receives return code -3 (XAER_RMERR).
  

Problem conclusion

• This APAR provides changes to XA client connections on z/OS
  which allow the transaction manager to prepare a transaction on
  a different connection. The change is not enabled by default. To
  make use of the change it must be explicitly enabled on the
  svrconn definition used by the XA client.
  
  This APAR also includes fixes for the issues reported in PI56679
  and PI68962.
  
  Documentation changes for V900 Knowledge Center:
  A new Knowledge Center page will be added as a sub-topic of:
  WebSphere MQ
   > Configuring
     > Configuring connections between the server and client
       > Configuring an extended transactional client
  
  https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.0.0/com.ibm
  .mq.con.doc/q016530_.htm
  
  Title: MQ z/OS considerations for extended transactional client
  connections
  
  Some XA transaction managers use sequences of transaction
  coordination calls which are incompatible with the features
  normally available to clients connecting to MQ on z/OS.
  
  Where an incompatible sequence is detected, MQ on z/OS may issue
  an abend for the connection and return an error response to the
  client.
  e.g.
  xa_prepare receives abend 5C6-00D4007D, with return code -3
  (XAER_RMERR) returned to the client.
  For transaction managers which encounter this situation, the
  following actions should be taken to allow the transaction
  manager to interact with MQ on z/OS:
   - Apply the fix for APAR PI73140.
   - Enable the change provided by PI73140 for the SVRCONN channel
  used by the transaction manager.
     The change is enabled by specifying the keyword CSQSERVICE1
  (in upper case) anywhere in the description field of the SVRCONN
  channel.
  
  Channels with the CSQSERVICE1 keyword have the following
  restrictions:
  
   - GROUP unit of recovery disposition is not permitted.
     Only QMGR unit of recovery disposition is allowed.
     An xa_open call specifying the QSG name in the xa_info
  parameter will fail with xaer_inval.
  
   - The MQGMO_LOCK and MQGMO_UNLOCK options are not permitted.
     An MQGET call with MQGMO_LOCK or MQGMO_UNLOCK will fail with
  MQRC_ENVIRONMENT_ERROR.
  

Temporary fix

Comments

• ×**** PE17/11/23 FIX IN ERROR. SEE APAR PI90544  FOR DESCRIPTION
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

  PI49236

• APAR is sysrouted TO one or more of the following:

  UI46719 PI92138

Modules/Macros

• CMQXRSRV CSQ7CBMC CSQMCALH CSQMCLMT CSQMCPRH CSQMDALL CSQMDCOH
  CSQMGETV CSQMXARH CSQMXCLN CSQXADPM none
  

Fix information

• Fixed component name

  MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R000 PSY UI46719

     UP17/05/19 P F705

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.