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
Report individual component user trace settings
Report individual component service trace settings
>>-+-reporttrace-+--t=yes---------------------------------------> '-rt ---------' >--+-, b=yes-------------------------+--------------------------> '-, e=egName--+-----------------+-' '-, f=messageFlow-' >--+---------------------+--+-----------------+---------------->< '-, k=applicationName-' '-, y=libraryName-'
Parameters
- -e egName
- (Required for component user trace, otherwise optional) The label of the execution group 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 execution group.
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
F MQP1BRK,rt t=yes, e='exgrp1'
F MQP1BRK,rt n=yes, e='exgrp1'
F MQP1BRK,rt