Displaying component or transaction trace status

Use the DISPLAY TRACE command to obtain status information about either components or applications defined to component trace, or about transaction trace.

D TRACE
`D TRACE[,COMP=cname[,SUB=(subname)][,N=nnn][,SUBLEVEL] ] [,COMP={(cname[,cname]...)\|ALL} ] [,WTR={(name[,name],...)\|ALL} ] [,TT ] [,L={a\|name\|name-a}]`

TRACE: Indicates that the system is to display status information, in short form, about the components defined to component trace.
COMP=ALL: Specifies that the system is to display status, in long form, for all components.
COMP=(cname[,cname]…): Specifies that the system is to display component status, in long form, for the component names requested. See your system programmer for the components and applications active on the system that are defined to component trace.
SUB=(subname): Specifies that the system is to display, in long form, the status of the specified sublevel trace. Obtain the specific names of sublevels from the system programmer. If the sub level trace name contains any national characters (@ # $ _) then the name must be enclosed in quotation marks. Otherwise, quotation marks are not required. In either case, the alphabetic characters can be specified in upper or lower case.
The command displays information for only one sublevel trace. Enter a separate DISPLAY command for each sublevel trace.
N=nnn: Specifies that the system is to display the subordinate node status and, when the SUBLEVEL keyword is specified, the specific ‘nnn’ number of parallel or sublevel nodes of the requested subordinate node.
SUBLEVEL: Specifies that sublevel trace status is to be displayed.
WTR=(name[,name],…): Displays information only about the component trace external writers you specify.
WTR=ALL: Displays information about all component trace external writers.
TT: Displays the status of the transaction trace currently in effect. In a parallel sysplex environment it displays the status of the transaction trace currently in effect in the sysplex. See Example 6.
L=a, name, or name-a: Specifies the display area (a), console name (name), or both (name-a) where the display is to appear.
If you omit this operand, the display is presented in the first available display area or the message area of the console through which you enter the command.

Note: See z/OS MVS Programming: Authorized Assembler Services Reference ALE-DYN for information about application traces of application programs. See z/OS MVS Diagnosis: Tools and Service Aids for information about component traces of components.

Example 1

To display the status of component trace in short form, enter:

DISPLAY TRACE

The system responds with:

IEE843I 15.18.24  TRACE DISPLAY 447
        SYSTEM STATUS INFORMATION
 ST=(ON,0001M,00001M) AS=ON  BR=OFF  EX=ON  MO=OFF MT=(ON,024K)
 COMPONENT MODE COMPONENT MODE COMPONENT MODE COMPONENT MODE
 -----------------------------------------------------------
 SYSRSM    MIN  SYSGRS    ON   SYSVLF    PRE  SYSLLA    MIN

COMPONENT

The component name.

MODE

The current state of the trace:

ON: Trace is on.
OFF: Trace is off.
MIN: This component has reduced tracing activity to the minimum required to provide serviceability data in a dump.
PRE: This trace is PRESET. Trace options were established with a TRACE CT specifying a parmlib member containing the PRESET(DEFINE) option.

Example 2

To display the component trace status of all components, enter:

DISPLAY TRACE,COMP=ALL

The system responds with:

IEE843I 15.18.24  TRACE DISPLAY 450
        SYSTEM STATUS INFORMATION
 ST=(ON,0001M,00001M) AS=ON  BR=OFF  EX=ON  MO=OFF MT=(ON,024K)
  COMPONENT MODE BUFFER HEAD SUBS
 -----------------------------------------------------------
  SYSVLF    PRE    4M
     ASIDS      *NOT SUPPORTED*
     JOBNAMES   *NOT SUPPORTED*
     OPTIONS    COMPONENT,SPECIFIC,OPTIONS,EXAMPLE
     WRITER     *NOT SUPPORTED*
 -----------------------------------------------------------
  SYSLLA    MIN    200K  HEAD  20
     ASIDS      *NOT SUPPORTED*
     JOBNAMES   *NOT SUPPORTED*
     OPTIONS    COMPONENT,SPECIFIC,OPTIONS,EXAMPLE
     WRITER     *NOT SUPPORTED*
 -----------------------------------------------------------
  SYSRSM    MIN    4M
     ASIDS      *NONE*
     JOBNAMES   *NONE*
     OPTIONS    *NONE*
     WRITER     *NONE*
 -----------------------------------------------------------

COMPONENT

The component name.

MODE

The current state of the trace:

ON: Trace is on.
OFF: Trace is off.
MIN: This component has reduced tracing activity to the minimum required to provide serviceability data in a dump.
PRE: This trace is PRESET. Trace options were established with a TRACE CT specifying a parmlib member containing the PRESET(DEFINE) option.

BUFFER

The buffer size, in decimal, established by PRESET(DEFINE) or by operator command when the component trace was turned on.

ASIDS

The ASIDs, in hexadecimal, currently in use as a filter for tracing this component, or one of the following values:

*NONE*: ASIDs can act as a tracing filter, but none were specified.
*NOT SUPPORTED*: ASIDs cannot be used as a filter for this component.

JOBNAMES

The job names currently in use as a filter for tracing this component, or one of the following values:

*NONE*: Job names can act as a tracing filter, but none were specified.
*NOT SUPPORTED*: Job names cannot be used as a filter for this component.

OPTIONS

List of options established when the component trace was turned on.

*NONE* indicates that options are permitted but none are currently in use.

WRITER

The component trace external writer established when the component trace was turned on or modified.

*NOT SUPPORTED* indicates that writers cannot be used for this component.

Example 3

To display the status of all component trace external writers, enter:

DISPLAY TRACE,WTR=ALL

The system responds with:

IEE843I 15.18.24  TRACE DISPLAY 447
        SYSTEM STATUS INFORMATION
 ST=(ON,0001M,00001M) AS=ON  BR=OFF  EX=ON  MO=OFF MT=(ON,024K)
 WRITER    STATUS    HEAD   COMPONENT   SUBNAME
 -----------------------------------------------------------
 WTRABC    ACTIVE           SYSGRS
                            SYSXCF
 WTRDEF    ACTIVE
 WTRXYZ    INACTIVE  HEAD   SYSSMS

WRITER

The component trace external writer name.

STATUS

The current state of the component trace external writer:

ACTIVE: Writer is active, and the components shown in the COMPONENT column are connected to it.
INACTIVE: Writer is inactive, and the components shown in the COMPONENT column are connected to it. Tracing begins when the component trace external writer is started.

HEAD

The specified trace is a HEAD trace, there may be SUB traces implicitly connected through the HEAD trace.

COMPONENT

The component(s) connected to the specified component trace external writer. Several components can be connected to the same component trace external writer.

SUBNAME

The specified trace is a SUB trace.

Example 4

To display the status of two sublevels of SAMPLE STEP1.STEP2, enter:

D TRACE,COMP=SAMPLE,SUB=(STEP1),N=2,SUBLEVEL

Example 5

To display the status of 2 parallel traces of ‘SAMPLE STEPB.STEPC’, enter:

D TRACE,COMP=SAMPLE,SUB=(STEPB.STEPC),N=2

Example 6

To display the status of the transaction trace in a sysplex, enter:

D TRACE,TT
IEE843I 14.47.19 TRACE DISPLAY 709
SYSTEM STATUS INFORMATION
ST=(ON,0001M,00001M) AS=ON BR=OFF EX=ON MO=OFF MT=(ON,024K)
---------------------------------------
 TRANSACTION TRACE STATUS: ON
   BUFSIZ=0002M  WRITER=*NONE*  LATENT=YES
   01: TRAN=TRAN1        USER=TESTERP1
        LVL=0001
   02: USER=DONNA*       LVL=002
   SYSTEMS PARTICIPATING IN TT: SYS1  SYS2  SYS3