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
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.
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.