DISPLAY TRACES command
Display the status of BUF, GPT, IO, LINE, QDIOSYNC, SIT, STATE, and TG traces:
- 1 Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand.
Display the status of the APPN route selection trace in a network node:
- 1 TYPE=ROUTE is allowed only in a network node.
Display the status of a TSO user trace:
- 1 Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand.
Abbreviations
Operand | Abbreviation |
---|---|
DISPLAY | D |
TRACES | TRACE |
TYPE=NODES | TYPE=NODE |
Purpose
The DISPLAY TRACES command displays the status of a trace.
Operands
- ID
- Specifies a value that varies depending on the type of trace.
- For TYPE=NODES, ID specifies the name of one or more resources
whose trace status is to be displayed. The ID operand is required
with TYPE=NODES. You can specify major or minor node names. Resource
names can be network-qualified.
Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand. However, if you specify a wildcard, trace status information is displayed only for resources that match the wildcard value, and not for subordinate resources. For more information about using wildcards, see Using wildcard names.
Guideline: Specifying a wildcard name might degrade performance because VTAM® checks every major or minor node in the network.If model application program definition names match the pattern you specify on the ID operand of the DISPLAY TRACES command when TYPE specifies NODES, those model application program names appear in your display output. In addition, any dynamic application programs built from those model application program definitions also appear in your display output. Similarly, any model CDRSCs and clone CDRSCs that match the pattern you specify on the ID operand appear in your display output. On message IST1041I, a model application program is identified as MODEL APPL, a dynamic (clone) application program is identified as DYNAMIC APPL, a model CDRSC is identified as MODEL CDRSC, and a clone CDRSC is identified as CLONE CDRSC
For example, if you issue the commandDISPLAY NET,TRACES,ID=APPL*,TYPE=NODES
, and model application programs and model CDRSCs have been defined using names that match the pattern specified on the ID operand (APPL*), you get the following output:IST097I DISPLAY ACCEPTED IST350I DISPLAY TYPE = TRACES,TYPE=NODES IST075I NAME = APPL1A, TYPE = APPL SEGMENT IST1041I NETA.APPL1 APPL IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO IST1041I NETA.APPL1V APPL IST1042I IO = ON - AMOUNT = **NA** - SAVED = NO IST924I -------------------------------------------------------- IST075I NAME = TESTAPPL, TYPE = APPL SEGMENT IST1041I NETA.APPL1* MODEL APPL IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO IST1041I NETA.APPL1Q DYNAMIC APPL IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO IST924I -------------------------------------------------------- IST075I NAME = TESTCDRS, TYPE = CDRSC SEGMENT IST1041I NETA.APPL2* MODEL CDRSC IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO IST1041I NETA.APPL2Q CLONE CDRSC IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO IST314I END
The wildcard character used in APPL* on the ID operand of the DISPLAY TRACES command tells VTAM to display the trace status of any resource whose name begins with APPL, followed by zero to four valid characters. The name fields of the network-qualified names NETA.APPL1* and NETA.APPL2*, even though they contain a wildcard character, begin with APPL, followed by zero to four valid characters [an asterisk (*) and a question mark (?) are valid characters in an application program minor node name and CDRSC minor node name]. Therefore, they are included in the display output, as are the dynamic application program (NETA.APPL1Q) built from APPL1* and the clone CDRSC (NETA.APPL2Q) built from APPL2*.
See the MODIFY TRACE command for information about which trace types are applicable to various VTAM resource types.
- For TYPE=CNM, the ID operand is not valid.
- For TYPE=EXIT, ID=ISTEXCAA, ISTEXCCS, and ISTEXCDM are the only valid values for the ID operand. ID = must be specified.
- For TYPE=MODULE, the ID operand is not valid.
- For TYPE=NETCTLR, ID specifies the name of the 3710 physical unit that is to perform the trace. The ID operand is required and wildcard names are not valid for TYPE=NETCTLR.
- For TYPE=SMS, ID=VTAMBUF is the only valid value for the ID operand. ID=VTAMBUF can be specified or assumed by default.
- For TYPE=STATE, the ID operand is not valid.
- For TYPE=TSO, ID specifies the user IDs for which trace
status is to be displayed. The ID operand is required with TYPE=TSO.
User IDs that do not have an active TSO trace are not displayed. Network-qualified
names are not allowed with TYPE=TSO.
Depending on the value of the DSPLYWLD start option, wildcard values can be used for this operand. For more information about using wildcards, see Using wildcard names.
Attention: Specifying a wildcard name might degrade performance because VTAM checks every TSO user ID in the network. - For TYPE=VTAM, the ID operand is not valid.
- For TYPE=ALL, the ID operand is not valid.
- For TYPE=NODES, ID specifies the name of one or more resources
whose trace status is to be displayed. The ID operand is required
with TYPE=NODES. You can specify major or minor node names. Resource
names can be network-qualified.
- IDTYPE
- Specifies the type of resource that the ID operand names. If several types of resources share the same name, IDTYPE identifies
which resource the command should act on. The IDTYPE operand is valid
only when TYPE=NODES is specified and the ID operand specifies a value
other than an asterisk (*).
- IDTYPE=CP
- Displays information for the CP with the name specified on the ID operand. The control point that is displayed can be the host CP or a CDRSC representing an adjacent CP.
- IDTYPE=RESOURCE
- Displays information for a CP, an SSCP, or another resource with the name specified on the ID operand. If both an SSCP and a CP are found, VTAM displays information for both of them.
- IDTYPE=SSCP
- Displays information for the SSCP with the name specified on the ID operand.
- TYPE
- If TYPE is not specified, TYPE=VTAM is used by default.
- TYPE=CNM
- Displays information about communication network management (CNM) traces.
- TYPE=EXIT
- Displays information about the session management exit (SME) buffer trace.
- TYPE=MODULE
- Displays information about a module trace.
- TYPE=NODES
- Displays information about BUF, GPT, IO, LINE, QDIOSYNC, SIT,
STATE, and TG traces for the resources named on the ID operand.
- BUF
- Buffer contents trace
- GPT
- Generalized PIU trace
- IO
- Input/output trace
- LINE
- NCP line trace
- QDIOSYNC
- Queued Direct I/O diagnostic synchronization
- SIT
- Scanner interface trace
- STATE
- Resource state trace
- TG
- Transmission group trace
- TYPE=NETCTLR
- Displays information about a 3710 Network Controller line trace.
- TYPE=ROUTE
- Displays the status of the APPN route selection trace.
- TYPE=SMS
- Displays information about the Storage Management services (SMS) buffer use trace.
- TYPE=STATE
- Displays information about the resource types being traced.
- TYPE=TSO
- Displays trace information for the TSO user IDs specified on the ID operand. This function is similar to that provided by the DISPLAY TSOUSER command.
- TYPE=VTAM
- Displays information about the VTAM internal trace (VIT).
- TYPE=ALL
- Displays information for the following types of traces, if they
are active:
- TYPE=CNM
- TYPE=EXIT
- TYPE=MODULE
- TYPE=NODES,ID=*
- TYPE=SMS
- TYPE=STATE
- TYPE=TSO,ID=*
- TYPE=VTAM
No information is displayed for the CNM, TSO, EXIT, MODULE, SMS, STATE, and VTAM traces if they are not active.
Note: Specifying TYPE=ALL might degrade performance because VTAM checks every major or minor node in the network. It may also temporarily delay subsequent VTAM operator commands.
Resulting display
- For TYPE=CNM, the resulting display shows the status for session awareness and problem determination PIU buffer traces (on or off).
- For TYPE=EXIT, the resulting display shows the functions of the session management exit (SME) for which tracing is active.
- For TYPE=MODULE, the resulting display shows the types of modules for which tracing is active.
- For TYPE=NODES, the resulting display shows:
- For ID=major node name, the resources subordinate to the named resource that have an active BUF, GPT, IO, LINE, QDIOSYNC, SIT, STATE, or TG trace.
- For ID=minor node name, the status of BUF, GPT, IO, LINE, QDIOSYNC, SIT, STATE, or TG tracing for this resource.
- For ID=*, all resources that have an active BUF, GPT, IO, LINE, QDIOSYNC, SIT, STATE, or TG trace, along with the name of the resource's major node.
- For ID=wildcard name, the status of BUF, GPT, IO, LINE, QDIOSYNC, SIT, STATE, or TG tracing for the resources that match the wildcard value.
Note: For ID=name in any form, the display also shows whether BUF, IO, QDIOSYNC, and STATE trace requests are saved, with saved trace requests for unknown resources. - For TYPE=NETCTLR, the resulting display shows the name of the 3710 performing the trace, and the PU name and line name of each resource being traced.
- For TYPE=ROUTE, the resulting display shows the APPN route selection trace status (on or off) and the amount of storage currently allocated to the trace table.
- For TYPE=SMS, the resulting display shows the trace status (on or off).
- For TYPE=STATE, the resulting display shows the resource types for which resource state tracing is active.
- For TYPE=TSO, the resulting display shows:
- For ID=name, the trace status for the named user ID (on or off).
- For ID=*, all user IDs that have an active trace.
- For TYPE=VTAM, the resulting display shows the mode (internal or both internal and external), the trace table size (applicable only to MODE=INT).
- For TYPE=VTAM, the display for the active trace options for MODE=INT is affected by the setting of the VTAM Internal Trace Control (VITCTRL) start option. See z/OS Communications Server: SNA Diagnosis Vol 2, FFST Dumps and the VIT for more details.
- For TYPE=ALL, the resulting display shows all of the information
for the following traces, if they are active:
- TYPE=CNM
- TYPE=EXIT
- TYPE=MODULE
- TYPE=NODES,ID=*
- TYPE=SMS
- TYPE=STATE
- TYPE=TSO,ID=*
- TYPE=VTAM
Examples
d net,traces,type=cnm
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=CNM
IST655I PDPIUBUF TRACE STATUS = ON
IST655I SAWBUF TRACE STATUS = ON
IST314I END
d net,traces,type=exit,id=istexcaa
IST097I DISPLAY ACCEPTED
IST075I NAME = ISTEXCAA, TYPE = EXIT
IST199I OPTIONS = BEGIN INITAUTH SECAUTH ACCTING GWPATH XRF ADJSSCP
IST199I OPTIONS = ALIAS ALS REPL VRSEL HPRVRSEL HPRP_OLU HPRP_ANR
IST199I OPTIONS = HPRP_DLU END
IST314I END
d net,traces,type=exit,id=istexccs
IST097I DISPLAY ACCEPTED
IST075I NAME = ISTEXCCS, TYPE = EXIT
IST199I OPTIONS = BEGIN CONNSTAT DYNA_XID PRED_XID END
IST314I END
d net,traces,type=module
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=MODULE
IST199I OPTIONS = COMMAND CONNECTION INTERFACES SESSION
IST314I END
d net,traces,type=nodes,id=(appl1,appl2,netappl1,noapp1)
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=NODES
IST075I NAME = APPL1A, TYPE = APPL SEGMENT
IST1041I NETA.APPL1 APPL
IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = YES
IST1042I STATE = ON - AMOUNT = **NA** - SAVED = YES
IST1041I NETA.APPL2 APPL
IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO
IST1042I STATE = ON - AMOUNT = **NA** - SAVED = NO
IST924I -------------------------------------------------------------
IST075I NAME = CDRSC1A, TYPE = CDRSC SEGMENT
IST1041I NETA.NETAPPL1 CDRSC
IST1042I IO = ON - AMOUNT = **NA** - SAVED = YES
IST1042I STATE = ON - AMOUNT = **NA** - SAVED = YES
IST924I -------------------------------------------------------------
IST1422I SAVED TRACE REQUESTS FOR NETA.NOAPP1
IST1041I NETA.NOAPP1 N/A
IST1042I BUF = SAVED - AMOUNT = PARTIAL
IST1042I STATE = SAVED - AMOUNT = **NA**
IST314I END
d net,traces,type=nodes,id=*
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=NODES
IST075I NAME = A50CDRMC, TYPE = CDRM SEGMENT
IST1041I C01N CDRM
IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO
IST924I -------------------------------------------------------------
IST075I NAME = A0362ZC, TYPE = PU T4/5
IST1041I A03S16 LINE
IST1042I LINE = TRACT
IST924I -------------------------------------------------------------
IST075I NAME = TRLHYDRA, TYPE = TRL MAJOR NODE
IST1041I TRLHYDRA TRL MAJOR NODE
IST1042I IO = ON - AMOUNT = **NA** - SAVED = NO
IST1041I NSQDIO11 TRLE
IST1042I IO = ON - AMOUNT = **NA** - SAVED = NO
IST2183I QDIOSYNC = ALLINOUT - SYNCID = NSQDIO11 - SAVED = YES
IST314I END
d net,traces,type=nodes,id=a500n,idtype=cp
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=NODES
IST075I NAME = NETA.A500N, TYPE = APPL
IST1041I NETA.A500N APPL
IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO
IST314I END
d net,traces,type=nodes,id=a500n,idtype=sscp
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=NODES
IST075I NAME = A500N, TYPE = CDRM
IST1041I A500N CDRM
IST1042I BUF = ON - AMOUNT = PARTIAL - SAVED = NO
IST314I END
d net,traces,type=route
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=ROUTE
IST2154I ROUTE SELECTION TRACE IS ACTIVE - BFRNUM = 100
IST2156I STORAGE ALLOCATED TO ROUTE SELECTION TRACE = 2000K
IST314I END
d net,traces,type=sms
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=SMS
IST655I SMS TRACE STATUS = OFF
IST314I END
d net,traces,type=state
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=STATE
IST199I OPTIONS = ADJCP APPL CDRM CDRSC GROUP LINE LU NCP PU
IST314I END
d net,traces,type=tso,id=user1
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=TSO
IST1200I USER1 TSO USERID TRACE = OFF
IST314I END
d net,traces,type=vtam
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=VTAM
IST315I VTAM INTERNAL TRACE ACTIVE - MODE = INT, SIZE = 0100 MB
IST199I OPTIONS = API APPC CFS CIO CMIP CSM ESC HPR LCS LOCK MSG NRM
IST199I OPTIONS = PIU PSS SMS SSCP TCP VCNS XBUF XCF
IST1730I SUBTRACE TREE ACTIVE UNDER TRACE OPTION SSCP
IST1730I SUBTRACE ARBP ACTIVE UNDER TRACE OPTION SSCP
IST314I END
d net,traces,type=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = TRACES,TYPE=NODES
IST075I NAME = A50CDRMC, TYPE = CDRM SEGMENT
IST1041I C01N CDRM
IST1042I BUF = ON - AMOUNT = PARTIAL
IST924I -------------------------------------------------------------
IST075I NAME = A0362ZC, TYPE = PU T4/5
IST1041I A03S16 LINE
IST1042I LINE = TRACT
IST924I -------------------------------------------------------------
IST075I NAME = TRLHYDRA, TYPE = TRL MAJOR NODE
IST1041I TRLHYDRA TRL MAJOR NODE
IST1042I IO = ON - AMOUNT = **NA** - SAVED = NO
IST1041I NSQDIO11 TRLE
IST1042I IO = ON - AMOUNT = **NA** - SAVED = NO
IST2183I QDIOSYNC = ALLINOUT - SYNCID = NSQDIO11 - SAVED = YES
IST924I -------------------------------------------------------------
IST075I NAME = ISTEXCAA, TYPE = EXIT
IST199I OPTIONS = BEGIN INITAUTH VRSEL END
IST924I -------------------------------------------------------
IST075I NAME = ISTEXCCS, TYPE = EXIT
IST199I OPTIONS = BEGIN CONNSTAT DYNA_XID PRED_XID END
IST924I -------------------------------------------------------------
IST350I DISPLAY TYPE = TRACES,TYPE=VTAM
IST315I VTAM INTERNAL TRACE ACTIVE - MODE = INT, SIZE = 0050 MB
IST199I OPTIONS = API APPC CFS CIO CMIP CSM ESC HPR LCS LOCK MSG NRM
IST199I OPTIONS = PIU PSS SMS SSCP TCP VCNS XBUF XCF
IST315I VTAM INTERNAL TRACE ACTIVE - MODE = EXT, SIZE = 0002 BUFFERS
IST199I OPTIONS = API APPC CFS CIO CMIP CSM ESC HPR LCS LOCK MSG NRM
IST199I OPTIONS = PIU PSS SMS SSCP TCP VCNS XBUF XCF
IST924I -------------------------------------------------------------
IST350I DISPLAY TYPE = TRACES,TYPE=STATE
IST199I OPTIONS = ADJCP APPL CDRM CDRSC GROUP LINE LU NCP PU
IST924I -------------------------------------------------------------
IST350I DISPLAY TYPE = TRACES,TYPE=MODULE
IST199I OPTIONS = COMMAND CONNECTION INTERFACES SESSION
IST314I END