Script (MQSC) Command Reference: DISPLAY TRACE

DISPLAY TRACE

Use DISPLAY TRACE to display a list of active traces.
Synonym: DIS TRACE
DISPLAY TRACE
 
                    .-*------.
>>-DISPLAY TRACE--(-+--------+-)-------------------------------->
                    +-ACCTG--+
                    +-GLOBAL-+
                    '-STAT---'
 
   .-CMDSCOPE(' ')------------.
>--+--------------------------+--+-----------------------+------>
   |                     (1)  |  '-| destination block |-'
   '-CMDSCOPE(qmgr-name)------'
 
>--+----------------------+--+-----------------+---------------->
   '-| constraint block |-'  '-COMMENT(string)-'
 
>--+---------------------+-------------------------------------><
   '-DETAIL(output-type)-'
 
Destination block
 
           .-,-------.
           V         |
|--DEST--(---+-GTF-+-+-)----------------------------------------|
             +-RES-+
             +-SMF-+
             '-SRV-'
 
Constraint block
 
   .-TYPE(ACTIVE)--------.  .-CLASS(*)---------------------.
|--+---------------------+--+------------------------------+---->
   '-TYPE(-+-INDOUBT-+-)-'  |          .-,-------.         |
           +-REGIONS-+      |          V         |         |
           '-*-------'      '-CLASS(-+---integer-+-----+-)-'
                                     '-integer:integer-'
 
   .-RMID(*)-------------.  .-TNO(*)-------------.
>--+---------------------+--+--------------------+-------------->
   |       .-,-------.   |  |      .-,-------.   |
   |       V         |   |  |      V         |   |
   '-RMID(---integer-+-)-'  '-TNO(---integer-+-)-'
 
   .-USERID(*)------------.
>--+----------------------+-------------------------------------|
   |         .-,------.   |
   |         V        |   |
   '-USERID(---string-+-)-'
 
 
Notes:

Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

Parameter descriptions

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)

GLOBAL

Service data from the entire queue manager(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 is executed 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 is executed on the queue manager on which it was entered. This is the default value.

qmgr-name

The command is executed 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 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 for a list of allowed resource manager identifiers. Do not use this option with STAT.
The default is RMID(*), which does not limit the list.

Note:

Information about RMID 231 might be inaccurate if the channel initiator has been stopped.

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

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.