The following 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 given. The MQRC_ constants require the WebSphere MQ cmqc.h header file. The MQRCCF_ constants require the WebSphere MQ cmqcfc.h header file (apart from MQRCCF_FILTER_ERROR and MQRCCF_WRONG_USER, which require the WebSphere Message Broker BipRfc.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 you 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 you 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 you have included all mandatory parameters within your <psc> and <mcd> folders. | Any command |
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 broker 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 your 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 broker 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 |
You have specified CorrelAsId as one of your 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 broker are handled by the system administrator using the Topics Hierarchy editor. | Publish and Register Subscriber commands |
3083 MQRCCF_REG_OPTIONS_ERROR |
You 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 |
You have specified an unrecognized PubOpt parameter in the <psc> folder that contains your Publish command. | Publish command |
3087 MQRCCF_DEL_OPTIONS_ERROR |
You 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. |
Notices |
Trademarks |
Downloads |
Library |
Support |
Feedback
![]() ![]() |
aq20813_ |