+

Search Tips | Advanced Search

+

Search Tips nbsp; | nbsp; Advanced Search

REST API messages

    MQWB0000E
    MQWB0000E: An unexpected exception <insert_0> has occurred.
    Explanation
    An exception has been 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 KnowledgeCenter 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 KnowledgeCenter can provide more information on the message from the command.

    MQWB0003E
    MQWB0003E: An unexpected MQ-related exception <insert_0> has occurred.
    Explanation
    An exception has been 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 MQ 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 could not 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 MQ 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 MQ 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 MQ REST API was invoked specifying a queue manager name which cannot be located.
    Response
    Resubmit the request with a valid queue manager name or no queue manager name, to retrieve a list of queue managers.

    MQWB0010E
    MQWB0010E: The function requested is not available.
    Explanation
    The requested function is not supported for the specified resource.
    Response
    Correct the method or resource and retry the operation.

    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 may not 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
    An attempt was made to create, copy or modify an object but 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, so 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
    The installation name at present 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 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 API does not support this value for the specified query parameter for this query.
    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 MQ 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 IBM 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 may also contain '-'. More details of MQ naming rules can be found at http://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/pro/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 may not 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> may not 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> may not 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> may only be specified once.
    Explanation
    The specified query parameter may 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-delimited 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 IBM 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: Could not find the queue <insert_0> - the queue manager reason code is <insert_1> : <insert_2>.
    Explanation
    The MQ 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 other than those which are 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 which 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: We 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 more 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> may only be specified once.
    Explanation
    The specified attribute may only be specified once.
    Response
    Resubmit the request with a valid set of attributes.

    MQWB0044E
    MQWB0044E: The attribute <insert_0> may only be specified for queries.
    Explanation
    The specified attribute may only be specified for query (GET) operations, it may not 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> may not be specified together.
    Explanation
    It is not valid to specify both a section and attributes 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 only valid 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 should be assigned to it.
    Explanation
    The parameter is a flag - it takes effect by either being or not being present. No value may be assigned to it.
    Response
    Resubmit the request with a valid set of parameters.

    MQWB0049E
    MQWB0049E: The value <insert_0> is not suitable 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 may not be purged - for example, remote, model and alias queues may not 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 may not 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> - 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 reissuing the request.

    MQWB0054E
    MQWB0054E: Cannot delete the queue <insert_0> - not empty.
    Explanation
    The specified queue could not be deleted as it contains messages.
    Response
    Ensure the queue is empty before reissuing the request or use the 'purge' option.

    MQWB0055E
    MQWB0055E: An internal error occurred while communicating with the queue manager. The root MQ reason code was <insert_0> : <insert_1>.
    Explanation
    The MQ 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> may not be changed.
    Explanation
    The specified attribute may only be specified for query (GET) operations or create (POST) operations, it may not 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> may be used.
    Explanation
    The specified attribute may only be filtered 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, such as queries specifying type=cluster, type=all(the default) require a channel initiator to be running.
    Response
    Either start the channel initiator or reformulate 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 MQ 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> may not 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.

    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 IBM 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 may also contain '-'. More details of MQ naming rules can be found at http://www.ibm.com/support/knowledgecenter/en/SSFKSJ_9.0.0/pro/q003340_.htm.
    Response
    Resubmit the request with a valid name.

    MQWB0068E
    MQWB0068E: The <insert_0> object <insert_1> cannot be replaced, deleted or modified as 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 did 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/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 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 at '/action/qmgr/<insert_qmgrName>/mqsc'.

    MQWB0078E
    MQWB0078E: The channel <insert_0> does not use TCP as a transport type.
    Explanation
    The REST API only supports channel with TCP as a transport type.
    Response
    Run the query using runmqsc commands at '/action/qmgr/<insert_qmgrName>/mqsc'.

    MQWB0079E
    MQWB0079E: The attribute <insert_0> may not be specified in a filter clause for a specific channel.
    Explanation
    Only status attributes may 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> may not 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> may not 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 MQ REST API was invoked specifying a channel name which 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> may not be specified in a filter clause for a specific queue.
    Explanation
    Only applicationHandle attributes may 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 MQ 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 has been 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 KnowledgeCentre and set a supported value, or delete the property.

    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.