Error Handling

Nearly all Message Queue C functions return an MQStatus result. You can use this return value to determine whether the function returned successfully and, if not, to determine the cause of the error.

Table 2-13 lists the functions you use to get error information.

Table 2-13 Functions Used in Handling Errors

To Handle Errors in Your Code

1. Call MQStatusIsError, passing it an MQStatus result for the function whose result you want to test.
2. If the MQStatusIsError function returns MQ_TRUE , call MQGetStatusCode or MQGetStatusString to identify the error.
3. If the status code and string information is not sufficient to identify the cause of the error, you can get additional diagnostic information by calling MQGetErrorTrace to obtain the calling thread’s current error trace if this information is available.

   Chapter 4, Reference, lists common errors returned for each function. In addition to these errors, the following error codes may be returned by any Message Queue C function:

   • MQ_STATUS_INVALID_HANDLE

   • MQ_OUT_OF_MEMORY

   • MQ_NULL_PTR_ARG

   In addition, the MQ_TIMEOUT_EXPIRED can return from any Message Queue C function that communicates with the Message Queue broker if the connection MQ_ACK_TIMEOUT_PROPERTY is set to a non-zero value.