Cisco IOS Dial Services Commands: VPDN Through X

This chapter explains the function and syntax of the Cisco IOS dial services commands from VPDN through X. For more information about defaults and usage guidelines, see the corresponding chapter of the Cisco IOS Dial Services Command Reference, Release 12.1.

vpdn domain-delimiter

To specify the characters to be used to delimit the domain prefix or domain suffix, use the vpdn domain-delimiter command in global configuration mode.

vpdn domain-delimiter characters [suffix | prefix]

Syntax Description

characters

One or more specific characters to be used as suffix or prefix delimiters. Available characters are %, -, @, \ , #, and /.

If a backslash (\) is the last delimiter in the command line, enter it as a double backslash (\\).

suffix | prefix

(Optional) Usage of the specified characters.

characters	One or more specific characters to be used as suffix or prefix delimiters. Available characters are %, -, @, \ , #, and /. If a backslash (\) is the last delimiter in the command line, enter it as a double backslash (\\).
suffix \| prefix	(Optional) Usage of the specified characters.

vpdn enable

To enable virtual private dialup networking on the router and inform the router to look for tunnel definitions in a local database and on a remote authorization server (home gateway), if one is present, use the vpdn enable command in global configuration mode.

vpdn enable

Syntax Description

This command has no arguments or keywords.

vpdn force-local-chap

To cause the home gateway to issue its own Challenge Handshake Authentication Protocol (CHAP) challenge even if one has already been issued from the network access server, use the vpdn force-local-chap command in global configuration mode. Use the no form of this command to prevent the home gateway from issuing its own CHAP challenge.

vpdn force-local-chap

no vpdn force-local-chap

Syntax Description

This command has no arguments or keywords.

vpdn group

To associate a Virtual Private Dialup Network (VPDN) group to a customer or VPDN profile, use the vpdn group command in customer profile or VPDN profile configuration mode. Use the no form of this command to remove the VPDN group from a customer profile or VPDN profile.

vpdn group name

Syntax Description

name

Name of the VPDN group.

name	Name of the VPDN group.

vpdn history failure table-size

To set the failure history table depth, use the vpdn history failure table-size command in global configuration mode.

vpdn history failure table-size entries

Syntax Description

entries

Defines the number of entries. Valid entries are 20 to 50.

entries	Defines the number of entries. Valid entries are 20 to 50.

vpdn incoming

To specify the local name to use for authenticating and the virtual template to use for building interfaces for incoming connections when a Level 2 Forwarding (tunnel) connection is requested from a certain remote host, use the vpdn incoming command in global configuration mode.

vpdn incoming remote-name local-name virtual-template number

Syntax Description

remote-name

Case-sensitive name of the remote host (the network access server) requesting the connection.

local-name

Case-sensitive local name (of the home gateway) to use when authenticating back to the remote host.

virtual-template number

Virtual template to use for building interfaces for incoming calls.

remote-name	Case-sensitive name of the remote host (the network access server) requesting the connection.
local-name	Case-sensitive local name (of the home gateway) to use when authenticating back to the remote host.
virtual-template number	Virtual template to use for building interfaces for incoming calls.

vpdn local-authentication

To enable local authentication of users on the network access server before the connection is forwarded to the home gateway, use the vpdn local-authentication command in global configuration mode. Use the no form of this command to reset the network access server to the default in which local authentication is disabled.

vpdn local-authentication

no vpdn local-authentication

Syntax Description

This command has no arguments or keywords.

vpdn logging

To enable the logging of Virtual Private Dialup Network (VPDN) events, use the vpdn logging command in global configuration mode. Use the no form of this command to disable the logging of VPDN events.

vpdn logging [local | remote]

no vpdn logging [local | remote]

Syntax Description

local

(Optional) Log VPDN events locally.

remote

(Optional) Log VPDN events to a remote tunnel endpoint.

local	(Optional) Log VPDN events locally.
remote	(Optional) Log VPDN events to a remote tunnel endpoint.

vpdn logging history failure

To enable the logging of failure events to the failure history table, use the vpdn logging history failure command in global configuration mode. Use the no form of this command to disable the logging of failure events.

vpdn logging history failure

no vpdn logging history failure

Syntax Description

This command has no arguments or keywords.

vpdn outgoing

To specify use of Dialed Number Information Service (DNIS) or use of a domain name when selecting a tunnel for forwarding traffic to the remote host (the home gateway) on a Virtual Private Dialup Network (VPDN), use the vpdn outgoing command in global configuration mode.

vpdn outgoing {dnis dialed-number | domain-name} local-name ip ip-address

Syntax Description

dnis dialed-number

Dialed number to be used for selecting a specific tunnel to be used for forwarding traffic to a home gateway.

domain-name

Case-sensitive name of the domain to forward traffic to.

local-name

Case-sensitive local name to use when authenticating the tunnel to the remote host.

ip ip-address

IP address of the remote host (home gateway).

dnis dialed-number	Dialed number to be used for selecting a specific tunnel to be used for forwarding traffic to a home gateway.
domain-name	Case-sensitive name of the domain to forward traffic to.
local-name	Case-sensitive local name to use when authenticating the tunnel to the remote host.
ip ip-address	IP address of the remote host (home gateway).

vpdn profile

To combine session counting over Virtual Private Dialup Network (VPDN) groups, use the vpdn profile command in customer profile configuration mode. Use the no form of this command to remove a VPDN profile from a customer profile.

vpdn profile name

no vpdn profile name

Syntax Description

name

Name of the VPDN profile.

name	Name of the VPDN profile.

vpdn search-order

To specify how the service provider's network access server is to perform Virtual Private Dialup Network (VPDN) tunnel authorization searches, use the vpdn search-order command in global configuration mode. Use the no form of the command to remove a prior specification.

vpdn search-order {dnis domain | domain dnis | domain | dnis}

no vpdn search-order

Syntax Description

dnis domain

Search first on the Dialed Number Information Service (DNIS) information provided on ISDN lines and then search on the domain name.

domain dnis

Search first on the domain name and then search on the DNIS information.

domain

Search on the domain name only.

dnis

Search on the DNIS information only.

dnis domain	Search first on the Dialed Number Information Service (DNIS) information provided on ISDN lines and then search on the domain name.
domain dnis	Search first on the domain name and then search on the DNIS information.
domain	Search on the domain name only.
dnis	Search on the DNIS information only.

vpdn source-ip

To set the source IP address of the network access server, use the vpdn source-ip command in global configuration mode.

vpdn source-ip address

Syntax Description

address

IP address of the network access server.

address	IP address of the network access server.

vty-async

To configure all virtual terminal lines on a router to support asynchronous protocol features, use the vty-async command in global configuration mode. Use the no form of this command to disable asynchronous protocol features on virtual terminal lines.

vty-async

no vty-async

Syntax Description

This command has no arguments or keywords.

vty-async dynamic-routing

To enable dynamic routing on all virtual asynchronous interfaces, use the vty-async dynamic-routing command in global configuration mode. Use the no form of this command to disable asynchronous protocol features on virtual terminal lines and, therefore, disable routing on virtual terminal lines.

vty-async dynamic-routing

no vty-async dynamic-routing

Syntax Description

This command has no arguments or keywords.

vty-async header-compression

To compress the headers of all TCP packets on virtual asynchronous interfaces, use the vty-async header-compression command in global configuration mode. Use the no form of this command to disable virtual asynchronous interfaces and header compression.

vty-async header-compression [passive]

no vty-async header-compression

Syntax Description

passive

(Optional) Specifies that outgoing packets to be compressed only if TCP incoming packets on the same virtual asynchronous interface are compressed. For SLIP, if you do not specify this option, the Cisco IOS software will compress all traffic. The default is no compression. For PPP, the Cisco IOS software always negotiates header compression.

passive	(Optional) Specifies that outgoing packets to be compressed only if TCP incoming packets on the same virtual asynchronous interface are compressed. For SLIP, if you do not specify this option, the Cisco IOS software will compress all traffic. The default is no compression. For PPP, the Cisco IOS software always negotiates header compression.

vty-async ipx ppp-client loopback

To enable IPX-PPP on virtual terminal lines, use the vty-async ipx ppp-client loopback command in global configuration mode. Use the no form of this command to disable IPX-PPP sessions on virtual terminal lines.

vty-async ipx ppp-client loopback number

no vty-async ipx ppp-client loopback

Syntax Description

number

Number of the loopback interface configured for IPX to which the virtual terminal lines are assigned.

number	Number of the loopback interface configured for IPX to which the virtual terminal lines are assigned.

vty-async keepalive

To change the frequency of keepalive packets on all virtual asynchronous interfaces, use the vty-async keepalive command in global configuration mode. Use the no vty-async command to disable asynchronous protocol features on virtual terminal lines, or the vty-async keepalive 0 command to disable keepalive packets on virtual terminal lines.

vty-async keepalive seconds

no vty-async keepalive

vty-async keepalive 0

Syntax Description

seconds

The frequency, in seconds, with which the Cisco IOS software sends keepalive messages to the other end of a virtual asynchronous interface. To disable keepalive packets, use a value of 0. The active keepalive interval range is 1 to 32767 seconds. The default is 10 seconds.

seconds	The frequency, in seconds, with which the Cisco IOS software sends keepalive messages to the other end of a virtual asynchronous interface. To disable keepalive packets, use a value of 0. The active keepalive interval range is 1 to 32767 seconds. The default is 10 seconds.

vty-async mtu

To set the maximum transmission unit (MTU) size on virtual asynchronous interfaces, use the vty-async mtu command in global configuration mode. Use the no form of this command to disable asynchronous protocol features on virtual terminal lines.

vty-async mtu bytes

no vty-async

Syntax Description

bytes

MTU size of IP packets that the virtual asynchronous interface can support. The default MTU is 1500 bytes, the minimum MTU is 64 bytes, and the maximum is 1,000,000 bytes.

bytes	MTU size of IP packets that the virtual asynchronous interface can support. The default MTU is 1500 bytes, the minimum MTU is 64 bytes, and the maximum is 1,000,000 bytes.

vty-async ppp authentication

To enable PPP authentication on virtual asynchronous interfaces, use the vty-async ppp authentication command in global configuration mode. Use the no form of this command to disable PPP authentication.

vty-async ppp authentication {chap | pap}

no vty-async ppp authentication {chap | pap}

Syntax Description

chap

Enable CHAP on all virtual asynchronous interfaces.

pap

Enable PAP on all virtual asynchronous interfaces.

chap	Enable CHAP on all virtual asynchronous interfaces.
pap	Enable PAP on all virtual asynchronous interfaces.

vty-async ppp use-tacacs

To enable TACACS authentication for PPP on virtual asynchronous interfaces, use the vty-async ppp use-tacacs command in global configuration mode. Use the no form of this command to disable TACACS authentication on virtual asynchronous interfaces.

vty-async ppp use-tacacs

no vty-async ppp use-tacacs

Syntax Description

This command has no arguments or keywords.

vty-async virtual-template

To configure virtual terminal lines to support asynchronous protocol functions based on the definition of a virtual interface template, use the vty-async virtual-template command in global configuration mode. Use the no form of this command to disable virtual interface templates for asynchronous functions on virtual terminal lines.

vty-async virtual-template number

no vty-async virtual-template

Syntax Description

number

The virtual interface number.

number	The virtual interface number.

where

To list the open sessions, use the where command in EXEC mode.

where

Syntax Description

This command has no arguments or keywords.

x25 aodi

To enable the Always On/Dynamic ISDN (AO/DI) client on an interface, use the x25 aodi command in interface configuration mode. Use the no form of this command to remove AO/DI client functionality.

x25 aodi

no x25 aodi

Syntax Description

This command has no arguments or keywords.

x25 map ppp

To enable a PPP session over the X.25 protocol, use the x25 map ppp command in interface configuration mode. Use the no form of this command to remove a prior mapping.

x25 map ppp x121-address interface cloning-interface no-outgoing

no x25 map ppp x121-address interface cloning-interface no-outgoing

Syntax Description

x121 address

The X.121 address as follows:

Client side---The calling number.

Server side---The called number.

interface cloning-interface

The interface to be used for cloning the configuration.

no-outgoing

Ensures that the X.25 map does not originate calls.

x121 address	The X.121 address as follows: Client side---The calling number. Server side---The called number.
interface cloning-interface	The interface to be used for cloning the configuration.
no-outgoing	Ensures that the X.25 map does not originate calls.

x25 subaddress

To append either a physical port number or a value specified for a line as a subaddress to the X.121 calling address, use the x25 subaddress command in line configuration mode. Use the no form of this command to disable subaddressing.

x25 subaddress {line | number}

no x25 subaddress {line | number}

Syntax Description

line

The physical port number for the indicated line will be appended to the X.121 address as the subaddress.

number

Numeric variable assigned to a specific line.

line	The physical port number for the indicated line will be appended to the X.121 address as the subaddress.
number	Numeric variable assigned to a specific line.

x28

To enter X.28 mode and access an X.25 network or set X.3 packet assembler/disassembler (PAD) parameters, use the x28 EXEC command. Use the no form of this command to exit X.28 mode.

x28 [escape character-string] [noescape] [nuicud] [profile file-name] [reverse] [verbose]

no x28 [escape character-string] [noescape] [nuicud] [profile file-name] [reverse] [verbose]

Syntax Description

escape character-string

(Optional) Specifies a character string to use to exit X.28 mode and return to EXEC mode. The character string can be any string of alphanumeric characters. The Ctrl key can be used in conjunction with the character string.

noescape

(Optional) Specifies that no escape character string is defined (user cannot return to EXEC mode). On the console line, the noescape option is ignored, and the default escape sequence is used (exit command).

nuicud

(Optional) Specifies the network user identification (NUI) data to not be placed in the network user identification facility of the call request. Instead it is placed in the call user data (CUD) area of the call request packet.

profile file-name

(Optional) Specifies using a user-configured profile of X.3 parameters. A profile is created with the x29 profile EXEC command.

reverse

(Optional) Specifies reverse charges for outgoing calls made from the local router to the destination device.

verbose

(Optional) Displays optional service signals such as the called DTE address, facility block, and CUD.

escape character-string	(Optional) Specifies a character string to use to exit X.28 mode and return to EXEC mode. The character string can be any string of alphanumeric characters. The Ctrl key can be used in conjunction with the character string.
noescape	(Optional) Specifies that no escape character string is defined (user cannot return to EXEC mode). On the console line, the noescape option is ignored, and the default escape sequence is used (exit command).
nuicud	(Optional) Specifies the network user identification (NUI) data to not be placed in the network user identification facility of the call request. Instead it is placed in the call user data (CUD) area of the call request packet.
profile file-name	(Optional) Specifies using a user-configured profile of X.3 parameters. A profile is created with the x29 profile EXEC command.
reverse	(Optional) Specifies reverse charges for outgoing calls made from the local router to the destination device.
verbose	(Optional) Displays optional service signals such as the called DTE address, facility block, and CUD.

x3

To set X.3 packet assembler/disassembler (PAD) parameters, use the x3 EXEC command.

x3 parameter:value

Syntax Description

parameter:value

Sets the PAD parameters.

parameter:value	Sets the PAD parameters.

xremote

To prepare the router for manual startup and initiate an XRemote connection, use the xremote EXEC command. This command begins the instructions that prompt you through the connection.

xremote

Syntax Description

This command has no arguments or keywords.

xremote lat

To initiate a DECwindow session over a local-area transport (LAT) connection, use the xremote lat EXEC command.

xremote lat service

Syntax Description

service

Name of the desired LAT service.

service	Name of the desired LAT service.

xremote tftp buffersize

To change the buffer size used for loading font files, use the xremote tftp buffersize command in global configuration mode. Use the no form of this command to restore the buffer size to the default value.

xremote tftp buffersize buffersize

no xremote tftp buffersize

Syntax Description

buffersize

Buffer size in bytes. This is a decimal number in the range from 4096 to 70000 bytes. The default is 70000.

buffersize	Buffer size in bytes. This is a decimal number in the range from 4096 to 70000 bytes. The default is 70000.

xremote tftp host

To add a specific Trivial File Transfer Protocol (TFTP) font server as a source of fonts for the terminal, use the xremote tftp host command in global configuration mode. Use the no form of this command to remove a font server from the list.

xremote tftp host hostname

no xremote tftp host hostname

Syntax Description

hostname

IP address or name of the host containing fonts.

hostname	IP address or name of the host containing fonts.

xremote tftp retries

To specify the number of retries the font loader will attempt before declaring an error condition, use the xremote tftp retries command in global configuration mode. Use the no form of this command to restore the default retries number.

xremote tftp retries retries

no xremote tftp retries

Syntax Description

retries

(Optional) Number of retries. Acceptable values are decimal numbers in the range from 1 to 15.

retries	(Optional) Number of retries. Acceptable values are decimal numbers in the range from 1 to 15.

xremote xdm

To activate automatic session startup for an XRemote connection, use the xremote xdm EXEC command.

xremote xdm [hostname]

Syntax Description

hostname

(Optional) Host computer name or IP address.

Table of Contents

Cisco IOS Dial Services Commands: VPDN Through X