mqsireporttrace command - Windows, Linux, and UNIX systems
Use the mqsireporttrace command to display the trace options currently in effect. Trace can be run only against an integration node, or any of its resources.
Syntax
Report integration node active user and service trace settings
Report individual component user trace settings
Report individual component service trace settings
Report Trace nodes
Parameters
- integrationNodeName
- (Required) The name of an integration node; this name is case sensitive on Linux® and UNIX systems.
- -e integrationServerName
- (Required for component user trace, otherwise optional) The label of the integration server for which a report is required.
- -f messageFlow
- (Optional) The label of the message flow for which a report is required. This option is valid only if you have specified an integration server.
- -k applicationName
- (Optional) This parameter specifies the name of the application
that contains the message flow for which trace options are displayed.
When you set this parameter, you must also set the -f (message flow) parameter. To display trace options for a named message flow in a specific application, set the -k and -f parameters.
You can use this parameter with the -y (library name) parameter to specify that the message flow is contained in a library referenced by the application.
- -u
- (Required for component user trace, otherwise optional) Derive report information from the user trace.
- -y libraryName
- (Optional) This parameter specifies the name of the library that
contains the message flow for which trace options are displayed.
When you set this parameter, you must also set the -f (message flow) parameter. To display trace options for a named message flow in a specific library, set the -y and -f parameters.
Additional parameters exclusive to service trace
Use these options only when directed to do so by your IBM® Support Center, or by a BIPxxxx
message.
- -b
- (Alternative to -e on all platforms)
Request a report for
agent
function. - -t
- (Required for component service trace, otherwise optional) Derive report information from the service trace.
Additional parameters exclusive to Trace nodes
- -n
- Report the setting of the Trace node switch. One BIP message is reported for each message flow.
Examples
mqsireporttrace IBNODE -t -e "exgrp1"
mqsireporttrace IBNODE -n -e "exgrp1"
mqsireporttrace IBNODE