WebSphere Message Broker, Version 8.0.0.7 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

mqsiexplain command

Use the mqsiexplain command to display the contents of a WebSphere® Message Broker BIP message.

Supported platforms

  • Windows systems.
  • Linux and UNIX systems.
  • z/OS®. Run this command by customizing and submitting BIPEXPL; see Contents of the broker PDSE.

Purpose

The mqsiexplain command returns the full details of a runtime BIP message that you specify, including the user response and explanation sections.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-mqsiexplain--messageNumber----------------------------------><

Parameters

messageNumber
(Required) The BIP message for which you want to display details. You can identify the message by using a number only (for example, 7161), or you can precede the number with "BIP" (for example, BIP7161). You can also include the severity marker (I, E, or W) at the end of the number (for example, BIP7161E).

Authorization

The user ID that is used to run this command must have Administrator authority on the local system.

Responses

This command shows the full contents of the specified message, including the user response and explanation sections. Where inserts are expected in the message, this command substitutes them with "insert#".

Examples

The following example is used to display the full content of error message BIP7152:
mqsiexplain 7152
The command returns the following information:
BIP7152E: The message flow failed to connect to an external WebSphere eXtreme Scale grid. A client attempted to connect
to WebSphere eXtreme Scale grid 'insert1', defined by configurable service 'insert4', using connection string 'insert2'.
This connection attempt failed with the following error: 'insert3'.
Ensure that the grid is available, and that the connection parameters specified in the configurable service are correct.
If the external WebSphere eXtreme Scale grid requires SSL, ensure that this execution group is correctly configured for 
SSL connections.

BIP8071I: Successful command completion.
The following example is used to display the full content of error message BIP7161:
mqsiexplain BIP7161E
The command returns the following information:
BIP7161E: Container server 'insert1' in execution group 'insert2' failed to start. Further details of the error are: 
'insert3'. Check that the catalog servers for this cache are started. Check the configured properties for this server. 
Verify that the ports that are configured for this server are available on this computer. Restart the execution group to 
restart this container server.
The WebSphere eXtreme Scale container server in this execution group has failed to start. If this container server is 
the only one for the broker global cache, the cache will not be available for use with message processing nodes.

BIP8071I: Successful command completion.
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2016Copyright IBM Corporation 1999, 2016.

        
        Last updated:
        
        Last updated: 2016-05-23 14:48:19


Reference topicReference topic | Version 8.0.0.7 | bn23805_