LATCP SHOW — VMS 5.4-3
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 an Ethernet link. A link name may 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. Do not use the
/BRIEF or /FULL qualifiers with this qualifier. The following
table lists and describes the counters:
Counter Description
Messages received The total number of messages
received over the link.
Multicast messages received The total number of multicast
messages received over the link.
Bytes received The total number of bytes of
information received.
Multicast bytes received The total number of multicast
bytes received.
Receive errors The total number of errors
occuring while receiving messages.
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 might
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
Ethernet.
User buffer unavailable The total number of times the
system was unable to allocate
a buffer in the user's process
space.
System buffer unavailable The total number of times the
system was unable to allocate a
buffer in the system space.
Local buffer errors The total number of times the
local node did not have a system
buffer available for the network
device to copy an Ethernet message
into.
A nonzero value might indicate
that the local node has too
many system buffers dedicated
to maintaining a large number
of virtual circuits, sessions,
or queued connections and not
enough for heavy network traffic
situations.
Transmit CDC failures 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 sent The total number of messages sent
over the link since the counters
were last reset.
Multicast messages sent The total number of multicast
messages sent.
Bytes sent The total number of bytes of
information sent.
Multicast bytes sent The total number of bytes of
multicast message sent.
Transmit errors The total number of times the link
device attempted to transmit data
and encountered an error while
trying to access the part of the
local node's memory that contains
the data.
Messages transmitted: The total number of single and
- single collision multiple collisions occurring
- multiple collision during transmission, and the
- initially deferred number of messages initially
deferred during transmission.
/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.
2. LATCP> SHOW LINK LINK_A/COUNTERS
The SHOW LINK command in this example produces the following
display of counters for link LINK_A:
Link Name: LINK_A
Device Name: _ETA6:
Seconds Since Zeroed: 6724
Messages Received: 184099 Messages Sent: 79922
Multicast Msgs Received: 106320 Multicast Msgs Sent: 2975
Bytes Received: 41485109 Bytes Sent: 9552010
Multicast Bytes Received: 10470760 Multicast Bytes Sent: 246635
Receive Errors: 0 Transmit Errors: 0
Data Overrun: 0
User Buffer Unavailable: 0 Messages Transmitted -
System Buffer Unavailable: 19 Single Collision: 1011
Local Buffer Errors: 0 Multiple Collisions: 1510
Transmit CDC Failure: 0 Initially Deferred: 4106
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. Use the /FULL or /BRIEF qualifier. The /BRIEF qualifier is the default.
/BRIEF
Displays the node status and identification string. This is the default 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. The following table lists and
describes the counters displayed with SHOW NODE/COUNTERS.
Table LAT-1 LAT Node Counters
Counter Description
Messages received The total number of LAT messages
successfully received by the local
node. If you specified a remote node
with the SHOW NODE command, the number
of messages received from that remote
node.
Multicast messages The total number of multicast messages
received received by the local node.
Messages transmitted The total number of LAT messages
successfully transmitted by the
local node. If you specified a remote
node with the SHOW NODE command, the
number of messages transmitted to the
specified remote node.
Multicast messages The total number of multicast messages
transmitted transmitted by the local node.
Slots received The total number of LAT slots received
by the local node. If you specified
a remote node with the SHOW NODE
command, the number of slots received
from that remote node. A slot is a
message segment containing information
corresponding to a single session.
Slots transmitted The total number of LAT slots
successfully transmitted by the local
node. If you specified a remote node
with the SHOW NODE command, the number
of slots transmitted to the specified
remote node.
Bytes received The total number of bytes received
by the local node. If you specified
a remote node with the SHOW NODE
command, the number of bytes
transmitted to the specified remote
node.
Multicast bytes received The total number of multicast bytes
received by the local node.
Bytes transmitted The total number of bytes transmitted
by the local node. If you specified
a remote node with the SHOW NODE
command, the number of bytes
transmitted to the specified remote
node.
Multicast bytes The total number of multicast bytes
transmitted transmitted by the local node.
Resource Errors The number of times memory was
unavailable to perform an operation.
This counter will be incremented
if the local node is listening to
multicast messages but does not have
enough room to cache the information
in a multicast message.
No transmit buffer The total number of times no buffer
was available on the local node for
transmission.
Multiple node addresses The total number of times that a node
announced itself with a physical
address different from that in a
previous announcement.
Duplicates received The total number of duplicate messages
that are received by the local node.
If you specify a remote node with
the SHOW NODE command, this counter
indicates the number of duplicate
messages received from that remote
node. This counter can indicate a
system slowdown.
Messages retransmitted The total number of LAT messages
that the 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, this counter indicates
the number of messages retransmitted
to that remote node.
Illegal messages received The total number of invalidly
formatted messages that the local
node received. If you specified a
remote node, the number of invalidly
formatted messages that 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 received The total number of LAT slots that the
local node received. If you specified
a remote node, the number of slots
that the local node received from that
remote node.
Solicitations accepted The total number of times the local
node has accepted solicitations from
other nodes. If you specify a remote
node with the SHOW NODE command,
this counter indicates the number
of times the local node has accepted
solicitations from that remote node.
Solicitations rejected The total number of times the local
node has rejected soliciations from
other nodes. If you specify a remote
node with the SHOW NODE command,
this counter indicates the number
of times the local node has rejected
solicitations from that remote node.
Virtual circuit timeouts The total number of times a circuit to
a 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, this
counter indicates the number of times
the local node timed out a connection
to that remote node.
Discarded output bytes The total number of data bytes that
were discarded because of an overflow
of an internal buffer before the data
could be output to an LT device.
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 create of slot by server
o Repeat disconnect of slot by server
/FULL
Displays the node's status, identification string, LAT protocol version, DECnet address, 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.4-1
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
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.4-1 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 an Ethernet 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 on 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.4-1
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.4-1 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
(reachability) and identification of all nodes known to the
local node. Notice 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
This 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. For more details, see the
discussion for the sample display in Example 1 given with the SHOW
PORT command.
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.
1. 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.
2. 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.
3. 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 LAT19:
also is an application port. The port maps to the service
PRINTER on terminal server TLAT1.
4. 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
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 qualifiers with this qualifier. The following table lists
and describes the counters:
Counter Description
Remote Counters
Connections Attempted The total number of times the local
node attempted to connect to the service
offered on a remote node.
Connections Completed The total number of times the local node
successfully connected to the service
offered on a remote node.
Local Counters
Connections Accepted The total number of times the local
node accepted a connection request
from a remote node to a locally offered
service.
Connections Rejected The total number of times the local
node 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 indicates the status and other
information about the nodes that offer the service, nodes
BURGIL and DARWIN.