1 – LINK
Displays the status and LAT characteristics of links on the local node. Format SHOW LINK [link-name]
1.1 – 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 node.
1.2 – Qualifiers
1.2.1 /BRIEF
Displays the device name and state of the link. This is the default display.
1.2.2 /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. Counters Common to CSMA/CD and FDDI Links lists and describes counters common to both CSMA/CD (carrier sense, multiple access with collision detect) and FDDI (fiber distributed data interface) links. Table 1 Counters Common to CSMA/CD and FDDI Links Counter Description Messages received The total number of messages received over the link. Multicast The total number of multicast messages messages received received over the link. Bytes received The total number of bytes of information received over the link. Multicast bytes The total number of multicast bytes received received over the link. System buffer The total number of times no system buffer was unavailable available for an incoming frame. Unrecognized The total number of times a frame was destination 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 The total number of multicast messages sent messages sent over the link. Bytes sent The total number of bytes of information sent over the link. Multicast bytes The total number of bytes of multicast sent messages sent over the link. User buffer The total number of times no user buffer was unavailable 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. Receive Errors Common to CSMA/CD and FDDI Links 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 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 CRC error on ring noticed by local FDDI error station (FDDI only). Frame length Frame length too short (FDDI only). error Transmit Errors Common to CSMA/CD and FDDI Links 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 3 Transmit Errors Common to CSMA/CD and FDDI Links Flag Description Excessive Frame(s) failed to transmit because the collisions collision limit of 16 was reached (CSMA/CD only). Carrier check Indicates transceiver problem or short circuit failures 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 A remote station failed to defer frame(s) defer 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. CSMA/CD Counters lists and describes link counters specific to CSMA/CD only. Table 4 CSMA/CD Counters Counter Description Transmit CDC The total number of carrier detect check failure 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 Single collision-The total number of times transmitted: 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. FDDI Counters lists and describes link counters specific to FDDI only. Table 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 The number of times the link detected the received 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 The number of times a duplicate token was detected 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 Elasticity buffer function errors. 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 The number of times the ring beacon initiated 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 The number of times the link address was a test failures 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.
1.2.3 /FULL
Displays the device name, state, and datalink address of the link and indicates whether the DECnet address is enabled.
1.3 – 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 – NODE
Displays the status and LAT characteristics of a node. Format SHOW NODE [node-name]
2.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.2 – Qualifiers
2.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.2 /BRIEF
Displays the node status and identification string. This is the default display if you specify the /ALL qualifier.
2.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.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.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).
2.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
3 – PORT
Displays the status and LAT characteristics of ports on the local node. Format SHOW PORT [port-name]
3.1 – 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. In addition do not use the /LIMITED qualifier with a specific port name.
3.2 – Qualifiers
3.2.1 /APPLICATION
Generates a display of all application ports.
3.2.2 /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.
3.2.3 /COUNTERS
Displays the counters kept for the port. Do not use the /BRIEF or /FULL qualifiers with this qualifier.
3.2.4 /DEDICATED
Generates a display of all dedicated ports.
3.2.5 /FORWARD
Generates a display of all LAT ports used for either outgoing LAT connections or local LAT management functions.
3.2.6 /FULL
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 For more information, see the description of the SHOW PORT/FULL example.
3.2.7 /INTERACTIVE
Generates a display of all LAT ports used for incoming interactive connections.
3.2.8 /LIMITED
Generates a display of all limited LTA devices on the system (previously established with the CREATE PORT /LIMITED or SET PORT /LIMITED command).
3.3 – Examples
1.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. The display shows information for each of the four types of ports: 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-no current LAT connection exists. 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. 2.LATCP> SHOW PORT LTA1 /COUNTERS The SHOW PORT /COUNTERS command in this example produces a display that lists counter information for the LTA1 device. Port Name: _LTA1: Seconds Since Zeroed: 66 Remote Accesses: 0 Framing Errors: 0 Local Accesses: 0 Parity Errors: 0 Bytes Transmitted: 0 Data Overruns: 0 Bytes Received: 0 Password Failures: 0 Solicitations Accepted: 1 Solicitations Rejected: 1 Incoming Solicits Accepted: 0 Incoming Solicits Rejected: 0 Last disconnect reason code: 18 (%LAT-F-LRJDELETED, queue entry deleted by server)
4 – QUEUE_ENTRY
Displays information about requests, or entries, queued on the local node. Format SHOW QUEUE_ENTRY [queue-entry-id]
4.1 – Parameter
queue-entry-id Specifies the identification number (ID) of the queued entry for which information is displayed. If you do not specify a value for this parameter, information about all queued entries is displayed.
4.2 – Qualifiers
4.2.1 /BRIEF
Displays the following information about the queued entries: o Position o Entry ID o Source node o Service o Port name (This is the default display.)
4.2.2 /FULL
In addition to the information displayed by the /BRIEF qualifier, the /FULL qualifier provides the following information for each node: o Node queue position o Service queue position o Node address o Soliciting Link
4.3 – Examples
1.LATCP> SHOW QUEUE_ENTRY The SHOW QUEUE_ENTRY command in this example produces the following type of display. Position Entry ID Source Node Service Port Name -------- -------- ---------------- ---------------- --------- 1 79EC NODE1 LAT_LIMITED 2 7AEC NODE2 LAT_LIMITED 3 7CEC NODE3 LAT_LIMITED 2.LATCP> SHOW QUEUE_ENTRY/FULL The SHOW QUEUE_ENTRY/FULL command in this example produces the following type of display. Entry ID: 7AEC Remote Node: NODE1 Node Queue Position: 1 Address: 08-00-2B-0A-A0-A0 Service Queue Position: 1 Target Port: Target Service: LAT_LIMITED Soliciting Link: LAT$LINK ------------------------------------------------------------------- Entry ID: 7CEC Remote Node: NODE2 Node Queue Position: 2 Address: AA-00-04-00-37-DD Service Queue Position: 2 Target Port: Target Service: LAT_LIMITED Soliciting Link: LAT$LINK
5 – SERVICE
Displays the status and LAT characteristics of LAT services known to the local node. Format SHOW SERVICE [service-name]
5.1 – 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 node. You can also specify any valid wildcard for this parameter. For example, the SHOW SERVICE LAT_* command displays the status and characteristics of all services that begin with the LAT_ prefix.
5.2 – Qualifiers
5.2.1 /BRIEF
Displays the status and identification string of the service.
5.2.2 /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. Password The total number of connect requests to the failures service which were rejected due to password violation errors.
5.2.3 /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.
5.2.4 /LOCAL
Displays information about services offered by the local node only. You can use this qualifier with the /BRIEF, /COUNTERS, or /FULL qualifier.
5.3 – Examples
1.LATCP> SHOW SERVICE NODE1 /FULL The SHOW SERVICE command in this example produces the following display of information about service NODE1. This service is offered by the local node. Service Name: NODE1 Service Type: General Service Status: Available Connections: Enabled Service Password: Enabled Queueing: N/A Service Ident: NODE1 - Test system 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 NODE1 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.