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