DISPLAY TRACES command

Abbreviations

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 command DISPLAY 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.

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