• DISPLAY,TOPO,ID=cpname
• DISPLAY,TOPO,ID=cpname,LIST=ADJ
• DISPLAY,TOPO,LIST=CDSERVR
• DISPLAY,TOPO,LIST=ICN
• DISPLAY,TOPO,LIST=VN
• DISPLAY,TOPO,LIST=EN
• DISPLAY,TOPO,LIST=NN
• DISPLAY TOPO,ID=cpname,LIST=ALL when it is issued at an end node and the ID specified is not the local end node

 IST350I   DISPLAY TYPE = TOPOLOGY
[IST1348I  VTAM STARTED AS nodetype]
[IST1805I  ONLY LOCAL TOPOLOGY INFORMATION IS AVAILABLE]
[IST1803I  parameter PARAMETER VALUE NOT VALID - DEFAULT default USED]
[IST1804I  parameter PARAMETER NOT VALID - IGNORED]
 IST1295I  CP NAME           NODETYPE ROUTERES CONGESTION  CP-CP WEIGHT
 IST1296I  cpname            nodetype routeres congestion  cp-cp weight
⋮
IST314I   END

 IST350I   DISPLAY TYPE = TOPOLOGY
 IST1295I  CP NAME           NODETYPE ROUTERES CONGESTION  CP-CP WEIGHT
 IST1296I  cpname            nodetype routeres congestion  cp-cp weight
 IST1579I                    ------------------------------------------
 IST1297I                    ICN/MDH  CDSERVR  RSN         HPR
 IST1298I                    icn/mdh  cdservr  rsn         option
 IST1579I                    ------------------------------------------
 IST1223I                    BN       NATIVE   TIME LEFT   LOCATE SIZE
 IST1224I                    bn       native   time_left   locate_size
 IST924I -------------------------------------------------------------
 IST2356I PLATFORM = platform
[IST2355I TDUDIAG THRESHOLD REACHED ON date AT time]
[IST2307I THIS NODE DOES NOT SUPPORT UNKNOWN TOPOLOGY VECTORS]
[IST2277I POSSIBLE CORRUPTION OF TOPOLOGY CONTROL VECTORS DETECTED] 
 IST924I -------------------------------------------------------------
 IST2275I TDU INFORMATION SINCE LAST RESET ON date AT time
[IST1769I LAST TDU RECEIVED - date time FROM adjacent_cp]
[IST1784I LAST TDU RECEIVED - NONE]
[IST2281I LAST TDU SENT - date time]
[IST2315I LAST TDU SENT - NONE]
 IST2282I TDU COUNTS:
 IST2352I   SENT     = sent         RECEIVED = received
 IST2353I   ACCEPTED = accepted     REJECTED = rejected
 IST2354I   IGNORED  = ignored
 IST924I -------------------------------------------------------------
 IST1299I  TRANSMISSION GROUPS ORIGINATING AT CP cpname
 IST1357I                                                  CPCP
 IST1300I  DESTINATION CP    TGN      STATUS   TGTYPE      VALUE WEIGHT
 IST1301I  destcpname        tgn      status   tgtype      cpval weight
⋮
 IST314I   END

IST1223I                   BN       NATIVE   TIME LEFT   LOCATE SIZE
IST1224I                   bn       native   time_left   locate_size

• This message is a header message for the information that is displayed in message IST1224I.

• bn indicates whether the node is a border node. Possible values are:

  YES

  The node has the border node function enabled and at least one active intersubnetwork link (ISL). For VTAM, the border node function is enabled by coding BN=YES as a VTAM start option.

  NO

  The node does not have the border node function enabled, or the border node function is enabled but no intersubnetwork link is active.

• The native value indicates whether the node is in the same subnetwork as the host node. Possible values are:

  YES

  bn is YES, and this node and the node issuing the display are in a subnetwork sharing topology information.

  NO

  bn is YES, and this node and the node issuing the display are not in a subnetwork sharing topology information.

  *NA*

  bn is NO.

• time_left is the number of days remaining until the node entry is removed from the topology database (garbage collected).
• locate_size is the maximum APPN Locate message size supported by the node. Possible values are:

  nnnK

  The valid range for nnn is 1–128 expressed in kilobytes.

IST1295I CP NAME           NODETYPE ROUTERES CONGESTION  CP-CP WEIGHT
IST1296I cpname            nodetype routeres congestion  cp-cp weight

• This message is a header message for information displayed in message IST1296I.

• cpname is the network-qualified name of the control point (CP) specified on the command.
• nodetype is the value that was specified on the NODETYPE start option and is the node type of cpname. Possible values are:

  EN

  End node

  NN

  Network node

  VN

  Virtual node

  GVRN

  Global Virtual Routing Node

  UNKNOWN

  The topology database has received conflicting information about cpname and is in the process of determining the node type. This is a temporary situation, and the node type should be available in a short time.

  If the node is quiescent, /Q is appended to the end of the nodetype value. If the node is ready for garbage collection, /G is appended to the end of the nodetype value.

• routeres is route resistance. This is a user-defined value specified on either the start command or in the start list and indicates the desirability of using cpname in intermediate routes.
  • Possible values are 0–255. A smaller value indicates higher desirability.
  • *NA* is displayed when
    • cpname is an end node. End nodes are not involved in intermediate routing.
    • cpname is a virtual node. The weight of a virtual node is always 0, so routeres is not involved in path weight calculation.
  • See the ROUTERES start option information in z/OS Communications Server: SNA Resource Definition Reference.
• congestion provides session congestion information about cpname. Possible values are:

  NONE

  Indicates that there is no session congestion for cpname.

  NODE

  Indicates that cpname is at its session limit.

  TDU

  Indicates that a large amount of topology database update (TDU) traffic is queued for the CP-CP session to cpname.

  NODE/TDU

  Indicates that cpname is at its session limit and a large amount of TDU traffic is queued for the CP-CP session to cpname.

  ***NA***

  ***NA*** is displayed when:

  • cpname is an end node. End nodes are not involved in intermediate routing.
  • cpname is a virtual node. The weight of a virtual node is always 0, so congestion is not involved in path weight calculation.

  TDU and NODE/TDU are displayed only when both of the following are true:

  • LIST=ADJ is specified on the command.
  • The node specified on the ID operand of the command is the node at which the command is entered (the host node).
• cp-cp indicates whether a CP-CP session is active. Possible values are:

  YES

  A CP-CP session is active to this node.

  NO

  A CP-CP session is not active to this node.

  *NA*

  cpname is a virtual node or cpname is the node that is issuing the command.

• weight represents the actual weight of cpname as calculated by VTAM using the node and Class of Service (CoS) definitions. The value of 32767 is displayed when a node is not operational or does not meet the CoS requirements specified by the APPNCOS parameter in the DISPLAY TOPO command.
  • The weight of cpname is a measure of the relative desirability of choosing that resource in the route selection process and is 0–255 or 32767.

  See the APPN Class of Service definitions information in z/OS Communications Server: SNA Resource Definition Reference.

IST1297I                   ICN/MDH  CDSERVR  RSN         HPR
IST1298I                   icn/mdh  cdservr  rsn         option

• This message is a header message for information displayed in message IST1298I.

• The information that is displayed for an end node might not be accurate if the node on which the command is executed is not the network node server (NNS) or dependent LU server (DLUS) of the end node, or if the end node does not support the registration of local topology information.
• icn/mdh indicates whether cpname is an interchange node (ICN) or a migration data host (MDH). Possible values are:

  YES

  • If NN is specified on the NODETYPE start option and the HOSTSA start option is specified, cpname is an interchange node.
  • If EN is specified on the NODETYPE start option and the HOSTSA start option is specified, cpname is a migration data host.

  NO

  • If cpname is an NN, it is not an interchange node.
  • If cpname is an EN, it is not a migration data node.

• cdservr indicates whether cpname is a central directory server. Possible values are:

  YES

  cpname is a central directory server.

  NO

  cpname is not a central directory server.

• rsn is the resource sequence number (RSN) of cpname expressed in decimal.
  • Displaying the RSN for a resource provides information about VTAM's current knowledge of that resource.
  • For example, if a display of a resource from two different VTAMs indicates different RSNs for the same resource, one VTAM has backlevel information. This mismatch might indicate a problem.
• option is the value that was coded for the HPR start option. Possible values are:

  NONE

  This node has no HPR capabilities.

  ANR

  This node provides ANR routing and can only function as an intermediate node in an HPR connection.

  RTP

  This node has all the capabilities of an ANR node and it can function as endpoints for RTP connections.

  For additional information on the meaning of the values for HPR for VTAM nodes, see the description of message IST1482I.

IST1299I  TRANSMISSION GROUPS ORIGINATING AT CP cpname
IST1357I                                                  CPCP
IST1300I  DESTINATION CP    TGN      STATUS   TGTYPE      VALUE WEIGHT
IST1301I  destcpname        tgn      status   tgtype      cpval weight

• This is a header message for the TGs that originate in the node that is displayed.
• cp_name is the network-qualified CP name of the origin node of the TGs.

• These are header messages for the TGs displayed in message IST1301I.

• destcpname is the network-qualified CP name of the TG destination node.
• tgn is the TG number. Possible values are 0–255.
• status is the current state of the TG. Possible values are:

  OPER

  The TG is operational.

  INOP

  The TG is not operational.

  QUIES

  The TG is quiescent.

  Tip: The status value for an intercluster TG or a TG to a branch extender will always be QUIES when it is displayed in a non-owning node. The owning node of a TG is the node where the TG originates (origin node).

  If the TG is ready for garbage collection, /G is appended to the end of the status value.

• tgtype is the TG type. Possible values are:

  BRANCH

  The TG is a branch extender. The BRANCH tgtype can be used by IBM® Communications Server for Data Center Deployment on Linux. For more information about this function, see IBM Communications Server for Linux, Quick Beginnings, GC31-6768-04.

  ENDPT

  The TG is an endpoint TG. If the origin node or destination node is an EN, then the TG is an endpoint TG.

  ENDPT VRTG

  The TG is an endpoint VR-based TG (VRTG). A VRTG connects two APPN-capable VTAM nodes through a subarea network. A VRTG, although it creates the appearance of APPN, always represents underlying subarea connectivity. If the origin node or destination node is an EN, then the TG is an endpoint VRTG.

  INTERM

  The TG is an intermediate routing TG. An intermediate routing TG represents an NN to NN or NN to virtual routing node (VRN) connection.

  INTERM VRTG

  The TG is an intermediate routing VRTG. A VRTG connects two APPN-capable VTAM nodes through a subarea network. A VRTG, although it creates the appearance of APPN, always represents underlying subarea connectivity. An intermediate routing VRTG represents an NN to NN connection.

  INTERCLUST

  The TG is an intercluster (ICL) or intersubnet link (ISL) TG. These TGs are connections between border nodes or non-native nodes.

• cpval indicates whether this connection supports CP-CP sessions. Possible values are:

  YES

  The connection supports CP-CP sessions. This is not an indication that a CP-CP session is active across the TG.

  NO

  The connection does not support CP-CP sessions.

• weight represents the actual weight of the TG as calculated by VTAM using the TG, the TG profile, and the class of service (CoS) definitions. The value of 32767 is displayed when a TG is not operational or does not meet the CoS requirements specified by the APPNCOS parameter in the DISPLAY TOPO command.
  • The weight of a TG is a measure of the relative desirability of choosing that resource in the route selection process. Valid values 0–255 or 32767.
  • See the APPN transmission group profile and the APPN Class of Service definitions in z/OS Communications Server: SNA Resource Definition Reference for more information about coding TG profiles and APPN Class of Service definitions.

END NODE

The host is a pure APPN end node.

MIGRATION DATA HOST

The host is a migration data host (MDH). A node is an MDH if EN is specified on the NODETYPE start option, and the HOSTSA start option is specified.

• DISPLAY NET,TOPO,LIST=TDUINFO,CLEAR=YES
• DISPLAY NET,TOPO,LIST=TDUDIAG,CLEAR=YES
• DISPLAY NET,TOPO,LIST=TDUDIAG,ID=cpname,CLEAR=YES

See DATE and TIME formats for information about the date and time values.

IST2282I TDU COUNTS:
IST2352I   SENT     = sent         RECEIVED = received
IST2353I   ACCEPTED = accepted     REJECTED = rejected
IST2354I   IGNORED  = ignored

• This is a header message for topology database update (TDU) counts for this node.

• This message displays counts of TDUs sent and received for this node.
• The sent value is the number of TDUs about the node that were sent since the last time that the TDU counts were reset.
• The received value is the number of TDUs about the node that were received since the last time that the TDU counts were reset.

• This message displays the counts of the TDUs that were accepted and rejected for this node.
• The accepted value is the number of TDUs about the node that were accepted since the last time that the TDU counts were reset. The TDUs contain new information about the node and the topology database was updated.
• The rejected value is the number of TDUs about the node that were rejected since the last time that the TDU counts were reset. The TDUs were rejected because the TDUs contain outdated information about the node. TDUs that are built from the local topology database information for the node were sent as corrections.

• This message displays counts of TDUs ignored for this node.
• The ignored value is the number of TDUs about the node that were ignored since the last time that the TDU counts were reset. The TDUs were discarded because the TDUs contained no new information.

****NA****

Platform identifier is unknown

CS/2

IBM Communications Server for OS/2

CS/AIX

IBM Communications Server for AIX®

CS/LINUX Z

IBM Communications Server for Linux on System Z

CS/LINUX I

IBM Communications Server for Linux on Intel

CS/WINDOWS

IBM Communications Server for Windows

ISERIES

IBM iSeries®

SNAPLUS2

Hewlett-Packard SNAplus2

Z/OS VTAM

IBM z/OS® Communications Server (VTAM)

Z/VM VTAM

IBM z/VM® VTAM

Z/VSE VTAM

IBM z/VSE® VTAM