Publish/subscribe reason codes
These reason codes might be returned in the Reason field of a publish/subscribe response <pscr> folder. Constants that can be used to represent these codes in the C or C++ programming languages are also listed.
The MQRC_ constants require the IBM MQ cmqc.h header file. The MQRCCF_ constants require the IBM MQ cmqcfc.h header file (apart from MQRCCF_FILTER_ERROR and MQRCCF_WRONG_USER, which require the cmqpsc.h header file).
| Reason code and text | Explanation | Issued by |
|---|---|---|
| 2336
MQRC_RFH_COMMAND_ERROR |
Valid values for the <Command> field of a <psc> folder are: RegSub, DeregSub, Publish, DeletePub, and ReqUpdate. Any other values result in this error code being issued. | Any command |
| 2337
MQRC_RFH_ PARM_ERROR |
The <psc> and <mcd> folders both have a set of valid parameters that can be specified within them. Check the descriptions of these folders and ensure that we have not specified incorrect parameters. | Any command |
| 2338
MQRC_RFH_DUPLICATE_PARM |
Some parameters (for example, Topic) within a <psc> folder can be repeated, but others (for example, Command) cannot be repeated. Check that we have not duplicated a non-repeatable parameter. | Any command |
| 2339
MQRC_RFH_PARM_MISSING |
Some parameters within <psc> or <mcd> folders are optional and can be omitted; some are mandatory and must not be omitted. Check that we have included all mandatory parameters within your <psc> and <mcd> folders. | Any command |
| 2551
MQRC_SELECTION_NOT_AVAILABLE |
No extended message selection provider was available to determine which subscribers with a filter specified should receive the publication. | Publish, Register Subscriber, and Request Update |
| No extended message selection provider was available to handle the filter of the specified subscriber. | Register Subscriber and Request Update | |
| 2554
MQRC_CONTENT_ERROR |
An extended message selection provider found an error in the current or retained publication. | Publish and Request Update |
| 3008
MQRCCF_COMMAND_FAILED |
An internal error occurred which prevented the command from executing correctly. The error might occur if the command is reissued. The system event log for the queue manager contains information which should be used when reporting the problem to IBM. | Any command |
| 3072
MQRCCF_TOPIC_ERROR |
One or more of the values you supplied for the Topic parameter are incorrect. Check that your values for Topic conform to the specified restrictions. | Any command |
| 3073
MQRCCF_NOT_REGISTERED |
The combination of SubPoint, Topic, and Filter that you specified on your DeregSub or ReqUpdate command was either not a combination with which you had previously registered or, for the DeregSub command if the DeregAll option was specified, one of the SubPoint, Topic, or Filter properties was not used to deregister any subscription. | Deregister Subscriber and Request Update commands |
| 3074
MQRCCF_Q_MGR_NAME_ERROR |
The specified queue manager was not valid, or the queue manager was not available or did not exist. | Deregister Subscriber, Publish, Register Subscriber, and Request Update commands |
| 3076
MQRCCF_Q_NAME_ERROR |
The specified queue name was not valid, or the queue did not exist on the specified queue manager. | Deregister Subscriber, Publish, Register Subscriber, and Request Update commands |
| 3077
MQRCCF_NO_RETAINED_MSG |
There were no retained messages for the topic you specified. This might or might not be an error, depending on the design of the application program. | Request Update command |
| 3079
MQRCCF_INCORRECT_Q |
RegSub, DeregSub, and ReqUpdate commands are always sent to the SYSTEM.BROKER.CONTROL.QUEUE queue of the queue manager for which they are intended. Publish and Delete Publication commands are sent to the input queue for the particular publish/subscribe message flow for which they are intended; this is determined when the message flow is designed. This error code is returned if a command is sent to the wrong queue. | Any command |
| 3080
MQRCCF_CORREL_ID_ERROR |
We have specified CorrelAsId as one of our RegOpt parameters. However, the CorrelId field of the MQMD does not contain a valid correlation identifier (that is, it is set to MQCI_NONE). | Deregister Subscriber and Register Subscriber commands |
| 3081
MQRCCF_NOT_AUTHORIZED |
You are not authorized to perform the requested action. Authorization settings for the queue manager are handled by the system administrator using the Topics Hierarchy editor. | Publish and Register Subscriber commands |
| 3083
MQRCCF_REG_OPTIONS_ERROR |
We have specified an unrecognized RegOpt parameter in the <psc> folder that contains your RegSub or DeregSub command. | Deregister Subscriber and Register Subscriber commands |
| 3084
MQRCCF_PUB_OPTIONS_ERROR |
We have specified an unrecognized PubOpt parameter in the <psc> folder that contains your Publish command. | Publish command |
| 3087
MQRCCF_DEL_OPTIONS_ERROR |
We have specified an unrecognized DelOpt parameter in the <psc> folder that contains your DeletePub command. | Delete Publication command |
| 3150
MQRCCF_FILTER_ERROR |
The value specified for the Filter parameter is not valid. Check the section that describes the valid syntax for filter expressions and ensure that your expression conforms. | Deregister Subscriber, Register Subscriber, and Request Update commands |
| 3151
MQRCCF_WRONG_USER |
A subscription that matches the one specified already exists; however, it was registered by a different user. A subscription can only be changed or deregistered by the user who originally registered it. | Deregister Subscriber, Register Subscriber, and Request Update commands |
| 3152
MQRCCF_DUPLICATE_SUBSCRIPTION |
A matching subscription already exists with a different subscription name. | |
| 3153
MQRCCF_SUB_NAME_ERROR |
Either the format of the subscription name is not valid, or a matching subscription already exists with no subscription name. | |
| 3154
MQRCCF_SUB_IDENTITY_ERROR |
The subscription identity parameter is in error. Either the supplied value exceeds the maximum length allowed, or the subscription identity is not currently a member of the subscription's identity set and a Join registration option was not specified. | |
| 3155
MQRCCF_SUBSCRIPTION_IN_USE |
An attempt to modify or deregister a subscription was attempted by a member of the identity set when it was not the only member of this set. | |
| 3156
MQRCCF_SUBSCRIPTION_LOCKED |
The subscription is currently exclusively locked by another identity. | |
| 3157
MQRCCF_ALREADY_JOINED |
A Join registration option was specified but the subscriber identity was already a member of the subscription's identity set. |