Appendix B. PCF reason codes
Reason codes might be returned in response to a command message in PCF format, depending on the parameters used in that message.
Codes in the range 3000 - 4999 (X'0BB8' - X'1387') are specific to PCF and are described here. You might also expect to see some of the API codes described in Appendix A. API completion and reason codes.
For more information about PCF, see the WebSphere MQ Programmable Command Formats and Administration Interface.
Reason codes
The following is a list of reason codes specific to PCF, in numeric order, providing detailed information to help you understand them, including:
- An explanation of the circumstances that have caused the code to be raised
- The associated completion code
- Suggested programmer actions in response to the code
See Reason code cross reference for a list of PCF reason codes in alphabetic order.
3001 (X'0BB9')MQRCCF_CFH_TYPE_ERRORExplanation:Type not valid.
The MQCFH Type field value was not valid.
Programmer Response:Specify a valid type.
3002 (X'0BBA')MQRCCF_CFH_LENGTH_ERRORExplanation:Structure length not valid.
The MQCFH StrucLength field value was not valid.
Programmer Response:Specify a valid structure length.
3003 (X'0BBB')MQRCCF_CFH_VERSION_ERRORExplanation:Structure version number is not valid.
The MQCFH Vfield value was not valid.
Programmer Response:Specify a valid structure version number.
3004 (X'0BBC')MQRCCF_CFH_MSG_SEQ_NUMBER_ERRExplanation:Message sequence number not valid.
The MQCFH MsgSeqNumber field value was not valid.
Programmer Response:Specify a valid message sequence number.
3005 (X'0BBD')MQRCCF_CFH_CONTROL_ERRORExplanation:Control option not valid.
The MQCFH Control field value was not valid.
Programmer Response:Specify a valid control option.
3006 (X'0BBE')MQRCCF_CFH_PARM_COUNT_ERRORExplanation:Parameter count not valid.
The MQCFH ParameterCount field value was not valid.
Programmer Response:Specify a valid parameter count.
3007 (X'0BBF')MQRCCF_CFH_COMMAND_ERRORExplanation:Command identifier not valid.
The MQCFH Command field value was not valid.
Programmer Response:Specify a valid command identifier.
3008 (X'0BC0')MQRCCF_COMMAND_FAILEDExplanation:Command failed.
The command has failed.
Programmer Response:Refer to the previous error messages for this command.
3009 (X'0BC1')MQRCCF_CFIN_LENGTH_ERRORExplanation:Structure length not valid.
The MQCFIN or MQCFIN64 StrucLength field value was not valid.
Programmer Response:Specify a valid structure length.
3010 (X'0BC2')MQRCCF_CFST_LENGTH_ERRORExplanation:Structure length not valid.
The MQCFST StrucLength field value was not valid. The value was not a multiple of four or was inconsistent with the MQCFST StringLength field value.
Programmer Response:Specify a valid structure length.
3011 (X'0BC3')MQRCCF_CFST_STRING_LENGTH_ERRExplanation:String length not valid.
The MQCFST StringLength field value was not valid. The value was negative or greater than the maximum permitted length of the parameter specified in the Parameter field.
Programmer Response:Specify a valid string length for the parameter.
3012 (X'0BC4')MQRCCF_FORCE_VALUE_ERRORExplanation:Force value not valid.
The force value specified was not valid.
Programmer Response:Specify a valid force value.
3013 (X'0BC5')MQRCCF_STRUCTURE_TYPE_ERRORExplanation:Structure type not valid.
The structure Type value was not valid.
Programmer Response:Specify a valid structure type.
3014 (X'0BC6')MQRCCF_CFIN_PARM_ID_ERRORExplanation:Parameter identifier is not valid.
The MQCFIN or MQCFIN64 Parameter field value was not valid.
Programmer Response:Specify a valid parameter identifier.
3015 (X'0BC7')MQRCCF_CFST_PARM_ID_ERRORExplanation:Parameter identifier is not valid.
The MQCFST Parameter field value was not valid.
Programmer Response:Specify a valid parameter identifier.
3016 (X'0BC8')MQRCCF_MSG_LENGTH_ERRORExplanation:Message length not valid.
The message data length was inconsistent with the length implied by the parameters in the message, or a positional parameter was out of sequence.
Programmer Response:Specify a valid message length, and check that positional parameters are in the correct sequence.
3017 (X'0BC9')MQRCCF_CFIN_DUPLICATE_PARMExplanation:Duplicate parameter.
Two MQCFIN or MQCFIN64 or MQCFIL or MQCFIL64 structures, or any two of those types of structure, with the same parameter identifier were present.
Programmer Response:Check for and remove duplicate parameters.
3018 (X'0BCA')MQRCCF_CFST_DUPLICATE_PARMExplanation:Duplicate parameter.
Two MQCFST structures, or an MQCFSL followed by an MQCFST structure, with the same parameter identifier were present.
Programmer Response:Check for and remove duplicate parameters.
3019 (X'0BCB')MQRCCF_PARM_COUNT_TOO_SMALLExplanation:Parameter count too small.
The MQCFH ParameterCount field value was less than the minimum required for the command.
Programmer Response:Specify a parameter count that is valid for the command.
3020 (X'0BCC')MQRCCF_PARM_COUNT_TOO_BIGExplanation:Parameter count too big.
The MQCFH ParameterCount field value was more than the maximum for the command.
Programmer Response:Specify a parameter count that is valid for the command.
3021 (X'0BCD')MQRCCF_Q_ALREADY_IN_CELLExplanation:Queue already exists in cell.
An attempt was made to define a queue with cell scope, or to change the scope of an existing queue from queue-manager scope to cell scope, but a queue with that name already existed in the cell.
Programmer Response:Do one of the following:
- Delete the existing queue and retry the operation.
- Change the scope of the existing queue from cell to queue-manager and retry the operation.
- Create the new queue with a different name.
3022 (X'0BCE')MQRCCF_Q_TYPE_ERRORExplanation:Queue type not valid.
The QType value was not valid.
Programmer Response:Specify a valid queue type.
3023 (X'0BCF')MQRCCF_MD_FORMAT_ERRORExplanation:Format not valid.
The MQMD Format field value was not MQFMT_ADMIN.
Programmer Response:Specify the valid format.
3024 (X'0BD0')MQRCCF_CFSL_LENGTH_ERRORExplanation:Structure length not valid.
The MQCFSL StrucLength field value was not valid. The value was not a multiple of four or was inconsistent with the MQCFSL StringLength field value.
Programmer Response:Specify a valid structure length.
3025 (X'0BD1')MQRCCF_REPLACE_VALUE_ERRORExplanation:Replace value not valid.
The Replace value was not valid.
Programmer Response:Specify a valid replace value.
3026 (X'0BD2')MQRCCF_CFIL_DUPLICATE_VALUEExplanation:Duplicate parameter value.
In the MQCFIL or MQCFIL64 structure, there was a duplicate parameter value in the list.
Programmer Response:Check for and remove duplicate parameter values.
3027 (X'0BD3')MQRCCF_CFIL_COUNT_ERRORExplanation:Count of parameter values not valid.
The MQCFIL or MQCFIL64 Count field value was not valid. The value was negative or greater than the maximum permitted for the parameter specified in the Parameter field.
Programmer Response:Specify a valid count for the parameter.
3028 (X'0BD4')MQRCCF_CFIL_LENGTH_ERRORExplanation:Structure length not valid.
The MQCFIL or MQCFIL64 StrucLength field value was not valid.
Programmer Response:Specify a valid structure length.
3029 (X'0BD5')MQRCCF_MODE_VALUE_ERRORExplanation:Mode value not valid.
The Mode value was not valid.
Programmer Response:Specify a valid mode value.
3029 (X'0BD5')MQRCCF_QUIESCE_VALUE_ERRORExplanation:Former name for MQRCCF_MODE_VALUE_ERROR.
3030 (X'0BD6')MQRCCF_MSG_SEQ_NUMBER_ERRORExplanation:Message sequence number not valid.
The message sequence number parameter value was not valid.
Programmer Response:Specify a valid message sequence number.
3031 (X'0BD7')MQRCCF_PING_DATA_COUNT_ERRORExplanation:Data count not valid.
The Ping Channel DataCount value was not valid.
Programmer Response:Specify a valid data count value.
3032 (X'0BD8')MQRCCF_PING_DATA_COMPARE_ERRORExplanation:Ping Channel command failed.
The Ping Channel command failed with a data compare error. The data offset that failed is returned in the message (with parameter identifier MQIACF_ERROR_OFFSET).
Programmer Response:Consult your systems administrator.
3033 (X'0BD9')MQRCCF_CFSL_PARM_ID_ERRORExplanation:Parameter identifier is not valid.
The MQCFSL Parameter field value was not valid.
Programmer Response:Specify a valid parameter identifier.
3034 (X'0BDA')MQRCCF_CHANNEL_TYPE_ERRORExplanation:Channel type not valid.
The ChannelType specified was not valid, or did not match the type of an existing channel being copied, changed or replaced, or the command and the specified disposition cannot be used with that type of channel.
Programmer Response:Specify a valid channel name, type, or disposition.
3035 (X'0BDB')MQRCCF_PARM_SEQUENCE_ERRORExplanation:Parameter sequence not valid.
The sequence of parameters is not valid for this command.
Programmer Response:Specify the positional parameters in a valid sequence for the command.
3036 (X'0BDC')MQRCCF_XMIT_PROTOCOL_TYPE_ERRExplanation:Transmission protocol type not valid.
The TransportType value was not valid.
Programmer Response:Specify a valid transmission protocol type.
3037 (X'0BDD')MQRCCF_BATCH_SIZE_ERRORExplanation:Batch size not valid.
The batch size specified was not valid.
Programmer Response:Specify a valid batch size value.
3038 (X'0BDE')MQRCCF_DISC_INT_ERRORExplanation:Disconnection interval not valid.
The disconnection interval specified was not valid.
Programmer Response:Specify a valid disconnection interval.
3039 (X'0BDF')MQRCCF_SHORT_RETRY_ERRORExplanation:Short retry count not valid.
The ShortRetryCount value was not valid.
Programmer Response:Specify a valid short retry count value.
3040 (X'0BE0')MQRCCF_SHORT_TIMER_ERRORExplanation:Short timer value not valid.
The ShortRetryInterval value was not valid.
Programmer Response:Specify a valid short timer value.
3041 (X'0BE1')MQRCCF_LONG_RETRY_ERRORExplanation:Long retry count not valid.
The long retry count value specified was not valid.
Programmer Response:Specify a valid long retry count value.
3042 (X'0BE2')MQRCCF_LONG_TIMER_ERRORExplanation:Long timer not valid.
The long timer (long retry wait interval) value specified was not valid.
Programmer Response:Specify a valid long timer value.
3043 (X'0BE3')MQRCCF_SEQ_NUMBER_WRAP_ERRORExplanation:Sequence wrap number not valid.
The SeqNumberWrap value was not valid.
Programmer Response:Specify a valid sequence wrap number.
3044 (X'0BE4')MQRCCF_MAX_MSG_LENGTH_ERRORExplanation:Maximum message length not valid.
The maximum message length value specified was not valid.
Programmer Response:Specify a valid maximum message length.
3045 (X'0BE5')MQRCCF_PUT_AUTH_ERRORExplanation:Put authority value not valid.
The PutAuthority value was not valid.
Programmer Response:Specify a valid authority value.
3046 (X'0BE6')MQRCCF_PURGE_VALUE_ERRORExplanation:Purge value not valid.
The Purge value was not valid.
Programmer Response:Specify a valid purge value.
3047 (X'0BE7')MQRCCF_CFIL_PARM_ID_ERRORExplanation:Parameter identifier is not valid.
The MQCFIL or MQCFIL64 Parameter field value was not valid, or specifies a parameter that cannot be filtered, or that is also specified as a parameter to select a subset of objects.
Programmer Response:Specify a valid parameter identifier.
3048 (X'0BE8')MQRCCF_MSG_TRUNCATEDExplanation:Message truncated.
The command server received a message that is larger than its maximum valid message size.
Programmer Response:Check the message contents are correct.
3049 (X'0BE9')MQRCCF_CCSID_ERRORExplanation:Coded character-set identifier error.
In a command message, one of the following occurred:
- The CodedCharSetId field in the message descriptor of the command does not match the coded character-set identifier of the queue manager at which the command is being processed, or
- The CodedCharSetId field in a string parameter structure within the message text of the command is not
- MQCCSI_DEFAULT, or
- the coded character-set identifier of the queue manager at which the command is being processed, as in the CodedCharSetId field in the message descriptor.
The error response message contains the correct value.
This reason can also occur if a ping cannot be performed because the coded character-set identifiers are not compatible. In this case the correct value is not returned.
Programmer Response:Construct the command with the correct coded character-set identifier, and specify this in the message descriptor when sending the command. For ping, use a suitable coded character-set identifier.
3050 (X'0BEA')MQRCCF_ENCODING_ERRORExplanation:Encoding error.
The Encoding field in the message descriptor of the command does not match that required for the platform at which the command is being processed.
Programmer Response:Construct the command with the correct encoding, and specify this in the message descriptor when sending the command.
3052 (X'0BEC')MQRCCF_DATA_CONV_VALUE_ERRORExplanation:Data conversion value not valid.
The value specified for DataConversion is not valid.
Programmer Response:Specify a valid value.
3053 (X'0BED')MQRCCF_INDOUBT_VALUE_ERRORExplanation:In-doubt value not valid.
The value specified for InDoubt is not valid.
Programmer Response:Specify a valid value.
3054 (X'0BEE')MQRCCF_ESCAPE_TYPE_ERRORExplanation:Escape type not valid.
The value specified for EscapeType is not valid.
Programmer Response:Specify a valid value.
3062 (X'0BF6')MQRCCF_CHANNEL_TABLE_ERRORExplanation:Channel table value not valid.
The ChannelTable specified was not valid, or was not appropriate for the channel type specified on an Inquire Channel or Inquire Channel Names command.
Programmer Response:Specify a valid channel table value.
3063 (X'0BF7')MQRCCF_MCA_TYPE_ERRORExplanation:Message channel agent type not valid.
The MCAType value specified was not valid.
Programmer Response:Specify a valid value.
3064 (X'0BF8')MQRCCF_CHL_INST_TYPE_ERRORExplanation:Channel instance type not valid.
The ChannelInstanceType specified was not valid.
Programmer Response:Specify a valid channel instance type.
3065 (X'0BF9')MQRCCF_CHL_STATUS_NOT_FOUNDExplanation:Channel status not found.
For Inquire Channel Status, no channel status is available for the specified channel. This may indicate that the channel has not been used.
Programmer Response:None, unless this is unexpected, in which case consult your systems administrator.
3066 (X'0BFA')MQRCCF_CFSL_DUPLICATE_PARMExplanation:Duplicate parameter.
Two MQCFSL structures, or an MQCFST followed by an MQCFSL structure, with the same parameter identifier were present.
Programmer Response:Check for and remove duplicate parameters.
3067 (X'0BFB')MQRCCF_CFSL_TOTAL_LENGTH_ERRORExplanation:Total string length error.
The total length of the strings (not including trailing blanks) in a MQCFSL structure exceeds the maximum allowable for the parameter.
Programmer Response:Check that the structure has been specified correctly, and if so reduce the number of strings.
3068 (X'0BFC')MQRCCF_CFSL_COUNT_ERRORExplanation:Count of parameter values not valid.
The MQCFSL Count field value was not valid. The value was negative or greater than the maximum permitted for the parameter specified in the Parameter field.
Programmer Response:Specify a valid count for the parameter.
3069 (X'0BFD')MQRCCF_CFSL_STRING_LENGTH_ERRExplanation:String length not valid.
The MQCFSL StringLength field value was not valid. The value was negative or greater than the maximum permitted length of the parameter specified in the Parameter field.
Programmer Response:Specify a valid string length for the parameter.
3070 (X'0BFE')MQRCCF_BROKER_DELETEDExplanation:Broker has been deleted.
When a broker is deleted using the dltmqbrk command, all broker queues created by the broker are deleted. Before this can be done the queues are emptied of all command messages; any that are found are placed on the dead-letter queue with this reason code.
Programmer Response:Process the command messages that were placed on the dead-letter queue.
3071 (X'0BFF')MQRCCF_STREAM_ERRORExplanation: