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

Read syntax diagramSkip visual syntax diagrammqsireporttraceintegrationNodeName -u  -t 

Report individual component user trace settings

Read syntax diagramSkip visual syntax diagrammqsireporttraceintegrationNodeName -u  -e integrationServerName -f messageFlow -k applicationName -y libraryName

Report individual component service trace settings

Read syntax diagramSkip visual syntax diagrammqsireporttraceintegrationNodeName -t  -b  -e integrationServerName -f messageFlow -k applicationName -y libraryName

Report Trace nodes

Read syntax diagramSkip visual syntax diagrammqsireporttraceintegrationNodeName -n  -e integrationServerName -f messageFlow -k applicationName -y libraryName

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

To derive report information from service trace for integration server exgrp1 in integration node IBNODE, enter the command:
mqsireporttrace IBNODE -t -e "exgrp1"
To report the setting of the Trace node switch for integration server exgrp1 in integration node IBNODE, enter the command:
mqsireporttrace IBNODE -n -e "exgrp1"
To report all active trace settings in integration node IBNODE, enter the command:
mqsireporttrace IBNODE