DISPLAY TRACE on z/OS

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


Use MQSC commands

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

We can issue this command from sources 12CR. For an explanation of the source symbols, see Use commands on z/OS®.

Synonym: DIS TRACE

DISPLAY TRACE

DISPLAY TRACE ( *ACCTGCHINITGLOBALSTAT
  • ) CMDSCOPE(' ')CMDSCOPE(qmgr-name)
  • 1
  • destination block
  • constraint block
  • COMMENT(string)
  • DETAIL(output-type)
  • Destination block DEST ( ,GTFRESSMFSRV
  • )
  • Constraint blockCLASS(*)CLASS(,integer
  • integer:integer
  • )
  • RMID(*)RMID(,integer
  • )
  • TNO(*)TNO(,integer
  • )
  • USERID(*)USERID(,string
  • )
  • Notes:

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

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