LCP(8)
NAME
lcp − Local Area Terminal server (LAT) control program
SYNTAX
/etc/lcp lcp [ −sr ] [ −m time ] [ −n node ]
[ −N nodedesc ] [ −v service ] [ −V servicedesc ]
lcp [ −t ]
lcp [ −dzc ] [ interval ]
DESCRIPTION
The LAT control program (lcp) provides the essential functions to control and manage LAT terminal service. It allows you to start and stop LAT service, modify and display configuration characteristics, and display and zero error counters. The command lcp −s is usually included in the /etc/rc.local file to automatically restart LAT service during reboot. You must have an RSX or VMS node in order to downline load LAT software.
The following options may be set with lcp:
−s Start LAT service. Enable connections from LAT terminal servers to host. If LAT parameters have not been set, they take on default values specified in the −r option.
−r Reset LAT parameters to the following default values:
multicast timer: 30 seconds
nodename: hostname
node description: “ULTRIX-32”
servicename: hostname
service description: “ULTRIX LAT SERVICE”
−m Set multicast timer to time seconds. A node advertises its presence to the LAT servers by sending out a multicast message over the network. The time variable sets the interval between transmissions. Valid intervals range from 10 to 255 seconds, with a default of 30 seconds.
−n Set nodename to node. Specifies the name that your node will be known by. Although the Terminal Server keeps track of nodes without an associated nodename, a LAT node must have a nodename in order for a terminal user to establish a connection. A node can have a list of associated services and service ratings, specified by up to 16 alphanumeric characters. Dollar ($) and underscore (_) characters are valid, but leading underscores and trailing colons are removed. The nodename must be unique on the Ethernet. The Terminal Server displays the nodename as a service if you type the “show services” command, and as a node if you type the “show nodes” command. The nodename default is the hostname.
−N Set node description to nodedesc. The node description allows for a short message to be displayed to LAT users, providing news or additional node information. Specify up to 64 alphanumeric characters. Dollar ($) and underscore (_) characters are valid, but leading underscores and trailing colons are removed. Leading ampersands (&) are not allowed. The default is “ULTRIX-32”. You must enclose the string in double quotes (") if it contains one or more spaces.
−v Set service name to service. Service names allow a service node to be known by more than just the nodename. The default is the nodename.
−V Set service description to servicedesc. It can be up to 64 characters in length. You must enclose the string in double quotes (") if it contains one or more spaces.
−t Stop LAT service. Disable connections from LAT terminal servers to host.
−d Display LAT characteristics. Shows the LAT parameters at their current setting. The following is an example of the output of the −d option:
/etc/lcp −d
Node name: NODE Service name: NODE
Node Identification: ULTRIX LAT service
Service Identification: ULTRIX-32
Groups: 0
Multicast timer: 30 seconds
LAT version: 5 eco: 0 LAT Protocol is active
The “groups” parameter is not supported in this release.
−z Zero all error counters. To test system performance over a period of time, zero the counters and observe the information that accumulates.
−c Display error counters once in vertical format. The following is an example of the output of the −c option:
% /etc/lcp −c
67413 Frames received (rcv)
32 Duplicate frames received (rcvdup)
89005 Frames transmitted (xmit)
62 Retransmissions (rexmit)
0 Illegal messages received (illmesg)
0 Illegal slots received (illslots)
interval Continuously display error counters in horizontal format, waiting interval seconds between each iteration. Quit by sending a keyboard interrupt. The following is an example of the output of the interval option:
% /etc/lcp 10
rcvrcvdupxmitrexmitillmesgillslots
6747432890666200
6748332890676200
6749132890736200
6750232890896200
Error Counters
The meaning of each error counter is explained below.
rcvnumber of Ethernet LAT messages.
rcvdupnumber of duplicate messages received (normally indicates a system slowdown).
xmitnumber of transmitted Ethernet LAT messages.
rexmitnumber of transmit frames that are sent more than once.
illmesgnumber of bad messages flagged by the LAT driver.
illslotsnumber of bad transmission slots flagged by the driver.
FILES
/etc/ttys
/etc/rc.local
DIAGNOSTICS
Messages indicating that user is not privileged or that LAT service is not loaded.