Content-type: text/html
latcp - Local Area Transport (LAT) Control Program
This section is organized by the tasks you can perform with the latcp command. Each task subsection provides the latcp command syntax and the flags to use to complete the tasks.
Syntax:
latcp -s Starts LAT and enables LAT connections. If the following LAT parameters have not been set, they take on the default values: Node name --- The default value is the host name. Multicast timer --- The default value is 60 seconds. Network adapter --- The default is all network adapters connected to broadcast media. Service name --- The default value is taken from the LAT node name parameter. This default service is an unbound interactive service.
Syntax:
latcp -h Shuts down LAT and disables LAT connections.
Syntax:
latcp -A -aservice [-idescription] [-o | -ptty_list] Adds a service on the host node. Specifies the name of the service to add. The service name must conform to the rules specified in the DESCRIPTION section. Sets the service identification to the value specified by the description field. The description field can contain up to 64 characters. If the field contains more than one word, you must enclose the string in double quotation marks ("). If you do not specify a value for the description field, the default identification string (``Tru64 UNIX Version X.X LAT Service'') is used. Indicates that the service you are adding is an optional or dedicated service to be used by specialized applications (such as an application service). For example, you must use the -o flag when adding the service used for the LAT/Telnet gateway. Do not specify this flag with the -p flag. For more information, refer to the Network Administration manual.
# latcp -A -asiteapp -p620,621,622,623
Syntax:
latcp -A -ptty -Hremote_node {-Rremote_port |
-Vremote_service} [-Q] [-wpassword | -W]
Maps an application port on the host node.
Identifies the LAT terminal device to be mapped to an application
port. The LAT terminal device name
syntax is only restricted by the name of the LAT terminal device in the
device directory.
Syntax:
latcp -A -ptty -O -V learned_service [-Hremote_node
[-Rremote_port ]] [-wpassword | -W]
Maps an port on the host node. The -O flag identifies the type of port.
Identifies the LAT terminal device to be mapped to an outgoing port. The LAT
terminal device name syntax is only restricted by the name of the LAT terminal
device in the device directory.
Identifies the mapped port as an outgoing port.
Identifies the service name offered by the remote node that is to be
mapped to the LAT terminal device specified by -ptty.
The service name must conform to the rules specified in the
DESCRIPTION section.
Identifies the remote node that provides the service specified by
-Vlearned_Service.
The -H flag is optional when mapping an outgoing port.
The remote node name must conform to the rules specified in
the DESCRIPTION section.
Identifies the name of the remote port on the remote node (remote_node)
that provides the service specified by -Vlearned_Service.
The -R flag must be specified with the -H flag, but is optional.
The remote port name must conform to the rules specified in the
DESCRIPTION section.
Allows the user to specify the password for the remote
service that will be accessed through the outgoing port. When the remote
service to be accessed has password checking enabled, this password is needed
or the connection is rejected. The password is not case sensitive and
spaces are disallowed.
Syntax:
latcp -A -V reserved_service Adds a reserved service on the host node. Specifies the name of the reserved service to add. A reserved service is a permanent entry in the learned services database. The reserved service name must conform to the rules specified in the DESCRIPTION section.
Syntax:
latcp -ccount Sets the maximum number of learned services in the local learned services database to count. The value of count can range from 0 to 1000. The actual number of learned services can range from 1 to 1000. A value of zero (0) indicates that the maximum number of learned services is restricted by the amount of system memory. By default, the maximum number of learned services is 100.
Syntax:
latcp -D {-aservice | -vreserved_service | -ptty_list} Deletes a service or reserved service, or unmaps an application port or outgoing port from the host node. You must specify either a service (-a), a reserved service (-v), or a port (-p) with the -D flag. Specifies the service to be deleted. When a service is deleted, active sessions associated with the service remain.
Syntax:
latcp [-p | -P]tty_list -aservice Binds (-p) or unbinds (-P) the specified list of LAT terminal devices to the specified bound interactive service. The list can be a single LAT terminal device or a list of LAT terminal devices separated by commas. The following example binds LAT devices 620, 621, 622, and 623 to the bound interactive service siteapp. Not that only the last component of the LAT terminal devices needs to be specified (for example, 620 instead of /dev/lat/620).
# latcp -p 620,621,622,623 -asiteapp
Syntax:
latcp -idescription -aservice Sets the service identification to the specified value. The description field can contain up to 64 characters. If the field contains more than one word, you must enclose the string in double quotation marks ("). Specifies the service for which you are changing the service identification.
Syntax:
latcp [-g | -G]list -aservice Enables (-g) and disables (-G) the service node groups specified in the list. Group codes can range from 0 to 255. Group 0 is enabled by default for all service nodes and servers. Specifies the service name. The -aservice flag is required. The service name must conform to the rules specified in the DESCRIPTION section. The following example specifies a single node group of 128 for the service siteapp:
# latcp -g 128 -asiteapp If you enter a group list, use commas (,) to separate individual groups. The following example shows multiple node groups being specified for the service transapp:
# latcp -g 56,5,102,10,20,30,40,50,60,...,
110,150,200,210,255 -atransapp
If the string exceeds the width of the screen, it must wrap to the
following line. You cannot use a carriage return to break a string.
Note that the individual group codes are separated by commas with no spaces.
Syntax:
latcp [-j | -J] Enables (-j) and disables (-J) node agent status.
Syntax:
latcp -Y Purges all of the existing non-reserved learned services; reserved learned services are not purged.
Syntax:
latcp -xrating -aservice Specifying a rating of -1 causes service ratings to be calculated dynamically based on the node's activity. The service ratings are placed in service announcement messages multicasted to all LAT nodes.
Syntax:
latcp -nnode Sets the node name to the name specified with the node argument. The node name specifies the name by which the node will be known. The node name must be unique within the LAT network and must conform to the rules specified in the DESCRIPTION section.
Syntax:
latcp -mtime Sets multicast transmission timer to the specified time in seconds. A node advertises its presence to other LAT nodes by sending out a multicast message over the network. The multicast timer determines the time between the multicast messages. Valid intervals range from 10 to 180 seconds. (The default is 60 seconds.)
Syntax:
latcp -d Displays LAT characteristics on the host node. For example, the following command shows the LAT parameters at their current setting:
# /usr/sbin/latcp -d
Node name: SERVICE1 Multicast timer: 60 seconds LAT version: 5 ECO: 2 Outgoing Port Groups: 0
Selected Interface Name(s): fza0 ln0 LAT Protocol is active Agent Status: Disabled Maximum Number of Learned Services: 100
Service information
Service name: SERVICE1
Service ID: Tru64 UNIX Version n.n LAT SERVICE
Rating: Dynamic 255
Groups: 0
Service information
Service name: BOUNDSVC (Bound)
Service ID: Tru64 UNIX Version n.n LAT SERVICE
Rating: Dynamic 255
Groups: 0
Ports: 620
Service information
Service name: DEDICATED (Optional)
Service ID: Tru64 UNIX Version n.n LAT SERVICE
Rating: Dynamic 255
Groups: 0
A service without Bound or Optional next to the name is an unbound
interactive service. For bound services, the display includes a Ports
entry that shows the LAT terminal devices (ttys) that are bound to the
bound interactive service.
Syntax:
latcp -d -l [-vlearned_service] Displays LAT characteristics specified by the following flag. Displays current learned services. For example:
# /usr/sbin/latcp -d -l
Number of Available Services: 98
Available Services:
Service Name Status Identification
ADJECT AVAILABLE Tru64 UNIX Version Vn.n LAT SERVICE
ALFIKR AVAILABLE Tru64 UNIX Version Vn.n LAT SERVICE
ANDERSON AVAILABLE Tru64 UNIX Version Xn.n LAT SERVICE
ARCHIE AVAILABLE Tru64 UNIX Version Vn.n LAT SERVICE
Displays information about learned_service.
The learned service name must conform to the rules specified in the
DESCRIPTION section. For example:
# /usr/sbin/latcp -d -l -vzipcode
Available Service: ZIPCODE
Node Name Status Rating Identification
ZIPCODE AVAILABLE 155 Tru64 UNIX Version Vn.n LAT SERVICE
Syntax:
latcp -d -Hremote_node Displays LAT characteristics specified by the following flag. Displays characteristics for remote_node. The remote node name must conform to the rules specified in the DESCRIPTION section.
# /usr/sbin/latcp -d -Hzipcode
LATCP Remote Node Characteristics for ZIPCODE
Ethernet Address: 08-00-2b-39-ba-c8 LAT version: 5 ECO: 2
Identification: Tru64 UNIX Version Vn.n LAT NODE
Node Groups: 0
Number of Available Services: 1
Available Services:
Service Name Status Identification
ZIPCODE AVAILABLE Tru64 UNIX Version Vn.n LAT SERVICE
Syntax:
latcp -d -C Displays LAT characteristics specified by the following flag. Displays counter information for the remote nodes with which the host currently has a virtual circuit. For example:
# /usr/sbin/latcp -d -C
LATCP Server Counters for SERVER1
120 Seconds since last reset 0 Fwd out-of-seq messages
22 Run messages received 0 Retransmitted messages
26 Run messages transmitted 0 Bad circuit messages
20 Slots received 0 Bad circuit slots
22 Slots transmitted 0 Accepted host-initiated
104 Bytes received 0 Rejected host-initiated
0 Duplicate messages 0 Multiple nodes seen
Syntax:
latcp -d -N Displays LAT characteristics specified by the following flag. Displays counter information for the local host node. For example:
# /usr/sbin/latcp -d -N
LATCP Node Counters
160020 Seconds since last reset 0 Fwd out-of-seq messages
283 Run messages received 0 Retransmitted messages
301 Run messages transmitted 0 Bad circuit messages
191 Slots received 0 Bad circuit slots
191 Slots transmitted 0 Accepted host-initiated
937 Bytes received 0 Rejected host-initiated
0 Duplicate messages 0 Multiple nodes seen
LATCP Node Statistics
2 Circuits created 0 Circuit timeouts
9 Sessions created 2826 Service messages xmit
285 Frames received 2826 Service messages recv
3130 Frames transmitted 2826 Service messages used
0 Illegal frames
LATCP Node Errors
0 Circuit Start 0 HIC Solicit
0 Circuit Run 0 HIC Response
0 Circuit Halt 0 HIC Command
0 Service Announcement 0 HIC Status
0 Other Message
Syntax:
latcp -d -S Displays LAT characteristics specified by the following flag. Displays the address of the remote nodes and the number of sessions with which the host currently has a virtual circuit. For example:
# /usr/sbin/latcp -d -S
LATCP Server Characteristics for MABBAM Ethernet address: 08-00-2B-a3-90-85 Number of Active Circuits: 1 Number of Active Sessions: 1
Syntax:
latcp -d -P [-ptty_list | -L | -I | -O] Displays LAT characteristics specified by the following flag. Displays the characteristics for ports on the host node. If this flag is issued without an argument, all application ports, active interactive sessions, and outgoing ports on the host node are displayed. Identifies the LAT terminal devices for which data is to be printed. The list can be a single LAT terminal device or a list of LAT terminal devices separated by commas. Do not use with the -L, -I, and -O flags. Sets the display of port characteristics to display all application ports. Do not use with the -p, -I, and -O flags. Sets the display of port characteristics to display all interactive ports. Do not use with the -p, -L, and -O flags. Sets the display of port characteristics to display all outgoing ports. Do not use with the -p, -L, and -I flags.
Syntax:
latcp [-e | -E]adapter Adds (-e) or removes (-E) the specified adapter to or from the list of adapters over which LAT can run.
Syntax:
latcp -z Sets to zero all counters displayed by the -d -C and -d -N options. You can test system performance over time by setting the counters to zero and observing the information that accumulates.
Syntax:
latcp -r Resets the LAT parameters to the default values. See the -s option for information.
Syntax:
latcp [-u | -U]list Enables (-u) or disables (-U) the outgoing port groups specified in the list. Outgoing port groups range from 0 to 255. Group 0 is enabled by default.
# latcp -u 1,10,100,200
The latcp utility provides the essential functions for LAT control and management. It allows nonprivileged users to display host, port, circuit, and server information and privileged users to perform the following tasks: Add, delete, change, and display service and port attributes Add and delete network interface adapters Add, delete, and display reserved services Bind and unbind LAT devices to specific services Map and unmap outgoing LAT devices to remote services Change the node name Enable and disable node group codes, node agent status, and outgoing port groups Purge non-reserved learned services Set and display maximum number of learned services Display learned services Display remote node information Change service rating Display and reset counter information Start and stop the LAT driver
When LAT automatic startup and shutdown is enabled, the /sbin/init.d/lat script is executed upon reaching run level 3. When this script is executed, it reads and executes the latcp commands in the /etc/latstartup.conf file (if it exists). LAT automatic startup and shutdown can be enabled or disabled with the latsetup utility. See the Network Administration manual for additional information.
The latcp program only effects one operation per invocation. Therefore, you can only specify one command on a command line.
For introductory information on LAT, see the lat_intro(7) reference page.
Some of the flags require that you specify a name for the service, node, or port. The names can contain 1 to 16 of the following ASCII characters: Uppercase letters A to Z Lowercase letters a to z
Specifies the LAT control device.
Commands: llogin(1), latsetup(8)
Network Services: lat_intro(7), lat_manual_setup(7)
Network Administration delim off