gtpc2m4v | C/C++ Language Support User's Guide |
This function closes a queue.
Format
#include <cmqc.h> void MQCLOSE(MQHCONN Hconn, PMQHOBJ pHobj, MQLONG Options, PMQLONG pCompCode, PMQLONG pReason);
If the completion code is MQCC_OK, the reason code is MQRC_NONE, which indicates a normal return.
If the completion code is MQCC_FAILED, see Error Return for the corresponding reason codes.
See MQSeries Application Programming Reference and MQSeries Message Queue Interface Technical Reference for more information about MQSeries data types and parameters.
Normal Return
If the completion code is MQCC_FAILED, the function failed with one of the following reason codes:
Programming Considerations
If the Hconn parameter is not for the local TPF MQSeries queue manager, this MQCLOSE function call will be sent by TPF MQSeries client support to the remote queue manager for processing. The options supported by the remote queue manager can differ from the options specified for the local TPF MQSeries queue manager.
Examples
The following example closes a queue.
#include <cmqc.h> PMQHOBJ pHobj; MQLONG CompCode; /* completion code */ MQLONG Reason; /* reason code */ MQHCONN Hcon; /* Connection Handle */ MQLONG C_options = 0; /* Hcon and Hobj from previous MQCONN MQOPEN */ MQCLOSE(Hcon, pHobj, C_options, &CompCode, &Reason); if(Reason != MQRC_NONE) printf("MQCLOSE ended with reason code %d.\n",Reason);
Related Information