LATCP SHOW — VMS 5.5-2H4
Additional information available:
LINK
Displays the status and LAT characteristics of links on the local
VMS node.
Format
SHOW LINK [link-name]
Additional information available:
Parameter
link-name Specifies the name for a LAT data link. A link name can have up to 16 ASCII characters. If you do not specify a link name, LATCP displays information about all links currently defined for the VMS node.
Qualifiers
Additional information available:
/BRIEF
Displays the device name and state of the link. This is the default display.
/COUNTERS
Displays the device counters kept for the link. The numbers
displayed represent the values recorded since the last time the
counters were reset (when the node first started or when the ZERO
COUNTERS command was used).
Do not use the /BRIEF or /FULL qualifier with this qualifier.
Table LAT-1 lists and describes counters common to both CSMA/CD
(carrier sense, multiple access with collision detect) and FDDI
(fiber distributed data interface) links.
Table LAT-1 Counters Common to CSMA/CD and FDDI Links
Counter Description
Messages received The total number of messages received
over the link.
Multicast messages The total number of multicast messages
received received over the link.
Bytes received The total number of bytes of
information received over the link.
Multicast bytes received The total number of multicast bytes
received over the link.
System buffer unavailable The total number of times no system
buffer was available for an incoming
frame.
Unrecognized destination The total number of times a frame
was discarded because there was no
portal with the protocol enabled. This
count includes frames received for the
physical address only.
Messages sent The total number of messages sent over
the link.
Multicast messages sent The total number of multicast messages
sent over the link.
Bytes sent The total number of bytes of
information sent over the link.
Multicast bytes sent The total number of bytes of multicast
messages sent over the link.
User buffer unavailable The total number of times no user
buffer was available for an incoming
frame that passed all filtering.
Data overrun The total number of bytes lost on the
link's device because the local node's
input buffers were full. A nonzero
value can indicate noisy lines, a bad
device, a busy or poorly tuned system
(not enough resources allocated), or a
hardware problem with another device on
the LAN connection.
Table LAT-2 lists and describes receive errors common to both
CSMA/CD and FDDI links. These errors, which are included in
the display generated by the SHOW LINK/COUNTERS command, are
represented by flags that indicate the error has occurred.
Table LAT-2 Receive Errors Common to CSMA/CD and FDDI Links
Flag Description
Block check error CRC error in packet(s) received.
Framing error Received frame(s) ended incorrectly.
Frame too long Frame(s) received longer than length
limits.
Frame status error CRC error on ring noticed by local FDDI
station (FDDI only).
Frame length error Frame length too short (FDDI only).
Table LAT-3 lists and describes transmit errors common to both
CSMA/CD and FDDI links. These errors, which are included in
the display generated by the SHOW LINK/COUNTERS command, are
represented by flags that indicate the error has occurred.
Table LAT-3 Transmit Errors Common to CSMA/CD and FDDI Links
Flag Description
Excessive collisions Frame(s) failed to transmit because
the collision limit of 16 was reached
(CSMA/CD only).
Carrier check failures Indicates transceiver problem or short
circuit in cable.
Short circuit Short circuit in cable.
Open circuit Open circuit in cable.
Frame too long Frame(s) too long. Indicates a
transmission problem in one of the
portals using the link.
Remote failure to defer A remote station failed to defer
frame(s) transmission. Could indicate a
misconfigured network.
Transmit underrun Transmission of a frame was too slow.
Indicates a hardware controller error.
Transmit failure Frame(s) failed to transmit.
Table LAT-4 lists and describes link counters specific to CSMA/CD
only.
Table LAT-4 CSMA/CD Counters
Counter Description
Transmit CDC failure The total number of carrier detect
check errors, that is, the number of
times the local node failed to detect
that another Ethernet station was
already transmitting when the local
node began transmitting.
Messages transmitted: Single collision--The total number
of times a frame was successfully
transmitted on the second attempt
after a normal collision on the first
attempt.
Multiple collision--The total number
of times a frame was successfully
transmitted on the third or later
attempt after normal collisions on
previous attempts.
Initially deferred--The total number of
times a frame transmission was deferred
on its first attempt. This counter is
used to measure Ethernet contention
with no collisions.
Table LAT-5 lists and describes link counters specific to FDDI
only.
Table LAT-5 FDDI Counters
Counter Description
Ring initializations The total number of times a ring
initiated reinitialization was initiated by the
link.
Ring initializations The total number of times a ring
received reinitialization was initiated by some
other link.
Directed beacons received The number of times the link detected
the directed beacon process. Each
invocation of the directed beacon
process is counted only once.
Connections completed The number of times the station
successfully connected to the
concentrator.
Duplicate tokens detected The number of times a duplicate token
was detected on the link.
Ring purge errors The number of times the ring purger
received a token while still in the
ring purge state.
LCT rejects Link Confidence Test rejects. Indicates
a problem with communication between
station and concentrator.
Elasticity buffer errors Elasticity buffer function errors.
Indicates a station on the ring with a
transmit clock out of tolerance.
MAC error count The number of times the MAC (Media
Access Control) changed the E indicator
in a frame from R to S.
Traces initiated The number of times the PC-trace
process was initiated by the link.
Traces received The number of times the link was
requested to perform the PC-trace
process.
Ring beacons initiated The number of times the ring beacon
process was initiated by the link.
Link errors The number of times the Link Error
Monitor (LEM) detected an error in
a received message. Slow counts are
normal.
Duplicate address test The number of times the link address
failures was a duplicate.
FCI strip errors The number of times a Frame Content
Independent Strip operation was
terminated by receipt of a token.
LEM rejects The number of times excessive LEM
errors were encountered.
MAC frame count The total number of frames (other than
tokens) seen by the link.
MAC lost count The total number of times a frame
(other than a token) was improperly
terminated.
/FULL
Displays the device name, state, and datalink address of the link and indicates whether the DECnet address is enabled.
Examples
1. LATCP> SHOW LINK/FULL NETWORK_A
The SHOW LINK command in this example produces the following
display of information about link NETWORK_A:
Link Name: NETWORK_A Datalink Address: 08-00-2B-10-12-E3
Device Name: _ESA7: DECnet Address: Disabled
Link State: On
The display in this example gives the device name of link
NETWORK_A and the device's hardware address. The link is in
the On state.
NODE
Displays the status and LAT characteristics of a VMS node.
Format
SHOW NODE [node-name]
Additional information available:
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.
Qualifiers
Additional information available:
/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).
/BRIEF
Displays the node status and identification string. This is the default display if you specify the /ALL qualifier.
/COUNTERS
Displays the counters kept for the node. Do not use the /BRIEF
or /FULL qualifier with this qualifier. Table LAT-6 lists and
describes the counters displayed with SHOW NODE/COUNTERS.
Table LAT-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 transmitted The total number of LAT messages 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 sent The total number of LAT multicast bytes sent
by the local node.
Multicast messages The total number of LAT multicast messages
received received by the local node.
Multicast messages The total number of LAT multicast messages
sent sent by the local node.
No transmit buffer The total number of times no buffer
was available on the local node for
transmission.
Multicast messages The total number of times LTDRIVER failed to
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 received The total number of duplicate messages
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 VMS
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
failures the local node received no response.
Transmit errors The total number of times the data link
failed to transmit a LAT message.
Last transmit error The most recent transmit 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
/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.
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,
and there is no limit to the number of sessions. 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 VAXcluster
.
.
.
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.
PORT
Displays the status and LAT characteristics of ports on the local
VMS node.
Format
SHOW PORT [port-name]
Additional information available:
Parameter
port-name Specifies the name of the port for which information is displayed. If you do not specify a port name, the SHOW PORT command displays the characteristics for all LTAn: ports on a node. Do not use the /APPLICATION, /DEDICATED, /FORWARD, or /INTERACTIVE qualifiers with a specific port name.
Qualifiers
Additional information available:
/APPLICATION/BRIEF/DEDICATED/FORWARD/FULL
/INTERACTIVE
/APPLICATION
Generates a display of all application ports.
/BRIEF
Displays port type, port status, and the remote node name, port, and service associated with the port. This is the default if you do not specify a port name with the SHOW PORT command.
/DEDICATED
Generates a display of all dedicated ports.
/FORWARD
Generates a display of all LAT ports used for either outgoing LAT connections or local LAT management functions.
/FULL
This displays the following information.
o Port type
o Port status
o Target port name, node name, and service name associated with
the port
o Remote node name, port, and service associated with the port if
a connection is currently active
/INTERACTIVE
Generates a display of all LAT ports used for incoming interactive connections.
Example
LATCP> SHOW PORT /FULL
The SHOW PORT command in this example produces the following
type of display. The display reflects the characteristics set
by the command examples given with the SET PORT command.
Local Port Name: _LTA16: Local Port Type: Forward
Local Port State: Inactive
Connected Link:
Target Port Name: Actual Port Name:
Target Node Name: LATCP$MGMT_PORT Actual Node Name:
Target Service Name: Actual Service Name:
--------------------------------------------------------------
Local Port Name: _LTA17: Local Port Type: Interactive
Local Port State: Active
Connected Link: LAT$LINK
Target Port Name: Actual Port Name: PORT_1
Target Node Name: Actual Node Name: MY_DS200_SERVER
Target Service Name: Actual Service Name:
--------------------------------------------------------------
Local Port Name: _LTA19: Local Port Type: Application (Queued)
Local Port State: Active
Connected Link: LAT$LINK
Target Port Name: Actual Port Name:
Target Node Name: TLAT1 Actual Node Name: TLAT1
Target Service Name: PRINTER Actual Service Name: PRINTER
--------------------------------------------------------------
Local Port Name: _LTA21: Local Port Type: Dedicated
Local Port State: Inactive
Connected Link:
Target Port Name: Actual Port Name:
Target Node Name: Actual Node Name:
Target Service Name: GRAPHICS Actual Service Name:
--------------------------------------------------------------
Local Port Name: _LTA22: Local Port Type: Application (Queued)
Local Port State: Active
Connected Link: LAT$LINK
Target Port Name: LN02 Actual Port Name: LN02
Target Node Name: TS33EW Actual Node Name: TS33EW
Target Service Name: Actual Service Name:
--------------------------------------------------------------
The display in this example shows information about all the
ports on the local node. There are four types of ports. The
display shows information for each of these types, as follows:
o Forward: a port used for outgoing LAT connections or for
executing local management functions and LATCP commands.
Port LTA16: is a forward port. The display shows that the
port is currently inactive, that is, there is no current
LAT connection. The target node name of LATCP$MGMT_PORT
indicates that LATCP is using this port to execute the LATCP
commands entered by the user. If the display listed a node
and service name, it would mean that the port is being used
for an outgoing connection.
o Interactive: a port created as a result of an incoming LAT
connection request from another node or terminal server.
Port LTA17: is an interactive port connected with port
PORT_1 on the terminal server MY_DS200_SERVER.
o Application: a port used for solicited connections to
devices on terminal servers or to application services on
remote LAT service nodes. Port LTA22: is an application
port. The port maps to port LN02 (a printer) on a terminal
server node TS33EW. The display indicates that server TS33EW
queues connection requests from the local node. Port LTA19:
is also an application port. The port maps to the service
PRINTER on terminal server TLAT1.
o Dedicated: a port dedicated to a local application service.
Port LTA21: is dedicated to the service GRAPHICS.
The target port name, target node name, and target service
name are the names specified with the SET PORT command. They
are passed to the remote node or terminal server when the
connection request is made.
The actual port name, actual node name, and actual service name
are the names returned by the remote node when it accepts the
connection request. They may differ from the corresponding
target names (specified with the SET PORT command) if the
remote node translates the names. For example, terminal servers
that accept connections to LAT service names usually return the
name of the port to which the connection was actually directed.
SERVICE
Displays the status and LAT characteristics of LAT services known
to the local VMS node.
Format
SHOW SERVICE [service-name]
Additional information available:
Parameters
service-name Specifies the name of the service for which information will be displayed. If you do not specify a service name, LATCP displays information about all services known to the VMS node.
Qualifiers
Additional information available:
/BRIEF
Displays the status and identification string of the service.
/COUNTERS
Displays the counters kept for the service. Do not use the /BRIEF
or /FULL qualifier with this qualifier. The following table lists
and describes the counters:
Counter Description
Remote Counters
Connections The total number of times the local node
attempted attempted to connect to the service offered
on a remote node.
Connections The total number of times the local node
completed successfully connected to the service offered
on a remote node.
Local Counters
Connections The total number of times the local node
accepted accepted a connection request from a remote
node to a locally offered service.
Connections The total number of times the local node
rejected rejected a connection request from a remote
node to a locally offered service.
/FULL
Displays the status, identification string, and type of service, and the values set for service characteristics. This qualifier also displays the status of all service nodes offering the service.
/LOCAL
Displays information about services offered by the local VMS node only. You can use this qualifier with the /BRIEF, /COUNTERS, or /FULL qualifier.
Examples
1. LATCP> SHOW SERVICE HOMEWK/FULL
The SHOW SERVICE command in this example produces the following
display of information about service HOMEWK. This service is
offered by the local node.
Service Name: HOMEWK Service Type: General
Service Status: Available
Service Ident: .
Node Name Status Rating Identification
LAV On 31 D .
LATP Reachable 48 .
LITTN Reachable 37 .
LTDRV Reachable 82 .
The display in this example indicates that the locally offered
service HOMEWK is available and its service type is General,
meaning that it is a general timesharing service (in contrast
to a dedicated application service). The display also lists the
status of all the nodes that offer the service. The local node
is LAV. The status of the local node can be either On, Off,
or Shut. Here node LAV's status is On. The status of the other
nodes indicates whether they are reachable. The display lists
the ratings of each service node, indicating their relative
capacity to accept new connections. The D next to the locally
offered service indicates that node LAV computes its rating
dynamically. An S would indicate that the node's rating was set
permanently by the node's system manager.
2. LATCP> SHOW SERVICE OFFICE/FULL
The SHOW SERVICE command in this example produces the following
display of information about the service OFFICE, which is
offered by a remote node:
Service Name: OFFICE
Service Status: Available
Service Ident: .
Node Name Status Rating Identification
BURGIL Reachable 121 .
DARWIN Reachable 43 .
The display in this example indicates that the service is
available. The display also indicates the status and other
information about the nodes that offer the service, BURGIL and
DARWIN.