Displays the status and LAT characteristics of a node.
Format
SHOW NODE [node-name]
1 – Parameter
node-name
Specifies the name of the node for which information is
displayed. If you do not specify a node name, LATCP displays
information about the local node.
You can also specify any valid wildcard for this parameter
For example, the SHOW NODE A* command displays the status and
characteristics of all nodes that begin with the letter A.
2 – Qualifiers
2.1 /ALL
Displays information about all nodes known to your local node.
When you use this qualifier, specify the /FULL or /BRIEF
qualifier as well. If you do not specify either the /FULL or
/BRIEF qualifier, the default display will contain the node
status and identification string (the display generated by the
/BRIEF qualifier).
2.2 /BRIEF
Displays the node status and identification string. This is the
default display if you specify the /ALL qualifier.
2.3 /COUNTERS
Displays the counters kept for the node. Do not use the /BRIEF or
/FULL qualifier with this qualifier. LAT Node Counters lists and
describes the counters displayed with SHOW NODE/COUNTERS.
Table 6 LAT Node Counters
Counter Description
Messages received The total number of LAT messages received by
the local node. If you specify a remote node
with the SHOW NODE command, the number of LAT
messages received from that remote node.
Messages The total number of LAT messages transmitted
transmitted by the local node. If you specify a remote
node with the SHOW NODE command, the number of
LAT messages transmitted to that remote node.
Slots received The total number of LAT slots received by the
local node. If you specify a remote node with
the SHOW NODE command, the number of slots
received from that remote node. A slot is a
message segment that contains information
corresponding to a single session.
Slots transmitted The total number of LAT slots transmitted by
the local node. If you specify a remote node
with the SHOW NODE command, the number of
slots transmitted to that remote node.
Bytes received The total number of bytes of LAT information
received by the local node. If you specify a
remote node with the SHOW NODE command, the
number of bytes received from that remote
node.
Bytes transmitted The total number of bytes of LAT information
transmitted by the local node. If you specify
a remote node with the SHOW NODE command, the
number of bytes transmitted to that remote
node.
Multicast bytes The total number of LAT multicast bytes
received received by the local node.
Multicast bytes The total number of LAT multicast bytes sent
sent by the local node.
Multicast The total number of LAT multicast messages
messages received received by the local node.
Multicast The total number of LAT multicast messages
messages sent sent by the local node.
No transmit The total number of times no buffer was
buffer available on the local node for transmission.
Multicast The total number of times LTDRIVER failed to
messages lost process an inbound multicast message because
of failed communication with the LATACP.
Multicast send The total number of times LTDRIVER failed to
failures send a multicast message because of failed
communication with the LATACP.
Controller errors The total number of times LTDRIVER failed
to communicate with the data link controller
driver.
Last controller The most recent controller error.
error
Multiple node The total number of times that a node
addresses announced itself with a physical address
different from that in a previous
announcement.
Duplicates The total number of duplicate messages
received received by the local node. If you specify
a remote node with the SHOW NODE command, the
number of duplicate messages received from
that remote node. This counter can indicate a
system slowdown.
Messages The total number of LAT messages that the
retransmitted local node retransmitted because they were
not acknowledged by terminal servers (or
nodes that support outgoing connections). If
you specify a remote node with the SHOW NODE
command, the number of messages retransmitted
to that remote node.
Illegal messages The total number of invalidly formatted LAT
received messages received by the local node. If you
specify a remote node with the SHOW NODE
command, the number of invalidly formatted
messages the local node received from that
remote node. Illegal messages are grouped into
several types of protocol errors, which are
listed at the end of this table.
Illegal slots The total number of invalidly formatted LAT
received slots received by the local node. If you
specify a remote node with the SHOW NODE
command, the number of invalidly formatted
slots the local node received from that remote
node.
Solicitations The total number of times a remote node
accepted accepted solicitations from the local node. If
you specify a remote node with the SHOW NODE
command, the number of accepted solicitations
by that remote node.
Solicitations The total number of times a remote node
rejected rejected solicitation from the local node. If
you specify a remote node with the SHOW NODE
command, the number of rejected solicitations
by that remote node.
Solicitation The total number of times solicitations by the
failures local node received no response.
Transmit errors The total number of times the data link failed
to transmit a LAT message.
Last transmit The most recent transmit error.
error
Virtual circuit The total number of times a LAT circuit to
timeouts another node timed out, indicating that the
remote node failed to send a valid message
in the required time span. If you specify a
remote node with the SHOW NODE command, the
number of times the local node timed out from
a connection to that remote node.
Discarded output The total number of data bytes that were
bytes discarded because of an overflow of an
internal buffer before the data could be
output to an LTA device.
User data lost The total number of times LTDRIVER failed to
allocate resources to buffer session data.
User data is lost and the session is stopped.
Resource errors The number of times LTDRIVER was unable to
allocate system resources.
Incoming solicits The total number of times the local node
accepted accepted solicitations from other nodes.
Incoming solicits The total number of times the local node
rejected rejected solicitations from other nodes.
The protocol errors that are counted as illegal messages are as
follows. These protocol error messages are displayed if their
associated counter is greater than zero:
o Invalid message type received
o Invalid start message received
o Invalid sequence number received in start message
o Zero-node index received
o Node circuit index out of range
o Node circuit sequence invalid
o Node circuit index no longer valid
o Circuit was forced to halt
o Invalid server slot index
o Invalid node slot index
o Invalid credit field or too many credits used
o Repeat creation of slot by server
o Repeat disconnection of slot by master
2.4 /FULL
Displays the node's status, identification string, LAT protocol
version, and the values of the node's characteristics. This is
the default except when you specify the /ALL qualifier.
2.5 /STATUS
Displays statistical information for parameters such as the
number of active circuits, sessions, and incoming queue entries.
For each parameter, the display shows the current value, the
highest value recorded, and the maximum value allowed.
Note that you can specify the /STATUS qualifier with the SHOW
NODE command to display information about the local node only
(for example, the command SHOW NODE /STATUS FOREIGN_NODE is not
supported).
3 – Examples
1.LATCP> SHOW NODE/FULL
The SHOW NODE command in this example produces the following
display of information about the local node:
Node Name: LTC LAT Protocol Version: 5.2
Node State: On
Node Ident: LTC - Engineering Development
Incoming Connections: Enabled Incoming Session Limit: None
Outgoing Connections: Enabled Outgoing Session Limit: None
Service Responder: Disabled
Circuit Timer (msec): 80 Keepalive Timer (sec): 20
Retransmit Limit (msg): 20 Node Limit (nodes): None
Multicast Timer (sec): 20 CPU Rating: 8
Maximum Unit Number: 9999
User Groups: 43, 73
Service Groups: 7-9,13,23,40,43,45,66,72-73,89,120-127,248-255
Service Name Status Rating Identification
LTVMS Available 31 D .
This display indicates that the local node LTC is in the On
state, which means LAT connections can be created on the
node. LTC is running Version 5.2. of the LAT protocol. The
identification of the node is "LTC - Engineering Development".
Because this is the local node, the display does not give
the address of a LAN device. Use the SHOW LINK command to
find addresses of devices on the local node. The display for
the status of remote nodes, as shown in Example 2, gives the
Ethernet address of that node.
Both incoming and outgoing connections can be made on node LTC,
the number of sessions is unlimited. The display indicates the
values of various timers and lists the groups that are enabled.
Users on the local node can access service nodes belonging to
user groups 43 and 73. Locally offered services can be accessed
by nodes belonging to the service groups listed.
The display indicates that the CPU rating of the local node
is 8. The display shows that the node offers a service named
LTVMS. This service is available and its rating is 31 D
(dynamic). (An S would indicate the rating is static.)
2.LATCP> SHOW NODE/FULL RWWUP
The SHOW NODE command in this example produces the following
display about the remote node RWWUP:
Node Name: RWWUP LAT Protocol Version: 5.2
Node State: Reachable Address: AA-00-04-00-11-10
Node Ident: .
Incoming Connections: Enabled
Circuit Timer (msec): 80
Multicast Timer (sec): 20
Service Groups: 7, 13, 42-43, 45, 66, 70-72, 75-82, 88-89
Service Name Status Rating Identification
NAC Available 28 .
SYSMGR Available 28 .
This display indicates that remote node RWWUP is reachable and
runs Version 5.2 of the LAT protocol. The display includes the
Ethernet address of node RWWUP. Because incoming connections
are enabled, you can connect to a service on node RWWUP,
provided that your node belongs to one of the service groups
listed in the display.
Node RWWUP offers two services: NAC and SYSMGR. Both are
available.
3.LATCP> SHOW NODE/ALL/BRIEF
The SHOW NODE command in this example produces the following
display about all nodes known to the local node:
Node Name Status Identification
--------- ----------- -----------------------------------
ABLAN Reachable Unauthorized access is prohibited.
ASKWEN Reachable .
CHUNK Reachable A member of the MAIN VMScluster
.
.
.
UTOO On Can be healthy at the Center
VULCUN Reachable Beam me up
ZENX Reachable ZENX
The SHOW NODE command in this example indicates the status
(whether a node is reachable) and identification of all nodes
known to the local node. Note also that the display includes
the status of the local node UTOO. The status can be either On,
Off, or Shut. Here it is On.
4.$ LCP :== $LATCP
$ LCP SHOW NODE /STATUS
The SHOW NODE /STATUS in this example produces the following
display:
Node Name: NODE1 LAT Protocol Version: 5.2
Node State: On
Node Ident: Test system
Current Highest Maximum
------- ------- -------
Active Circuits: 1 2 1023
Connected Sessions: 1 6 260865
Incoming Queue Entries: 0 0 24
Outgoing Queue Entries: 0 1 32767
Unprocessed Announcements: 0 7 500
Unprocessed Solicits: 0 2 250
Local Services: 1 2 255
Available Services: 188 194 N/A
Reachable Nodes: 166 172 N/A
Discarded Nodes: 0