IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

mqsireporttrace command - z/OS®

Use the mqsireporttrace command to display the trace options currently in effect.

Syntax

z/OS console command

Report broker-wide active user and service trace settings


>>-+-reporttrace-+--+--------+---------------------------------><
   '-rt ---------'  +-,t=yes-+   
                    '-,u=yes-'

Report individual component user trace settings


>>-+-reporttrace-+--u=yes--, e=egName--+-----------------+------>
   '-rt ---------'                     '-, f=messageFlow-'   

>--+---------------------+--+-----------------+----------------><
   '-, k=applicationName-'  '-, y=libraryName-'

Report individual component service trace settings


>>-+-reporttrace-+--t=yes--------------------------------------->
   '-rt ---------'          

>--+-, b=yes-------------------------+-------------------------->
   '-, e=egName--+-----------------+-'   
                 '-, f=messageFlow-'     

>--+---------------------+--+-----------------+----------------><
   '-, k=applicationName-'  '-, y=libraryName-'

Report Trace nodes


>>-+-reporttrace-+--n=yes--, e=egName--+-----------------+------>
   '-rt ---------'                     '-, f=messageFlow-'   

>--+---------------------+--+-----------------+----------------><
   '-, k=applicationName-'  '-, y=libraryName-'

Parameters

-e isName

(Required for component user trace, otherwise optional) The label of the integration server for which a report is required.

This name is case sensitive; include the name in single quotes if it contains mixed-case characters.

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

This name is case sensitive; include the name in single quotes if it contains mixed-case characters.

-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=yes: Report the setting of the Trace node switch. One BIP message is reported for each message flow.

Examples

To report information from service trace for integration server exgrp1, enter the command:

F MQP1BRK,rt t=yes, e='exgrp1'

To report the setting of the Trace node switch for integration server exgrp1, enter the command:

F MQP1BRK,rt n=yes, e='exgrp1'

To report all active trace settings in broker MQP1BRK, enter the command:

F MQP1BRK,rt

an28410_.htm |

Last updated Friday, 21 July 2017