See information about the latest product version
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 a broker, or any of its resources.
Syntax
Report broker-wide active user and service trace settings
Report individual component user trace settings
Report individual component service trace settings
>>-mqsireporttrace--brokerName-- -t ----------------------------> >--+- -b --------------------------------+----------------------> '- -e --egName--+-------------------+-' '- -f --messageFlow-' >--+----------------------+--+------------------+-------------->< '- -k -applicationName-' '- -y -libraryName-'
Parameters
- brokerName
- (Required) The name of a broker; this name is case sensitive on Linux and UNIX systems.
- -e egName
- (Required for component user trace, otherwise optional) The label of the execution group 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 execution group.
- -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 MB8BROKER -t -e "exgrp1"
mqsireporttrace MB8BROKER -n -e "exgrp1"
mqsireporttrace MB8BROKER