Completion codes

The completion code parameter (CMPCOD) allows the caller to see quickly whether the call completed successfully, completed partially, or failed.

The following is a list of completion codes, with more detail than is given in the call descriptions:

CCOK

Successful completion.

The call completed fully; all output parameters have been set. The REASON parameter always has the value RCNONE in this case.

CCWARN

Warning (partial completion).

The call completed partially. Some output parameters may have been set in addition to the CMPCOD and REASON output parameters. The REASON parameter gives additional information about the partial completion.

CCFAIL

Call failed.

The processing of the call did not complete, and the state of the queue manager is normally unchanged; exceptions are specifically noted. The CMPCOD and REASON output parameters have been set; other parameters are unchanged, except where noted.

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