Terminal Services Commands
translate lat
translate lat
To translate a connection request to another protocol connection type when receiving a local-area
transport (LAT) request, use the translate lat command in global configuration mode. To remove or
change the translation request, use the no form of this command.
translate lat incoming-service-name [incoming-options] protocol outgoing-address
[outgoing-options] [global-options]
no translate lat incoming-service-name [incoming-options] protocol outgoing-address
[outgoing-options] [global-options]
Syntax Description
incoming-service-name
A LAT service name. When used on the incoming portion of the
command, incoming-service-name is the name of the service that users
specify when trying to make a translated connection. This name can
match the name of the final destination resource, but is not required to.
This argument is useful when making remote translated connections.
incoming-options
(Optional) An incoming connection request option. For LAT, the only
option currently supported is:
•
unadvertised—Prevents service advertisements from being
broadcast to the network. This keyword can be useful, for example,
when you define translations for many printers, and you do not want
these services advertised to other LAT terminal servers. (VMS
systems will be able to connect to the service even though it is not
advertised.)
protocol outgoing-address A protocol name followed by an address or host name. Protocol
translation choices are: ppp, slip, tcp, and x25.
Note
The host name is resolved to an address during
configuration, unless you are translating to TCP and use the
host-name keyword, which allows the host name to be
resolved at connection time instead of configuration time.
See Table 39 for more information about the host-name
keyword.
Additional keywords that can be entered with the protocol are as follows:
•
autocommand—Specifies an EXEC command for an outgoing
connection. The command executes upon connection to a host. You
can issue any EXEC command and any switch or host name as an
argument to the autocommand command. If the string following
autocommand has one or more spaces as part of the string, you
must place quotation marks (“ ”) around the string.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-163
Terminal Services Commands
translate lat
If you want to enable AppleTalk Remote Access (ARA) on an
outgoing connection, specify the autocommand arap keywords.
These keywords are necessary for ARA because ARA does not use
addressing, and this option permits you to invoke the ARA string.
•
virtual-template—Associates a virtual template with a virtual
access interface. See the translate lat (virtual access interfaces)
command description for more information.
outgoing-options
(Optional) Outgoing connection request options. Choices depend upon
the protocol or command entered. See Table 37, Table 38, Table 39, and
Table 40 for more information.
global-options
(Optional) One or more of the following translation options can be used
by any connection type:
•
access-class number—Allows the incoming call to be used by
source hosts that match the access list parameters. The argument
number is an integer previously assigned to an access list. Standard
access list numbers are in the range from1 to 99; expanded standard
access lists numbers are in the range 1300 to 1999.
•
local—Allows Telnet protocol negotiations to not be translated.
•
login—Requires that the user log in before the outgoing connection
is made. This type of login is specified on the virtual terminal lines
with the login command.
•
max-users number—Limits the number of simultaneous users of
the translation to number (an integer you specify).
•
quiet—Suppresses printing of user-information messages.
Defaults
No default translation parameters
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
12.1
The no-reset permanent virtual circuits (PVC) subkeyword was added
to support outgoing PVCs.
Usage Guidelines
You define protocol translation connections by supplying a protocol keyword and the address, host
name, or service name. A LAT protocol translation command can be as simple as the following
example:
Router(config)# translate lat LAT-1 X.25 1236672
However, the Cisco IOS software provides a broad range of options that support protocol translations
in many networking environments. Table 37, Table 38, Table 39, and Table 40 list the translate lat
translation options by protocol.
Cisco IOS Terminal Services Command Reference
TR-164
78-12094-02
Terminal Services Commands
translate lat
You can also use the Cisco IOS command-line interface to help you understand how these keywords are
entered. In global configuration mode, begin entering the translate command and add a question mark
at each portion of the command to display the options available. Some examples follow:
Router(config)# translate lat ?
WORD
LAT service name
Router(config)# translate lat LSVC ?
autocommand
lat
ppp
slip
tcp
unadvertised
virtual-template
x25
Associate a command with a translation on this connections
DEC LAT protocol
Virtual async PPP
Virtual async SLIP
TCP/IP Telnet
Prevent service advertisements from being broadcast to the
network
Associate a virtual template with virtual access interface
X.25
Router(config)# translate lat LSVC tcp ?
Hostname or A.B.C.D
IP address
Router(config)# translate lat LSVC tcp 1.1.1.1 ?
access-class
binary
host-name
local
login
max-users
multibyte-IAC
port
quiet
source-interface
stream
Note
Allow access list parameters to be used by source hosts
Negotiate Telnet binary mode on the connection
Store the host name rather than its IP address
Allow Telnet protocol negotiations not to be translated
Require that the user log in before the outgoing connection
is made
Limit the number of simultaneous users of the translation
Always treat multiple IACs as telnet command
Port Number
Suppress printing of user-information messages
Specify source interface
Treat telnet escape characters as data
If you plan to translate to X.25 on a permanent virtual circuit (PVC), see the description for the
translate x25 command for important configuration notes.
Table 37
LAT-to-PPP Outgoing Translation Options
Outgoing PPP Translation
ppp {ip-address | ip-pool [scope-name name]}
Translates from LAT to virtual asynchronous PPP. Supply an IP address as a standard, four-part dotted
decimal IP address.
The ip-pool keyword obtains an IP address from a Dynamic Host Configuration Protocol (DHCP)
proxy client or a local pool. If the optional scope-name keyword is not specified, the address is
obtained from a DHCP proxy client. If the scope-name keyword is specified, the IP address is
obtained from the specified local pool. The scope-name keyword can specify a range of IP addresses.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-165
Terminal Services Commands
translate lat
Table 37
LAT-to-PPP Outgoing Translation Options (continued)
Outgoing PPP Connection Request Options
Add any of the following keywords to configure PPP connection requests:
•
authentication {pap | chap}—Sets Challenge Handshake Authentication Protocol (CHAP) or
Password Authentication Protocol (PAP) authentication for PPP on virtual asynchronous
interfaces. If you specify both keywords, order is significant; the system will try to use the first
authentication type, then the second.
•
header-compression—Implements header compression on IP packets only.
•
ipx loopback number—Specifies the loopback interface to be created and permits clients running
IPX-PPP to connect through virtual terminal lines on the router. A loopback interface must have
been created and configured with a Novell IPX network number before IPX-PPP can work on the
virtual terminal line. The virtual terminal line is assigned to the loopback interface.
•
keepalive number-of-seconds—Specifies the interval at which keepalive packets are sent on
Serial Line Internet Protocol (SLIP) and PPP virtual asynchronous interfaces. By default,
keepalive packets are enabled and sent every 10 seconds. To shut off keepalive packets, use a
value of 0. The active keepalive interval is 1 through 32,767 seconds. When you do not change
from the default of 10, the keepalive interval does not appear in more system:running-config or
show translate command output.
•
mtu bytes—Sets the interface maximum transmission unit (MTU) of packets that the virtual
asynchronous interface supports. The default MTU is 1500 bytes on a virtual asynchronous
interface. The acceptable range is from 64 to 1,000,000 bytes.
•
routing—Permits routing updates between connections. This keyword is required if the
destination device is not on a subnet connected to one of the interfaces on the router.
•
use-tacacs—Uses TACACS to verify PPP authentications for CHAP or PAP on virtual
asynchronous interfaces.
Table 38
LAT-to-SLIP Outgoing Translation Options
Outgoing SLIP Translation
slip {ip-address| ip-pool [scope-name name]}
Translates from LAT to virtual asynchronous SLIP. Supply an IP address as a standard, four-part
dotted decimal IP address.
The ip-pool keyword obtains an IP address from a DHCP proxy client or a local pool. If the optional
scope-name keyword is not specified, the address is obtained from a DHCP proxy client. If the
scope-name keyword is specified, the IP address is obtained from the specified local pool. The
scope-name keyword can specify a range of IP addresses.
Note
The slip argument applies only to outgoing connections; SLIP is not supported on
incoming protocol translation connections.
Cisco IOS Terminal Services Command Reference
TR-166
78-12094-02
Terminal Services Commands
translate lat
Table 38
LAT-to-SLIP Outgoing Translation Options (continued)
Outgoing SLIP Connection Request Options
Add any of the following keywords to configure SLIP connection requests:
•
header-compression [passive]—Implements header compression on IP packets only. The
passive keyword permits compression on outgoing packets only if incoming TCP packets on the
same virtual asynchronous interface are compressed. The default (without the passive keyword)
permits compression on all traffic.
•
ipx loopback number—Specifies the loopback interface to be created and permits clients running
IPX-PPP to connect through virtual terminal lines on the router. A loopback interface must have
been created and configured with a Novell IPX network number before IPX-PPP can work on the
virtual terminal line. The virtual terminal line is assigned to the loopback interface.
•
keepalive number-of-seconds—Specifies the interval at which keepalive packets are sent on SLIP
and PPP virtual asynchronous interfaces. By default, keepalive packets are enabled and sent every
10 seconds. To shut off keepalive packets, use a value of 0. The active keepalive interval is 1
through 32,767 seconds. When you do not change from the default of 10, the keepalive interval
does not appear in more system:running-config or show translate command output.
•
mtu bytes—Sets the interface MTU of packets that the virtual asynchronous interface supports.
The default MTU is 1500 bytes on a virtual asynchronous interface. The acceptable range is from
64 to 1,000,000 bytes.
•
routing—Permits routing updates between connections. This keyword is required if the
destination device is not on a subnet connected to one of the interfaces on the router.
Table 39
LAT-to-TCP Outgoing Options
Outgoing TCP Translation
tcp ip-address
Translates LAT to TCP/IP Telnet. Supply an IP address as a standard, four-part dotted decimal IP
address, the name of an IP host that can be resolved by the DNS, or explicit specification in an ip host
command (refer to the description for the host-name keyword in the “Outgoing TCP Connection
Request Options” section).
Outgoing TCP Connection Request Options
Any of the following optional keywords can be used to configure TCP connection requests:
•
binary—Negotiates Telnet binary mode on the connection.
•
host-name—Stores the host name rather than its IP address, thereby allowing the host name to
be resolved at connection time instead of configuration time. There is also a rotor keyword
suboption that you can use to modify the behavior of the host-name keyword by allowing one of
the IP addresses defined by the ip host configuration command to be chosen randomly. If one
address fails, another one will be tried, and so on until all address choices are exhausted. You can
use the rotor keyword, therefore, to provide basic load sharing of the IP destinations.
•
multibyte-IAC—Always treat multiple Interpret as Command (IAC) escape character codes as a
Telnet command.
•
port number—For outgoing connections, enter the number of the port to match. The default is
port 23 (Telnet).
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-167
Terminal Services Commands
translate lat
Table 39
LAT-to-TCP Outgoing Options (continued)
•
source-interface—Specifies the source address used for Telnet connections initiated by the
router.
•
stream—Performs stream processing, which enables a raw TCP stream with no Telnet control
sequences. A stream connection does not process or generate any Telnet options, and also
prevents Telnet processing of the data stream. This keyword might be useful for connections to
ports running the UNIX-to-UNIX Copy Program (UUCP) or other non-Telnet protocols, or to
ports connected to printers. For ports connected to printers using Telnet, the stream keyword
prevents some of the problems associated with using Telnet for printers, such as unusual events
happening to carriage returns or line feeds and echoing of data back to VMS systems.
Table 40
LAT-to-X.25 Outgoing Translation Options
Outgoing X.25 Translation
x25 x.121-address
Translates LAT to the X.25 protocol. Supply an X.121 address that conforms to the specifications
provided in the CCITT 1984 Red Book, or the name of an X.25 host that can be resolved by the DNS,
or explicit specification in an x25 host command.
The address number generally consists of a portion that is administered by the public data network
(PDN) and a portion that is locally assigned. You must be sure that the numbers that you assign agree
with the addresses assigned to you by the X.25 service provider. The X.121 addresses generally will
be subaddresses of the X.121 address for the X.25 network interface.
Outgoing X.25 Connection Request Options
Any of the following optional keywords can be used to configure X.25 connection requests:
•
cud c-u-data—Sends the specified X.25 Call User Data (CUD) text as part of an outgoing call
request after the protocol identification bytes.
•
no-reverse—Specifies that outgoing calls not request the X.25 reverse charge facility, when the
interface default is that all outgoing calls are reverse charged.
•
profile profile—Sets the X.3 packet assembler/disassembler (PAD) parameters as defined in the
profile created by the x29 profile command.
•
pvc number [interface serial number | packetsize in-size out-size | windowsize in-size out-size |
no-reset]—Specifies that the outgoing connection is actually a PVC. The number argument
specifies the virtual circuit channel number of the connection, which must be less than the virtual
circuits assigned to the switched virtual circuit (SVC).Only one session is allowed per PVC. Use
the following optional keywords to further define the connection:
– interface serial number—Specifies a PVC interface on which to set up the PVC connection.
– packetsize in-size out-size—Specifies the input packet size (in-size) and output packet size
(out-size) for the PVC. Valid packet size values are: 16, 32, 64, 128, 256, 512, 1024, 2048,
and 4096.
– windowsize in-size out-size—Specifies the packet count for input windows (in-size) and
output windows (out-size) for the outgoing translation. Values of in-size and out-size range
from 1 to 127 and must not be greater than the value set for the x25 modulo command. You
must specify the same value for in-size and out-size.
– no-reset—Causes the Cisco router to send a no Reset packet request at startup of a TCP or
LAT to permanent virtual circuit (PVC) translation session.
Cisco IOS Terminal Services Command Reference
TR-168
78-12094-02
Terminal Services Commands
translate lat
Table 40
Examples
LAT-to-X.25 Outgoing Translation Options (continued)
•
reverse—Provides reverse charging for X.25 on a per-call rather than a per-interface basis.
Requests reverse charges on a specified X.121 address, even if the serial interface is not
configured to request reverse charge calls.
•
use-map—Applies x25 map pad command entry options (such as CUD and idle) and facilities
(such as packet in, packet out, win in, and win out) to the outgoing protocol translation call. When
the use-map keyword is specified on the translate command, the Destination address and
optional PAD Protocol Identification (PID), CUD, and facilities are checked against a configured
list of x25 map pad entries. If a match is found, the map entry PID, CUD, and facilities are applied
to the outgoing protocol translation call. The X.25 map facilities applied to the outgoing
translation can be displayed with the show translation command throughout the duration of the
translation session.
The following example illustrates incoming LAT to outgoing TCP translations. The unadvertised
keyword prevents broadcast of service advertisements to other servers in the network. Outgoing
translated packets are sent to IP host Host1, TCP port 4005.
translate lat pt-printer1 unadvertised tcp Host1 port 4005
The following example translates LAT on an incoming line to SLIP on an outgoing line. It uses header
compression only if incoming TCP packets on the same interface are compressed.
translate lat Service1 slip 10.0.0.4 header-compression
The following example first shows how to disable keepalive packets on a PPP line using the
translate lat command, then shows translated session output from the show translate EXEC command
indicating keepalive packets have been turned off.
translate lat Service2 ppp 172.21.2.2 keepalive 0
.
.
.
Router# show translate
Translate From: LAT Service2
To:
PPP 172.21.2.2 keepalive 0
0/0 users active, 0 peak, 0 total, 0 failures
Related Commands
Command
Description
show translate
Displays configured translation sessions.
translate tcp
Translates a TCP connection request automatically to another outgoing protocol
connection.
translate x25
Translates an X.25 connection request automatically to another outgoing protocol
connection.
x29 access-list
Limits access to the access server from certain X.25 hosts.
x29 profile
Creates a PAD profile script for use by the translate command.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-169
Terminal Services Commands
translate lat (virtual access interfaces)
translate lat (virtual access interfaces)
When receiving a local-area transport (LAT) connection request to a service name, to set up the Cisco
router to automatically translate the request to another outgoing protocol connection type, use the
translate lat command in global configuration mode. To remove or change the translation request, use
the no form of this command.
The command syntax that follows shows how to apply a virtual interface template in place of outgoing
translate options. If you are using virtual templates for protocol translation, all outgoing options are
defined in the virtual interface template. Table 41 lists all outgoing options and their corresponding
interface configuration commands.
translate lat incoming-service-name [incoming-options] virtual-template number
[global-options]
no translate lat incoming-service-name [incoming-options] virtual-template number
[global-options]
Syntax Description
incoming-service-name
A LAT service name. When used on the incoming portion of the
translate lat command, service-name is the name of the service that
users specify when trying to make a translated connection. This name
can match the name of the final destination resource, but this match is
not required. Such matches can be useful when making remote translated
connections.
incoming-options
(Optional) An incoming connection request option. For LAT, the only
keyword currently supported is:
•
unadvertised—Prevents service advertisements from being
broadcast to the network. This keyword can be useful, for example,
when you define translations for many printers, and you do not want
these services advertised to other LAT terminal servers. (VMS
systems will be able to connect to the service even though it is not
advertised.)
virtual-template number
Applies the virtual interface template specified by the number argument
in place of outgoing options.
global-options
(Optional) Translation options that can be used by any connection type
and can be one or more of the following:
•
access-class number—Allows the incoming call to be used by
source hosts that match the access list parameters. The argument
number is an integer previously assigned to an access list. Standard
access list numbers are in the range from1 to 99; expanded standard
access lists numbers are in the range 1300 to 1999.
•
max-users number—Limits the number of simultaneous users of
the translation to number (an integer you specify).
•
local—Allows Telnet protocol negotiations to not be translated.
•
login—Requires that the user log in before the outgoing connection
is made. This type of login is specified on the virtual terminal lines
with the login command.
•
quiet—Suppresses printing of user-information messages.
Cisco IOS Terminal Services Command Reference
TR-170
78-12094-02
Terminal Services Commands
translate lat (virtual access interfaces)
Defaults
No default translation parameters
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
Usage Guidelines
You define the protocol translation connections by choosing a protocol keyword and supplying the
appropriate address, host name, or service name. The protocol connection information is followed by
optional features for that connection, as appropriate. For example, the binary keyword is only
appropriate with TCP/IP connections. The global options, in general, apply to all the connection types,
but there are exceptions.
Rather than specifying outgoing translation options in the translate command, configure these options
as interface configuration commands under the virtual interface template, then apply the virtual
interface template to the translate command. Table 41 maps outgoing translate command options to
interface commands you can configure in the virtual interface template.
Table 41
Examples
Mapping Outgoing translate lat Options to Interface Commands
translate lat Command
Options
Corresponding Interface Configuration Command
ip-pool
peer default ip address {ip-address | dhcp | pool [poolname]}
header-compression
ip tcp header compression [on | off | passive]
routing
ip routing or ipx routing
mtu
mtu
keepalive
keepalive
authentication {chap | pap}
ppp authentication {chap | pap}
ppp use-tacacs
ppp use-tacacs
ipx loopback
ipx ppp-client loopback number
The following example configures PPP tunneling from a PC across a LAT network. The remote PC is
given the IP address 10.12.118.12 when it dials in. The unadvertised keyword prevents broadcast of
service advertisements to other servers.
interface Virtual-Template1
ip unnumbered Ethernet0
peer default ip address 10.12.118.12
ppp authentication chap
!
translate lat pt-printer1 unadvertised virtual-template 1
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-171
Terminal Services Commands
translate lat (virtual access interfaces)
Related Commands
Command
Description
show translate
Displays configured translation sessions.
translate tcp
Translates a TCP connection request automatically to another outgoing protocol
connection.
translate x25
Translates an X.25 connection request automatically to another outgoing protocol
connection.
x29 access-list
Limits access to the access server from certain X.25 hosts.
x29 profile
Creates a PAD profile script for use by the translate command.
Cisco IOS Terminal Services Command Reference
TR-172
78-12094-02
Terminal Services Commands
translate tcp
translate tcp
To translate a connection request to another protocol connection type when receiving a TCP connection
request to a particular destination address or host name, use the translate tcp command in global
configuration mode. To remove or change the translation request, use the no form of this command.
translate tcp incoming-address [incoming-options] protocol outgoing-address [outgoing-options]
[global-options]
no translate tcp incoming-address [incoming-options] protocol outgoing-address
[outgoing-options] [global-options]
Syntax Description
incoming-address
Standard IP address in standard, four-part dotted decimal notation. The IP
address cannot be in use by other routers, and it should be on a connected subnet.
incoming-options
(Optional) An incoming connection request option. Choices are as follows:
•
binary—Negotiates Telnet binary mode on the Telnet connection. (This was
the default in previous versions of the protocol translation software and is set
automatically when you enter a translate command in the previous format.)
•
port number—The number of the port to match for incoming connections.
The default is port 23 (Telnet). For outgoing connections, enter the number
of the port to use. The default is port 23.
•
printer—Supports local-area transport (LAT) and X.25 printing over a TCP
network among multiple sites. This keyword causes the protocol translation
software to delay the completion of an incoming Telnet connection until
after the outgoing protocol connection (to LAT or X.25) has been
successfully established. An unsuccessful outgoing connection attempt
results in the TCP connection to the router being refused, rather than being
accepted and then closed, which is the default behavior. Note that using this
keyword will force the global quiet keyword to be applied to the translation.
•
stream—Performs stream processing, which enables a raw TCP stream with
no Telnet control sequences. A stream connection does not process or
generate any Telnet options, and also prevents Telnet processing of the data
stream. This keyword might be useful for connections to ports running the
UNIX-to-UNIX Copy Program (UUCP) or other non-Telnet protocols, or to
ports connected to printers. For ports connected to printers using Telnet, the
stream keyword prevents some of the problems associated with using Telnet
for printers, such as unusual events happening to carriage returns or line
feeds and echoing of data back to VMS systems.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-173
Terminal Services Commands
translate tcp
protocol
outgoing-address
A protocol name followed by an address or host name. Protocol translation
choices are: lat, ppp, slip, and x25.
Additional keywords that can be entered with the protocol are as follows:
•
autocommand—Specifies an EXEC command for an outgoing connection.
The command executes upon connection to a host. You can issue any EXEC
command and any switch or host name as an argument to the autocommand
keyword. If the string following autocommand has one or more spaces as
part of the string, you must place quotation marks (“ ”) around the string. If
you want to enable AppleTalk Remote Access (ARA) on an outgoing
connection, specify the autocommand arap keywords. These keywords are
necessary for ARA because ARA does not use addressing, and this option
permits you to invoke the ARA string.
•
virtual-template—Associates a virtual template with a virtual access
interface. See the translate tcp (virtual access interfaces) command
description for more information.
outgoing-options
(Optional) Outgoing connection request options. Choices depend upon the
protocol or command entered. See Table 42, Table 43, Table 44, and Table 45 for
more information.
global-options
(Optional) One or more of the following translation options can be used by any
connection type:
•
access-class number—Allows the incoming call to be used by source hosts
that match the access list parameters. The argument number is an integer
previously assigned to an access list. Standard access list numbers are in the
range from1 to 99; expanded standard access lists numbers are in the range
1300 to 1999.
•
local—Allows Telnet protocol negotiations to not be translated.
•
login—Requires that the user log in before the outgoing connection is made.
This type of login is specified on the virtual terminal lines with the login
command.
•
max-users number—Limits the number of simultaneous users of the
translation to number (an integer you specify).
•
quiet—Suppresses printing of user-information messages.
•
swap—Valid for TCP-to-X.25 translations only, and allows X.3 parameters
to be set on the router by the host originating the X.25 call, or by an X.29
profile. This configuration enables incoming and outgoing X.25 connections
to be swapped so that the device is treated like a PAD when it accepts a call.
By default, the router functions like a PAD for calls that it initiates, and like
an X.25 host for calls it accepts. The swap keyword allows connections from
an X.25 host that wants to connect to the router, and then treats it like a PAD.
Defaults
No default translation parameters
Command Modes
Global configuration
Cisco IOS Terminal Services Command Reference
TR-174
78-12094-02
Terminal Services Commands
translate tcp
Command History
Usage Guidelines
Release
Modification
10.0
This command was introduced.
12.1
The no-reset permanent virtual circuits (PVCs) subkeyword was added to
support outgoing PVCs.
You define protocol translation connections by supplying a protocol keyword and the address, host
name, or service name. A TCP protocol translation command can be as simple as the following
example:
Router(config)# translate tcp 10.1.1.1 X.25 1236672
However, the Cisco IOS software provides a broad range of options that support protocol translations
in many networking environments. Table 42, Table 43, Table 44, and Table 45 list the translate tcp
translation options by protocol.
You can also use the Cisco IOS command-line interface to help you understand how these keywords are
entered. In global configuration mode, begin entering the translate command and add a question mark
at each portion of the command to display the options available. Some examples follow:
Router(config)# translate tcp ?
Hostname or A.B.C.D
IP address
Router(config)# translate tcp 1.1.1.1 ?
autocommand
binary
lat
port
ppp
printer
slip
stream
tcp
virtual-template
x25
Associate a command with a translation on this connections
Negotiate Telnet binary mode on the connection
DEC LAT protocol
Port Number
Virtual async PPP
Enable non-interactive (implies global quiet)
Virtual async SLIP
Enable stream processing
TCP/IP Telnet
Associate a virtual template with virtual access interface
X.25
Router(config)# translate tcp 1.1.1.1 lat LAT-1 ?
access-class
local
login
max-users
node
port
quiet
unadvertised
Note
Allow access list parameters to be used by source hosts
Allow Telnet protocol negotiations not to be translated
Require that the user log in before the outgoing connection is
made
Limit the number of simultaneous users of the translation
LAT node name
LAT port name
Suppress printing of user-information messages
Prevent service advertisements from being broadcast to the
network
If you plan to translate to X.25 on a permanent virtual circuit (PVC), see the description for the
translate x25 command for important configuration notes.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-175
Terminal Services Commands
translate tcp
Table 42
TCP-to-LAT Outgoing Options
Outgoing LAT Translation
lat service-name
Translates TCP to the LAT protocol.The software must learn the service name through LAT service
advertisements before it can use the service.
Outgoing LAT Connection Request Options
Any of the following optional keywords can be used to configure LAT connection requests:
•
node name—Connects to the specified node that offers a LAT service. By default, the connection
is made to the highest-rated node that offers the service.
•
port name—Destination LAT port name in the format of the remote system. This parameter is
usually ignored in most time-sharing systems, but is used by terminal servers that offer
reverse-LAT services.
•
unadvertised—Prevents LAT service advertisements from being broadcast to the network.
Table 43
TCP-to-PPP Outgoing Options
Outgoing PPP Translation
ppp {ip-address | ip-pool [scope-name name]}
Translates from TCP to virtual asynchronous PPP. Supply an IP address as a standard, four-part dotted
decimal IP address.
The ip-pool keyword obtains an IP address from a Dynamic Host Configuration Protocol (DHCP)
proxy client or a local pool. If the scope-name keyword is not specified, the address is obtained from
a DHCP proxy client. If the scope-name keyword is specified, the IP address is obtained from the
specified local pool. The scope-name keyword can specify a range of IP addresses.
Outgoing PPP Connection Request Options
Any of the following optional keywords can be used to configure PPP connection requests:
•
authentication {pap | chap}—Sets Challenge Handshake Authentication Protocol (CHAP) or
Password Authentication Protocol (PAP) authentication for PPP on virtual asynchronous
interfaces. If you specify both keywords, order is significant; the system will try to use the first
authentication type, then the second.
•
header-compression [passive]—Implements header compression on IP packets only. The
passive keyword permits compression on outgoing packets only if incoming TCP packets on the
same virtual asynchronous interface are compressed. The default (without the passive keyword)
permits compression on all traffic.
•
ipx loopback number—Specifies the loopback interface to be created and permits clients running
IPX-PPP to connect through virtual terminal lines on the router. A loopback interface must have
been created and configured with a Novell IPX network number before IPX-PPP can work on the
virtual terminal line. The virtual terminal line is assigned to the loopback interface.
•
keepalive number-of-seconds—Specifies the interval at which keepalive packets are sent on
Serial Line Internet Protocol (SLIP) and PPP virtual asynchronous interfaces. By default,
keepalive packets are enabled and sent every 10 seconds. To shut off keepalive packets, use a value
of 0. The active keepalive interval is 1 through 32,767 seconds. When you do not change from the
default of 10, the keepalive interval does not appear in more system:running-config or show
translate command output.
Cisco IOS Terminal Services Command Reference
TR-176
78-12094-02
Terminal Services Commands
translate tcp
Table 43
TCP-to-PPP Outgoing Options (continued)
•
mtu bytes—Sets the interface maximum transmission unit (MTU) of packets that the virtual
asynchronous interface supports. The default MTU is 1500 bytes on a virtual asynchronous
interface. The acceptable range is from 64 to 1,000,000 bytes.
•
routing—Permits routing updates between connections. This keyword is required if the
destination device is not on a subnet connected to one of the interfaces on the router.
•
use-tacacs—Uses TACACS to verify PPP authentications for CHAP or PAP on virtual
asynchronous interfaces.
Table 44
TCP-to-SLIP Outgoing Options
Outgoing SLIP Translation
slip {ip-address | ip-pool [scope-name name]}
Translates from TCP to virtual asynchronous SLIP. Supply an IP address as a standard, four-part dotted
decimal IP address.
The ip-pool keyword obtains an IP address from a DHCP proxy client or a local pool. If the optional
scope-name keyword is not specified, the address is obtained from a DHCP proxy client. If the
scope-name keyword is specified, the IP address is obtained from the specified local pool. The
scope-name keyword can specify a range of IP addresses.
Note
The slip keyword applies only to outgoing connections; SLIP is not supported on incoming
protocol translation connections.
Outgoing SLIP Connection Request Options
Any of the following optional keywords can be used to configure SLIP connection requests:
•
header-compression [passive]—Implements header compression on IP packets only. The
passive keyword permits compression on outgoing packets only if incoming TCP packets on the
same virtual asynchronous interface are compressed. The default (without the passive keyword)
permits compression on all traffic.
•
ipx loopback number—Specifies the loopback interface to be created and permits clients running
IPX-PPP over X.25 to connect through virtual terminal lines on the router. A loopback interface
must have been created and configured with a Novell IPX network number before IPX-PPP can
work on the virtual terminal line. The virtual terminal line is assigned to the loopback interface.
•
keepalive number-of-seconds—Specifies the interval at which keepalive packets are sent on SLIP
and PPP virtual asynchronous interfaces. By default, keepalive packets are enabled and sent every
10 seconds. To shut off keepalive packets, use a value of 0. The active keepalive interval is 1
through 32,767 seconds. When you do not change from the default of 10, the keepalive interval
does not appear in more system:running-config or show translate command output.
•
mtu bytes—Sets the interface MTU of packets that the virtual asynchronous interface supports.
The default MTU is 1500 bytes on a virtual asynchronous interface. The acceptable range is from
64 to 1,000,000 bytes.
•
routing—Permits routing updates between connections. This keyword is required if the
destination device is not on a subnet connected to one of the interfaces on the router.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-177
Terminal Services Commands
translate tcp
Table 45
TCP-to-X.25 Outgoing Options
Outgoing X.25 Translation
x25 x.121-address
Translates TCP to the X.25 protocol. Supply an X.121 address that conforms to the specifications
provided in the CCITT 1984 Red Book, or the name of an X.25 host that can be resolved by the DNS,
or explicit specification in an x25 host command.
The address number generally consists of a portion that is administered by the public data network
(PDN) and a portion that is locally assigned. You must be sure that the numbers that you assign agree
with the addresses assigned to you by the X.25 service provider. The X.121 addresses generally will
be subaddresses of the X.121 address for the X.25 network interface.
Outgoing X.25 Connection Request Options
Any of the following optional keywords can be used to configure X.25 connection requests:
•
cud c-u-data—Sends the specified X.25 Call User Data (CUD) text as part of an outgoing call
request after the protocol identification bytes.
•
no-reverse—Specifies that outgoing calls not request the X.25 reverse charge facility, when the
interface default is that all outgoing calls are reverse charged.
•
profile profile—Sets the X.3 packet assembler/disassembler (PAD) parameters as defined in the
profile created by the x29 profile command.
•
pvc number [interface serial number | packetsize in-size out-size | windowsize in-size out-size |
no-reset]—Specifies that the outgoing connection is actually a PVC. The number argument
specifies the virtual circuit channel number of the incoming connection, which must be less than
the virtual circuits assigned to the switched virtual circuit (SVC).Only one session is allowed per
PVC. Use the following optional keywords to further define the connection:
– interface serial number—Specifies a PVC interface on which to set up the PVC connection.
– packetsize in-size out-size—Specifies the input packet size (in-size) and output packet size
(out-size) for the PVC. Valid packet size values are: 16, 32, 64, 128, 256, 512, 1024, 2048,
and 4096.
– windowsize in-size out-size—Specifies the packet count for input windows (in-size) and
output windows (out-size) for the outgoing translation. Values of in-size and out-size range
from 1 to 127 and must not be greater than the value set for the x25 modulo command. You
must specify the same value for in-size and out-size.
– no-reset—Causes the Cisco router to send a no Reset packet request at startup of a TCP or
LAT to PVC translation session.
•
reverse—Provides reverse charging for X.25 on a per-call rather than a per-interface basis.
Requests reverse charges on a specified X.121 address, even if the serial interface is not
configured to request reverse charge calls.
•
use-map—Applies x25 map pad command entry options (such as CUD and idle) and facilities
(such as packet in, packet out, win in, and win out) to the outgoing protocol translation call. When
the use-map keyword is specified on the translate command, the Destination address and
optional PAD Protocol Identification (PID), CUD, and facilities are checked against a configured
list of x25 map pad command entries. If a match is found, the map entry PID, CUD, and facilities
are applied to the outgoing protocol translation call. The X.25 map facilities applied to the
outgoing translation can be displayed with the show translation command throughout the
duration of the translation session.
Cisco IOS Terminal Services Command Reference
TR-178
78-12094-02
Terminal Services Commands
translate tcp
Examples
The following example illustrates the use of the TCP incoming protocol printer keyword for an
incoming TCP connection:
translate tcp 172.19.32.250 printer x25 5678
The following example permits clients running IPX-PPP to connect through the device virtual terminal
lines to a server running PPP:
interface loopback0
no ip address
ipx network 544
ipx sap-interval 2000
!
translate tcp 172.21.14.67 port 1234 ppp 10.0.0.2 ipx loopback0
Related Commands
Command
Description
show translate
Displays configured translation sessions.
translate lat
Translates a LAT connection request automatically to another outgoing protocol
connection.
translate x25
Translates an X.25 connection request automatically to another outgoing protocol
connection.
x29 access-list
Limits access to the access server from certain X.25 hosts.
x29 profile
Creates a PAD profile script for use by the translate command.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-179
Terminal Services Commands
translate tcp (virtual access interfaces)
translate tcp (virtual access interfaces)
When receiving a TCP connection request to a particular destination address or host name, to set up the
Cisco router to automatically translate the request to another outgoing protocol connection type, use the
translate tcp command in global configuration mode. To remove or change the translation request, use
the no form of this command.
The command syntax that follows shows how to apply a virtual interface template in place of outgoing
translate options. If you are using virtual templates for protocol translation, all outgoing options are
defined in the virtual interface template.
translate tcp incoming-address [incoming-options] virtual-template number [global-options]
no translate tcp incoming-address [incoming-options] virtual-template number [global-options]
Syntax Description
incoming-address
TCP/IP Telnet and a standard IP address or host name. The ip-address argument
is a standard, four-part dotted decimal IP address or the name of an IP host that
can be resolved by the Domain Name System (DNS) or explicit specification in
an ip host command.
incoming-options
(Optional) Incoming connection request options. These arguments can have the
following values:
virtual-template
number
•
binary—Negotiates Telnet binary mode on the Telnet connection. (This was
the default in previous versions of the Cisco IOS software and is set
automatically when you enter a translate command in the old format.)
•
port number—For incoming connections, enter the number of the port to
match. The default is port 23 (Telnet). For outgoing connections, enter the
number of the port to use. The default is port 23.
•
printer—Supports LAT and X.25 printing over a TCP network among
multiple sites. This keyword causes the protocol translation software to delay
the completion of an incoming Telnet connection until after the outgoing
protocol connection (to LAT or X.25) has been successfully established. An
unsuccessful outgoing connection attempt results in the TCP connection to
the router being refused, rather than being accepted and then closed, which is
the default behavior. Note that using this keyword will force the global quiet
keyword to be applied to the translation.
•
stream—Performs stream processing, which enables a raw TCP stream with
no Telnet control sequences. A stream connection does not process or
generate any Telnet options, and also prevents Telnet processing of the data
stream. This keyword might be useful for connections to ports running the
UNIX-to-UNIX Copy Program (UUCP) or other non-Telnet protocols, or to
ports connected to printers. For ports connected to printers using Telnet, the
stream keyword prevents some of the problems associated with using Telnet
for printers, such as unusual events happening to carriage returns or line feeds
and echoing of data back to VMS systems.
Applies the virtual interface template specified by the number argument in place
of outgoing options.
Cisco IOS Terminal Services Command Reference
TR-180
78-12094-02
Terminal Services Commands
translate tcp (virtual access interfaces)
global-options
(Optional) One or more of the following translation options can be used by any
connection type:
•
access-class number—Allows the incoming call to be used by source hosts
that match the access list parameters. The argument number is an integer
previously assigned to an access list. Standard access list numbers are in the
range from1 to 99; expanded standard access lists numbers are in the range
1300 to 1999.
•
local—Allows Telnet protocol negotiations to not be translated.
•
login—Requires that the user log in before the outgoing connection is made.
This type of login is specified on the virtual terminal lines with the login
command.
•
max-users number—Maximum number of simultaneous users of the
translation.
•
quiet—Suppresses printing of user-information messages.
•
swap—Valid for TCP-to-X.25 translations only, and allows X.3 parameters
to be set on the router by the host originating the X.25 call, or by an X.29
profile. This configuration enables incoming and outgoing X.25 connections
to be swapped so that the device is treated like a PAD when it accepts a call.
By default, the router functions like a PAD for calls that it initiates, and like
an X.25 host for calls it accepts. The swap keyword allows connections from
an X.25 host that wants to connect to the router, and then treats it like a PAD.
Defaults
No default translation parameters
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
Usage Guidelines
You define the protocol translation connections by choosing a protocol keyword and supplying the
appropriate address, host name, or service name. The protocol connection information is followed by
optional features for that connection, as appropriate. For example, the binary keyword is only
appropriate with TCP/IP connections. The global options, in general, apply to all the connection types,
but there are exceptions.
Examples
The following example illustrates the use of the TCP incoming printer keyword for an incoming TCP
connection:
interface Virtual-Template1
ip unnumbered Ethernet0
peer default ip address 10.12.108.1
ppp authentication chap
translate tcp 172.19.32.250 printer Virtual-Template1
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-181
Terminal Services Commands
translate tcp (virtual access interfaces)
Related Commands
Command
Description
show translate
Displays configured translation sessions.
translate tcp
Translates a TCP connection request automatically to another outgoing
protocol connection.
translate x25
Translates an X.25 connection request automatically to another outgoing
protocol connection.
x29 access-list
Limits access to the access server from certain X.25 hosts.
x29 profile
Creates a PAD profile script for use by the translate command.
Cisco IOS Terminal Services Command Reference
TR-182
78-12094-02
Terminal Services Commands
translate x25
translate x25
To translate a connection request to another protocol connection type when receiving an X.25
connection request to a particular destination address or host name, use the translate x25 command in
global configuration mode. To remove or change the translation request, use the no form of this
command.
translate x25 incoming-address [incoming-options [pvc number [pvc-options]]] protocol
outgoing-address [outgoing-options] [global-options]
no translate x25 incoming-address [incoming-options [pvc number [pvc-options]]] protocol
outgoing-address [outgoing-options] [global-options]
Syntax Description
incoming-address
An X.25 and X.121 address that conform to specifications provided in the
CCITT 1984 Red Book.
This address generally consists of a portion that is administered by the PDN
and a portion that is locally assigned. You must be sure that the numbers that
you assign agree with the addresses assigned to you by the X.25 service
provider. The X.121 addresses generally will be subaddresses of the X.121
address for the X.25 network interface. Typically, the interface address will be
a 12-digit number. Any additional digits are interpreted as a subaddress. The
PDN still routes these calls to the interface, and the Cisco IOS software is
responsible for interpreting the extra digits.
Do not use the same address on the interface and for translation.
incoming-options
(Optional) An incoming connection request option. Choices are as follows:
•
accept-reverse—Accepts reverse charged calls on an X.121 address even
if the serial interface is not configured to accept reverse charged calls.
•
cud c-u-data—Specifies the Call User Data (CUD) field to match in the
X.25 Incoming Call packet. If not configured, the CUD in the Incoming
Call packet must be blank.
•
idle minutes—Specifies the number of minutes the virtual circuit is idle.
This keyword enables the protocol translation function to clear a switched
virtual circuit after a set period of inactivity, where minutes is the number
of minutes in the period. Calls either originated or terminated are cleared.
The maximum value of minutes is 255. The default value of minutes is
zero.
•
printer—Supports local-area transport (LAT) and TCP printing over an
X.25 network among multiple sites. Provides an “interlock mechanism”
between the acceptance of an incoming X.25 connection and the opening
of an outgoing LAT or TCP connection. This keyword causes the
Cisco IOS software to delay the call confirmation of an incoming X.25
call request until after the outgoing protocol connection (to TCP or LAT)
has been successfully established. An unsuccessful outgoing connection
attempt to the router results in the incoming X.25 connection being
refused, rather than being accepted and then closed, which is the default
behavior. Note that using this keyword will force the global quiet
keyword to be applied to the translation.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-183
Terminal Services Commands
translate x25
•
profile profile—Sets the X.3 packet assembler/disassembler (PAD)
parameters as defined in the profile created by the x29 profile command.
•
pvc number [interface serial number | packetsize in-size out-size |
windowsize in-size out-size ]—Specifies that the outgoing connection is
actually a PVC. The number argument specifies the virtual circuit channel
number of the connection, which must be less than the virtual circuits
assigned to the switched virtual circuit (SVC).Only one session is allowed
per PVC. Use the following optional keywords to further define the
connection:
– interface serial number—Specifies a PVC interface on which to set
up the PVC connection.
– packetsize in-size out-size—Specifies the input packet size (in-size)
and output packet size (out-size) for the PVC. Valid packet size values
are as follows: 16, 32, 64, 128, 256, 512, 1024, 2048, and 4096.
– windowsize in-size out-size—Specifies the packet count for input
windows (in-size) and output windows (out-size) for the outgoing
translation. Values of in-size and out-size range from 1 to 127 and
must not be greater than the value set for the x25 modulo command.
You must specify the same value for in-size and out-size.
protocol
outgoing-address
A protocol name followed by an address or host name. Protocol translation
choices are lat, ppp, slip, and tcp.
The host name is translated to an address during configuration,
unless you are translating to TCP and use the host-name keyword,
which allows the host name to be resolved at connection time
instead of configuration time. See Table 49 for more information
about the host-name keyword.
Note
Additional keywords that can be entered with the protocol are as follows:
•
autocommand—Specifies an EXEC command for an outgoing
connection. The command executes upon connection to a host. You can
issue any EXEC command and any switch or host name as an argument to
the autocommand keyword. If the string following autocommand has
one or more spaces as part of the string, you must place quotation marks
(“ ”) around the string. If you want to enable AppleTalk Remote Access
(ARA) on an outgoing connection, specify the autocommand arap
keywords. These keywords are necessary for ARA because ARA does not
use addressing, and this option permits you to invoke the ARA string.
•
virtual-template—Associates a virtual template with a virtual access
interface. See the translate x25 (virtual access interfaces) command
description for more information.
Cisco IOS Terminal Services Command Reference
TR-184
78-12094-02
Terminal Services Commands
translate x25
outgoing-options
(Optional) Outgoing connection request option. Choices depend upon the
protocol or command entered. See Table 46,Table 47, Table 48, and Table 49
for a list of outgoing protocol translation options.
global-options
(Optional) One or more of the following translation options can be used by any
connection type:
•
access-class number—Allows the incoming call to be used by source
hosts that match the access list parameters. The argument number is an
integer previously assigned to an access list. Standard access list numbers
are in the range from1 to 99; expanded standard access lists numbers are
in the range 1300 to 1999.
•
local—Allows Telnet protocol negotiations to not be translated.
•
login—Requires that the user log in before the outgoing connection is
made. This type of login is specified on the virtual terminal lines with the
login command.
•
max-users number—Limits the number of simultaneous users of the
translation to number (an integer you specify).
•
quiet—Suppresses printing of user-information messages.
•
swap—Valid for X.25-to-TCP translations only, and allows X.3
parameters to be set on the router by the host originating the X.25 call, or
by an X.29 profile. This configuration enables incoming and outgoing
X.25 connections to be swapped so that the device is treated like a PAD
when it accepts a call. By default, the router functions like a PAD for calls
that it initiates, and like an X.25 host for calls it accepts. The swap
keyword allows connections from an X.25 host that wants to connect to
the router, and then treats it like a PAD.
Defaults
No default translation parameters.
Command Modes
Global configuration
Command History
Release
Modification
10.0
This command was introduced.
Usage Guidelines
You define protocol translation connections by supplying a protocol keyword and the address, host
name, or service name. An X.25 protocol translation command can be as simple as the following
example:
Router(config)# translate X.25 1236672 tcp 1.1.1.1
However, the Cisco IOS software provides a broad range of options that support protocol translations
in many networking environments. Table 46, Table 47, Table 48, and Table 49 lists the translate x25
translation options by protocol.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-185
Terminal Services Commands
translate x25
You can also use the Cisco IOS command-line interface to help you understand how these keywords are
entered. In global configuration mode, begin entering the translate command and add a question mark
at each portion of the command to display the options available. Some examples follow:
Router(config)# translate x25 ?
WORD
X.121 Address pattern
Router(config)# translate x25 66666 ?
accept-reverse
autocommand
cud
idle
lat
ppp
printer
profile
pvc
slip
tcp
virtual-template
x25
Accept reverse charge on a per-call basis
Associate a command with a translation on this connections
Specify the Call User Data (CUD)
Specify VC idle timer
DEC LAT protocol
Virtual async PPP
Enable non-interactive (implies global quiet)
Use a defined X.3 profile
An incoming connection is actually a PVC
Virtual async SLIP
TCP/IP Telnet
Associate a virtual template with virtual access interface
X.25
Router(config)# translate x25 66666 tcp 1.1.1.1 ?
access-class
binary
host-name
local
login
max-users
multibyte-IAC
port
quiet
source-interface
stream
swap
Table 46
Allow access list parameters to be used by source hosts
Negotiate Telnet binary mode on the connection
Store the host name rather than its IP address
Allow Telnet protocol negotiations not to be translated
Require that the user log in before the outgoing connection
is made
Limit the number of simultaneous users of the translation
Always treat multiple IACs as telnet command
Port Number
Suppress printing of user-information messages
Specify source interface
Treat telnet escape characters as data
Allow X.3 parameters to be set on the protocol translator
by the host originating the X.25 call
X.25-to-LAT Outgoing Options
Outgoing LAT Translation
lat service-name
Translates X.25 to the LAT protocol.The software must learn the service name through LAT service
advertisements before it can use the service.
Outgoing LAT Connection Request Options
Any of the following optional keywords can be used to configure LAT connection requests:
•
node name—Connects to the specified node that offers a LAT service. By default, the connection
is made to the highest-rated node that offers the service.
•
port name—Destination LAT port name in the format of the remote system. This parameter is
usually ignored in most time-sharing systems, but is used by terminal servers that offer
reverse-LAT services.
•
unadvertised—Prevents LAT service advertisements from being broadcast to the network.
Cisco IOS Terminal Services Command Reference
TR-186
78-12094-02
Terminal Services Commands
translate x25
Table 47
X.25-to-PPP Outgoing Options
Outgoing PPP Translation
ppp {ip-address | ip-pool [scope-name name]}
Translates from X.25 to virtual asynchronous PPP. Supply an IP address as a standard, four-part dotted
decimal IP address.
The ip-pool keyword obtains an IP address from a Dynamic Host Configuration Protocol (DHCP)
proxy client or a local pool. If the optional scope-name keyword is not specified, the address is
obtained from a DHCP proxy client. If the scope-name keyword is specified, the IP address is
obtained from the specified local pool. The scope-name keyword can specify a range of IP addresses.
Outgoing PPP Connection Request Options
Any of the following optional keywords can be used to configure PPP connection requests:
•
authentication {pap | chap}—Sets Challenge Handshake Authentication Protocol (CHAP) or
Password Authentication Protocol (PAP) authentication for PPP on virtual asynchronous
interfaces. If you specify both options, order is significant; the system will try to use the first
authentication type, then the second.
•
header-compression—Configures header compression on IP packets only.
•
ipx loopback number—Specifies the loopback interface to be created and permits clients running
IPX-PPP over X.25 to connect through virtual terminal lines on the router. A loopback interface
must have been created and configured with a Novell IPX network number before IPX-PPP can
work on the virtual terminal line. The virtual terminal line is assigned to the loopback interface.
•
keepalive number-of-seconds—Specifies the interval at which keepalive packets are sent on
Serial Line Internet Protocol (SLIP) and PPP virtual asynchronous interfaces. By default,
keepalive packets are enabled and sent every 10 seconds. To shut off keepalive packets, use a value
of 0. The active keepalive interval is 1 through 32,767 seconds. When you do not change from the
default of 10, the keepalive interval does not appear in more system:running-config or show
translate command output.
•
mtu bytes—Sets the interface MTU of packets that the virtual asynchronous interface supports.
The default MTU is 1500 bytes on a virtual asynchronous interface. The acceptable range is from
64 to 1,000,000 bytes.
•
routing—Permits routing updates between connections. This option is required if the destination
device is not on a subnet connected to one of the interfaces on the router.
•
use-tacacs—Uses TACACS to verify PPP authentications for CHAP or PAP on virtual
asynchronous interfaces.
Cisco IOS Terminal Services Command Reference
78-12094-02
TR-187
Terminal Services Commands
translate x25
Table 48
X.25-to-SLIP Outgoing Options
Outgoing SLIP Translation
slip {ip-address | ip-pool [scope-name name]}
Translates from X.25 to virtual asynchronous SLIP. Supply an IP address as a standard, four-part
dotted decimal IP address.
The ip-pool keyword obtains an IP address from a DHCP proxy client or a local pool. If the optional
scope-name keyword is not specified, the address is obtained from a DHCP proxy client. If the
scope-name keyword is specified, the IP address is obtained from the specified local pool. The
scope-name keyword can specify a range of IP addresses.
The slip argument applies only to outgoing connections; SLIP is not supported on
incoming protocol translation connections.
Note
Outgoing SLIP Connection Request Options
Any of the following optional keywords can be used to configure SLIP connection requests:
•
header-compression [passive]—Implements header compression on IP packets only. The
passive keyword permits compression on outgoing packets only if incoming TCP packets on the
same virtual asynchronous interface are compressed. The default (without the passive keyword)
permits compression on all traffic.
•
ipx loopback number—Specifies the loopback interface to be created and permits clients running
IPX-PPP over X.25 to connect through virtual terminal lines on the router. A loopback interface
must have been created and configured with a Novell IPX network number before IPX-PPP can
work on the virtual terminal line. The virtual terminal line is assigned to the loopback interface.
•
keepalive number-of-seconds—Specifies the interval at which keepalive packets are sent on SLIP
and PPP virtual asynchronous interfaces. By default, keepalive packets are enabled and sent every
10 seconds. To shut off keepalive packets, use a value of 0. The active keepalive interval is 1
through 32,767 seconds. When you do not change from the default of 10, the keepalive interval
does not appear in more system:running-config or show translate command output.
•
mtu bytes—Sets the interface MTU of packets that the virtual asynchronous interface supports.
The default MTU is 1500 bytes on a virtual asynchronous interface. The acceptable range is from
64 to 1,000,000 bytes.
•
routing—Permits routing updates between connections. This keyword is required if the
destination device is not on a subnet connected to one of the interfaces on the router.
Table 49
X.25-to-TCP Outgoing Options
Outgoing TCP Translation
tcp ip-address
Translates X.25 to TCP/IP Telnet. Supply an IP address as a standard, four-part dotted decimal IP
address, or the name of an IP host that can be resolved by the DNS, or explicit specification in an ip
host command (refer to the description for the host-name keyword in the “Outgoing TCP Connection
Request Options” section).
Cisco IOS Terminal Services Command R