2354 (0932) (RC2354): MQRC_UOW_ENLISTMENT_ERROR


Explanation

This reason code can occur for various reasons and occurs only on Windows, and HP Integrity NonStop Server.

On Windows, the most likely reason is that an object created by a DTC transaction does not issue a transactional MQI call until after the DTC transaction timed out. (If the DTC transaction times out after a transactional MQI call has been issued, reason code MQRC_HANDLE_IN_USE_FOR_UOW is returned by the failing MQI call.)

On HP Integrity NonStop Server, this reason occurs:

  • On a transactional MQI call when the client encounters a configuration error preventing it from enlisting with the TMF/Gateway, therefore preventing participation within a global unit of work that is coordinated by the Transaction Management Facility (TMF).
  • If a client application makes an enlistment request before the TMF/Gateway completes recovery of in-doubt transactions, the request is held for up to 1 second. If recovery does not complete within that time, the enlistment is rejected.

Another cause of MQRC_UOW_ENLISTMENT_ERROR is incorrect installation.


Completion code

MQCC_FAILED


Programmer response

On Windows, check the DTC Transaction timeout value. If necessary, verify the Windows installation order.

On HP Integrity NonStop Server this might be a configuration error. The client issues a message to the client error log providing extra information about the configuration error. Contact the system administrator to resolve the indicated error.

Parent topic: API reason codes