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,0016K,0016K) AS=ON  BR=OFF  EX=ON  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. 
DISPLAY TRACE,COMP=ALL
The system responds with: 
IEE843I 15.18.24  TRACE DISPLAY 450
        SYSTEM STATUS INFORMATION
 ST=(ON,0016K,0016K) AS=ON  BR=OFF  EX=ON  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. Through the PRESET(DEFINE) option in the parmlib member.
BUFFER
The buffer size, in decimal, established by PRESET(DEFINE) or by operator command when the component trace was turned on.
ASIDS
Any ASIDs, in hexadecimal, currently in use as a filter for tracing this component.
  • *NOT SUPPORTED* indicates that ASIDs cannot be used as a filter for this component.
  • *NONE* indicates that ASIDs can act as a tracing filter but none have been specified.
JOBNAMES
Any job names currently in use as a filter for tracing this component.
  • *NOT SUPPORTED* indicates that job names cannot be used as a filter for this component.
  • *NONE* indicates that job names can act as a tracing filter but none have been specified.
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,0016K,0016K) AS=ON  BR=OFF  EX=ON  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 what components are connected
  • INACTIVE — writer is inactive and what components are connected to it. When the component trace external writer is started, tracing will begin.
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 2 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,0064K,00064K) AS=ON BR=OFF EX=ON
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
Parent topic: DISPLAY command