DISPLAY TRACE (display active traces list) on z/OS

Use the MQSC command DISPLAY TRACE to display a list of active traces.

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

You can issue this command from sources 12CR. For an explanation of the source symbols, see Sources from which you can issue MQSC commands on z/OS®.

Syntax diagram
Parameter descriptions for DISPLAY TRACE
Destination block
Constraint block

Synonym: DIS TRACE

DISPLAY TRACE

Destination block

Constraint block

Notes:

¹ Valid only when the queue manager is a member of a queue sharing group.

Parameter descriptions for DISPLAY TRACE

All parameters are optional. Each option that is used limits the effect of the command to active traces that were started using the same option, either explicitly or by default, with exactly the same parameter values.

*

Does not limit the list of traces. This is the default. The CLASS option cannot be used with DISPLAY TRACE(*).

Each remaining parameter in this section limits the list to traces of the corresponding type:

ACCTG

Accounting data (the synonym is A)

CHINIT

Service data from the channel initiator. The synonym is CHI or DQM.

GLOBAL

Service data from the entire queue manager except the channel initiator. The synonym is G.

STAT

Statistical data (the synonym is S)

COMMENT( string )

Specifies a comment. This does not appear in the display, but it might be recorded in trace output.

DETAIL( output-type )

This parameter is ignored; it is retained only for compatibility with earlier releases.

Possible values for output-type are *, 1, or 2.

CMDSCOPE

This parameter specifies how the command runs when the queue manager is a member of a queue sharing group.

CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1.

' ': The command runs on the queue manager on which it was entered. This is the default value.
qmgr-name: The command runs on the queue manager you specify, providing the queue manager is active within the queue sharing group.
You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue sharing group environment and if the command server is enabled.

Destination block

DEST

Limits the list to traces started for particular destinations. More than one value can be specified, but do not use the same value twice. If no value is specified, the list is not limited.

Possible values and their meanings are:

GTF: The Generalized Trace Facility
RES: A wraparound table residing in the ECSA (extended common service area)
SMF: The System Management Facility
SRV: A serviceability routine designed for IBM® for problem diagnosis

Constraint block

CLASS( integer ): Limits the list to traces started for particular classes. See START TRACE (start trace) on z/OS for a list of allowed classes.
The default is CLASS(*), which does not limit the list.
RMID( integer ): Limits the list to traces started for particular resource managers. See START TRACE (start trace) on z/OS for a list of allowed resource manager identifiers. Do not use this option with the STAT or CHINIT trace type.
The default is RMID(*), which does not limit the list.
TNO( integer ): Limits the list to particular traces, identified by their trace number (0 to 32). Up to 8 trace numbers can be used. If more than one number is used, only one value for USERID can be used. The default is TNO(*), which does not limit the list.
0 is the trace that the channel initiator can start automatically. Traces 1 to 32 are those for queue manager or the channel initiator that can be started automatically by the queue manager, or manually, using the START TRACE command.
USERID( string ): Limits the list to traces started for particular user IDs. Up to 8 user IDs can be used. If more than one user ID is used, only one value can be used for TNO. Do not use this option with STAT. The default is USERID(*), which does not limit the list.