REST API messages

MQWB0000E
MQWB0000E: An unexpected exception <insert_0> occurred.
Explanation
An exception was thrown which is not otherwise handled.
Response
Use the message from the exception to resolve the problem if possible. If necessary, seek assistance from IBM support.
MQWB0001E
MQWB0001E: The attempt to query the MQ installation or installations with the <insert_0> command failed with the following message: <insert_1>.
Explanation
A suitable command was used to query the MQ installation or installations, but the command failed.
Response
Use the message from the command to resolve the problem and, if appropriate, resubmit the request. The MQ Knowledge Center can provide more information on the message from the command.
MQWB0002E
MQWB0002E: The attempt to query the queue manager state with the <insert_0> command failed with the following message: <insert_1> .
Explanation
A suitable command was used to query the queue manager state, but the command failed.
Response
Use the message from the command to resolve the problem and, if appropriate, resubmit the request. The MQ Knowledge Center can provide more information on the message from the command.
MQWB0003E
MQWB0003E: An unexpected MQ related exception <insert_0> occurred.
Explanation
An exception was thrown which is not otherwise handled.
Response
Use the message from the exception to resolve the problem if possible, if necessary, seek assistance from IBM support.
MQWB0004E
MQWB0004E: An internal error occurred while communicating with the queue manager. The root MQ reason code was <insert_0> : <insert_1>.
Explanation
The REST API caught an exception when communicating with the queue manager. This might indicate that there was a problem with the queue manager, or that a parameter that was passed was incorrect.
Response
Use the serialized exception in the 'exception' field, if any, to get more information about the problem. Rectify the problem, which might require operations to be performed on the queue manager, and resubmit the request.
MQWB0005E
MQWB0005E: The host name cannot be determined.
MQWB0006E
MQWB0006E: The platform type cannot be determined from the command output <insert_0>.
MQWB0007E
MQWB0007E: The string <insert_0> is not a valid attribute for <insert_1> objects.
Explanation
The REST API was invoked requesting an attribute or attribute section which is not valid.
Response
Resubmit the request with a valid list of attributes or attribute sections.
MQWB0008E
MQWB0008E: Could not query the installation <insert_0>.
Explanation
The REST API was invoked specifying an installation name which cannot be located.
Response
Resubmit the request with a valid installation name or no installation name, to retrieve a list of installations.
MQWB0009E
MQWB0009E: Could not query the queue manager <insert_0>.
Explanation
The REST API was invoked specifying a queue manager name which cannot be located.
Response
Resubmit the request with a valid queue manager name.
MQWB0010E
MQWB0010E: The HTTP method <insert_0> is not allowed for <insert_1> objects.
Explanation
The requested method is not allowed for the specified object type.
Response
Use an allowed method - see the HTTP 'Allow' header of this response for a list of allowed methods.
MQWB0011E
MQWB0011E: The function requested is not yet available.
Explanation
The requested function is not yet supported for the specified resource.
Response
Wait for a version of the software supporting this function.
MQWB0012E
MQWB0012E: An installation cannot be specified on z/OS.
Explanation
An attempt to query a specific MQ installation has failed, as this is not applicable to z/OS.
Response
Do not specify an installation name when querying installations on z/OS.
MQWB0013E
MQWB0013E: The attribute <insert_0> is required.
Explanation
A mandatory attribute was missing.
Response
Resubmit the request with an appropriate value for the attribute.
MQWB0014E
MQWB0014E: The value <insert_0> is not appropriate for the attribute <insert_1>.
Explanation
An inappropriate value was provided for an attribute.
Response
Resubmit the request with an appropriate value for the attribute.
MQWB0015E
MQWB0015E: The attribute section <insert_0> is required.
Explanation
No value was provided for an attribute section that is required in this context.
Response
Resubmit the request with an appropriate value for the attribute section.
MQWB0016E
MQWB0016E: A true or false value is required for the query parameter <insert_0>.
Explanation
The query parameter was specified with a value other than 'true' or 'false'.
Response
Resubmit the request with an appropriate value for the query parameter.
MQWB0017E
MQWB0017E: The installation name is not appropriate when querying installations on z/OS.
Explanation
MQ on z/OS does not have the concept of multiple installations. Therefore, it is not appropriate to specify an installation name.
Response
Resubmit the request without specifying an installation name.
MQWB0018E
MQWB0018E: The installation name does not match.
Explanation
At present, the installation name must be that of the installation under which the service is run.
Response
Resubmit the request with the appropriate installation name, or without specifying an installation name.
MQWB0019E
MQWB0019E: The query parameter <insert_0> is not allowed.
Explanation
The REST API does not support this query parameter for this operation.
Response
Resubmit the request with an appropriate set of parameters.
MQWB0020E
MQWB0020E: <insert_0> is not a valid value for query parameter <insert_1>.
Explanation
The REST API does not support this value for the specified query parameter.
Response
Resubmit the request with an appropriate set of parameters.
MQWB0021E
MQWB0021E: Could not query the queue manager <insert_0> with the state <insert_1>.
Explanation
The REST API was invoked specifying a combination of queue manager name and state which cannot be found.
Response
Resubmit the request with a more appropriate set of query parameters.
MQWB0022E
MQWB0022E: The name <insert_0> is not allowed.
Explanation
A name was supplied for an MQ entity which does not conform to the naming conventions. Names must contain only letters (upper-case and lower-case are permitted), digits, '.', '/', '_' and '%'. Certain identifiers can also contain '-'. More details of MQ naming rules can be found at http://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.1.0/com.ibm.mq.pro.doc/q003340_.htm
Response
Resubmit the request with a valid name.
MQWB0023I
MQWB0023I: <insert_0> level: <insert_1>
Explanation
The level of the identified resource.
Response
No action.
MQWB0024E
MQWB0024E: The attribute group <insert_0> is not valid.
Explanation
The named attribute group is not valid.
Response
Resubmit the request without this attribute group.
MQWB0025E
MQWB0025E: The query parameter <insert_0> and value <insert_1> is not compatible with the query parameter <insert_2> and value <insert_3>.
Explanation
The specified query parameters cannot be used together.
Response
Resubmit the request with a valid set of query parameters.
MQWB0026E
MQWB0026E: The parameter <insert_0> is not applicable to queue managers on the <insert_1> platform.
Explanation
The named parameter is platform-specific and not applicable to the platform that the queue manager runs on.
Response
Resubmit the request without this query parameter.
MQWB0027E
MQWB0027E: The filter clause <insert_0> is not valid.
Explanation
The filter clause does not conform to the format rules.
Response
Resubmit the request with a valid filter clause.
MQWB0028E
MQWB0028E: The attribute <insert_0> cannot be specified in a filter clause for <insert_1> objects.
Explanation
The named attribute is not available to be used in a filter clause.
Response
Resubmit the request with a valid filter clause.
MQWB0029E
MQWB0029E: The nested object <insert_0> cannot be specified for an MQ <insert_1> object of type <insert_2>.
Explanation
The named nested object is not appropriate to this type of MQ object.
Response
Resubmit the request with a valid set of attributes.
MQWB0030E
MQWB0030E: The query parameter <insert_0> can only be specified once.
Explanation
The specified query parameter can only be specified once.
Response
Resubmit the request with a valid set of query parameters.
MQWB0031E
MQWB0031E: The query parameter <insert_0> requires a list of attribute names.
Explanation
The specified query parameter must be provided with a comma-separated list of attribute names or '*' (indicating all relevant attributes).
Response
Resubmit the request with a valid list of attribute names for this parameter.
MQWB0032E
MQWB0032E: If a <insert_0> attribute is specified for filtering, <insert_0> must also be retrieved.
Explanation
To filter on an attribute, the relevant attribute section must be retrieved.
Response
Resubmit the request with a valid set of parameters.
MQWB0033E
MQWB0033E: The value <insert_0> for <insert_1> must be between <insert_2> and <insert_3> characters long.
Explanation
A name was supplied for an MQ entity which does not conform to the naming conventions.
Response
Resubmit the request with a valid name.
MQWB0034E
MQWB0034E: The value <insert_0> for <insert_1> is outside the allowed range <insert_2> - <insert_3>.
Explanation
A value was supplied which does not fall in the allowable range.
Response
Resubmit the request with a valid value.
MQWB0035E
MQWB0035E: The value <insert_0> is not suitable for <insert_1>.
Explanation
A value was supplied which does not conform to the naming conventions.
Response
Resubmit the request with a valid value.
MQWB0036E
MQWB0036E: The queue manager <insert_0> is not in a queue sharing group.
Explanation
An operation was attempted which required the queue manager to be in a queue sharing group, but it was not.
Response
Resubmit the request with a valid parameters.
MQWB0037E
MQWB0037E: Cannot find the queue <insert_0>. The queue manager reason code is <insert_1> : <insert_2>.
Explanation
The REST API was invoked specifying a queue name which cannot be located.
Response
Resubmit the request with the name of an existing queue, or with no queue name to retrieve a list of queues.
MQWB0038E
MQWB0038E: Filter condition <insert_0> is not allowed.
Explanation
A filter was specified with a condition that is not allowed.
Response
Resubmit the request with a valid filter condition.
MQWB0039E
MQWB0039E: Attribute <insert_0> is of the wrong type for filter condition <insert_1>.
Explanation
A filter was specified with an attribute that is inappropriate to the condition type. For example, a string attribute for a 'lessThan' filter condition.
Response
Resubmit the request with a valid combination of attribute and filter condition.
MQWB0040E
MQWB0040E: Value <insert_0> is inappropriate for filter condition <insert_1>.
Explanation
A filter was specified with an value which is inappropriate to the condition type. For example, a string value containing an asterisk other than as the last character or only containing an asterisk.
Response
Resubmit the request with a valid combination of value and filter condition.
MQWB0041E
MQWB0041E: You cannot retrieve status or applicationHandle information for queues of type <insert_0>.
Explanation
It is not possible to retrieve this information for this type of queue.
Response
Resubmit the request with appropriate parameters.
MQWB0042E
MQWB0042E: Command timed out after <insert_0> seconds.
Explanation
A valid command was sent to the queue manager but the queue manager did not respond in a reasonable period.
Response
If the problem persists, check the queue manager state. If the queue manager is not in the same installation as the mqweb server, check that the relevant channels are correctly configured and running. Also ensure that the correct user is authorized to access the relevant queues and perform the requested operation on the queue manager.
MQWB0043E
MQWB0043E: The attribute <insert_0> can be specified only once.
Explanation
The specified attribute can be specified only once.
Response
Resubmit the request with a valid set of attributes.
MQWB0044E
MQWB0044E: The attribute <insert_0> can be specified only for queries.
Explanation
The specified attribute can be specified only for query (GET) operations. It cannot be set for update (PATCH) or create (POST) operations.
Response
Resubmit the request with a valid set of attributes.
MQWB0045E
MQWB0045E: The section <insert_0> and the attribute or attributes <insert_1> cannot be specified together.
Explanation
It is not valid to specify both a section and attributes that are contained in that section.
Response
Resubmit the request with a valid set of attributes.
MQWB0046E
MQWB0046E: The value <insert_1> for attribute <insert_0> is not allowed on the <insert_2> platform.
Explanation
The value provided for the attribute is not valid on the platform that the queue manager runs on.
Response
Resubmit the request with a valid set of attributes.
MQWB0047E
MQWB0047E: The value <insert_1> for attribute <insert_0> is valid only when <insert_2> has a valid non-null value.
Explanation
The value provided for the attribute is valid only in conjunction with some other attribute.
Response
Resubmit the request with a valid set of attributes.
MQWB0048E
MQWB0048E: The parameter <insert_0> is a flag. No value can be assigned to it.
Explanation
The parameter is a flag that takes effect by either being or not being present. No value can be assigned to it.
Response
Resubmit the request with a valid set of parameters.
MQWB0049E
MQWB0049E: The value <insert_0> is not valid for filtering on dates.
Explanation
Dates are of the form 'YYYY-MM-DDThh:mm:ss' but can end prematurely with a single trailing wildcard ('*'), or be a blank string.
Response
Resubmit the request with a valid date to filter on.
MQWB0050E
MQWB0050E: The 'purge' option is not applicable to the queue <insert_0>.
Explanation
The queue cannot be purged. For example, remote, model, and alias queues cannot be purged.
Response
Resubmit the request without the purge option.
MQWB0051E
MQWB0051E: Cannot create an object of type <insert_0> called <insert_1>. The queue manager reason code is <insert_2> : <insert_3>.
Explanation
The queue cannot be created. The reason code should clarify why this is.
Response
Resubmit the request, correcting any issues.
MQWB0052E
MQWB0052E: Cannot create a shared queue without a CF Structure name.
Explanation
A CF Structure name is required when creating a queue with a queue sharing group disposition of 'shared'.
Response
Resubmit the request with a CF Structure name.
MQWB0053E
MQWB0053E: Cannot delete the queue <insert_0>. It is open by another process.
Explanation
The specified queue could not be deleted as it is open by another process.
Response
Ensure the queue is not in use before resubmitting the request.
MQWB0054E
MQWB0054E: Cannot delete the queue <insert_0> because it is not empty.
Explanation
The specified queue could not be deleted as it contains messages.
Response
Ensure the queue is empty before resubmitting the request, or use the 'purge' option to remove the messages.
MQWB0055E
MQWB0055E: An internal error occurred while communicating with the queue manager. The root MQ reason code was <insert_0> : <insert_1>.
Explanation
The REST API caught an exception when communicating with the queue manager. This might indicate that there was a problem with the queue manager, or that a parameter that was passed was incorrect.
Response
Rectify the problem, which might require operations to be performed on the queue manager, and resubmit the request.
MQWB0056E
MQWB0056E: The attribute <insert_0> cannot be changed.
Explanation
The specified attribute can be specified only for query (GET) operations or create (POST) operations, it cannot be set for update (PATCH) operations.
Response
Resubmit the request with a valid set of attributes.
MQWB0057E
MQWB0057E: The filter operation <insert_0> is not suitable for the attribute <insert_1>. Only one of <insert_2> can be used.
Explanation
The specified attribute can be filtered only in a limited number of ways.
Response
Resubmit the request with a valid filter.
MQWB0058E
MQWB0058E: No attributes were specified for PATCH.
Explanation
The PATCH operation was requested but no changes were specified.
Response
Resubmit the request with a valid request body.
MQWB0059E
MQWB0059E: The filter operation <insert_0> is not allowed for <insert_1> queues.
Explanation
The filter operation requested is not appropriate for the queue type specified.
Response
Resubmit the request with a valid filter.
MQWB0060E
MQWB0060E: The attribute <insert_0> is not applicable to queue managers on the <insert_1> platform.
Explanation
The named attribute is platform-specific and not applicable to the platform that the queue manager runs on.
Response
Resubmit the request without this attribute.
MQWB0061E
MQWB0061E: An operation failed as the channel initiator was not running.
Explanation
Some operations require a channel initiator to be running.
Response
Either start the channel initiator or change the request to avoid the need for it.
MQWB0062E
MQWB0062E: An error occurred when communicating with the queue manager <insert_2>. The root MQ reason code was <insert_0> : <insert_1>
Explanation
The REST API caught an exception when communicating with the queue manager. This might indicate that the command server on the queue manager is not running or another problem with the queue manager.
Response
Start the command server if necessary. Rectify any other problem, which might require operations to be performed on the queue manager, and resubmit the request.
MQWB0063E
MQWB0063E: The queue manager <insert_0> is not available.
Explanation
An operation was attempted which required the queue manager to be available, but it was not.
Response
Check that the queue manager is available and resubmit the request.
MQWB0064E
MQWB0064E: An incorrect combination of attributes <insert_0> and <insert_1> was specified. The queue manager reported an error with reason code <insert_2>
Explanation
An attempt was made to change one attribute without changing another dependent one.
Response
Resubmit the request with a valid parameters.
MQWB0065E
MQWB0065E: The attribute <insert_0> cannot be specified for an MQ <insert_1> object of type <insert_2>.
Explanation
The named nested object is not appropriate for this type of MQ object.
Response
Resubmit the request with a valid set of attributes.
MQWB0066E
MQWB0066E: No further attributes or sections can be combined with '*'.
Explanation
As '*' represents all sections and attributes, it is invalid to specify them individually.
Response
Resubmit the request with a valid set of attributes.
MQWB0067E
MQWB0067E: The value <insert_0> is not allowed for the attribute <insert_1>.
Explanation
A name was supplied for an MQ entity which does not conform to the naming conventions. Names must contain only letters (upper-case and lower-case are permitted), digits, '.', '/', '_' and '%'. Certain identifiers can also contain '-'. More details of MQ naming rules can be found at http://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.1.0/com.ibm.mq.pro.doc/q003340_.htm
Response
Resubmit the request with a valid name.
MQWB0068E
MQWB0068E: The <insert_0> object <insert_1> cannot be replaced, deleted or modified because it is in use.
Explanation
One or more processes have the MQ object open.
Response
Ensure the object is not in use before retrying the operation.
MQWB0069E
MQWB0069E: No suitable group definition object found.
Explanation
To create an object with queue sharing group disposition 'copy' there must be a suitable group definition object.
Response
Ensure the group definition object exists before retrying the operation.
MQWB0070E
MQWB0070E: The attribute <insert_0> supplied does not match the expected attribute prefix <insert_1>.
MQWB0070E: The attribute <insert_0> supplied did not match the expected attribute prefix <insert_1> or <insert_2>.
Explanation
An unexpected attribute prefix was supplied.
Response
Resubmit the request with a valid set of attributes with the required prefixes.
MQWB0071E
MQWB0071E: PCF Queue <insert_0> cannot be accessed as it is <insert_1> inhibited.
Explanation
The queue manager cannot be queried or updated as the necessary queue is not available.
Response
Ensure that the necessary queue is available before retrying the operation.
MQWB0072E
MQWB0072E: The attribute <insert_0> cannot be specified in a filter for queue managers on the <insert_1> platform.
Explanation
The filter clause cannot be used on the platform that the queue manager runs on.
Response
Resubmit the request with a valid filter clause.
MQWB0073E
MQWB0073E: The field <insert_0> is required.
Explanation
A request was submitted but a mandatory field was missing.
Response
Resubmit the request with an appropriate value for the field.
MQWB0074E
MQWB0074E: <insert_0> is not a valid command.
Explanation
A request was submitted which did not start with a valid MQ script command name.
Response
Resubmit the request with an appropriate command name.
MQWB0075E
MQWB0075E: The provided request body is not valid.
Explanation
A request body is not supported on this operation.
Response
Resubmit the request without a request body.
MQWB0076E
MQWB0076E: The attribute <insert_0> cannot have a blank value for its filter.
Explanation
The filter value does not conform to the format rules.
Response
Resubmit the request with a valid filter clause.
MQWB0077E
MQWB0077E: The channel <insert_0> has a type that is not supported by the REST API.
Explanation
The REST API only supports channels of type sender, receiver, server, requester, clusterSender and clusterReceiver.
Response
Run the query using runmqsc commands on the '/action/qmgr/<insert_qmgrName>/mqsc' resource.
MQWB0078E
MQWB0078E: The channel <insert_0> does not use TCP as a transport type.
Explanation
The REST API supports only channels with TCP as a transport type.
Response
Run the query using runmqsc commands on the '/action/qmgr/<insert_qmgrName>/mqsc' resource.
MQWB0079E
MQWB0079E: The attribute <insert_0> cannot be specified in a filter clause for a specific channel.
Explanation
Only status attributes can be specified in a filter clause for a specific channel.
Response
Resubmit the request with a valid filter clause.
MQWB0080E
MQWB0080E: The attribute <insert_0> cannot be specified in a filter clause without also querying the specified status type.
Explanation
A query of the specified status type must be requested in order to filter an attribute of that type.
Response
Resubmit the request with a valid status query or filter clause.
MQWB0081E
MQWB0081E: The attribute <insert_0> cannot be requested individually.
Explanation
The specified attribute can only be returned as part of its containing object.
Response
Resubmit the request specifying the section that contains the attribute.
MQWB0082E
MQWB0082E: Could not find the channel <insert_0>. The queue manager reason code is <insert_1> : <insert_2>.
Explanation
The REST API was invoked specifying a channel name that cannot be located.
Response
Resubmit the request with the name of an existing channel, or with no channel name to retrieve a list of channels.
MQWB0083E
MQWB0083E: The queue manager does not support one or more of the query parameters provided.
Explanation
The queue manager is running on a version of MQ which does not support one or more of the given query parameters.
Response
Resubmit the request with a valid set of parameters.
MQWB0084E
MQWB0084E: The attribute <insert_0> cannot be specified in a filter clause for a specific queue.
Explanation
Only applicationHandle attributes can be specified in a filter clause for a specific queue.
Response
Resubmit the request with a valid filter clause.
MQWB0085E
MQWB0085E: The string <insert_0> is not a valid attribute for <insert_1> objects.
Explanation
The REST API was invoked filtering an attribute which is not valid.
Response
Resubmit the request with a valid attribute.
MQWB0086E
MQWB0086E: The <insert_0> property has an unsupported value of <insert_1>.
Explanation
A property was configured in the mqwebuser.xml file with an unsupported value. This message will be suppressed for the next minute.
Response
Review the documentation for the property in the Knowledge Center and set a supported value, or delete the property.
MQWB0087E
MQWB0087E: Incompatible attributes or attribute values.
Explanation
The specified attributes or attribute values are incompatible. Either an attribute was not specified that is required by another attribute or attribute value, or an attribute or attribute value was specified that is not allowed with some other attribute or attribute value.
Response
Resubmit the request with valid attributes.
MQWB0098E
MQWB0098E: Incorrect attributes were specified for PATCH.
Explanation
The PATCH operation was requested but an incorrect value was specified for an attribute, probably the object type.
Response
Resubmit the request with a valid request body.
MQWB0099E
MQWB0099E: The attribute <insert_0> can only be set once.
Explanation
The REST API request failed as an duplicate attribute setting was included in the request.
Response
Resubmit the request setting the attribute only once.