Syntax Description

incoming-service-name	A LAT service name. When used on the incoming portion, 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 final destination resource, but this is not required. This can be useful when making remote translated connections.
in-option	(Optional) Incoming connection request option: unadvertised---Prevents service advertisements from being broadcast to the network. This 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 IP address or host name. The host name is translated to an IP address during configuration, unless you use the tcp host-name option, which allows load balancing by dynamically resolving an IP address from a host name. These arguments can have the following values: x25 X.121-address---X.25 and an X.121 address. The X.121 address must conform to specifications provided in the CCITT 1984 Red Book. This number 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 will generally 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 itself is responsible for dealing with the extra digits appropriately. tcp ip-address---TCP/IP Telnet and a standard IP address or host name. The argument ip-address 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. slip ip-address---The argument ip-address 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).
	ppp ip-address---The argument ip-address 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). autocommand---Enables you to specify a string for an outgoing connection. The string executes upon connection to a host. If you want to enable ARA on an outgoing connection, you need to specify autocommand arap. The autocommand option is necessary for ARA, because ARA does not use addressing, and autocommand permits you to invoke the arap string. If the string following autocommand has one or more spaces as part of the string, you must place quotation marks (" ") around the string. For example, if you specify autocommand tn3270 abracadabra, you must enclose tn3270 abracadabra in quotes. The autocommand option applies only to outgoing connections. You can issue any EXEC command and any switch or host name as an argument to the autocommand option.
out-options	(Optional) Incoming and outgoing connection request options. These arguments can have the following values:
	X.25 translation options: cud c-u-data---Sends the specified Call User Data (CUD) text (c-u-data) as part of an outgoing call request after the protocol identification bytes. no-reverse---Specifies that outgoing calls are not to use reverse charging, when the interface default is that all outgoing calls are reverse charged. profile profile---Sets the X.3 PAD parameters as defined in the profile created by the x29 profile command. 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. This is an outgoing option only.
	Telnet TCP translation option: port number---For incoming connections, number of the port to match. The default is port 23 (any port). For outgoing connections, number of the port to use. The default is port 23 (Telnet).
	SLIP and PPP translation options: ip-pool---Obtain an IP address from a DHCP proxy client or a local pool. If the scope-name option is not specified, the address is obtained from a DHCP proxy client. If the scope-name option is specified, the IP address is obtained from the specified local pool. scope-name---Specific local scope name from which to obtain an IP address. Can specify a range of IP addresses. header-compression [passive]---Implements header compression on IP packets only. The option passive for SLIP connections permits compression on outgoing packets only if incoming TCP packets on the same virtual asynchronous interface are compressed. The default (without the passive option) permits compression on all traffic. 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. mtu bytes---Permits you to change the 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 64 through 1,000,000 bytes.
	More PPP translation options: keepalive number-of-seconds---Permits you to specify the interval at which keepalive packets are sent on SLIP and PPP virtual asynchronous interfaces. By default, keepalive packets are enabled and are sent every 10 seconds. To shut off keepalive packets, use a value of 0. The active keepalive interval is 1 through 32767 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 output authentication {chap | pap}---Use CHAP or 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. ppp use-tacacs---Enables TACACS authentication for CHAP or PAP on virtual asynchronous interfaces (for PPP only; TACACS authentication is not supported for SLIP).
	ipx loopback number---Permits clients running IPX-PPP over X.25 to connect through virtual terminal (VTY) lines on the router. The loopback number option specifies the loopback interface to be created. A loopback interface must have been created and configured with a Novell IPX network number before IPX-PPP can work on the VTY line. The VTY line is assigned to the loopback interface.
global-options	(Optional) Translation options that can be used by any connection type. It 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 the number (integer) previously assigned to an access list. The standard access list is 1-99. 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. rotor---Specifies a rotary among host-name addresses. login---Requires that the user log in before the outgoing connection is made. This type of login is specified on the VTY lines with the login command. 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.

Usage Guidelines

Examples

The following example illustrates incoming LAT to outgoing TCP translations. The unadvertised keyword prevents broadcast of service advertisements to other servers. Outgoing translated packets are transmitted to IP host rubble, TCP port 4005.

translate lat pt-printer1 unadvertised tcp rubble port 4005
          incoming        option        outgoing    option

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 rudolph slip 10.0.0.4 header-compression 
          incoming    outgoing     option

The following example first shows the command to disable keepalive packets on a PPP line, then shows sample output from the show translate command when keepalive packets have been turned off on the line.

translate lat ramble ppp 172.21.2.2 keepalive 0
.
.
router# show translate
 
Translate From: LAT ramble
          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.

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.
unadvertised	(Optional) The only incoming connection request option for LAT. Prevents service advertisements from being broadcast to the network. This 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 number in place of outgoing options.
global-options	(Optional) Translation options that can be used by any connection type. It 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 the number (integer) previously assigned to an access list. The standard access list is 1 to 99. 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. rotor---Specifies a rotary among host-name addresses. login---Requires that the user log in before the outgoing connection is made. This type of login is specified on the VTY lines with the login command. 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.

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 option 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 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 
          incoming         option         outgoing

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.

Syntax Description

incoming-address	TCP/IP Telnet and a standard IP address or host name. The argument ip-address 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.
in-options	(Optional) Incoming connection request options. These arguments can have the following values:
	Telnet TCP translation options: 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 at translate command in the old format.) port number---For incoming connections, number of the port to match. The default is port 23 (any port). For outgoing connections, number of the port to use. The default is port 23 (Telnet). printer---Supports LAT and X.25 printing over a TCP network among multiple sites. 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 option will force the global option quiet 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 prevents Telnet processing of the data stream as well. This option might be useful for connections to ports running UUCP or other non-Telnet protocols, or to ports connected to printers. For ports connected to printers using Telnet, the stream option prevents some of usual problems associated with using Telnet for printers, such as strange things happening to bare carriage returns or line feeds and echoing of data back to VMS systems.
protocol outgoing-address	Name of a protocol followed by a service name, IP address, or host name. The host name is translated to an IP address during configuration. These arguments can have the following values:
	lat service-name---LAT and a LAT service name. You must learn the service name, through LAT service advertisements, before you can use it. x25 X.121-address---X.25 and an X.121 address. The X.121 address must conform to specifications provided in the CCITT 1984 Red Book. This number 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 will generally be subaddresses of the X.121 address for the X.25 network interface. slip ip-address---The argument ip-address 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). The slip argument applies only to outgoing connections; SLIP is not supported on incoming protocol translation connections. ppp ip-address---The argument ip-address 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). The ppp argument applies only to outgoing connections; PPP is not supported for incoming protocol translation connections. autocommand---Enables you to specify a string for an outgoing connection. The string executes upon connection to a host. If you want to enable ARA on an outgoing connection, you need to specify autocommand arap. The autocommand option is necessary for ARA, because ARA does not use addressing, and autocommand permits you to invoke the arap string. If the string following autocommand has one or more spaces as part of the string, you must place quotation marks (" ") around the string. For example, if you specify autocommand tn3270 abracadabra, you must enclose tn3270 abracadabra in quotes. The autocommand option applies only to outgoing connections. You can issue any EXEC command and any switch or host name as an argument to the autocommand option.
out-options	(Optional) Outgoing connection request options. These arguments can have the following values:
	LAT translation options: node node-name---Connects to the specified node (node-name) that offers a service. By default, the connection is made to the highest-rated node that offers the service. port port-name---Destination LAT port name (port-name) in the format of the remote system. This parameter is usually ignored in most timesharing systems, but is used by terminal servers that offer reverse-LAT services.
	X.25 translation options:
	cud c-u-data---Sends the specified Call User Data (CUD) text (c-u-data) as part of an outgoing call request after the protocol identification bytes. no-reverse---Specifies that outgoing calls are not to use reverse charging, when the interface default is that all outgoing calls are reverse charged. profile profile---Sets the X.3 PAD parameters as defined in the profile created by the x29 profile command. 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. This is an outgoing option only.
	SLIP and PPP translation options: ip-pool---Obtain an IP address from a DHCP proxy client or a local pool. If the scope-name option is not specified, the address is obtained from a DHCP proxy client. If the scope-name option is specified, the IP address is obtained from the specified local pool. scope-name---Specific local scope name from which to obtain an IP address. Can specify a range of IP addresses. header-compression [passive]---Implements header compression on IP packets only. The option passive for SLIP connections permits compression on outgoing packets only if incoming TCP packets on the same virtual asynchronous interface are compressed. The default (without the passive option) permits compression on all traffic. 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. mtu bytes---Permits you to change the 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 64 through 1,000,000 bytes.
	More PPP translation options: keepalive number-of-seconds---Permits you to specify the interval at which keepalive packets are sent on SLIP and PPP virtual asynchronous interfaces. By default, keepalive packets are enabled and are sent every 10 seconds. To shut off keepalive packets, use a value of 0. The active keepalive interval is 1 through 32767 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 output. authentication {chap | pap}---Use CHAP or 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. ppp use-tacacs---Enables TACACS authentication for CHAP or PAP on virtual asynchronous interfaces (for PPP only; TACACS authentication is not supported for SLIP). ipx loopback number---Permits clients running IPX-PPP over X.25 to connect through virtual terminal (VTY) lines on the router. The loopback number option specifies the loopback interface to be created. A loopback interface must have been created and configured with a Novell IPX network number before IPX-PPP can work on the VTY line. The VTY line is assigned to the loopback interface.
global-options	(Optional) Translation options that can be used by any connection type. It 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 the number (integer) previously assigned to an access list. The standard access list is 1-99. 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. rotor---Specifies a rotary among host-name addresses. login---Requires that the user log in before the outgoing connection is made. This type of login is specified on the VTY lines with the login command. quiet---Suppresses printing of user-information messages.

Defaults

No default translation parameters

Command Modes

Global configuration

Command History

Release	Modification
11.2	This command was introduced.

Usage Guidelines

Examples

The following example illustrates the use of the TCP incoming protocol option printer for an incoming TCP connection:

translate tcp 172.19.32.250 printer x25 5678
          incoming          option  outgoing
 

The following example permits clients running IPX/PPP to connect through the device's VTY 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 
!         incoming                   outgoing    option

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.

Syntax Description

incoming-address	TCP/IP Telnet and a standard IP address or host name. The argument ip-address 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.
in-options	(Optional) Incoming connection request options. These arguments can have the following values: 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 at translate command in the old format.) port number---For incoming connections, enter the number of the port to match. The default is port 23 (any port). For outgoing connections, enter the number of the port to use. The default is port 23 (Telnet). printer---Supports LAT and X.25 printing over a TCP network among multiple sites. This option causes the Cisco IOS 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 option will force the global option quiet 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 prevents Telnet processing of the data stream as well. This option might be useful for connections to ports running UUCP or other non-Telnet protocols, or to ports connected to printers. For ports connected to printers using Telnet, the stream option prevents some of the usual problems associated with using Telnet for printers, such as strange things happening to bare carriage returns or line feeds and echoing of data back to VMS systems.
virtual-template number	Applies the virtual interface template specified by number in place of outgoing options.
global-options	(Optional) Translation options that can be used by any connection type. It 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 value previously assigned to an access list. The standard access list range is from 1 to 99.
	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. rotor---Specifies a rotary among host-name addresses.

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 option 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 option printer 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
          incoming          option  outgoing

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.

Syntax Description

incoming-address	X.25 and an X.121 address. The X.121 address must conform to specifications provided in the CCITT 1984 Red Book. This number 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 will generally 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 itself is responsible for dealing with the extra digits appropriately. Do not use the same address on the interface and for translation.
in-options	(Optional) Incoming connection request options. These arguments can have the following values: accept-reverse---Accepts reverse charged calls on an X.121 address even if the serial interface is not configured to accept reverse charged calls. This is an incoming option only. cud c-u-data---Sends the specified Call User Data (CUD) text (c-u-data) as part of an outgoing call request after the protocol identification bytes. idle minutes---Specifies the number of minutes the VC is idle. This option enables the protocol translation function to clear a switched virtual circuit (SVC) 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 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. The option causes the Cisco IOS software to delay the call confirmation of an incoming X.25 call request until 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 confirmed and then cleared, which is the default behavior. Note that using this option will force the global option quiet to be applied to the translation. profile profile---Sets the X.3 PAD parameters as defined in the profile created by the x29 profile command.
protocol outgoing-address	Name of a protocol followed by a service name, IP address, or host name. The host name is translated to an IP address during configuration, unless you use the TCP host-name option, which allows load balancing by dynamically resolving an IP address from a host name. These arguments can have the following values: lat service-name---LAT and a LAT service name. You must learn the service name, through LAT service advertisements, before you can use it. tcp ip-address---TCP/IP Telnet and a standard IP address or host name. The argument ip-address 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. slip ip-address---The argument ip-address 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). The slip argument applies only to outgoing connections; SLIP is not supported on incoming protocol translation connections. ppp ip-address---The argument ip-address 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). The ppp argument applies only to outgoing connections; PPP is not supported for incoming protocol translation connections. autocommand---Enables you to specify a string for an outgoing connection. The string executes upon connection to a host. If you want to enable ARA on an outgoing connection, you need to specify the autocommand arap string. The autocommand option is necessary for ARA, because ARA does not use addressing, and autocommand permits you to invoke the arap string. If the string following autocommand has one or more spaces as part of the string, you must place quotation marks (" ") around the string. For example, if you specify autocommand tn3270 abracadabra, you must enclose the tn3270 abracadabra string in quotes. The autocommand option applies only to outgoing connections. You can issue any EXEC command and any switch or host name as an argument to the autocommand option.
out-options	(Optional) Outgoing connection request options. These arguments can have the following values: 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. This application occurs when the protocol translation function searches the X.25 map PAD entries and finds a matching X.121 destination address. The X.25 map facilities applied to the outgoing translation can be viewed with the show translation command throughout the duration of the translation session.
	LAT translation options: node node-name---Connects to the specified node (node-name) that offers a service. By default, the connection is made to the highest-rated node that offers the service. port port-name---Destination LAT port name (port-name) in the format of the remote system. This parameter is usually ignored in most timesharing systems but is used by terminal servers that offer reverse-LAT services.
	Telnet TCP translation options: port number---For incoming connections, number of the port to match. The default is port 23 (any port). For outgoing connections, number of the port to use. The default is port 23 (Telnet).
	SLIP and PPP translation options: ip-pool---Obtain an IP address from a DHCP proxy client or a local pool. If the scope-name option is not specified, the address is obtained from a DHCP proxy client. If the scope-name option is specified, the IP address is obtained from the specified local pool. scope-name---Specific local scope name from which to obtain an IP address. This option can specify a range of IP addresses. header-compression [passive]---Implements header compression on IP packets only. The option passive for SLIP connections permits compression on outgoing packets only if incoming TCP packets on the same virtual asynchronous interface are compressed. The default (without the passive option) permits compression on all traffic. 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. mtu bytes---Permits you to change the 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 64 to 1,000,000 bytes.
	PPP translation options: keepalive number-of-seconds---Permits you to specify the interval at which keepalive packets are sent on SLIP and PPP virtual asynchronous interfaces. By default, keepalive packets are enabled and are sent every 10 seconds. To shut off keepalive packets, use a value of 0. The active keepalive interval is 1 to 32767 seconds. When you do not change from the default of 10, the keepalive interval does not appear in the more system:running-config or show translate command output. authentication {chap | pap}---Use CHAP or 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. ppp use-tacacs---Enables TACACS authentication for CHAP or PAP on virtual asynchronous interfaces (for PPP only; TACACS authentication is not supported for SLIP). 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.
global-options	(Optional) Translation options that can be used by any connection type. It 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 the number (integer) previously assigned to an access list. The standard access list is 1 to 99. max-users number---Limits the number of simultaneous users of the translation to number (an integer you specify). local---Prevents Telnet protocol negotiations to from being 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. rotor---Specifies a rotary among host-name addresses. quiet---Suppresses printing of user-information messages.
	swap---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. For X.25-to-TCP translations only.
	pvc number {[interface serial number] [packetsize in-size out-size] [windowsize in-size out-size]}---Specifies that the incoming or outgoing connection is actually a permanent virtual circuit (PVC). Only one session is allowed per PVC, where: number ---Specifies the virtual-circuit channel number of the incoming connection, which must be less than the virtual circuits assigned to the switched virtual circuits (SVC). 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. Following are valid packet size values: 16, 32, 64, 128, 256, 512 1024, 2048, or 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 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.

Defaults

No default translation parameters

Command Modes

Global configuration

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

Examples

The following example illustrates a simple X.25-to-TCP translate x25 command. Packets coming in X.25 address 652365123 arrive via PVC 1 and are translated to TCP packets and sent out IP address 172.16.1.1.

translate x25 652365123 pvc 1 tcp 172.16.1.1
!         incoming       option outgoing

The following example illustrates a more complex configuration that calls an X.29 profile and swaps the default PAD operation of the router to that of an X.25 host. The name of the profile is fullpackets.

x29 profile fullpackets 2:0 3:0 4:100 7:21
translate x25 217536124 profile fullpackets tcp rubble port 4006 swap
!         incoming      option              outgoing   option    global
 

The following example illustrates the use of the X.25 incoming protocol option printer for an incoming X.25 connection:

translate x25 55555 printer tcp 172.16.1.1
!         incoming   option  outgoing
 

The following example translates X.25 packets to PPP. It enables routing updates between the two connections:

translate x25 12345678 ppp 10.0.0.2 routing
!         incoming     outgoing    option
 

The following example permits clients running ARA to connect through the devices' virtual terminal lines to an AppleTalk network:

appletalk routing
translate x25 12345678 autocommand arap
!         incoming     outgoing 
  arap enable
  arap dedicated
  arap timelimit 45
  arap warningtime 5
  arap noguest
  arap require-manual-password
  arap net-access-list 614
 

The following example specifies IP pooling from a DHCP server named ludicrous. It then specifies that incoming TCP traffic be translated to SLIP. The DHCP server will dynamically assign IP addresses on the outgoing sessions.

ip address-pool dhcp-proxy-client
ip dhcp-server ludicrous
translate x25 5467835 ppp ip-pool scope-name ludicrous
 

The following example specifies a local IP pool named scandal with IP addresses ranging from 172.18.10.10 to 172.18.10.110. It then specifies that incoming X.25 traffic be translated to PPP. The local IP pool scandal will be used to dynamically assign IP addresses on the outgoing sessions.

ip-pool scandal 172.18.10.10 172.18.10.110
translate x25 1234567 ppp ip-pool scope-name scandal
 

X.25 calls are cleared if they are idle for the configured time, as shown in the following example:

translate x25 1234 idle 2 lat shazam 

Related Commands

Command	Description
show translate	Displays configured translation sessions.
translate lat	When a LAT connection request to a service name is received, the Cisco router can automatically translate the request to another outgoing protocol connection type.
translate tcp	When a TCP connection request to a particular destination address or host name is received, the Cisco router can automatically translate the request to another outgoing protocol connection type.
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.

Examples

The following example shows a virtual template with PPP encapsulation specified by default (not explicit). It also specifies CHAP authentication and an X.29 access list.

x29 access-list 1 permit ^5555
!
interface Virtual-Template1
 ip unnumbered Ethernet0
 peer default ip address 172.16.2.129
 ppp authentication chap
!
translate x25 5555667 virtual-template 1 access-class 1

Related Commands

Command	Description
interface virtual-template	Creates a virtual template interface that can be configured and applied dynamically in creating virtual access interfaces.
show translate	Displays configured translation sessions.
translate lat	When a LAT connection request to a service name is received, the Cisco router can automatically translate the request to another outgoing protocol connection type.
translate tcp	When a TCP connection request to a particular destination address or host name is received, the Cisco router can automatically translate the request to another outgoing protocol connection type.
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.

Table 136: Definitions of ttycap Capabilities: Number Sequences

Number Sequence	Description
li	Lines on the screen
co	Columns on the screen
sg	Standout glitch, number of spaces printed when entering or leaving standout display mode
ug	Underline glitch, number of spaces printed when entering or leaving underline mode

The ttycap database uses these color sequences to translate IBM directives into screen drawing commands. These color sequences control only foreground terminal colors. They do not control background color, which is configured to black by default.

Examples

The following is an example of a ttycap file. Refer to the chapter "Configuring Dial-In Terminal Services" in the Cisco IOS Dial Services Configuration Guide: Terminal Services and the tn3270.examples file in the Cisco ftp@cisco.com directory for more examples.

ttycap ttycap1\
d0|vt100|vt100-am|vt100am|dec vt100:do=^J:co#80:li#24:\
cl=50^[[;H^[[2J:bs:am:cm=5^[[%i%d;%dH:nd=2^[[C:up=2^[[A:\
ce=3^[[K:so=2^[[7m:se=2^[[m:us=2^[[4m:ue=2^[[m:md=2^[[1m:\
me=2^[[m:ho=^[[H:xn:sc=^[7:rc=^[8:cs=^[[%i%d;%dr:

Related Commands

Command	Description
keymap-type	Specifies the keyboard map for a terminal connected to the line.
terminal-type	Specifies the type of terminal connected to a line.

Syntax Description

host	Name or IP address of a specific host on a network that can be reached by the router.

Command Modes

User EXEC

Command History

Release	Modification
10.0	This command was introduced.

Usage Guidelines

If you are a mobile user, it is often impractical to dial in to your "home" router from a remote site. The asynchronous mobility feature allows you to dial in to different routers elsewhere on the internetwork while experiencing the same server environment that you would if you were connecting directly to your home router.

This asynchronous host mobility is accomplished by packet tunneling, a technique by which raw data from the dial-in user is encapsulated and transported directly to the host site where your home router performs the actual protocol processing.

You enable asynchronous mobility by entering the tunnel command to set up a network layer connection to a specified host. From a router other than a Cisco router, however, you need to use the Telnet protocol.

After a connection is established, you receive an authentication dialog or prompt from your home router and can proceed as if you are connected directly to it. When communications are complete, the network connection can be closed and terminated from either end of the connection.

Examples

The following example establishes a network layer connection with an IBM host named mktg:

router> tunnel mktg

Syntax Description

This command has no arguments or keywords.

Defaults

Disabled

Command Modes

Global configuration

Command History

Release	Modification
11.2F	This command was introduced.
12.0(7)T	This command was enhanced to allow virtual profiles to be downloaded from an AAA server using the HDLC, LAPB-TA, X.25, and Frame Relay encapsulations, in addition to the originally supported PPP encapsulation.

Usage Guidelines

Effect of this command for any specific user depends on the router being configured for AAA and the AAA server being configured for that user's specific configuration information.

Examples

The following example configures virtual profiles by AAA configuration only:

virtual-profile aaa

Related Commands

Command	Description
aaa authentication	Enables AAA authentication to determine if a user can access the privileged command level.
virtual-profile if-needed	Enables virtual profiles by virtual interface template.

Syntax Description

number

Number of the virtual template to apply, in the range 1 to 30.

Defaults

Disabled. No virtual template is defined, and no default virtual template number is used.

Command Modes

Global configuration

Command History

Release	Modification
11.2F	This command was introduced.

Usage Guidelines

When virtual profiles are configured by virtual templates only, any interface-specific configuration information that is downloaded from the AAA server is ignored in configuring the virtual access interface for a user.

Examples

The following example configures virtual profiles by virtual templates only. The number 2 was chosen because virtual template 1 was previously defined for use by Multilink PPP.

virtual-profile virtual-template 2 

Related Commands

Command	Description
interface virtual-template	Creates a virtual template interface that can be configured and applied dynamically in creating virtual access interfaces.