API completion and reason codes

For each call, a completion code and a reason code are returned by the queue manager or by an exit routine, to indicate the success or failure of the call.

For more information about the IBM MQ API, see Developing applications, and the reference information in Developing applications reference.

For a full list and explanation of the API reason codes, see API reason codes.

API completion codes

The following is a list of the completion codes (MQCC) returned by IBM MQ

0: Successful completion (MQCC_OK)

The call completed fully; all output parameters have been set.

The Reason parameter always has the value MQRC_NONE in this case.

1: Warning (partial completion) (MQCC_WARNING)

The call completed partially. Some output parameters might have been set in addition to the CompCode and Reason output parameters.

The Reason parameter gives additional information.

2: Call failed (MQCC_FAILED)

The processing of the call did not complete, and the state of the queue manager is normally unchanged; exceptions are specifically noted. Only the CompCode and Reason output parameters have been set; all other parameters are unchanged.

The reason might be a fault in the application program, or it might be a result of some situation external to the program, for example the application's authority might have been revoked. The Reason parameter gives additional information.